AWBStandardStatus¶
Devuelve el rastreo de una guía: un encabezado con su estado actual y la lista de estados estándar por los que pasó, ordenados por fecha.
URL¶
POST https://ocelot.servientrega.us/api/Tracking/Track/AwbStandardStatus
POST https://ocelotkiwi.azurewebsites.net/api/Tracking/Track/AwbStandardStatus
Parámetros¶
| Nombre | Tipo | Obligatorio | Reglas |
|---|---|---|---|
shippingId |
número | Sí | Número de guía |
language |
texto | Sí | EN inglés o ES español. Los estados significan lo mismo en los dos idiomas |
Ejemplo de petición¶
curl -X POST "https://ocelot.servientrega.us/api/Tracking/Track/AwbStandardStatus" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{ "shippingId": 2290000001, "language": "EN" }'
curl -X POST "https://ocelotkiwi.azurewebsites.net/api/Tracking/Track/AwbStandardStatus" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{ "shippingId": 2290000001, "language": "EN" }'
awbImage ya no trae la imagen
Desde noviembre de 2026, awbImage no trae la imagen de entrega en base64. Cuando la guía tiene imagen
de entrega, el campo trae un texto con la ruta para descargarla; cuando no la tiene, el campo es null. El
campo se conserva para no romper las integraciones existentes.
Para saber si la imagen existe, lea hasDeliveryProof. Para descargarla, use
Imagen de prueba de entrega con el mismo token.
Ejemplo de respuesta¶
Con language: EN:
{
"result": true,
"entities": [
{
"header": {
"shippingId": 2290000001,
"reference": "ORDER-10001",
"awbDate": "2026-05-04T13:43:28.16Z",
"destinationCountry": "COLOMBIA",
"destinationCity": "BARRANQUILLA",
"currentStatus": "DELIVERED",
"awbImage": "Se obtiene en /api/DestinationStatus/track/DeliveryProof?awb=2290000001. Por favor refiérase a la documentación.",
"estimatedDeliveryDate": "2026-05-07T18:07:35Z",
"hasDeliveryProof": true
},
"details": [
{
"shippingId": 2290000001,
"idStatus": 1,
"status": "CREATED ORDER",
"dateTrack": "2026-05-04T13:43:28.16",
"location": "MIAMI",
"detail": "Create AWB"
},
{
"shippingId": 2290000001,
"idStatus": 3,
"status": "SEND TO INTERNATIONAL DEPARTURE",
"dateTrack": "2026-05-05T18:15:00",
"location": "MIAMI",
"detail": "729-00000000"
},
{
"shippingId": 2290000001,
"idStatus": 13,
"status": "DELIVERED",
"dateTrack": "2026-05-07T18:07:35",
"location": "BARRANQUILLA",
"detail": "ENTREGADO"
}
]
}
],
"messages": [
"Tracking returned sucessfully. Dates returned in UTC."
],
"notificationType": 3
}
header¶
| Campo | Significado |
|---|---|
shippingId |
Número de guía |
reference |
El reference que se envió al crear la guía |
awbDate |
Fecha de creación de la guía |
destinationCountry / destinationCity |
Destino |
currentStatus |
Estado estándar actual |
awbImage |
Ruta de la imagen de entrega, o null. Vea el aviso de arriba |
estimatedDeliveryDate |
Fecha estimada o real de entrega, cuando el operador de destino la informa |
hasDeliveryProof |
true cuando la imagen de entrega está disponible |
La respuesta puede traer otros campos (por ejemplo currentStep, currentState o lastOperatorQueryUtc) que usa
nuestra página de rastreo. Ignore los campos que no use: se pueden agregar campos nuevos sin aviso.
details¶
| Campo | Significado |
|---|---|
idStatus |
Código del estado estándar (vea la tabla siguiente) |
status |
Nombre del estado estándar, en el language pedido |
dateTrack |
Fecha del estado |
location |
Lugar donde ocurrió, cuando se conoce |
detail |
Información adicional. Con el estado 3, el número de guía master (MAWB) |
Todas las fechas están en UTC.
Estados estándar¶
Los nombres van en inglés, como en language: EN; con ES llegan en español con el mismo significado.
idStatus |
Etapa | Estado | Información adicional |
|---|---|---|---|
| 1 | Operación en EE. UU. | CREATED ORDER | No |
| 2 | Operación en EE. UU. | RECEIVED IN MIAMI HUB | No |
| 3 | Operación en EE. UU. | SEND TO INTERNATIONAL DEPARTURE | No |
| 4 | Operación en EE. UU. | DELAY IN INTERNATIONAL DEPARTURE | Sí |
| 5 | Operación en EE. UU. | ARRIVE TO DESTINATION COUNTRY | No |
| 6 | Operación de aduana | STARTING CUSTOM PROCESS | No |
| 7 | Operación de aduana | ENDING CUSTOM PROCESS | No |
| 8 | Operación de aduana | CUSTOMS CLEARANCE RETENTION | Sí |
| 24 | Operación de aduana | CUSTOMS REVIEW | Sí |
| 9 | Última milla | ENTRY LAST MILE OPERATION | No |
| 10 | Última milla | DEPARTURE TO DESTINATION CITY | No |
| 11 | Última milla | ENTRY DESTINATION CITY | No |
| 12 | Última milla | LOCAL DISTRIBUTION | No |
| 13 | Última milla | DELIVERED | No |
| 14 | Última milla | LAST MILE DELIVERY DELAY | Sí |
| 15 | Última milla | RETURN TO SENDER | Sí |
| 16 | Última milla | LOST | Sí |
| 17 | Última milla | REFUNDED | Sí |
| 18 | Última milla | VOIDED | Sí |
| 19 | Última milla | ABANDONED | Sí |
| 20 | Última milla | OTHER | Sí |
| 21 | Última milla | RETURN TO MAIN HUB | Sí |
| 22 | Última milla | IN CLAIM PROCESS | Sí |
| 23 | Última milla | WAITING FOR PICKUP | Sí |
| 25 | Última milla | REJECTED BY CUSTOMER | Sí |
| 26 | Última milla | DATA CONFIRMATION PROCESS REQUIRED | Sí |
"Información adicional: Sí" significa que el estado normalmente requiere una acción o un seguimiento; detail lo
explica.
Notas¶
- Use
idStatusen su lógica, no el texto destatus. - Token inválido o vencido: este método responde
400conmessages: ["TURNSTILE_INVALID"]ynotificationType: 1, en lugar de401. Cuando lo reciba, pida un token nuevo y repita la petición.