Aller au contenu principal

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éthodeDescription
getTrackingDataRenvoie 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
parameterstypes:getTrackingData

Sortie :

NomÉlément
parameterstypes:getTrackingDataResponse

Erreurs :

NomÉlément
authenticationFaulttypes_authentication:authenticationFault

Exemples​

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

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.

ChampType / OccurrenceDescription
receivertypes:ContentItem / 0..1Destinataire du colis
predictInformationtypes:ContentItem / 0..1Heure de livraison estimée (DPD Predict)
serviceDescriptiontypes:ContentItem / 0..1Nom du produit DPD (p. ex. DPD Classic)
additionalServiceElementstypes:ContentItem / 0..1Services additionnels
trackingPropertytypes:TrackingProperty / 0..*Propriétés
statusxsd:string / 1..1L'une des valeurs : SHIPMENT, ACCEPTED, AT_SENDING_DEPOT, ON_THE_ROAD, AT_DELIVERY_DEPOT, DELIVERED
labeltypes:ContentLine / 1..1Nom du statut
descriptiontypes:ContentItem / 1..1Description du statut
statusHasBeenReachedxsd:boolean / 1..1Indique si ce statut a été atteint
isCurrentStatusxsd:boolean / 1..1Indique s'il s'agit du statut actuel
showContactInfoxsd:boolean / 1..1Indique s'il faut afficher les informations de contact
locationtypes:ContentLine / 0..1Lieu du dernier scan
datetypes:ContentLine / 0..1Date et heure du dernier scan
normalItemstypes:ContentItem / 0..*Événements classés comme NORMAL
importantItemstypes:ContentItem / 0..*Événements classés comme IMPORTANT
errorItemstypes:ContentItem / 0..*Événements classés comme ERROR

StatusInfo​

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

ChampType / OccurrenceDescription
statusxsd:string / 1..1Code de statut
labeltypes:ContentLine / 1..1Nom du statut
descriptiontypes:ContentItem / 1..1Description du statut
statusHasBeenReachedxsd:boolean / 1..1Indique si le statut a été atteint
isCurrentStatusxsd:boolean / 1..1Indique s'il s'agit du statut actuel
showContactInfosxsd:boolean / 1..1Indique s'il faut afficher les informations de contact
locationtypes:ContentLine / 0..1Lieu du dernier scan
datetypes:ContentLine / 0..1Date et heure
normalItemstypes:ContentItem / 0..*Événements NORMAL
importantItemstypes:ContentItem / 0..*Événements IMPORTANT
errorItemstypes:ContentItem / 0..*Événements ERROR

TrackingResult​

ChampType / OccurrenceDescription
shipmentInfotypes:ShipmentInfo / 0..1Informations générales de l'envoi
statusInfotypes:StatusInfo / 0..*Historique des statuts
contactInfotypes:ContentItem / 0..3Informations de contact

getTrackingData​

ChampType / OccurrenceDescription
parcelLabelNumberxsd:string / 1..1 · length 14Numéro d'étiquette de colis

ContentItem​

ChampType / OccurrenceDescription
labeltypes:ContentLine / 0..1Identifiant de l'élément de contenu
contenttypes:ContentLine / 1..*Lignes de contenu
linkTargetxsd:string / 0..1Si défini, un lien est créé à partir de l'élément de contenu

ContentLine​

ChampType / OccurrenceDescription
contentxsd:string / 1..1Contenu textuel
boldxsd:boolean / 1..1Indique s'il faut afficher en gras
paragraphxsd:boolean / 1..1Indique s'il faut afficher sous forme de paragraphe

Espace de noms : types_authentication​

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

authentication​

ChampType / OccurrenceDescription
delisIdxsd:string / 1..1 · 8–10 caractèresIdentifiant utilisateur DELIS
authTokenxsd:string / 1..1 · 0–64 caractèresJeton issu de LoginService.getAuth
messageLanguagexsd:string / 1..1 · length 5de_CH, fr_CH, it_CH ou en_CH

Codes de statut de colis​

StatutDescription
SHIPMENTEnvoi créé
ACCEPTEDColis remis à DPD
AT_SENDING_DEPOTEn transit au dépôt d'expédition
ON_THE_ROADEn route vers le dépôt de livraison
AT_DELIVERY_DEPOTEn cours de livraison
DELIVEREDColis livré

Points d'accès​

EnvironnementProtocoleURL
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