Ottieni i dettagli di tracciamento di un pacco e lo stato attuale.

Restituisci l'UID breve dell'ordine e i checkpoint che indicano lo stato attuale e gli aggiornamenti del pacco.

GET /v1/tracking/{trackingNumber}

Esempio di richiesta

/v1/tracking/EXMPL0001234TRCKNUM

Esempio di risposta di successo

{
  "shortUid": "EXMPL0001234",
  "trackingNumber": "EXMPL0001234TRCKNUM",
  "trackingUrl": "https://mydhl.express.dhl/no/en/tracking.html#/results?id=EXMPL0001234TRCKNUM",
  "shipmentMethodUid": "dhl_express_worldwide",
  "shipmentMethodName": "DHL Express Worldwide",
  "carrierUid": "dhl_express",
  "carrierName": "DHL Express",
  "weightInGrams": "460",
  "checkpoints": [
    {
      "status": 6,
      "message": "Delivered",
      "description": "Delivered",
      "location": "LONDON-GBR, United Kingdom",
      "createdAt": "2024-07-29T18:16:06Z",
      "expectedDeliveryDate": "",
      "statusUid": "delivered",
      "signedBy": "aftership"
    },
    {
      "status": 2,
      "message": "Shipment is out with courier for delivery",
      "description": "Out for Delivery",
      "location": "LONDON-GBR, United Kingdom",
      "createdAt": "2024-07-29T08:58:40Z",
      "expectedDeliveryDate": "",
      "statusUid": "out_for_delivery",
      "signedBy": "aftership"
    },
    {
      "status": 1,
      "message": "Arrived at DHL Sort Facility LONDON-HEATHROW-GBR",
      "description": "Arrival scan",
      "location": "LONDON-HEATHROW-GBR, United Kingdom",
      "createdAt": "2024-07-29T00:35:29Z",
      "expectedDeliveryDate": "",
      "statusUid": "in_transit",
      "signedBy": "aftership"
    },
    {
      "status": 1,
      "message": "Scheduled to depart on the next planned movement",
      "description": "Departure Scan",
      "location": "EAST MIDLANDS-GBR, United Kingdom",
      "createdAt": "2024-07-28T12:02:21Z",
      "expectedDeliveryDate": "2024-07-30",
      "statusUid": "in_transit",
      "signedBy": "aftership"
    },
    {
      "status": 1,
      "message": "Customs clearance status updated. Note - The Customs clearance process may start while the shipment is in transit to the destination.",
      "description": "Customs clearance started",
      "location": "EAST MIDLANDS-GBR, United Kingdom",
      "createdAt": "2024-07-26T13:00:23Z",
      "expectedDeliveryDate": "2024-07-30",
      "statusUid": "in_transit",
      "signedBy": "aftership"
    },
    {
      "status": 1,
      "message": "Shipment has departed from a DHL facility ULM-DEU",
      "description": "Departure Scan",
      "location": "ULM-DEU, Germany",
      "createdAt": "2024-07-25T16:41:58Z",
      "expectedDeliveryDate": "2024-07-30",
      "statusUid": "in_transit",
      "signedBy": "aftership"
    },
    {
      "status": 1,
      "message": "Shipment picked up",
      "description": "Acceptance scan",
      "location": "ULM-DEU, Germany",
      "createdAt": "2024-07-25T14:21:55Z",
      "expectedDeliveryDate": "2024-07-30",
      "statusUid": "in_transit",
      "signedBy": "aftership"
    }
  ]
}

Esempio di risposta di errore

{
  "trackingNumber": "EXMPL0001234TRCKNUM",
  "code": "TRACKING_DETAILS_NOT_FOUND",
  "message": "Tracking details not found.",
  "details": null
}

Richiesta

Parametro	Tipologia	Descrizione
`trackingNumber` (obbligatorio)	string	Il numero di tracciamento del pacco fornito dal corriere

Risposta riuscita

Parametro	Tipologia	Descrizione
`shortUid` (obbligatorio)	string	Un identificatore breve univoco per la risposta
`trackingNumber` (obbligatorio)	string	Il numero di tracciamento del pacco
`trackingUrl` (opzionale)	string	URL di tracciamento del pacco del corriere
`shipmentMethodUid` (opzionale)	string	UID del metodo di spedizione utilizzato per consegnare il pacco
`shipmentMethodName` (opzionale)	string	Nome del metodo di spedizione utilizzato per consegnare il pacco
`carrierUid` (opzionale)	string	UID del corriere utilizzato per consegnare il pacco
`carrierName` (opzionale)	string	Nome del corriere utilizzato per consegnare il pacco
`weightInGrams` (opzionale)	string	Peso del pacco in grammi
`checkpoints` (facoltativo)	CheckPoint[]	Un array di oggetti CheckPoint (può essere vuoto)

CheckPoint

Parametro	Tipologia	Descrizione
`status` (obbligatorio)	numero	Numero ID dello stato
`statusUid` (obbligatorio)	string	UID stato (vedi StatusEnum)
`message` (obbligatorio)	string	Messaggio di stato
`description` (facoltativo)	string	Descrizione dello stato
`location` (opzionale)	string	Posizione attuale del pacco (indirizzo)
`createdAt` (obbligatorio)	string	Stato creato il (RFC3339)
`expectedDeliveryDate` (opzionale)	string	Data di consegna prevista (`YYYY-MM-DD`). Esempio: `2024-01-21`
`signedBy` (obbligatorio)	string	Quale fornitore/servizio l'ha firmato

StatusEnum

Valore dello stato	Descrizione
`registrato`	Rappresenta lo stato registrato
`in transito`	Rappresenta lo stato "in transito"
`In consegna`	Rappresenta lo stato "in consegna"
`tentativo_fallito`	Rappresenta lo stato di tentativo fallito
`eccezione di spedizione`	Rappresenta lo stato di eccezione della spedizione
`disponibile per il ritiro`	Rappresenta lo stato "disponibile per il ritiro"
`consegnato`	Rappresenta lo stato "Consegnato"
`spedito`	Rappresenta lo stato "spedito"
`restituito`	Rappresenta lo stato "reso"
`non ritirato`	Rappresenta lo stato "non ritirato"

Risposta di errore

Parametro	Tipologia	Descrizione
`Numero di tracciamento`	string	Il numero di tracciamento del pacco
`codice`	string	Codice di errore
`messaggio`	string	Messaggio di errore
`dettagli` (opzionale)	ResponseErrorDetails	Dettagli aggiuntivi dell'errore

ResponseErrorDetails

Parametro	Tipologia	Descrizione
codice	string	Codice di errore.
messaggio	string	Messaggio di errore
riferimento (facoltativo)	string	ID di riferimento.

Passaggio successivo: 🔗[GCL] API di logistica - Postman Collection

📝 Non era quello che cercavi?

Aiutaci a migliorare questo articolo, inviaci un'email a [email protected] — ricordati di includere il titolo dell'articolo.

[GCL] API di logistica - Tracking