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

POST {baseUrl}/services/ParcelShopFinderService

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/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>8585</zipCode>
      <limit>2</limit>
    </ns1:findParcelShops>
  </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>
    <findParcelShopsResponse xmlns="http://dpd.com/common/service/types/ParcelShopFinderService/5.1">
      <parcelShop>
        <parcelShopId>67725048545051</parcelShopId>
        <pudoId>CH20623</pudoId>
        <pudoType>200</pudoType>
        <company>k kiosk EKZ MM Sulgen</company>
        <street>HAUPTSTR.</street>
        <houseNo>3</houseNo>
        <country>CH</country>
        <countryNum>756</countryNum>
        <zipCode>8583</zipCode>
        <city>SULGEN</city>
        <town>SULGEN</town>
        <phone />
        <fax />
        <email />
        <homepage />
        <latitude>47.54079</latitude>
        <longitude>9.18309</longitude>
        <coordinateX>0</coordinateX>
        <coordinateY>0</coordinateY>
        <coordinateZ>0</coordinateZ>
        <distance>4.818</distance>
        <expressPickupTime />
        <extraInfo />
        <openingHours>
          <weekday>Montag</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <openingHours>
          <weekday>Dienstag</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <openingHours>
          <weekday>Mittwoch</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <openingHours>
          <weekday>Donnerstag</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <openingHours>
          <weekday>Freitag</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <openingHours>
          <weekday>Samstag</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <services>
          <service>
            <code>100</code>
            <available>true</available>
            <description>Abholung durch Empfänger</description>
            <serviceDetail />
          </service>
          <service>
            <code>200</code>
            <available>true</available>
            <description>Annahme Pakete online bezahlt ist möglich</description>
            <serviceDetail />
          </service>
          <service>
            <code>201</code>
            <available>true</available>
            <description>Annahme Pakete im Shop bezahlt ist möglich</description>
            <serviceDetail />
          </service>
        </services>
      </parcelShop>
      <parcelShop>
        <parcelShopId>67725048545149</parcelShopId>
        <pudoId>CH20631</pudoId>
        <pudoType>200</pudoType>
        <company>k kiosk EKZ Seepark</company>
        <street>BLEICHESTRASSE</street>
        <houseNo>15</houseNo>
        <country>CH</country>
        <countryNum>756</countryNum>
        <zipCode>8280</zipCode>
        <city>KREUZLINGEN</city>
        <town>KREUZLINGEN</town>
        <phone />
        <fax />
        <email />
        <homepage />
        <latitude>47.64139</latitude>
        <longitude>9.19587</longitude>
        <coordinateX>0</coordinateX>
        <coordinateY>0</coordinateY>
        <coordinateZ>0</coordinateZ>
        <distance>6.997</distance>
        <expressPickupTime />
        <extraInfo />
        <openingHours>
          <weekday>Montag</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <openingHours>
          <weekday>Dienstag</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <openingHours>
          <weekday>Mittwoch</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <openingHours>
          <weekday>Donnerstag</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <openingHours>
          <weekday>Freitag</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <openingHours>
          <weekday>Samstag</weekday>
          <openMorning>08:00</openMorning>
          <closeMorning>12:00</closeMorning>
          <closeAfternoon>20:00</closeAfternoon>
          <openAfternoon>12:00</openAfternoon>
        </openingHours>
        <services>
          <service>
            <code>100</code>
            <available>true</available>
            <description>Abholung durch Empfänger</description>
            <serviceDetail />
          </service>
          <service>
            <code>200</code>
            <available>true</available>
            <description>Annahme Pakete online bezahlt ist möglich</description>
            <serviceDetail />
          </service>
          <service>
            <code>201</code>
            <available>true</available>
            <description>Annahme Pakete im Shop bezahlt ist möglich</description>
            <serviceDetail />
          </service>
        </services>
      </parcelShop>
    </findParcelShopsResponse>
  </soap:Body>
</soap: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