Zum Hauptinhalt springen

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​

MethodeBeschreibung
getTrackingDataGibt die Paketverfolgungsdaten für eine bestimmte Paketetikettennummer zurück

getTrackingData​

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

Eingabe:

NameElement
authentication (Header)types_authentication:authentication
parameterstypes:getTrackingData

Ausgabe:

NameElement
parameterstypes:getTrackingDataResponse

Faults:

NameElement
authenticationFaulttypes_authentication:authenticationFault

Beispiele​

getTrackingData — SOAP​

POST {baseUrl}/services/ParcelLifeCycleService

Anfragetext:

<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>

Antwort (Erfolg):

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soap:Body>
<getTrackingDataResponse xmlns="http://dpd.com/common/service/types/ParcelLifeCycleService/2.0">
<trackingresult>
<shipmentInfo>
<serviceDescription>
<label>
<content>DPD service:</content>
<bold>false</bold>
<paragraph>false</paragraph>
</label>
<content>
<content>N/A</content>
<bold>false</bold>
<paragraph>false</paragraph>
</content>
</serviceDescription>
<status>SHIPMENT</status>
<statusHasBeenReached>false</statusHasBeenReached>
<isCurrentStatus>false</isCurrentStatus>
<showContactInfo>false</showContactInfo>
</shipmentInfo>
<statusInfo>
<status>AT_SENDING_DEPOT</status>
<label>
<content>Paket unterwegs</content>
<bold>true</bold>
<paragraph>false</paragraph>
</label>
<description>
<content>
<content>Das Paket befindet sich im Paketversandzentrum.</content>
<bold>false</bold>
<paragraph>false</paragraph>
</content>
</description>
<statusHasBeenReached>true</statusHasBeenReached>
<isCurrentStatus>false</isCurrentStatus>
<showContactInfo>true</showContactInfo>
<location>
<content>Unknown Location (Buchs (CH))</content>
<bold>true</bold>
<paragraph>false</paragraph>
</location>
<date>
<content>28/09/2026, 18:01</content>
<bold>true</bold>
<paragraph>false</paragraph>
</date>
</statusInfo>
<statusInfo>
<status>ON_THE_ROAD</status>
<label>
<content>Paket unterwegs</content>
<bold>true</bold>
<paragraph>false</paragraph>
</label>
<description>
<content>
<content>Das Paket befindet sich auf dem Weg zum Paketzustellzentrum.</content>
<bold>false</bold>
<paragraph>false</paragraph>
</content>
</description>
<statusHasBeenReached>true</statusHasBeenReached>
<isCurrentStatus>false</isCurrentStatus>
<showContactInfo>true</showContactInfo>
<location>
<content>Unknown Location (Möhlin (CH))</content>
<bold>true</bold>
<paragraph>false</paragraph>
</location>
<date>
<content>29/09/2026, 00:59</content>
<bold>true</bold>
<paragraph>false</paragraph>
</date>
</statusInfo>
<statusInfo>
<status>AT_DELIVERY_DEPOT</status>
<label>
<content>In Zustellung</content>
<bold>true</bold>
<paragraph>false</paragraph>
</label>
<description>
<content>
<content>Das Paket hat das Paketzustellzentrum verlassen und befindet sich auf dem Weg zum Empfänger.</content>
<bold>false</bold>
<paragraph>false</paragraph>
</content>
</description>
<statusHasBeenReached>true</statusHasBeenReached>
<isCurrentStatus>false</isCurrentStatus>
<showContactInfo>true</showContactInfo>
<location>
<content>Unknown Location (Möhlin (CH))</content>
<bold>true</bold>
<paragraph>false</paragraph>
</location>
<date>
<content>29/09/2026, 07:33</content>
<bold>true</bold>
<paragraph>false</paragraph>
</date>
</statusInfo>
<statusInfo>
<status>DELIVERED</status>
<label>
<content>Paket zugestellt</content>
<bold>true</bold>
<paragraph>false</paragraph>
</label>
<description>
<content>
<content>Das Paket wurde erfolgreich zugestellt.</content>
<bold>false</bold>
<paragraph>false</paragraph>
</content>
</description>
<statusHasBeenReached>true</statusHasBeenReached>
<isCurrentStatus>true</isCurrentStatus>
<showContactInfo>true</showContactInfo>
<location>
<content>Unknown Location (Möhlin (CH))</content>
<bold>true</bold>
<paragraph>false</paragraph>
</location>
<date>
<content>29/09/2026, 14:20</content>
<bold>true</bold>
<paragraph>false</paragraph>
</date>
</statusInfo>
</trackingresult>
</getTrackingDataResponse>
</soap:Body>
</soap: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.

FeldTyp / VorkommenBeschreibung
receivertypes:ContentItem / 0..1Empfänger des Pakets
predictInformationtypes:ContentItem / 0..1Voraussichtliche Zustellzeit (DPD Predict)
serviceDescriptiontypes:ContentItem / 0..1DPD-Produktname (z. B. DPD Classic)
additionalServiceElementstypes:ContentItem / 0..1Zusatzleistungen
trackingPropertytypes:TrackingProperty / 0..*Eigenschaften
statusxsd:string / 1..1Einer der Werte: SHIPMENT, ACCEPTED, AT_SENDING_DEPOT, ON_THE_ROAD, AT_DELIVERY_DEPOT, DELIVERED
labeltypes:ContentLine / 1..1Statusbezeichnung
descriptiontypes:ContentItem / 1..1Statusbeschreibung
statusHasBeenReachedxsd:boolean / 1..1Gibt an, ob dieser Status erreicht wurde
isCurrentStatusxsd:boolean / 1..1Gibt an, ob dies der aktuelle Status ist
showContactInfoxsd:boolean / 1..1Gibt an, ob Kontaktinformationen angezeigt werden sollen
locationtypes:ContentLine / 0..1Ort des letzten Scans
datetypes:ContentLine / 0..1Datum und Uhrzeit des letzten Scans
normalItemstypes:ContentItem / 0..*Als NORMAL klassifizierte Ereignisse
importantItemstypes:ContentItem / 0..*Als IMPORTANT klassifizierte Ereignisse
errorItemstypes:ContentItem / 0..*Als ERROR klassifizierte Ereignisse

StatusInfo​

Enthält alle Scan-Daten zu einem Status.

FeldTyp / VorkommenBeschreibung
statusxsd:string / 1..1Statuscode
labeltypes:ContentLine / 1..1Statusbezeichnung
descriptiontypes:ContentItem / 1..1Statusbeschreibung
statusHasBeenReachedxsd:boolean / 1..1Gibt an, ob der Status erreicht wurde
isCurrentStatusxsd:boolean / 1..1Gibt an, ob dies der aktuelle Status ist
showContactInfoxsd:boolean / 1..1Gibt an, ob Kontaktinformationen angezeigt werden sollen
locationtypes:ContentLine / 0..1Ort des letzten Scans
datetypes:ContentLine / 0..1Datum und Uhrzeit
normalItemstypes:ContentItem / 0..*NORMAL-Ereignisse
importantItemstypes:ContentItem / 0..*IMPORTANT-Ereignisse
errorItemstypes:ContentItem / 0..*ERROR-Ereignisse

TrackingResult​

FeldTyp / VorkommenBeschreibung
shipmentInfotypes:ShipmentInfo / 0..1Allgemeine Sendungsinformationen
statusInfotypes:StatusInfo / 0..*Statusverlauf
contactInfotypes:ContentItem / 0..3Kontaktinformationen

getTrackingData​

FeldTyp / VorkommenBeschreibung
parcelLabelNumberxsd:string / 1..1 · Länge 14Paketetikettennummer

ContentItem​

FeldTyp / VorkommenBeschreibung
labeltypes:ContentLine / 0..1Bezeichner für das Inhaltselement
contenttypes:ContentLine / 1..*Inhaltszeilen
linkTargetxsd:string / 0..1Falls gesetzt, wird aus dem Inhaltselement ein Link erstellt

ContentLine​

FeldTyp / VorkommenBeschreibung
contentxsd:string / 1..1Textinhalt
boldxsd:boolean / 1..1Gibt an, ob fett dargestellt werden soll
paragraphxsd:boolean / 1..1Gibt an, ob als Absatz dargestellt werden soll

Namespace: types_authentication​

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

authentication​

FeldTyp / VorkommenBeschreibung
delisIdxsd:string / 1..1 · 8–10 ZeichenDELIS-Benutzer-ID
authTokenxsd:string / 1..1 · 0–64 ZeichenToken von LoginService.getAuth
messageLanguagexsd:string / 1..1 · Länge 5de_CH, fr_CH, it_CH oder en_CH

Paketstatuscodes​

StatusBeschreibung
SHIPMENTSendung erstellt
ACCEPTEDPaket an DPD übergeben
AT_SENDING_DEPOTIn Transit im Versanddepot
ON_THE_ROADUnterwegs zum Zustelldepot
AT_DELIVERY_DEPOTIn Zustellung
DELIVEREDPaket zugestellt

Einstiegspunkte​

UmgebungProtokollURL
StageSOAPhttps://shivah-st.dpd.ch/external/soap/services/ParcelLifeCycleService
LiveSOAPhttps://shivah.dpd.ch/external/soap/services/ParcelLifeCycleService
StageRESThttps://shivah-st.dpd.ch/external/rest/services/ParcelLifeCycleService/getTrackingData
LiveRESThttps://shivah.dpd.ch/external/rest/services/ParcelLifeCycleService/getTrackingData