Tracciamento
Recuperare la cronologia di tracciamento in tempo reale per un pacco DPD, inclusi tutti gli eventi di stato, i timestamp e le informazioni sulla posizione.
Endpoint: GET /api/v1/tracking/{parcelNumber}
Autenticazione: Token JWT Bearer obbligatorio
Richiesta
| Parametro | Tipo | Obbligatorio | Esempio |
|---|---|---|---|
parcelNumber (percorso) | String | Sì | 05305000123456 |
locale (query) | String | No | it_CH, de_CH, en_US, fr_CH |
curl -X GET "https://label-print-shipments.dpd.ch/api/v1/tracking/05305000123456?locale=it_CH" \
-H "Authorization: Bearer <jwt_token>"
Codici di stato
| Stato | Italiano | Inglese |
|---|---|---|
ORDER_RECORDED | Spedizione annunciata | Order recorded |
PICKED_UP | Ritirato | Picked up |
IN_TRANSIT | In transito | In transit |
AT_DEPOT | Al deposito | At depot |
OUT_FOR_DELIVERY | In consegna | Out for delivery |
DELIVERED | Consegnato | Delivered |
READY_FOR_PICKUP | Pronto per il ritiro | Ready for pickup |
DELIVERY_FAILED | Consegna fallita | Delivery failed |
RETURNED_TO_SENDER | Reso al mittente | Returned to sender |
Flussi di stato tipici
Consegna normale:
ORDER_RECORDED → PICKED_UP → IN_TRANSIT → AT_DEPOT → OUT_FOR_DELIVERY → DELIVERED
Consegna in punto di ritiro:
ORDER_RECORDED → PICKED_UP → IN_TRANSIT → READY_FOR_PICKUP → PICKED_UP_BY_RECEIVER
Codici HTTP
| Codice | Descrizione |
|---|---|
200 OK | Dati di tracciamento restituiti |
401 Unauthorized | Token mancante o non valido |
404 Not Found | Numero di pacco non trovato |