Få spårningsinformation för ett paket och aktuell status.

Returnera orderns shortUid och de checkpoints som indikerar paketets aktuella status och uppdateringar.

GET /v1/tracking/{trackingNumber}

Exempel på förfrågan

/v1/tracking/EXMPL0001234TRCKNUM

Exempel på lyckad respons

{  "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"    }  ]}

Exempel på felmeddelande

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

Begäran

Parameter	Typ	Beskrivning
`trackingNumber` (obligatoriskt)	sträng	Paketets spårningsnummer som tillhandahålls av transportören

Lyckad respons

Parameter	Typ	Beskrivning
`shortUid` (obligatoriskt)	sträng	En unik kort identifierare för svaret
`trackingNumber` (obligatoriskt)	sträng	Paketets spårningsnummer
`trackingUrl` (valfritt)	sträng	Fraktbolagets spårnings-URL för paketet
`shipmentMethodUid` (valfritt)	sträng	UID för leveransmetoden som används för att leverera paketet
`shipmentMethodName` (valfritt)	sträng	Namnet på leveransmetoden som används för att leverera paketet
`carrierUid` (valfritt)	sträng	Transportörens UID som används för att leverera paketet
`carrierName` (valfritt)	sträng	Fraktbolagets namn som används för att leverera paketet
`weightInGrams` (valfritt)	sträng	Vikt på paketet i gram
`checkpoints` (valfritt)	CheckPoint[]	En array med CheckPoint-objekt (kan vara tom)

CheckPoint

Parameter	Typ	Beskrivning
`status` (obligatoriskt)	nummer	Status-ID-nummer
`statusUid` (obligatoriskt)	sträng	Status UID (se StatusEnum)
`message` (obligatoriskt)	sträng	Statusmeddelande
`description` (valfritt)	sträng	Statusbeskrivning
`location` (valfritt)	sträng	Paketets nuvarande plats (adress)
`createdAt` (obligatoriskt)	sträng	Status skapad (RFC3339)
`expectedDeliveryDate` (valfritt)	sträng	Förväntat leveransdatum (`YYYY-MM-DD`). Exempel: `2024-01-21`
`signedBy` (obligatoriskt)	sträng	Vilken leverantör/tjänst som signerade den

StatusEnum

Statusvärde	Beskrivning
`registrerad`	Visar registrerad status
`på väg`	Visar leveransstatus
`Levereras`	Visar statusen "levereras"
`misslyckat_försök`	Visar status för misslyckat försök
`shipping_exception`	Visar status för leveransundantag
`Tillgänglig för upphämtning`	Visar statusen "tillgänglig för upphämtning"
`levererad`	Representerar levererat status
`skickad`	Visar statusen "skickad"
`returnerad`	Visar returnerad status
`Ej upphämtad`	Representerar statusen "ej upphämtad"

Felmeddelande

Parameter	Typ	Beskrivning
`trackingNumber`	sträng	Paketets spårningsnummer
`kod`	sträng	Felkod
`meddelande`	sträng	Felmeddelande
`details` (valfritt)	ResponseErrorDetails	Ytterligare felinformation