Desembolsos de un despacho
GET/dispatch/:numeroDespacho/desembolsos
Devuelve todos los desembolsos de un despacho: los gastos que la agencia pagó por cuenta del cliente, con su estado, sus montos y los documentos que los respaldan.
Mismas condiciones de acceso que GET /dispatch/{numeroDespacho}/files:
rut obligatorio, y el despacho tiene que pertenecer a esa cuenta.
GET https://api-comex.eurus.pro/{idAgencia}/v1/dispatch/{numeroDespacho}/desembolsos?key=...&rut=...
No hay paginación: la respuesta trae todos los desembolsos del
despacho, y total es su cantidad.
Cada elemento trae el despacho asociado en dispatch, con la misma
forma en todos.
Request
Responses
- 200
- 400
- 403
- 404
- 500
Desembolsos del despacho.
Parámetros inválidos. Ver el code del cuerpo para discriminar:
DISPATCH_ID_INVALID, RUT_NUMBER_INVALID, START_DATE_REQUIRED,
END_DATE_REQUIRED, START_DATE_INVALID, END_DATE_INVALID,
DATE_RANGE_INVALID, FILE_TYPE_NAME_INVALID,
RECORD_TYPE_INVALID, NEXT_TOKEN_INVALID, PROJECT_ID_UNDEFINED.
API Key ausente, inválida, o no autorizada para el idAgencia de la
ruta. Códigos: API_KEY_INVALID, PROJECT_ID_UNAUTHORIZED.
La API responde 403, no 401, también cuando la key falta.
El recurso no existe o no pertenece a la cuenta del rut.
Códigos: DISPATCH_NOT_FOUND y ACCOUNT_NOT_FOUND (el RUT no es
cliente o no está activo para esta API).
Los dos casos del despacho —inexistente y de otra cuenta— devuelven la misma respuesta a propósito. Distinguirlos permitiría deducir, probando números correlativos, qué despachos existen en la agencia sin acceder a ninguno.
Dos code posibles, de dos capas distintas:
INTERNAL_ERROR— fallo de la operación. Acá nunca se propaga el código de la capa de datos: elcodees siempre este y el mensaje es genérico, porque el detalle queda en los logs del servicio. Reintentar con back-off; si persiste, reportar elrequestId.TENANT_UNRESOLVED— la configuración de la agencia no se pudo resolver. Lo emite la capa de autenticación, antes de llegar a esta operación. Reintentar no lo resuelve: reportar elrequestId.