ParcelShopFinderService
Version: 5.1 · Dezember 2025
Der ParcelShopFinderService sucht nach DPD Pickup Paketshops anhand von Adresse oder Geokoordinaten.
hinweis
Sie müssen zuerst den LoginService aufrufen, um einen authToken zu erhalten, und diesen anschliessend im Authentifizierungs-Header jeder Anfrage übergeben.
Methoden
| Methode | Beschreibung |
|---|---|
findCities | Findet Städte mit DPD Pickup Paketshops anhand von Land, Postleitzahl und Stadt |
findParcelShops | Findet DPD Pickup Paketshops anhand von Land, Postleitzahl, Stadt und optionalen Servicekriterien |
findParcelShopsByGeoData | Findet DPD Pickup Paketshops anhand von Geokoordinaten und optionalen Servicekriterien |
findCities
Action: http://dpd.com/common/service/ParcelShopFinderService/5.0/findCities
Eingabe:
| Name | Element |
|---|---|
authentication (Header) | types_authentication:authentication |
parameters | types:findCities |
Ausgabe:
| Name | Element |
|---|---|
parameters | types:findCitiesResponse |
Faults:
| Name | Element |
|---|---|
authenticationFault | types_authentication:authenticationFault |
systemFault | types:systemFault |
dataFault | types:dataFault |
findParcelShops
Action: http://dpd.com/common/service/ParcelShopFinderService/5.0/findParcelShops
Eingabe:
| Name | Element |
|---|---|
authentication (Header) | types_authentication:authentication |
parameters | types:findParcelShops |
Ausgabe:
| Name | Element |
|---|---|
parameters | types:findParcelShopsResponse |
Faults:
| Name | Element |
|---|---|
authenticationFault | types_authentication:authenticationFault |
systemFault | types:systemFault |
dataFault | types:dataFault |
findParcelShopsByGeoData
Action: http://dpd.com/common/service/ParcelShopFinderService/5.0/findParcelShopsByGeoData
Eingabe:
| Name | Element |
|---|---|
authentication (Header) | types_authentication:authentication |
parameters | types:findParcelShopsByGeoData |
Ausgabe:
| Name | Element |
|---|---|
parameters | types:findParcelShopsByGeoDataResponse |
Faults:
| Name | Element |
|---|---|
authenticationFault | types_authentication:authenticationFault |
systemFault | types:systemFault |
dataFault | types:dataFault |
Beispiele
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>
hinweis
Ein REST-Endpunkt für findCities wird derzeit nicht bereitgestellt. Verwenden Sie für diese Methode den unter Einstiegspunkte aufgeführten SOAP-Service-Endpunkt.
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>
Komplexe Typen
Namespace: types
URL: http://dpd.com/common/service/types/ParcelShopFinderService/5.0
CityType
Der Stadttyp mit Land, Postleitzahl und Name.
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
country | xsd:string / 0..1 · max. 2 | Ländercode im Format ISO 3166-1 alpha-2 |
countryNum | xsd:int / 0..1 · 0–999 | Ländernummer im numerischen Format ISO 3166 (z. B. Schweiz = 756) |
zipCode | xsd:string / 0..1 | Postleitzahl der Stadt |
name | xsd:string / 0..1 | Name der Stadt |
town | xsd:string / 0..1 | Ortschaft innerhalb der Stadt |
DataFaultType
Wird ausgelöst, wenn ein Datenfehler auftritt.
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
additionalData | xsd:string / 0..1 | Zusätzliche Daten zum Fehler |
additionalInfo | xsd:string / 0..1 | Zusätzliche Information in der Benutzersprache |
errorClass | xsd:string / 0..1 | Klasse, die den Fehler ausgelöst hat |
errorCode | xsd:string / 0..1 | Fehlercode |
fullMessage | xsd:string / 0..1 | Vollständige Meldung mit Zusatzinformationen in der Benutzersprache |
language | xsd:string / 0..1 | Sprache für Meldungen |
message | xsd:string / 0..1 | Fehlermeldung in der Benutzersprache |
shortMessage | xsd:string / 0..1 | Kurze Fehlerbeschreibung in der Benutzersprache |
systemFullMessage | xsd:string / 0..1 | Vollständige Meldung mit Zusatzinformationen in der Systemsprache |
systemMessage | xsd:string / 0..1 | Fehlermeldung in der Systemsprache |
systemShortMessage | xsd:string / 0..1 | Kurze Fehlerbeschreibung in der Systemsprache |
FindCitiesType
Suchparameter für findCities.
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
country | types:CountryType / 1..1 | Land für die Suche (ISO 3166-1 alpha-2 oder numerisch) |
zipCode | xsd:string / 1..1 · max. 9 | Postleitzahl des Suchursprungs |
city | xsd:string / 1..1 · max. 100 | Stadt des Suchursprungs |
limit | xsd:int / 1..1 · 1–10 | Maximale Anzahl der Datensätze in der Antwort |
order | xsd:string / 1..1 · ZIP_CODE oder NAME | Sortierfeld: Postleitzahl oder Stadtname |
FindCitiesResponseType
Ergebnis von findCities.
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
city | types:CityType / 0..* | Liste der nach Stadtname sortierten Städte |
FindParcelShopsType
Suchparameter für findParcelShops.
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
country | types:CountryType / 1..1 | Land für die Suche (ISO 3166-1 alpha-2 oder numerisch) |
zipCode | xsd:string / 1..1 · max. 9 | Postleitzahl des Suchursprungs |
city | xsd:string / 1..1 · max. 100 | Stadt des Suchursprungs |
street | xsd:string / 0..1 · max. 100 | Strassenname des Suchursprungs |
houseNo | xsd:string / 0..1 · max. 10 | Hausnummer des Suchursprungs |
limit | xsd:int / 1..1 · 1–10 | Maximale Anzahl der Datensätze in der Antwort |
availabilityDate | xsd:string / 0..1 · Länge 10 | Frühestes Zustelldatum im Paketshop (yyyy-MM-dd). Mindestens 24 Std. im Voraus. Standard: Aufrufdatum + 1 |
hideClosed | xsd:boolean / 0..1 | Keine Funktion — nur zur Abwärtskompatibilität |
searchCountry | types:CountryType / 0..* | Inländische oder grenzüberschreitende Länder für die Suche |
services | types:ServicesRequestType / 0..1 | Service-Filterkriterien |
FindParcelShopsResponseType
Ergebnis von findParcelShops.
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
parcelShop | types:ParcelShopType / 0..* | Liste der Paketshops, die der Suche entsprechen |
FindParcelShopsByGeoDataType
Suchparameter für findParcelShopsByGeoData.
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
longitude | xsd:double / 1..1 | Längengrad des Suchursprungs |
latitude | xsd:double / 1..1 | Breitengrad des Suchursprungs |
limit | xsd:int / 1..1 · 1–10 | Maximale Anzahl der Datensätze in der Antwort |
availabilityDate | xsd:string / 0..1 · Länge 10 | Frühestes Zustelldatum im Paketshop (yyyy-MM-dd). Mindestens 24 Std. im Voraus. Standard: Aufrufdatum + 1 |
hideClosed | xsd:boolean / 0..1 | Keine Funktion — nur zur Abwärtskompatibilität |
searchCountry | types:CountryType / 0..* | Inländische oder grenzüberschreitende Länder für die Suche |
services | types:ServicesRequestType / 0..1 | Service-Filterkriterien |
FindParcelShopsByGeoDataResponseType
Ergebnis von findParcelShopsByGeoData.
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
parcelShop | types:ParcelShopType / 0..* | Liste der Paketshops, die der Suche entsprechen |
ParcelShopType
Für jeden passenden Paketshop zurückgegebene Daten.
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
parcelShopId | xsd:long / 0..1 · max. 999999999 | ID des Paketshops |
pudoId | xsd:string / 0..1 · max. 7 | PUDO-ID des Paketshops |
company | xsd:string / 0..1 · max. 100 | Firmenname des Shops |
street | xsd:string / 0..1 · max. 100 | Strasse (teilweise mit Hausnummer kombiniert) |
houseNo | xsd:string / 0..1 · max. 8 | Hausnummer |
country | xsd:string / 0..1 · max. 2 | Ländercode im Format ISO 3166-1 alpha-2 |
countryNum | xsd:int / 0..1 · 0–999 | Ländernummer im numerischen Format ISO 3166-1 |
state | xsd:string / 0..1 · max. 22 | Name des Bundeslands/Kantons |
zipCode | xsd:string / 0..1 · max. 10 | Postleitzahl |
city | xsd:string / 0..1 · max. 100 | Stadt |
town | xsd:string / 0..1 · max. 35 | Ortschaft (Teil der Stadt) |
phone | xsd:string / 0..1 · max. 50 | Telefonnummer |
fax | xsd:string / 0..1 · max. 50 | Faxnummer |
email | xsd:string / 0..1 · max. 100 | E-Mail-Adresse |
homepage | xsd:string / 0..1 · max. 100 | Website |
latitude | xsd:double / 0..1 | Breitengrad des Shops |
longitude | xsd:double / 0..1 | Längengrad des Shops |
coordinateX | xsd:double / 0..1 | X-Geokoordinate |
coordinateY | xsd:double / 0..1 | Y-Geokoordinate |
coordinateZ | xsd:double / 0..1 | Z-Geokoordinate |
distance | xsd:double / 0..1 | Entfernung vom Suchursprung |
expressPickupTime | xsd:string / 0..1 · max. 5 | Zeitpunkt, zu dem Expresssendungen abgeholt werden |
extraInfo | xsd:string / 0..1 · max. 300 | Zusätzliche Informationen (z. B. Lage innerhalb eines Einkaufszentrums) |
openingHours | types:OpeningHoursType / 0..* | Liste der Öffnungszeiten |
holiday | types:HolidayType / 0..* | Liste der Ferienzeiten des Shops |
services | types:ServicesType / 0..1 | Unterstützte Services |
OpeningHoursType
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
weekday | xsd:string / 0..1 | Lokalisierter Name des Wochentags |
openMorning | xsd:string / 0..1 | Öffnungszeit am Vormittag |
closeMorning | xsd:string / 0..1 | Schliesszeit am Vormittag |
openAfternoon | xsd:string / 0..1 | Öffnungszeit am Nachmittag |
closeAfternoon | xsd:string / 0..1 | Schliesszeit am Nachmittag |
HolidayType
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
holidayStart | xsd:string / 0..1 | Beginn der Ferienzeit (yyyy-MM-dd HH:mm:ss) |
holidayEnd | xsd:string / 0..1 | Ende der Ferienzeit (yyyy-MM-dd HH:mm:ss) |
ServicesRequestType
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
service | types:ServiceRequestType / 0..* | Liste der Service-Filter |
ServiceRequestType
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
code | types:CodeType / 1..1 | Servicecode (Länge 3) |
available | xsd:boolean / 1..1 | Muss true sein |
serviceDetail | — | Keine Funktion — nur zur Abwärtskompatibilität |
ServicesType
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
service | types:ServiceType / 0..* | Liste der unterstützten Services |
ServiceType
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
code | types:CodeType / 1..1 | Servicecode |
available | xsd:boolean / 1..1 | Gibt an, ob der Service für die Paketshop-Suche verfügbar ist |
description | types:DescriptionType / 0..1 | Beschreibung des Service (max. 500 Zeichen) |
serviceDetail | types:ServiceDetailType / 0..* | Liste der Service-Detailinformationen |
SystemFaultType
Wird ausgelöst, wenn ein interner Systemfehler auftritt.
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
additionalData | xsd:string / 0..1 | Zusätzliche Daten zum Fehler |
additionalInfo | xsd:string / 0..1 | Zusätzliche Information in der Benutzersprache |
errorClass | xsd:string / 0..1 | Klasse, die den Fehler ausgelöst hat |
errorCode | xsd:string / 0..1 | Fehlercode |
fullMessage | xsd:string / 0..1 | Vollständige Meldung mit Zusatzinformationen in der Benutzersprache |
language | xsd:string / 0..1 | Sprache für Meldungen |
message | xsd:string / 0..1 | Fehlermeldung in der Benutzersprache |
shortMessage | xsd:string / 0..1 | Kurze Fehlerbeschreibung in der Benutzersprache |
systemFullMessage | xsd:string / 0..1 | Vollständige Meldung mit Zusatzinformationen in der Systemsprache |
systemMessage | xsd:string / 0..1 | Fehlermeldung in der Systemsprache |
systemShortMessage | xsd:string / 0..1 | Kurze Fehlerbeschreibung in der Systemsprache |
Namespace: types_authentication
URL: http://dpd.com/common/service/types/Authentication/2.0
authentication
| Feld | Typ / Vorkommen | Beschreibung |
|---|---|---|
delisId | xsd:string / 1..1 · 8–10 Zeichen | DELIS-Benutzer-ID |
authToken | xsd:string / 1..1 · 0–64 Zeichen | Token von LoginService.getAuth |
messageLanguage | xsd:string / 1..1 · Länge 5 | de_CH, fr_CH, it_CH oder en_CH |
Einfache Typen
Namespace: types
URL: http://dpd.com/common/service/types/ParcelShopFinderService/5.0
| Typ | Basistyp | Einschränkung | Beschreibung |
|---|---|---|---|
CodeType | xsd:string | Länge 3 | Service- oder Service-Detailcode |
CountryType | xsd:string | 1–3 Zeichen | ISO 3166-1 alpha-2 (z. B. CH) oder numerisch (z. B. 756) |
DescriptionType | xsd:string | max. 500 | Beschreibung eines Service oder Service-Details |
Einstiegspunkte
| Umgebung | Protokoll | URL |
|---|---|---|
| Stage | SOAP (alle Methoden) | https://shivah-st.dpd.ch/external/soap/services/ParcelShopFinderService |
| Live | SOAP (alle Methoden) | 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 |