Saltar al contenido principal

Listar presupuestos

GEThttps://carchost.fieldcontrol.com.br/quotations

Lista los presupuestos de la cuenta, con los ítems, con paginación y filtros. El listado se ordena por el identificador.

Requiere los headers X-Api-Key y User-Agent. Límite: 1 solicitud por segundo (más información).

Solicitud​

Parámetros de consulta

limitinteger

Cantidad de ítems por página.

De 1 a 100.Predeterminado: 10.

offsetinteger

Cantidad de ítems que se omiten.

De 0 a 200000.Predeterminado: 0.

qstring

Filtros en el formato campo:valor, separados por espacios (cómo filtrar). Los filtros aceptados están en la tabla de abajo.

Ejemplo: status:pending customerId:NTc4NTQ1OjIyOTE1.

FiltroQué hace
name

Parte del nombre, sin distinguir mayúsculas y minúsculas.

identifier

Parte del número, sin distinguir mayúsculas y minúsculas.

status

pending, approved, refused, expired o canceled.

archived

true para archivados, false para activos.

createdBy

Parte del nombre de quien lo creó.

customerId

Identificador del cliente.

locationId

Identificador de la ubicación.

createdAt>=

Creados a partir de la fecha informada, inclusive.

createdAt<=

Creados hasta la fecha informada, inclusive.

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Respuestas

  • 200

    Lista de presupuestos.

  • 401

    Clave de API ausente (Missing API Key) o inválida (Invalid API Key). Consulte Autenticación.

  • 403

    Cuenta bloqueada (Account blocked), vencida (Account expired) o con un plan que no permite integración (Account plan not allowed). Consulte Autenticación.

  • 422

    Filtro o paginación inválidos (parametersValidationErr).

  • 429

    Se superó el límite de 1 solicitud por segundo. Consulte Límite de solicitudes.

  • 500

    Error inesperado en el servidor.