Sendungsverfolgung

Rufen Sie Echtzeit-Verfolgungshistorie für ein DPD-Paket ab, einschliesslich aller Statusereignisse, Zeitstempel und Standortinformationen.

Endpunkt: GET /api/v1/tracking/{parcelNumber} Authentifizierung: Bearer JWT-Token erforderlich

---

Anfrage

Pfadparameter:

Parameter	Typ	Pflichtfeld	Beispiel
parcelNumber	String	Ja	05305000123456

Abfrageparameter:

Parameter	Typ	Pflichtfeld	Beschreibung
locale	String	Optional	Beschreibungen lokalisieren – de_CH, en_US, fr_CH, it_CH

curl -X GET "https://label-print-shipments.dpd.ch/api/v1/tracking/05305000123456?locale=de_CH" \
  -H "Authorization: Bearer <jwt_token>"

---

Antwort

200 OK:

{
  "shipmentInfo": {
    "type": "shipment",
    "service": "PSD",
    "product": "DPD Classic"
  },
  "statusInfo": [
    {
      "name": "ORDER_RECORDED",
      "displayName": "Sendung angekündigt",
      "description": "Die Sendung wurde elektronisch an DPD übermittelt",
      "location": "",
      "date": "2025-10-29 14:30:00",
      "hasBeenReached": true,
      "isCurrent": false
    },
    {
      "name": "IN_TRANSIT",
      "displayName": "Unterwegs",
      "description": "Die Sendung ist auf dem Weg zum Ziel",
      "location": "Bern Hub",
      "date": "2025-10-30 08:15:00",
      "hasBeenReached": true,
      "isCurrent": true
    },
    {
      "name": "DELIVERED",
      "displayName": "Zugestellt",
      "description": "Die Sendung wurde erfolgreich zugestellt",
      "location": "",
      "date": "",
      "hasBeenReached": false,
      "isCurrent": false
    }
  ]
}

Felder in statusInfo

Feld	Typ	Beschreibung
name	String	Statuscodekennung
displayName	String	Übersetztes Status-Label
description	String	Übersetzte Detailbeschreibung
location	String	Ort, an dem das Ereignis eingetreten ist
date	String	Zeitstempel (yyyy-MM-dd HH:mm:ss), leer wenn noch nicht erreicht
hasBeenReached	Boolean	Ob dieser Status bereits eingetreten ist
isCurrent	Boolean	Ob dies der aktuelle Status ist

---

Statuscodes

Status	Deutsch	Englisch
ORDER_RECORDED	Sendung angekündigt	Order recorded
PICKED_UP	Abgeholt	Picked up
IN_TRANSIT	Unterwegs	In transit
AT_DEPOT	Im Depot	At depot
OUT_FOR_DELIVERY	Wird zugestellt	Out for delivery
DELIVERED	Zugestellt	Delivered
READY_FOR_PICKUP	Zur Abholung bereit	Ready for pickup
PICKED_UP_BY_RECEIVER	Abgeholt	Picked up by receiver
DELIVERY_FAILED	Zustellung fehlgeschlagen	Delivery failed
RETURNED_TO_SENDER	Rücksendung	Returned to sender

Typische Statusabläufe

Normale Zustellung:

ORDER_RECORDED → PICKED_UP → IN_TRANSIT → AT_DEPOT → OUT_FOR_DELIVERY → DELIVERED

Paketshop-Zustellung:

ORDER_RECORDED → PICKED_UP → IN_TRANSIT → READY_FOR_PICKUP → PICKED_UP_BY_RECEIVER

Fehlgeschlagene Zustellung:

ORDER_RECORDED → PICKED_UP → IN_TRANSIT → DELIVERY_FAILED → RETURNED_TO_SENDER

---

HTTP-Statuscodes

Code	Beschreibung
200 OK	Verfolgungsdaten zurückgegeben
401 Unauthorized	Token fehlt oder ist ungültig
404 Not Found	Paketnummer nicht gefunden