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
hasDeliveryProofen AWBStandardStatus antes de llamar a este método: cuando estrue, la imagen está disponible.
Cómo migrar desde el campo en base64¶
Si su integración leía la imagen de awbImage:
- Llame a AWBStandardStatus como siempre.
- Si
header.hasDeliveryProofestrue, llame a este método con el mismo token y elshippingId. - Guarde el cuerpo de la respuesta como la imagen. No lo decodifique: ya es el archivo binario.
- Deje de leer
awbImagecomo base64: ahora trae un texto, onull.
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.