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

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

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