Saltar a contenido

Imagen de prueba de entrega

Descarga la imagen de la prueba de entrega de una guía (foto o escaneo que entrega el operador de destino).

Nuevo en noviembre de 2026

Este método reemplaza la imagen en base64 que traía awbImage en AWBStandardStatus.

URL

GET https://ocelot.servientrega.us/api/DestinationStatus/track/DeliveryProof?awb={shippingId}
GET https://ocelotkiwi.azurewebsites.net/api/DestinationStatus/track/DeliveryProof?awb={shippingId}

Parámetros

Nombre Dónde Obligatorio Reglas
awb query string Sí Número de guía
Authorization encabezado Sí Bearer <ACCESS_TOKEN>: el mismo token de los demás métodos

Ejemplo de petición

curl "https://ocelot.servientrega.us/api/DestinationStatus/track/DeliveryProof?awb=2290000001" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -o proof-2290000001
curl "https://ocelotkiwi.azurewebsites.net/api/DestinationStatus/track/DeliveryProof?awb=2290000001" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -o proof-2290000001

Respuesta

La respuesta es el archivo de la imagen, no JSON. Use el encabezado Content-Type para escoger la extensión del archivo:

Content-Type Extensión
image/jpeg .jpg
image/png .png
Código Significado
200 El cuerpo es la imagen
404 La guía todavía no tiene imagen de entrega
403 El token falta, no es válido o venció, o no tiene acceso a esa guía

Las respuestas 404 y 403 traen un cuerpo JSON (application/problem+json) con title y status.

Cuándo está disponible la imagen

  • Solo para guías entregadas en Colombia y Ecuador.
  • Normalmente 24 a 48 horas después de que el operador de destino confirma la entrega.
  • Revise hasDeliveryProof en AWBStandardStatus antes de llamar a este método: cuando es true, la imagen está disponible.

Cómo migrar desde el campo en base64

Si su integración leía la imagen de awbImage:

  1. Llame a AWBStandardStatus como siempre.
  2. Si header.hasDeliveryProof es true, llame a este método con el mismo token y el shippingId.
  3. Guarde el cuerpo de la respuesta como la imagen. No lo decodifique: ya es el archivo binario.
  4. Deje de leer awbImage como base64: ahora trae un texto, o null.

Notas

  • La respuesta se puede guardar en caché 10 minutos (Cache-Control: private, max-age=600). Descargue cada imagen una vez y guarde su propia copia en lugar de pedirla cada vez.