ParcelLifeCycleService

Versione: 2.0 · Dicembre 2025

Il ParcelLifeCycleService recupera i dati completi di tracciamento del collo, inclusi gli eventi di scansione, lo stato e le informazioni di consegna.

note

È necessario richiamare prima LoginService per ottenere un authToken, da passare poi nell'header di autenticazione di ogni richiesta.

Prima di inviare una richiesta

Ottenere un token di autenticazione da LoginService e associarlo alla richiesta di tracciamento.

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

Login REST:

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

Metodi

Metodo	Descrizione
`getTrackingData`	Restituisce i dati di tracciamento del collo per un dato numero di etichetta del collo

getTrackingData

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

Input:

Nome	Elemento
`authentication` (header)	`types_authentication:authentication`
`parameters`	`types:getTrackingData`

Output:

Nome	Elemento
`parameters`	`types:getTrackingDataResponse`

Fault:

Nome	Elemento
`authenticationFault`	`types_authentication:authenticationFault`

Esempi

getTrackingData — SOAP

POST {baseUrl}/services/ParcelLifeCycleService

Corpo della richiesta:

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

Risposta (successo):

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

Risposta (successo):

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

Tipi complessi

Namespace: `types`

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

ShipmentInfo

Contiene le informazioni generali della spedizione.

Campo	Tipo / Occorrenza	Descrizione
`receiver`	`types:ContentItem` / 0..1	Destinatario del collo
`predictInformation`	`types:ContentItem` / 0..1	Orario di consegna stimato (DPD Predict)
`serviceDescription`	`types:ContentItem` / 0..1	Nome del prodotto DPD (es. DPD Classic)
`additionalServiceElements`	`types:ContentItem` / 0..1	Servizi aggiuntivi
`trackingProperty`	`types:TrackingProperty` / 0..*	Proprietà
`status`	`xsd:string` / 1..1	Uno tra: `SHIPMENT`, `ACCEPTED`, `AT_SENDING_DEPOT`, `ON_THE_ROAD`, `AT_DELIVERY_DEPOT`, `DELIVERED`
`label`	`types:ContentLine` / 1..1	Nome dello stato
`description`	`types:ContentItem` / 1..1	Descrizione dello stato
`statusHasBeenReached`	`xsd:boolean` / 1..1	Se questo stato è stato raggiunto
`isCurrentStatus`	`xsd:boolean` / 1..1	Se questo è lo stato corrente
`showContactInfo`	`xsd:boolean` / 1..1	Se visualizzare le informazioni di contatto
`location`	`types:ContentLine` / 0..1	Luogo dell'ultima scansione
`date`	`types:ContentLine` / 0..1	Data e ora dell'ultima scansione
`normalItems`	`types:ContentItem` / 0..*	Eventi classificati come NORMAL
`importantItems`	`types:ContentItem` / 0..*	Eventi classificati come IMPORTANT
`errorItems`	`types:ContentItem` / 0..*	Eventi classificati come ERROR

StatusInfo

Contiene tutti i dati di scansione di uno stato.

Campo	Tipo / Occorrenza	Descrizione
`status`	`xsd:string` / 1..1	Codice dello stato
`label`	`types:ContentLine` / 1..1	Nome dello stato
`description`	`types:ContentItem` / 1..1	Descrizione dello stato
`statusHasBeenReached`	`xsd:boolean` / 1..1	Se lo stato è stato raggiunto
`isCurrentStatus`	`xsd:boolean` / 1..1	Se questo è lo stato corrente
`showContactInfo`	`xsd:boolean` / 1..1	Se visualizzare le informazioni di contatto
`location`	`types:ContentLine` / 0..1	Luogo dell'ultima scansione
`date`	`types:ContentLine` / 0..1	Data e ora
`normalItems`	`types:ContentItem` / 0..*	Eventi NORMAL
`importantItems`	`types:ContentItem` / 0..*	Eventi IMPORTANT
`errorItems`	`types:ContentItem` / 0..*	Eventi ERROR

TrackingResult

Campo	Tipo / Occorrenza	Descrizione
`shipmentInfo`	`types:ShipmentInfo` / 0..1	Informazioni generali della spedizione
`statusInfo`	`types:StatusInfo` / 0..*	Storico degli stati
`contactInfo`	`types:ContentItem` / 0..3	Informazioni di contatto

getTrackingData

Campo	Tipo / Occorrenza	Descrizione
`parcelLabelNumber`	`xsd:string` / 1..1 · length 14	Numero di etichetta del collo

ContentItem

Campo	Tipo / Occorrenza	Descrizione
`label`	`types:ContentLine` / 0..1	Identificatore dell'elemento di contenuto
`content`	`types:ContentLine` / 1..*	Righe di contenuto
`linkTarget`	`xsd:string` / 0..1	Se impostato, viene creato un link dall'elemento di contenuto

ContentLine

Campo	Tipo / Occorrenza	Descrizione
`content`	`xsd:string` / 1..1	Contenuto testuale
`bold`	`xsd:boolean` / 1..1	Se visualizzare in grassetto
`paragraph`	`xsd:boolean` / 1..1	Se rendere come paragrafo

Namespace: `types_authentication`

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

authentication

Campo	Tipo / Occorrenza	Descrizione
`delisId`	`xsd:string` / 1..1 · 8–10 caratteri	ID utente DELIS
`authToken`	`xsd:string` / 1..1 · 0–64 caratteri	Token da `LoginService.getAuth`
`messageLanguage`	`xsd:string` / 1..1 · length 5	`de_CH`, `fr_CH`, `it_CH` o `en_CH`

Codici di stato del collo

Stato	Descrizione
`SHIPMENT`	Spedizione creata
`ACCEPTED`	Collo consegnato a DPD
`AT_SENDING_DEPOT`	In transito presso il depot di partenza
`ON_THE_ROAD`	In viaggio verso il depot di consegna
`AT_DELIVERY_DEPOT`	In consegna
`DELIVERED`	Collo consegnato

Punti di accesso

Ambiente	Protocollo	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`

Prima di inviare una richiesta​

Metodi​

getTrackingData​

Esempi​

getTrackingData — SOAP​

getTrackingData — REST​

Tipi complessi​

Namespace: types​

ShipmentInfo​

StatusInfo​

TrackingResult​

getTrackingData​

ContentItem​

ContentLine​

Namespace: types_authentication​

authentication​

Codici di stato del collo​

Punti di accesso​

Prima di inviare una richiesta

Metodi

getTrackingData

Esempi

getTrackingData — SOAP

getTrackingData — REST

Tipi complessi

Namespace: `types`

ShipmentInfo

StatusInfo

TrackingResult

getTrackingData

ContentItem

ContentLine

Namespace: `types_authentication`

authentication

Codici di stato del collo

Punti di accesso