ParcelLifeCycleService

Version : 2.0 · Décembre 2025

Le ParcelLifeCycleService récupère l'ensemble des données de suivi d'un colis, y compris les événements de scan, le statut et les informations de livraison.

remarque

Vous devez d'abord appeler LoginService pour obtenir un authToken, puis le transmettre dans l'en-tête d'authentification de chaque requête.

Avant d'envoyer une requête

Obtenez un jeton d'authentification auprès de LoginService et associez-le à votre requête de suivi.

Connexion SOAP :

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

Connexion REST :

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

Méthodes

Méthode	Description
`getTrackingData`	Renvoie les données de suivi d'un colis pour un numéro d'étiquette de colis donné

getTrackingData

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

Entrée :

Nom	Élément
`authentication` (en-tête)	`types_authentication:authentication`
`parameters`	`types:getTrackingData`

Sortie :

Nom	Élément
`parameters`	`types:getTrackingDataResponse`

Erreurs :

Nom	Élément
`authenticationFault`	`types_authentication:authenticationFault`

Exemples

getTrackingData — SOAP

POST {baseUrl}/services/ParcelLifeCycleService

Corps de la requête :

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

Réponse (succès) :

<?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"
  }
}

Réponse (succès) :

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

Types complexes

Espace de noms : `types`

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

ShipmentInfo

Contient les informations générales de l'envoi.

Champ	Type / Occurrence	Description
`receiver`	`types:ContentItem` / 0..1	Destinataire du colis
`predictInformation`	`types:ContentItem` / 0..1	Heure de livraison estimée (DPD Predict)
`serviceDescription`	`types:ContentItem` / 0..1	Nom du produit DPD (p. ex. DPD Classic)
`additionalServiceElements`	`types:ContentItem` / 0..1	Services additionnels
`trackingProperty`	`types:TrackingProperty` / 0..*	Propriétés
`status`	`xsd:string` / 1..1	L'une des valeurs : `SHIPMENT`, `ACCEPTED`, `AT_SENDING_DEPOT`, `ON_THE_ROAD`, `AT_DELIVERY_DEPOT`, `DELIVERED`
`label`	`types:ContentLine` / 1..1	Nom du statut
`description`	`types:ContentItem` / 1..1	Description du statut
`statusHasBeenReached`	`xsd:boolean` / 1..1	Indique si ce statut a été atteint
`isCurrentStatus`	`xsd:boolean` / 1..1	Indique s'il s'agit du statut actuel
`showContactInfo`	`xsd:boolean` / 1..1	Indique s'il faut afficher les informations de contact
`location`	`types:ContentLine` / 0..1	Lieu du dernier scan
`date`	`types:ContentLine` / 0..1	Date et heure du dernier scan
`normalItems`	`types:ContentItem` / 0..*	Événements classés comme NORMAL
`importantItems`	`types:ContentItem` / 0..*	Événements classés comme IMPORTANT
`errorItems`	`types:ContentItem` / 0..*	Événements classés comme ERROR

StatusInfo

Contient toutes les données de scan d'un statut.

Champ	Type / Occurrence	Description
`status`	`xsd:string` / 1..1	Code de statut
`label`	`types:ContentLine` / 1..1	Nom du statut
`description`	`types:ContentItem` / 1..1	Description du statut
`statusHasBeenReached`	`xsd:boolean` / 1..1	Indique si le statut a été atteint
`isCurrentStatus`	`xsd:boolean` / 1..1	Indique s'il s'agit du statut actuel
`showContactInfo`	`xsd:boolean` / 1..1	Indique s'il faut afficher les informations de contact
`location`	`types:ContentLine` / 0..1	Lieu du dernier scan
`date`	`types:ContentLine` / 0..1	Date et heure
`normalItems`	`types:ContentItem` / 0..*	Événements NORMAL
`importantItems`	`types:ContentItem` / 0..*	Événements IMPORTANT
`errorItems`	`types:ContentItem` / 0..*	Événements ERROR

TrackingResult

Champ	Type / Occurrence	Description
`shipmentInfo`	`types:ShipmentInfo` / 0..1	Informations générales de l'envoi
`statusInfo`	`types:StatusInfo` / 0..*	Historique des statuts
`contactInfo`	`types:ContentItem` / 0..3	Informations de contact

getTrackingData

Champ	Type / Occurrence	Description
`parcelLabelNumber`	`xsd:string` / 1..1 · length 14	Numéro d'étiquette de colis

ContentItem

Champ	Type / Occurrence	Description
`label`	`types:ContentLine` / 0..1	Identifiant de l'élément de contenu
`content`	`types:ContentLine` / 1..*	Lignes de contenu
`linkTarget`	`xsd:string` / 0..1	Si défini, un lien est créé à partir de l'élément de contenu

ContentLine

Champ	Type / Occurrence	Description
`content`	`xsd:string` / 1..1	Contenu textuel
`bold`	`xsd:boolean` / 1..1	Indique s'il faut afficher en gras
`paragraph`	`xsd:boolean` / 1..1	Indique s'il faut afficher sous forme de paragraphe

Espace de noms : `types_authentication`

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

authentication

Champ	Type / Occurrence	Description
`delisId`	`xsd:string` / 1..1 · 8–10 caractères	Identifiant utilisateur DELIS
`authToken`	`xsd:string` / 1..1 · 0–64 caractères	Jeton issu de `LoginService.getAuth`
`messageLanguage`	`xsd:string` / 1..1 · length 5	`de_CH`, `fr_CH`, `it_CH` ou `en_CH`

Codes de statut de colis

Statut	Description
`SHIPMENT`	Envoi créé
`ACCEPTED`	Colis remis à DPD
`AT_SENDING_DEPOT`	En transit au dépôt d'expédition
`ON_THE_ROAD`	En route vers le dépôt de livraison
`AT_DELIVERY_DEPOT`	En cours de livraison
`DELIVERED`	Colis livré

Points d'accès

Environnement	Protocole	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`

Avant d'envoyer une requête​

Méthodes​

getTrackingData​

Exemples​

getTrackingData — SOAP​

getTrackingData — REST​

Types complexes​

Espace de noms : types​

ShipmentInfo​

StatusInfo​

TrackingResult​

getTrackingData​

ContentItem​

ContentLine​

Espace de noms : types_authentication​

authentication​

Codes de statut de colis​

Points d'accès​

Avant d'envoyer une requête

Méthodes

getTrackingData

Exemples

getTrackingData — SOAP

getTrackingData — REST

Types complexes

Espace de noms : `types`

ShipmentInfo

StatusInfo

TrackingResult

getTrackingData

ContentItem

ContentLine

Espace de noms : `types_authentication`

authentication

Codes de statut de colis

Points d'accès