ParcelLifeCycleService

Version: 2.0 · Dezember 2025

Der ParcelLifeCycleService ruft vollständige Paketverfolgungsdaten ab, einschliesslich Scan-Ereignissen, Status und Zustellinformationen.

hinweis

Sie müssen zuerst den LoginService aufrufen, um einen authToken zu erhalten, und diesen anschliessend im Authentifizierungs-Header jeder Anfrage übergeben.

---

Bevor Sie eine Anfrage senden

Rufen Sie ein Auth-Token vom LoginService ab und ordnen Sie es Ihrer Tracking-Anfrage zu.

SOAP-Login:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ns="http://dpd.com/common/service/types/LoginService/2.1">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:getAuth>
      <delisId>String</delisId>
      <password>String</password>
      <messageLanguage>en_EN</messageLanguage>
    </ns:getAuth>
  </soapenv:Body>
</soapenv:Envelope>

REST-Login:

{
  "delisId": "String",
  "password": "String",
  "messageLanguage": "en_CH"
}

---

Methoden

Methode	Beschreibung
getTrackingData	Gibt die Paketverfolgungsdaten für eine bestimmte Paketetikettennummer zurück

getTrackingData

Action: http://dpd.com/common/service/ParcelLifeCycleService/2.0/getTrackingData

Eingabe:

Name	Element
authentication (Header)	types_authentication:authentication
parameters	types:getTrackingData

Ausgabe:

Name	Element
parameters	types:getTrackingDataResponse

Faults:

Name	Element
authenticationFault	types_authentication:authenticationFault

---

Beispiele

getTrackingData — SOAP

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ns="http://dpd.com/common/service/types/Authentication/2.0"
                  xmlns:ns1="http://dpd.com/common/service/types/ParcelLifeCycleService/2.0">
  <soapenv:Header>
    <ns:authentication>
      <delisId>{your delisId}</delisId>
      <authToken>{your authToken}</authToken>
      <messageLanguage>de_CH</messageLanguage>
    </ns:authentication>
  </soapenv:Header>
  <soapenv:Body>
    <ns1:getTrackingData>
      <parcelLabelNumber>06081234567890</parcelLabelNumber>
    </ns1:getTrackingData>
  </soapenv:Body>
</soapenv:Envelope>

getTrackingData — REST

POST {baseUrl}/services/ParcelLifeCycleService/getTrackingData

{
  "authentication": {
    "delisId": "{your delisId}",
    "authToken": "{your authToken}",
    "messageLanguage": "en_CH"
  },
  "getTrackingData": {
    "parcelLabelNumber": "06081234567890"
  }
}

Antwort (Erfolg):

{
  "getTrackingDataResponse": {
    "trackingResult": {
      "shipmentInfo": {
        "serviceDescription": {
          "content": [{ "content": "DPD CLASSIC (option Predict)", "bold": false }]
        },
        "status": "SHIPMENT"
      },
      "statusInfo": [
        {
          "status": "ACCEPTED",
          "label": { "content": "Parcel handed to DPD", "bold": true },
          "statusHasBeenReached": true,
          "isCurrentStatus": false,
          "location": null,
          "date": null
        },
        {
          "status": "AT_SENDING_DEPOT",
          "label": { "content": "In transit", "bold": true },
          "statusHasBeenReached": true,
          "location": { "content": "Buchs (CH)", "bold": true },
          "date": { "content": "22/04/2020, 03:08 Uhr", "bold": true }
        },
        {
          "status": "AT_DELIVERY_DEPOT",
          "label": { "content": "Parcel out for delivery", "bold": true },
          "statusHasBeenReached": true,
          "location": { "content": "Buchs (CH)", "bold": true },
          "date": { "content": "24/04/2020, 09:23 Uhr", "bold": true }
        },
        {
          "status": "DELIVERED",
          "label": { "content": "Parcel delivered", "bold": true },
          "statusHasBeenReached": true,
          "isCurrentStatus": true,
          "location": { "content": "Buchs (CH)", "bold": true },
          "date": { "content": "24/04/2020, 13:49 Uhr", "bold": true }
        }
      ]
    }
  },
  "status": { "type": "OK", "code": "200", "message": "valid" }
}

---

Komplexe Typen

Namespace: types

URL: http://dpd.com/common/service/types/ParcelLifeCycleService/2.0

ShipmentInfo

Enthält allgemeine Sendungsinformationen.

Feld	Typ / Vorkommen	Beschreibung
receiver	types:ContentItem / 0..1	Empfänger des Pakets
predictInformation	types:ContentItem / 0..1	Voraussichtliche Zustellzeit (DPD Predict)
serviceDescription	types:ContentItem / 0..1	DPD-Produktname (z. B. DPD Classic)
additionalServiceElements	types:ContentItem / 0..1	Zusatzleistungen
trackingProperty	types:TrackingProperty / 0..*	Eigenschaften
status	xsd:string / 1..1	Einer der Werte: SHIPMENT, ACCEPTED, AT_SENDING_DEPOT, ON_THE_ROAD, AT_DELIVERY_DEPOT, DELIVERED
label	types:ContentLine / 1..1	Statusbezeichnung
description	types:ContentItem / 1..1	Statusbeschreibung
statusHasBeenReached	xsd:boolean / 1..1	Gibt an, ob dieser Status erreicht wurde
isCurrentStatus	xsd:boolean / 1..1	Gibt an, ob dies der aktuelle Status ist
showContactInfo	xsd:boolean / 1..1	Gibt an, ob Kontaktinformationen angezeigt werden sollen
location	types:ContentLine / 0..1	Ort des letzten Scans
date	types:ContentLine / 0..1	Datum und Uhrzeit des letzten Scans
normalItems	types:ContentItem / 0..*	Als NORMAL klassifizierte Ereignisse
importantItems	types:ContentItem / 0..*	Als IMPORTANT klassifizierte Ereignisse
errorItems	types:ContentItem / 0..*	Als ERROR klassifizierte Ereignisse

StatusInfo

Enthält alle Scan-Daten zu einem Status.

Feld	Typ / Vorkommen	Beschreibung
status	xsd:string / 1..1	Statuscode
label	types:ContentLine / 1..1	Statusbezeichnung
description	types:ContentItem / 1..1	Statusbeschreibung
statusHasBeenReached	xsd:boolean / 1..1	Gibt an, ob der Status erreicht wurde
isCurrentStatus	xsd:boolean / 1..1	Gibt an, ob dies der aktuelle Status ist
showContactInfos	xsd:boolean / 1..1	Gibt an, ob Kontaktinformationen angezeigt werden sollen
location	types:ContentLine / 0..1	Ort des letzten Scans
date	types:ContentLine / 0..1	Datum und Uhrzeit
normalItems	types:ContentItem / 0..*	NORMAL-Ereignisse
importantItems	types:ContentItem / 0..*	IMPORTANT-Ereignisse
errorItems	types:ContentItem / 0..*	ERROR-Ereignisse

TrackingResult

Feld	Typ / Vorkommen	Beschreibung
shipmentInfo	types:ShipmentInfo / 0..1	Allgemeine Sendungsinformationen
statusInfo	types:StatusInfo / 0..*	Statusverlauf
contactInfo	types:ContentItem / 0..3	Kontaktinformationen

getTrackingData

Feld	Typ / Vorkommen	Beschreibung
parcelLabelNumber	xsd:string / 1..1 · Länge 14	Paketetikettennummer

ContentItem

Feld	Typ / Vorkommen	Beschreibung
label	types:ContentLine / 0..1	Bezeichner für das Inhaltselement
content	types:ContentLine / 1..*	Inhaltszeilen
linkTarget	xsd:string / 0..1	Falls gesetzt, wird aus dem Inhaltselement ein Link erstellt

ContentLine

Feld	Typ / Vorkommen	Beschreibung
content	xsd:string / 1..1	Textinhalt
bold	xsd:boolean / 1..1	Gibt an, ob fett dargestellt werden soll
paragraph	xsd:boolean / 1..1	Gibt an, ob als Absatz dargestellt werden soll

Namespace: types_authentication

URL: http://dpd.com/common/service/types/Authentication/2.0

authentication

Feld	Typ / Vorkommen	Beschreibung
delisId	xsd:string / 1..1 · 8–10 Zeichen	DELIS-Benutzer-ID
authToken	xsd:string / 1..1 · 0–64 Zeichen	Token von LoginService.getAuth
messageLanguage	xsd:string / 1..1 · Länge 5	de_CH, fr_CH, it_CH oder en_CH

---

Paketstatuscodes

Status	Beschreibung
SHIPMENT	Sendung erstellt
ACCEPTED	Paket an DPD übergeben
AT_SENDING_DEPOT	In Transit im Versanddepot
ON_THE_ROAD	Unterwegs zum Zustelldepot
AT_DELIVERY_DEPOT	In Zustellung
DELIVERED	Paket zugestellt

---

Einstiegspunkte

Umgebung	Protokoll	URL
Stage	SOAP	https://shivah-st.dpd.ch/external/soap/services/ParcelLifeCycleService
Live	SOAP	https://shivah.dpd.ch/external/soap/services/ParcelLifeCycleService
Stage	REST	https://shivah-st.dpd.ch/external/rest/services/ParcelLifeCycleService/getTrackingData
Live	REST	https://shivah.dpd.ch/external/rest/services/ParcelLifeCycleService/getTrackingData