ParcelShopFinderService

Versione: 5.1 · Dicembre 2025

Il ParcelShopFinderService cerca i punti di ritiro DPD Pickup per indirizzo o coordinate geografiche.

note

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

Metodi

Metodo	Descrizione
`findCities`	Trova le città con punti di ritiro DPD Pickup per paese, codice postale e città
`findParcelShops`	Trova i punti di ritiro DPD Pickup per paese, codice postale, città e criteri di servizio opzionali
`findParcelShopsByGeoData`	Trova i punti di ritiro DPD Pickup per coordinate geografiche e criteri di servizio opzionali

findCities

Action: http://dpd.com/common/service/ParcelShopFinderService/5.0/findCities

Input:

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

Output:

Nome	Elemento
`parameters`	`types:findCitiesResponse`

Fault:

Nome	Elemento
`authenticationFault`	`types_authentication:authenticationFault`
`systemFault`	`types:systemFault`
`dataFault`	`types:dataFault`

findParcelShops

Action: http://dpd.com/common/service/ParcelShopFinderService/5.0/findParcelShops

Input:

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

Output:

Nome	Elemento
`parameters`	`types:findParcelShopsResponse`

Fault:

Nome	Elemento
`authenticationFault`	`types_authentication:authenticationFault`
`systemFault`	`types:systemFault`
`dataFault`	`types:dataFault`

findParcelShopsByGeoData

Action: http://dpd.com/common/service/ParcelShopFinderService/5.0/findParcelShopsByGeoData

Input:

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

Output:

Nome	Elemento
`parameters`	`types:findParcelShopsByGeoDataResponse`

Fault:

Nome	Elemento
`authenticationFault`	`types_authentication:authenticationFault`
`systemFault`	`types:systemFault`
`dataFault`	`types:dataFault`

Esempi

findCities — 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/ParcelShopFinderService/5.0">
  <soapenv:Header>
    <ns:authentication>
      <delisId>{your delisId}</delisId>
      <authToken>{your authToken}</authToken>
      <messageLanguage>de_CH</messageLanguage>
    </ns:authentication>
  </soapenv:Header>
  <soapenv:Body>
    <ns1:findCities>
      <country>CH</country>
      <zipCode>8635</zipCode>
      <city>Dürnten</city>
      <limit>10</limit>
      <order>NAME</order>
    </ns1:findCities>
  </soapenv:Body>
</soapenv:Envelope>

note

Attualmente non è esposto un endpoint REST per findCities. Per questo metodo, utilizzare l'endpoint del servizio SOAP elencato in Punti di accesso.

findParcelShops — 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/ParcelShopFinderService/5.0">
  <soapenv:Header>
    <ns:authentication>
      <delisId>{your delisId}</delisId>
      <authToken>{your authToken}</authToken>
      <messageLanguage>de_CH</messageLanguage>
    </ns:authentication>
  </soapenv:Header>
  <soapenv:Body>
    <ns1:findParcelShops>
      <country>CH</country>
      <zipCode>8400</zipCode>
      <city>Winterthur</city>
      <limit>10</limit>
      <availabilityDate>2019-09-09</availabilityDate>
    </ns1:findParcelShops>
  </soapenv:Body>
</soapenv:Envelope>

findParcelShopsByGeoData — 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/ParcelShopFinderService/5.0">
  <soapenv:Header>
    <ns:authentication>
      <delisId>{your delisId}</delisId>
      <authToken>{your authToken}</authToken>
      <messageLanguage>de_CH</messageLanguage>
    </ns:authentication>
  </soapenv:Header>
  <soapenv:Body>
    <ns1:findParcelShopsByGeoData>
      <longitude>7.593039</longitude>
      <latitude>47.588694</latitude>
      <limit>10</limit>
      <searchCountry>DE</searchCountry>
      <searchCountry>CH</searchCountry>
    </ns1:findParcelShopsByGeoData>
  </soapenv:Body>
</soapenv:Envelope>

Tipi complessi

Namespace: `types`

URL: http://dpd.com/common/service/types/ParcelShopFinderService/5.0

CityType

Il tipo città con paese, codice postale e nome.

Campo	Tipo / Occorrenza	Descrizione
`country`	`xsd:string` / 0..1 · max 2	Codice paese in formato ISO 3166-1 alpha-2
`countryNum`	`xsd:int` / 0..1 · 0–999	Numero paese in formato numerico ISO 3166 (es. Svizzera = 756)
`zipCode`	`xsd:string` / 0..1	Codice postale della città
`name`	`xsd:string` / 0..1	Nome della città
`town`	`xsd:string` / 0..1	Località all'interno della città

DataFaultType

Sollevato quando si verifica un fault dei dati.

Campo	Tipo / Occorrenza	Descrizione
`additionalData`	`xsd:string` / 0..1	Dati aggiuntivi per l'errore
`additionalInfo`	`xsd:string` / 0..1	Informazioni aggiuntive nella lingua dell'utente
`errorClass`	`xsd:string` / 0..1	Classe che ha generato l'errore
`errorCode`	`xsd:string` / 0..1	Codice di errore
`fullMessage`	`xsd:string` / 0..1	Messaggio completo con informazioni aggiuntive nella lingua dell'utente
`language`	`xsd:string` / 0..1	Lingua dei messaggi
`message`	`xsd:string` / 0..1	Messaggio di errore nella lingua dell'utente
`shortMessage`	`xsd:string` / 0..1	Breve descrizione dell'errore nella lingua dell'utente
`systemFullMessage`	`xsd:string` / 0..1	Messaggio completo con informazioni aggiuntive nella lingua di sistema
`systemMessage`	`xsd:string` / 0..1	Messaggio di errore nella lingua di sistema
`systemShortMessage`	`xsd:string` / 0..1	Breve descrizione dell'errore nella lingua di sistema

FindCitiesType

Parametri di ricerca per findCities.

Campo	Tipo / Occorrenza	Descrizione
`country`	`types:CountryType` / 1..1	Paese per la ricerca (ISO 3166-1 alpha-2 o numerico)
`zipCode`	`xsd:string` / 1..1 · max 9	Codice postale dell'origine della ricerca
`city`	`xsd:string` / 1..1 · max 100	Città dell'origine della ricerca
`limit`	`xsd:int` / 1..1 · 1–10	Numero massimo di record nella risposta
`order`	`xsd:string` / 1..1 · `ZIP_CODE` o `NAME`	Campo di ordinamento: codice postale o nome della città

FindCitiesResponseType

Risultato di findCities.

Campo	Tipo / Occorrenza	Descrizione
`city`	`types:CityType` / 0..*	Elenco di città ordinate per nome della città

FindParcelShopsType

Parametri di ricerca per findParcelShops.

Campo	Tipo / Occorrenza	Descrizione
`country`	`types:CountryType` / 1..1	Paese per la ricerca (ISO 3166-1 alpha-2 o numerico)
`zipCode`	`xsd:string` / 1..1 · max 9	Codice postale dell'origine della ricerca
`city`	`xsd:string` / 1..1 · max 100	Città dell'origine della ricerca
`street`	`xsd:string` / 0..1 · max 100	Nome della via dell'origine della ricerca
`houseNo`	`xsd:string` / 0..1 · max 10	Numero civico dell'origine della ricerca
`limit`	`xsd:int` / 1..1 · 1–10	Numero massimo di record nella risposta
`availabilityDate`	`xsd:string` / 0..1 · length 10	Data di consegna più vicina presso il punto di ritiro (`yyyy-MM-dd`). Minimo 24 h di anticipo. Predefinito: data della chiamata + 1
`hideClosed`	`xsd:boolean` / 0..1	Nessuna funzionalità — solo per compatibilità retroattiva
`searchCountry`	`types:CountryType` / 0..*	Paesi nazionali o transfrontalieri per la ricerca
`services`	`types:ServicesRequestType` / 0..1	Criteri di filtro dei servizi

FindParcelShopsResponseType

Risultato di findParcelShops.

Campo	Tipo / Occorrenza	Descrizione
`parcelShop`	`types:ParcelShopType` / 0..*	Elenco dei punti di ritiro corrispondenti alla ricerca

FindParcelShopsByGeoDataType

Parametri di ricerca per findParcelShopsByGeoData.

Campo	Tipo / Occorrenza	Descrizione
`longitude`	`xsd:double` / 1..1	Longitudine dell'origine della ricerca
`latitude`	`xsd:double` / 1..1	Latitudine dell'origine della ricerca
`limit`	`xsd:int` / 1..1 · 1–10	Numero massimo di record nella risposta
`availabilityDate`	`xsd:string` / 0..1 · length 10	Data di consegna più vicina presso il punto di ritiro (`yyyy-MM-dd`). Minimo 24 h di anticipo. Predefinito: data della chiamata + 1
`hideClosed`	`xsd:boolean` / 0..1	Nessuna funzionalità — solo per compatibilità retroattiva
`searchCountry`	`types:CountryType` / 0..*	Paesi nazionali o transfrontalieri per la ricerca
`services`	`types:ServicesRequestType` / 0..1	Criteri di filtro dei servizi

FindParcelShopsByGeoDataResponseType

Risultato di findParcelShopsByGeoData.

Campo	Tipo / Occorrenza	Descrizione
`parcelShop`	`types:ParcelShopType` / 0..*	Elenco dei punti di ritiro corrispondenti alla ricerca

ParcelShopType

Dati restituiti per ogni punto di ritiro corrispondente.

Campo	Tipo / Occorrenza	Descrizione
`parcelShopId`	`xsd:long` / 0..1 · max 999999999	ID del punto di ritiro
`pudoId`	`xsd:string` / 0..1 · max 7	PUDO ID del punto di ritiro
`company`	`xsd:string` / 0..1 · max 100	Ragione sociale del punto di ritiro
`street`	`xsd:string` / 0..1 · max 100	Via (a volte combinata con il numero civico)
`houseNo`	`xsd:string` / 0..1 · max 8	Numero civico
`country`	`xsd:string` / 0..1 · max 2	Codice paese in formato ISO 3166-1 alpha-2
`countryNum`	`xsd:int` / 0..1 · 0–999	Numero paese in formato numerico ISO 3166-1
`state`	`xsd:string` / 0..1 · max 22	Nome del cantone/stato
`zipCode`	`xsd:string` / 0..1 · max 10	Codice postale
`city`	`xsd:string` / 0..1 · max 100	Città
`town`	`xsd:string` / 0..1 · max 35	Località (parte della città)
`phone`	`xsd:string` / 0..1 · max 50	Numero di telefono
`fax`	`xsd:string` / 0..1 · max 50	Numero di fax
`email`	`xsd:string` / 0..1 · max 100	Indirizzo e-mail
`homepage`	`xsd:string` / 0..1 · max 100	Sito web
`latitude`	`xsd:double` / 0..1	Latitudine del punto di ritiro
`longitude`	`xsd:double` / 0..1	Longitudine del punto di ritiro
`coordinateX`	`xsd:double` / 0..1	Coordinata geografica X
`coordinateY`	`xsd:double` / 0..1	Coordinata geografica Y
`coordinateZ`	`xsd:double` / 0..1	Coordinata geografica Z
`distance`	`xsd:double` / 0..1	Distanza dall'origine della ricerca
`expressPickupTime`	`xsd:string` / 0..1 · max 5	Orario di ritiro delle consegne express
`extraInfo`	`xsd:string` / 0..1 · max 300	Informazioni aggiuntive (es. ubicazione all'interno di un centro commerciale)
`openingHours`	`types:OpeningHoursType` / 0..*	Elenco degli orari di apertura
`holiday`	`types:HolidayType` / 0..*	Elenco dei periodi di chiusura del punto di ritiro
`services`	`types:ServicesType` / 0..1	Servizi supportati

OpeningHoursType

Campo	Tipo / Occorrenza	Descrizione
`weekday`	`xsd:string` / 0..1	Nome localizzato del giorno della settimana
`openMorning`	`xsd:string` / 0..1	Orario di apertura mattutino
`closeMorning`	`xsd:string` / 0..1	Orario di chiusura mattutino
`openAfternoon`	`xsd:string` / 0..1	Orario di apertura pomeridiano
`closeAfternoon`	`xsd:string` / 0..1	Orario di chiusura pomeridiano

HolidayType

Campo	Tipo / Occorrenza	Descrizione
`holidayStart`	`xsd:string` / 0..1	Inizio del periodo di chiusura (`yyyy-MM-dd HH:mm:ss`)
`holidayEnd`	`xsd:string` / 0..1	Fine del periodo di chiusura (`yyyy-MM-dd HH:mm:ss`)

ServicesRequestType

Campo	Tipo / Occorrenza	Descrizione
`service`	`types:ServiceRequestType` / 0..*	Elenco dei filtri di servizio

ServiceRequestType

Campo	Tipo / Occorrenza	Descrizione
`code`	`types:CodeType` / 1..1	Codice del servizio (length 3)
`available`	`xsd:boolean` / 1..1	Deve essere `true`
`serviceDetail`	—	Nessuna funzionalità — solo per compatibilità retroattiva

ServicesType

Campo	Tipo / Occorrenza	Descrizione
`service`	`types:ServiceType` / 0..*	Elenco dei servizi supportati

ServiceType

Campo	Tipo / Occorrenza	Descrizione
`code`	`types:CodeType` / 1..1	Codice del servizio
`available`	`xsd:boolean` / 1..1	Se il servizio è disponibile per la ricerca dei punti di ritiro
`description`	`types:DescriptionType` / 0..1	Descrizione del servizio (max 500 caratteri)
`serviceDetail`	`types:ServiceDetailType` / 0..*	Elenco delle informazioni di dettaglio del servizio

SystemFaultType

Sollevato quando si verifica un fault interno di sistema.

Campo	Tipo / Occorrenza	Descrizione
`additionalData`	`xsd:string` / 0..1	Dati aggiuntivi per l'errore
`additionalInfo`	`xsd:string` / 0..1	Informazioni aggiuntive nella lingua dell'utente
`errorClass`	`xsd:string` / 0..1	Classe che ha generato l'errore
`errorCode`	`xsd:string` / 0..1	Codice di errore
`fullMessage`	`xsd:string` / 0..1	Messaggio completo con informazioni aggiuntive nella lingua dell'utente
`language`	`xsd:string` / 0..1	Lingua dei messaggi
`message`	`xsd:string` / 0..1	Messaggio di errore nella lingua dell'utente
`shortMessage`	`xsd:string` / 0..1	Breve descrizione dell'errore nella lingua dell'utente
`systemFullMessage`	`xsd:string` / 0..1	Messaggio completo con informazioni aggiuntive nella lingua di sistema
`systemMessage`	`xsd:string` / 0..1	Messaggio di errore nella lingua di sistema
`systemShortMessage`	`xsd:string` / 0..1	Breve descrizione dell'errore nella lingua di sistema

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

Namespace: `types`

URL: http://dpd.com/common/service/types/ParcelShopFinderService/5.0

Tipo	Tipo base	Vincolo	Descrizione
`CodeType`	`xsd:string`	length 3	Codice del servizio o del dettaglio del servizio
`CountryType`	`xsd:string`	1–3 caratteri	ISO 3166-1 alpha-2 (es. `CH`) o numerico (es. `756`)
`DescriptionType`	`xsd:string`	max 500	Descrizione di un servizio o dettaglio del servizio

Punti di accesso

Ambiente	Protocollo	URL
Stage	SOAP (tutti i metodi)	`https://shivah-st.dpd.ch/external/soap/services/ParcelShopFinderService`
Live	SOAP (tutti i metodi)	`https://shivah.dpd.ch/external/soap/services/ParcelShopFinderService`
Stage	REST · findParcelShops	`https://shivah-st.dpd.ch/external/rest/services/ParcelShopFinderService/findParcelShops`
Live	REST · findParcelShops	`https://shivah.dpd.ch/external/rest/services/ParcelShopFinderService/findParcelShops`
Stage	REST · findParcelShopsByGeoData	`https://shivah-st.dpd.ch/external/rest/services/ParcelShopFinderService/findParcelShopsByGeoData`
Live	REST · findParcelShopsByGeoData	`https://shivah.dpd.ch/external/rest/services/ParcelShopFinderService/findParcelShopsByGeoData`

Metodi​

findCities​

findParcelShops​

findParcelShopsByGeoData​

Esempi​

findCities — SOAP​

findParcelShops — SOAP​

findParcelShopsByGeoData — SOAP​

Tipi complessi​

Namespace: types​

CityType​

DataFaultType​

FindCitiesType​

FindCitiesResponseType​

FindParcelShopsType​

FindParcelShopsResponseType​

FindParcelShopsByGeoDataType​

FindParcelShopsByGeoDataResponseType​

ParcelShopType​

OpeningHoursType​

HolidayType​

ServicesRequestType​

ServiceRequestType​

ServicesType​

ServiceType​

SystemFaultType​

Namespace: types_authentication​

authentication​

Tipi semplici​

Namespace: types​

Punti di accesso​

Metodi

findCities

findParcelShops

findParcelShopsByGeoData

Esempi

findCities — SOAP

findParcelShops — SOAP

findParcelShopsByGeoData — SOAP

Tipi complessi

Namespace: `types`

CityType

DataFaultType

FindCitiesType

FindCitiesResponseType

FindParcelShopsType

FindParcelShopsResponseType

FindParcelShopsByGeoDataType

FindParcelShopsByGeoDataResponseType

ParcelShopType

OpeningHoursType

HolidayType

ServicesRequestType

ServiceRequestType

ServicesType

ServiceType

SystemFaultType

Namespace: `types_authentication`

authentication

Tipi semplici

Namespace: `types`

Punti di accesso