Seguimiento
El módulo de Seguimiento permite consultar el estado de los despachos de comercio exterior: tipo de registro, estado de la DIN o el DUS, fechas relevantes y prioridad.
Sirve tanto para importaciones como para exportaciones: el campo recordType distingue el tipo de operación.
Endpoints disponibles
Ambos en la etiqueta Seguimiento de la Referencia de la API:
-
GET /dispatch/{numeroDespacho}/statusEstado de un despacho específico. -
GET /dispatch/statusTodos los despachos de tu cuenta, con filtros por tipo de registro y estado de cierre, ordenamiento y límite.
Tres diferencias con el módulo de Documentación
Los dos módulos comparten autenticación y el parámetro rut, pero su contrato de respuesta difiere en tres puntos que conviene no confundir.
1. Todas las claves están siempre presentes
En Documentación, un campo vacío desaparece del JSON. Acá es al revés: la respuesta trae siempre las trece claves, y las que no tienen valor se emiten como null.
{
"id": "123457",
"numeroDespacho": "123457",
"recordType": "din",
"EstadoDIN": "ACEPTADA",
"EstadoDUS": null,
"isCompleted": false,
"dueStatus": "EN_PLAZO",
"priority": "ALTA",
"allowEdit": true,
"createdDate": "2026-01-05T13:00:00.000Z",
"lastModifiedDate": "2026-01-18T09:10:00.000Z",
"fechaEta": "2026-01-22T00:00:00.000Z",
"fechaLegalizacion": null
}
2. No hay paginación por cursor
El listado se acota con limit, que admite hasta 200 y por defecto trae 50. No hay nextToken.
total no es el total existentetotal es la cantidad devuelta en esa respuesta. Si viene igual a limit, es probable que haya más despachos de los que estás viendo: subí el limit o afiná los filtros.
3. Los filtros toleran valores no soportados, pero no te apoyes en eso
Los valores soportados son los que declara la Referencia de la API: orderBy dentro de su lista, orderDirection en asc o desc, y limit entre 1 y 200.
Hoy un valor fuera de ahí no produce error: se descarta y se aplica el valor por defecto. Ese comportamiento no es parte del contrato y puede pasar a responder 400 sin aviso previo, así que validá los filtros de tu lado en vez de confiar en el descarte silencioso.
Parámetros comunes
| Parámetro | Ubicación | Descripción |
|---|---|---|
idAgencia | Path (variable de servidor) | Identificador de tu agencia EURUS PRO®. |
key | Query | API Key provista por EURUS PRO®. Ver Autenticación. |
rut | Query | RUT del cliente final (ver formato de RUT). Acota lo que ves: solo devuelve despachos de esa cuenta. |
Un despacho que pertenece a otro cliente responde 404, igual que uno inexistente. Ver Errores.