Erhalten Sie die Sendungsverfolgungsdetails eines Pakets und den aktuellen Status.

Gib die shortUid der Bestellung und die Checkpoints zurück, die den aktuellen Status und die Aktualisierungen des Pakets anzeigen.

GET /v1/tracking/{trackingNumber}

Beispiel anfordern

/v1/tracking/EXMPL0001234TRCKNUM

Beispiel für eine erfolgreiche Antwort

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

Beispiel für eine Fehlermeldung

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

Anfrage

Parameter	Typ	Beschreibung
`trackingNumber` (erforderlich)	Zeichenkette	Die vom Versanddienstleister bereitgestellte Sendungsverfolgungsnummer

Erfolgreiche Antwort

Parameter	Typ	Beschreibung
`shortUid` (erforderlich)	Zeichenkette	Eine eindeutige kurze Kennung für die Antwort
`trackingNumber` (erforderlich)	Zeichenkette	Die Sendungsnummer des Pakets
`trackingUrl` (optional)	Zeichenkette	Tracking-URL des Pakets vom Versanddienstleister
`shipmentMethodUid` (optional)	Zeichenkette	UID der Versandmethode, die für die Lieferung des Pakets verwendet wird
`shipmentMethodName` (optional)	Zeichenkette	Name der Versandmethode, die für die Lieferung des Pakets verwendet wird
`carrierUid` (optional)	Zeichenkette	Carrier-UID, die für die Lieferung des Pakets verwendet wird
`carrierName` (optional)	Zeichenkette	Name des Versanddienstleisters, der das Paket liefert
`weightInGrams` (optional)	Zeichenkette	Gewicht des Pakets in Gramm
`checkpoints` (optional)	CheckPoint[]	Ein Array von CheckPoint-Objekten (kann leer sein)

CheckPoint

Parameter	Typ	Beschreibung
`status` (erforderlich)	Zahl	Status-ID-Nummer
`statusUid` (erforderlich)	Zeichenkette	Status-UID (siehe StatusEnum)
`message` (erforderlich)	Zeichenkette	Statusmeldung
`description` (optional)	Zeichenkette	Statusbeschreibung
`location` (optional)	Zeichenkette	Aktueller Paketstandort (Adresse)
`createdAt` (erforderlich)	Zeichenkette	Status erstellt am (RFC3339)
`expectedDeliveryDate` (optional)	Zeichenkette	Voraussichtliches Lieferdatum (`YYYY-MM-DD`). Beispiel: `2024-01-21`
`signedBy` (erforderlich)	Zeichenkette	Welcher Anbieter / Dienst hat es signiert

StatusEnum

Statuswert	Beschreibung
`registriert`	Steht für den Status "registriert"
`Unterwegs`	Steht für den Status "in Zustellung"
`Wird zugestellt`	Steht für den Status "Wird zugestellt"
`Fehlgeschlagener Versuch`	Steht für den Status "fehlgeschlagener Versuch"
`Versandausnahme`	Stellt den Status einer Versandausnahme dar
`Abholung möglich`	Steht für den Status "zur Abholung verfügbar"
`Zugestellt`	Steht für den Status "Zustellung"
`versendet`	Steht für den Status "Versendet"
`zurückgegeben`	Steht für den Status "zurückgegeben"
`Nicht abgeholt`	Steht für den Status "Nicht abgeholt"

Fehlermeldung

Parameter	Typ	Beschreibung
`trackingNumber`	Zeichenkette	Die Sendungsnummer des Pakets
`code`	Zeichenkette	Fehlercode
`Nachricht`	Zeichenkette	Fehlermeldung
`details` (optional)	ResponseErrorDetails	Weitere Fehlerdetails