pagequery · integerOpcionalRestricciones
{
"type": "integer",
"minimum": 1,
"default": 1
}Parámetros, estructura de datos y respuestas del contrato versionado.
/embarcador/solicitacoes-transporteLas descripciones técnicas se traducen del contrato versionado. Se conservan los identificadores y el JSON originales; se omiten los ejemplos de datos.
Devuelve la lista paginada de solicitudes de transporte pertenecientes al shipper_company_id autenticado, con filtros por estado de recepción (intake_status), comercial (commercial_status), atención (attendance_status), fiscal (fiscal_status), modalidad (contract_mode), tipo de operación (operation_type), búsqueda de texto (search) y lote (batch_id).
operacao — Operación[
{
"oauth2": []
},
{
"chaveApi": []
}
]pagequery · integerOpcional{
"type": "integer",
"minimum": 1,
"default": 1
}per_pagequery · integerOpcional{
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}intake_statusquery · stringOpcional{
"type": "string",
"enum": [
"draft",
"received",
"pending_data",
"validated",
"cancelled"
]
}commercial_statusquery · stringOpcional{
"type": "string",
"enum": [
"pending_resolution",
"contract_identified",
"ambiguous_contract",
"ambiguity_blocked",
"out_of_scope_spot_required",
"spot_requested",
"spot_proposal_ready",
"spot_accepted",
"pending_acceptance",
"contracted",
"revision_requested",
"cancelled"
]
}attendance_statusquery · stringOpcional{
"type": "string",
"enum": [
"not_requested",
"awaiting_confirmation",
"manager_committed",
"awaiting_driver_acceptance",
"partially_confirmed",
"confirmed",
"declined",
"in_transit",
"completed",
"cancelled"
]
}fiscal_statusquery · stringOpcional{
"type": "string",
"enum": [
"awaiting_nfe",
"not_required_yet",
"nfe_received_pending_confirmation",
"pending_nfe",
"nfe_validated",
"nfe_linked",
"ready_for_cte_prefill",
"ready_for_cte",
"cte_prefilled",
"cte_issuing",
"cte_authorized",
"cte_rejected",
"cte_timeout",
"cancelled"
]
}contract_modequery · stringOpcional{
"type": "string",
"enum": [
"period_contract",
"spot"
]
}operation_typequery · stringOpcional{
"type": "string",
"enum": [
"urban_delivery",
"closed_load",
"full_load"
]
}searchquery · stringOpcional{
"type": "string"
}batch_idquery · stringOpcional{
"type": "string"
}200 Respuesta HTTPLista paginada de solicitudes de transporte
application/json401 Respuesta HTTPSin autenticación (autenticacao): credencial ausente, inválida o vencida, incluida una clave API utilizada en el entorno incorrecto. La clave de homologación no es válida en producción, ni la de producción en homologación; el mensaje de error indica el entorno esperado.
403 Respuesta HTTPÁmbito no habilitado para esta credencial
429 Respuesta HTTPLímite de solicitudes excedido (limite_requisicoes). Espera el intervalo indicado en el encabezado Retry-After antes de reintentar. Puede provenir del proveedor o del límite antiabuso de FleetPay, calculado por empresa autenticada y grupo de rutas, con una ventana corta para ráfagas y otra larga para tráfico automatizado lento. Los límites son amplios deliberadamente: las integraciones reales, incluidos lotes grandes procesados de una vez, deberían quedar muy por debajo. Si tu integración alcanza un límite, contacta con FleetPay.
{
"tags": [
"Solicitações e Contratação de Transporte (Embarcador)"
],
"summary": "Listar solicitações de transporte do embarcador",
"description": "Retorna a lista paginada de solicitações de transporte pertencentes ao `shipper_company_id` autenticado, com filtros por status de recepção (`intake_status`), comercial (`commercial_status`), atendimento (`attendance_status`), fiscal (`fiscal_status`), modalidade (`contract_mode`), tipo de operação (`operation_type`), busca textual (`search`) e lote (`batch_id`).\n",
"operationId": "listarSolicitacoesTransporteEmbarcador",
"parameters": [
{
"$ref": "#/components/parameters/Page"
},
{
"$ref": "#/components/parameters/PerPage"
},
{
"name": "intake_status",
"in": "query",
"schema": {
"type": "string",
"enum": [
"draft",
"received",
"pending_data",
"validated",
"cancelled"
]
}
},
{
"name": "commercial_status",
"in": "query",
"schema": {
"type": "string",
"enum": [
"pending_resolution",
"contract_identified",
"ambiguous_contract",
"ambiguity_blocked",
"out_of_scope_spot_required",
"spot_requested",
"spot_proposal_ready",
"spot_accepted",
"pending_acceptance",
"contracted",
"revision_requested",
"cancelled"
]
}
},
{
"name": "attendance_status",
"in": "query",
"schema": {
"type": "string",
"enum": [
"not_requested",
"awaiting_confirmation",
"manager_committed",
"awaiting_driver_acceptance",
"partially_confirmed",
"confirmed",
"declined",
"in_transit",
"completed",
"cancelled"
]
}
},
{
"name": "fiscal_status",
"in": "query",
"schema": {
"type": "string",
"enum": [
"awaiting_nfe",
"not_required_yet",
"nfe_received_pending_confirmation",
"pending_nfe",
"nfe_validated",
"nfe_linked",
"ready_for_cte_prefill",
"ready_for_cte",
"cte_prefilled",
"cte_issuing",
"cte_authorized",
"cte_rejected",
"cte_timeout",
"cancelled"
]
}
},
{
"name": "contract_mode",
"in": "query",
"schema": {
"type": "string",
"enum": [
"period_contract",
"spot"
]
}
},
{
"name": "operation_type",
"in": "query",
"schema": {
"type": "string",
"enum": [
"urban_delivery",
"closed_load",
"full_load"
]
}
},
{
"name": "search",
"in": "query",
"schema": {
"type": "string"
}
},
{
"name": "batch_id",
"in": "query",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Lista paginada de solicitações de transporte",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ListaSolicitacoesTransporteResponse"
}
}
}
},
"401": {
"$ref": "#/components/responses/Erro401"
},
"403": {
"$ref": "#/components/responses/Erro403"
},
"429": {
"$ref": "#/components/responses/Erro429"
}
},
"x-fleetpay-scope": "operacao",
"x-fleetpay-module": "contratacao-direta",
"x-fleetpay-profiles": [
"embarcador",
"gestor",
"agregado_empresarial"
],
"method": "GET",
"path": "/embarcador/solicitacoes-transporte"
}