Saltar a contenido

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
}
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 idStatus en su lógica, no el texto de status.
  • Token inválido o vencido: este método responde 400 con messages: ["TURNSTILE_INVALID"] y notificationType: 1, en lugar de 401. Cuando lo reciba, pida un token nuevo y repita la petición.