ShipmentService

Versione: 3.5 · Dicembre 2025

Il ShipmentService memorizza gli ordini di spedizione e restituisce le relative etichette dei colli in formato PDF o ZPL.

Metodi

Metodo	Descrizione
`storeOrders`	Memorizza fino a 30 spedizioni e crea i relativi documenti di spedizione

storeOrders

Action: http://dpd.com/common/serviceShipmentService/3.2/storeOrders

Input:

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

Output:

Nome	Elemento
`return`	`types:storeOrdersResponse`

Fault:

Nome	Elemento
`AuthenticationFault`	`types_authentication:authenticationFault`

Esempi

storeOrders — 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/ShipmentService/3.2">
  <soapenv:Header>
    <ns:authentication>
      <delisId>{your delisId}</delisId>
      <authToken>{your authToken}</authToken>
      <messageLanguage>de_CH</messageLanguage>
    </ns:authentication>
  </soapenv:Header>
  <soapenv:Body>
    <ns1:storeOrders>
      <printOptions>
        <printerLanguage>PDF</printerLanguage>
        <paperFormat>A6</paperFormat>
      </printOptions>
      <order>
        <generalShipmentData>
          <sendingDepot>{your sendingDepot}</sendingDepot>
          <product>B2B</product>
          <sender>
            <name1>Sender Name</name1>
            <street>Sender Street</street>
            <country>CH</country>
            <zipCode>8000</zipCode>
            <city>Sender City</city>
          </sender>
          <recipient>
            <name1>Recipient Name</name1>
            <street>Recipient Street</street>
            <country>CH</country>
            <zipCode>8000</zipCode>
            <city>Recipient City</city>
          </recipient>
        </generalShipmentData>
        <parcels/>
        <productAndServiceData>
          <orderType>consignment</orderType>
        </productAndServiceData>
      </order>
    </ns1:storeOrders>
  </soapenv:Body>
</soapenv:Envelope>

storeOrders — REST

POST {baseUrl}/services/ShipmentService/storeOrders

Corpo della richiesta:

{
  "authentication": {
    "delisId": "{your delisId}",
    "authToken": "{your authToken}",
    "messageLanguage": "de_CH"
  },
  "storeOrders": {
    "printOptions": {
      "printerLanguage": "PDF",
      "paperFormat": "A6"
    },
    "order": [{
      "generalShipmentData": {
        "sendingDepot": "0615",
        "product": "B2B",
        "sender": {
          "name1": "Sender Name",
          "street": "Sender Street",
          "country": "CH",
          "zipCode": "8000",
          "city": "Sender City"
        },
        "recipient": {
          "name1": "Recipient Name",
          "street": "Recipient Street",
          "country": "CH",
          "zipCode": "8000",
          "city": "Recipient City"
        }
      },
      "parcels": [{}],
      "productAndServiceData": {
        "orderType": "consignment"
      }
    }]
  }
}

Risposta (successo):

{
  "orderResult": {
    "parcellabelsPDF": "{BASE64-Label}",
    "shipmentResponses": [{
      "identificationNumber": "",
      "mpsId": "B2C0608000000174920200525",
      "parcelInformation": [{
        "parcelLabelNumber": "06080000001749",
        "dpdReference": null
      }],
      "faults": []
    }]
  },
  "status": { "type": "OK", "code": "200", "message": "valid" }
}

Risposta (errore):

{
  "orderResult": null,
  "status": {
    "type": "FaultCodeType",
    "code": "ERR_DELICOM_TOKEN_EXPIRED",
    "message": "token has expired"
  }
}

Tipi complessi

Namespace: `types`

URL: http://dpd.com/common/service/types/ShipmentService/3.2

address

Campo	Tipo / Occorrenza	Descrizione
`name1`	`xs:string` / 1..1 · max 35	Nome del titolare dell'indirizzo
`name2`	`xs:string` / 0..1 · max 35	Nome 2 del titolare dell'indirizzo
`street`	`xs:string` / 1..1 · max 35	Via
`houseNo`	`xs:string` / 0..1 · max 8	Numero civico
`street2`	`xs:string` / 0..1 · max 35	Via 2
`state`	`xs:string` / 0..1 · length 2	Cantone/stato (ISO 3166-2, es. `ZH`)
`country`	`xs:string` / 1..1 · length 2	Paese (ISO 3166-1 alpha-2, es. `CH`)
`zipCode`	`xs:string` / 1..1 · max 9	Codice postale
`city`	`xs:string` / 1..1 · max 35	Città
`gln`	`xs:long` / 0..1	Numero di localizzazione internazionale
`customerNumber`	`xs:string` / 0..1 · max 17	Numero cliente
`contact`	`xs:string` / 0..1 · max 35	Persona di contatto
`phone`	`xs:string` / 0..1 · max 30	Numero di telefono
`fax`	`xs:string` / 0..1 · max 30	Numero di fax
`email`	`xs:string` / 0..1 · max 50	E-mail (max 40 per le richieste di ritiro)
`comment`	`xs:string` / 0..1 · max 70	Commento
`iaccount`	`xs:string` / 0..1 · max 50	Allocazione contabile / centro di costo

cod (Contrassegno)

Campo	Tipo / Occorrenza	Descrizione
`amount`	`xs:long` / 1..1 · max 350000	Importo del contrassegno come intero (es. 30000 = 300.00 CHF)
`currency`	`xs:string` / 1..1 · length 3	Codice valuta ISO 4217 — sempre `CHF`
`inkasso`	`xs:int` / 1..1 · 0	Tipo di incasso: `0` = contanti
`purpose`	`xsd:string` / 0..1 · max 14	Scopo dell'utilizzo
`bankCode`	`xs:string` / 0..1 · max 25	Codice banca (richiede bankName, bankAccountNumber, bankAccountHolder)
`bankName`	`xs:string` / 0..1 · max 27	Nome della banca
`bankAccountNumber`	`xs:string` / 0..1 · max 25	Numero di conto bancario
`bankAccountHolder`	`xs:string` / 0..1 · max 30	Titolare del conto
`iban`	`xs:string` / 0..1 · max 50	IBAN
`bic`	`xs:string` / 0..1 · max 50	BIC

generalShipmentData

Campo	Tipo / Occorrenza	Descrizione
`sendingDepot`	`xs:string` / 1..1 · length 4	Depot responsabile (valore da LoginService, con zeri iniziali, es. `0615`)
`product`	`xs:string` / 1..1	Codice prodotto — vedi Servizi e opzioni
`sender`	`types:address` / 1..1	Indirizzo del mittente
`recipient`	`types:address` / 1..1	Indirizzo del destinatario
`identificationNumber`	`xs:string` / 0..1 · max 999	Chiave alfanumerica univoca per la spedizione
`mpsId`	`xs:string` / 0..1 · length 25	Numero di spedizione (inizia con `MPS`, `EXP` o `B2C`)
`mpsCustomerReferenceNumber1–4`	`xs:string` / 0..1 · max 35	Numeri di riferimento del cliente
`mpsWeight`	`xs:long` / 0..1	Peso della spedizione in grammi (unità da 10 g, senza decimali)
`mpsExpectedSendingDate`	`xs:string` / 0..1	Data di invio prevista (`YYYYMMDD`)
`mpsExpectedSendingTime`	`xs:string` / 0..1	Ora di invio prevista (`HHMMSS`)

notification

Campo	Tipo / Occorrenza	Descrizione
`channel`	`xs:int` / 1..1	`1` = e-mail, `3` = SMS
`value`	`xs:string` / 1..1 · max 50	Indirizzo e-mail o numero di telefono (formato internazionale, es. `+41790000000`)
`language`	`xs:string` / 0..1 · length 2	Lingua della notifica (ISO 3166-1 alpha-2, es. `DE`)

parcel

Campo	Tipo / Occorrenza	Descrizione
`parcelLabelNumber`	`xs:string` / 0..1 · length 14	Numero di etichetta del collo
`customerReferenceNumber1–4`	`xs:string` / 0..1 · max 35	Numeri di riferimento del collo
`weight`	`xs:int` / 0..1	Peso del collo in grammi (unità da 10 g)
`volume`	`xs:int` / 0..1	Volume in cm³ (formato `LLLWWWHHH`)
`swap`	`xs:boolean` / 0..1	Flag collo di scambio (predefinito: `false`)
`hazardousLimitedQuantities`	`xs:boolean` / 0..1	Merci pericolose in quantità limitate (predefinito: `false`)
`content`	`xs:string` / 0..1 · max 50	Descrizione del contenuto del collo
`cod`	`types:cod` / 0..1	Dati del contrassegno
`returns`	`xs:boolean` / 0..1	Flag collo di reso (predefinito: `false`)
`info1`	`xs:string` / 0..1 · max 29	Campo info 1 (solo richiesta di ritiro, stampato sull'etichetta)
`info2`	`xs:string` / 0..1 · max 30	Campo info 2 (solo richiesta di ritiro, stampato sull'etichetta)

printOptions

Campo	Tipo / Occorrenza	Descrizione
`printerLanguage`	`xs:string` / 1..1 · `PDF` o `ZPL`	Formato di output. L'output è sempre codificato in base64
`paperFormat`	`xs:string` / 1..1 · `A4` o `A6`	Formato carta per l'etichetta
`startPosition`	`types:startPosition` / 0..1	Posizione iniziale sul foglio A4
`printerResolution`	`xs:double` / 1..1 · `150`, `200`/`203`, `300`, `600`	Solo ZPL (ignorato per PDF). Risoluzione della stampante in dpi. Deve corrispondere alla densità fisica della testina di stampa Zebra — altri valori non sono supportati.

productAndServiceData

Campo	Tipo / Occorrenza	Descrizione
`orderType`	`xs:string` / 1..1	`consignment`, `collection request order` o `pickup information`
`pickup`	`types:pickup` / 0..1	Informazioni sul ritiro
`parcelShopDelivery`	`types:parcelShopDelivery` / 0..1	Dati di consegna al punto di ritiro
`predict`	`types:notification` / 0..1	Notifica interattiva (solo e-mail o SMS)
`exWorksDelivery`	`xs:boolean` / 0..1	Il destinatario paga la spedizione (predefinito: `false`)
`guarantee`	`xs:boolean` / 0..1	Garanzia per spedizioni internazionali (solo prodotti `NP`, `E18`)
`tyres`	`xs:boolean` / 0..1	Pneumatici sfusi (solo prodotto `NP`)

storeOrders

Campo	Tipo / Occorrenza	Descrizione
`printOptions`	`types:printOptions` / 0..1	Opzioni di stampa dell'etichetta
`order`	`types:shipmentServiceData` / 1..30	Dati della spedizione (fino a 30 per chiamata)

storeOrdersResponseType

Campo	Tipo / Occorrenza	Descrizione
`parcellabelsPDF`	`xs:base64Binary` / 0..1	Dati dell'etichetta del collo in PDF o ZPL (codificati in base64)
`shipmentResponses`	`types:shipmentResponse` / 0..*	Dati di risposta per ogni ordine di spedizione

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`

Tipi semplici

startPosition

Valore	Descrizione
`UPPER_LEFT`	Posizione in alto a sinistra sull'A4
`UPPER_RIGHT`	Posizione in alto a destra sull'A4
`LOWER_LEFT`	Posizione in basso a sinistra sull'A4
`LOWER_RIGHT`	Posizione in basso a destra sull'A4

Punti di accesso

Ambiente	Protocollo	URL
Stage	SOAP	`https://shivah-st.dpd.ch/external/soap/services/ShipmentService`
Live	SOAP	`https://shivah.dpd.ch/external/soap/services/ShipmentService`
Stage	REST	`https://shivah-st.dpd.ch/external/rest/services/ShipmentService/storeOrders`
Live	REST	`https://shivah.dpd.ch/external/rest/services/ShipmentService/storeOrders`

Metodi​

storeOrders​

Esempi​

storeOrders — SOAP​

storeOrders — REST​

Tipi complessi​

Namespace: types​

address​

cod (Contrassegno)​

generalShipmentData​

notification​

parcel​

printOptions​

productAndServiceData​

storeOrders​

storeOrdersResponseType​

Namespace: types_authentication​

authentication​

Tipi semplici​

startPosition​

Punti di accesso​

Metodi

storeOrders

Esempi

storeOrders — SOAP

storeOrders — REST

Tipi complessi

Namespace: `types`

address

cod (Contrassegno)

generalShipmentData

notification

parcel

printOptions

productAndServiceData

storeOrders

storeOrdersResponseType

Namespace: `types_authentication`

authentication

Tipi semplici

startPosition

Punti di accesso