ParcelShopFinderService

Version: 5.0 · December 2025

The ParcelShopFinderService searches for DPD Pickup parcel shops by address or geographic coordinates.

note

You must first call LoginService to obtain an authToken, then pass it in the authentication header of every request.

Methods

Method	Description
`findCities`	Find cities with DPD Pickup parcel shops by country, zip code, and city
`findParcelShops`	Find DPD Pickup parcel shops by country, zip code, city, and optional service criteria
`findParcelShopsByGeoData`	Find DPD Pickup parcel shops by geographic coordinates and optional service criteria

findCities

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

Input:

Name	Element
`authentication` (header)	`types_authentication:authentication`
`parameters`	`types:findCities`

Output:

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

Input:

Name	Element
`authentication` (header)	`types_authentication:authentication`
`parameters`	`types:findParcelShops`

Output:

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

Input:

Name	Element
`authentication` (header)	`types_authentication:authentication`
`parameters`	`types:findParcelShopsByGeoData`

Output:

Name	Element
`parameters`	`types:findParcelShopsByGeoDataResponse`

Faults:

Name	Element
`authenticationFault`	`types_authentication:authenticationFault`
`systemFault`	`types:systemFault`
`dataFault`	`types:dataFault`

Examples

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>

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>

Complex Types

Namespace: `types`

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

CityType

The city type with country, zip code, and name.

Field	Type / Occurrence	Description
`country`	`xsd:string` / 0..1 · max 2	Country code in ISO 3166-1 alpha-2 format
`countryNum`	`xsd:int` / 0..1 · 0–999	Country number in ISO 3166 numeric format (e.g. Switzerland = 756)
`zipCode`	`xsd:string` / 0..1	Zip code of the city
`name`	`xsd:string` / 0..1	Name of the city
`town`	`xsd:string` / 0..1	Town within the city

DataFaultType

Thrown when a data fault occurs.

Field	Type / Occurrence	Description
`additionalData`	`xsd:string` / 0..1	Additional data for the error
`additionalInfo`	`xsd:string` / 0..1	Additional info in user language
`errorClass`	`xsd:string` / 0..1	Class that raised the error
`errorCode`	`xsd:string` / 0..1	Error code
`fullMessage`	`xsd:string` / 0..1	Full message with additional info in user language
`language`	`xsd:string` / 0..1	Language for messages
`message`	`xsd:string` / 0..1	Error message in user language
`shortMessage`	`xsd:string` / 0..1	Short error description in user language
`systemFullMessage`	`xsd:string` / 0..1	Full message with additional info in system language
`systemMessage`	`xsd:string` / 0..1	Error message in system language
`systemShortMessage`	`xsd:string` / 0..1	Short error description in system language

FindCitiesType

Search parameters for findCities.

Field	Type / Occurrence	Description
`country`	`types:CountryType` / 1..1	Country for the search (ISO 3166-1 alpha-2 or numeric)
`zipCode`	`xsd:string` / 1..1 · max 9	Zip code of the search origin
`city`	`xsd:string` / 1..1 · max 100	City of the search origin
`limit`	`xsd:int` / 1..1 · 1–10	Max number of records in the response
`order`	`xsd:string` / 1..1 · `ZIP_CODE` or `NAME`	Sorting field: zip code or city name

FindCitiesResponseType

Result of findCities.

Field	Type / Occurrence	Description
`city`	`types:CityType` / 0..*	List of cities sorted by city name

FindParcelShopsType

Search parameters for findParcelShops.

Field	Type / Occurrence	Description
`country`	`types:CountryType` / 1..1	Country for the search (ISO 3166-1 alpha-2 or numeric)
`zipCode`	`xsd:string` / 1..1 · max 9	Zip code of the search origin
`city`	`xsd:string` / 1..1 · max 100	City of the search origin
`street`	`xsd:string` / 0..1 · max 100	Street name of the search origin
`houseNo`	`xsd:string` / 0..1 · max 10	House number of the search origin
`limit`	`xsd:int` / 1..1 · 1–10	Max number of records in the response
`availabilityDate`	`xsd:string` / 0..1 · length 10	Earliest delivery date at the parcel shop (`yyyy-MM-dd`). Minimum 24 h ahead. Default: calling date + 1
`hideClosed`	`xsd:boolean` / 0..1	No functionality — for backward compatibility only
`searchCountry`	`types:CountryType` / 0..*	Domestic or cross-border countries for the search
`services`	`types:ServicesRequestType` / 0..1	Service filter criteria

FindParcelShopsResponseType

Result of findParcelShops.

Field	Type / Occurrence	Description
`parcelShop`	`types:ParcelShopType` / 0..*	List of parcel shops matching the search

FindParcelShopsByGeoDataType

Search parameters for findParcelShopsByGeoData.

Field	Type / Occurrence	Description
`longitude`	`xsd:double` / 1..1	Longitude of the search origin
`latitude`	`xsd:double` / 1..1	Latitude of the search origin
`limit`	`xsd:int` / 1..1 · 1–10	Max number of records in the response
`availabilityDate`	`xsd:string` / 0..1 · length 10	Earliest delivery date at the parcel shop (`yyyy-MM-dd`). Minimum 24 h ahead. Default: calling date + 1
`hideClosed`	`xsd:boolean` / 0..1	No functionality — for backward compatibility only
`searchCountry`	`types:CountryType` / 0..*	Domestic or cross-border countries for the search
`services`	`types:ServicesRequestType` / 0..1	Service filter criteria

FindParcelShopsByGeoDataResponseType

Result of findParcelShopsByGeoData.

Field	Type / Occurrence	Description
`parcelShop`	`types:ParcelShopType` / 0..*	List of parcel shops matching the search

ParcelShopType

Data returned for each matching parcel shop.

Field	Type / Occurrence	Description
`parcelShopId`	`xsd:long` / 0..1 · max 999999999	ID of the parcel shop
`pudoId`	`xsd:string` / 0..1 · max 7	PUDO ID of the parcel shop
`company`	`xsd:string` / 0..1 · max 100	Company name of the shop
`street`	`xsd:string` / 0..1 · max 100	Street (sometimes combined with house number)
`houseNo`	`xsd:string` / 0..1 · max 8	House number
`country`	`xsd:string` / 0..1 · max 2	Country code in ISO 3166-1 alpha-2 format
`countryNum`	`xsd:int` / 0..1 · 0–999	Country number in ISO 3166-1 numeric format
`state`	`xsd:string` / 0..1 · max 22	State name
`zipCode`	`xsd:string` / 0..1 · max 10	Zip code
`city`	`xsd:string` / 0..1 · max 100	City
`town`	`xsd:string` / 0..1 · max 35	Town (part of the city)
`phone`	`xsd:string` / 0..1 · max 50	Phone number
`fax`	`xsd:string` / 0..1 · max 50	Fax number
`email`	`xsd:string` / 0..1 · max 100	Email address
`homepage`	`xsd:string` / 0..1 · max 100	Website
`latitude`	`xsd:double` / 0..1	Latitude of the shop
`longitude`	`xsd:double` / 0..1	Longitude of the shop
`coordinateX`	`xsd:double` / 0..1	X geo coordinate
`coordinateY`	`xsd:double` / 0..1	Y geo coordinate
`coordinateZ`	`xsd:double` / 0..1	Z geo coordinate
`distance`	`xsd:double` / 0..1	Distance from the search origin
`expressPickupTime`	`xsd:string` / 0..1 · max 5	Time when express deliveries are picked up
`extraInfo`	`xsd:string` / 0..1 · max 300	Additional information (e.g. location within a mall)
`openingHours`	`types:OpeningHoursType` / 0..*	List of opening hours
`holiday`	`types:HolidayType` / 0..*	List of shop vacation periods
`services`	`types:ServicesType` / 0..1	Supported services

OpeningHoursType

Field	Type / Occurrence	Description
`weekday`	`xsd:string` / 0..1	Localized name of the weekday
`openMorning`	`xsd:string` / 0..1	Morning opening time
`closeMorning`	`xsd:string` / 0..1	Morning closing time
`openAfternoon`	`xsd:string` / 0..1	Afternoon opening time
`closeAfternoon`	`xsd:string` / 0..1	Afternoon closing time

HolidayType

Field	Type / Occurrence	Description
`holidayStart`	`xsd:string` / 0..1	Start of holiday period (`yyyy-MM-dd HH:mm:ss`)
`holidayEnd`	`xsd:string` / 0..1	End of holiday period (`yyyy-MM-dd HH:mm:ss`)

ServicesRequestType

Field	Type / Occurrence	Description
`service`	`types:ServiceRequestType` / 0..*	List of service filters

ServiceRequestType

Field	Type / Occurrence	Description
`code`	`types:CodeType` / 1..1	Service code (length 3)
`available`	`xsd:boolean` / 1..1	Must be `true`
`serviceDetail`	—	No functionality — for backward compatibility only

ServicesType

Field	Type / Occurrence	Description
`service`	`types:ServiceType` / 0..*	List of supported services

ServiceType

Field	Type / Occurrence	Description
`code`	`types:CodeType` / 1..1	Service code
`available`	`xsd:boolean` / 1..1	Whether the service is available for parcel shop search
`description`	`types:DescriptionType` / 0..1	Description of the service (max 500 chars)
`serviceDetail`	`types:ServiceDetailType` / 0..*	List of service detail information

SystemFaultType

Thrown when an internal system fault occurs.

Field	Type / Occurrence	Description
`additionalData`	`xsd:string` / 0..1	Additional data for the error
`additionalInfo`	`xsd:string` / 0..1	Additional info in user language
`errorClass`	`xsd:string` / 0..1	Class that raised the error
`errorCode`	`xsd:string` / 0..1	Error code
`fullMessage`	`xsd:string` / 0..1	Full message with additional info in user language
`language`	`xsd:string` / 0..1	Language for messages
`message`	`xsd:string` / 0..1	Error message in user language
`shortMessage`	`xsd:string` / 0..1	Short error description in user language
`systemFullMessage`	`xsd:string` / 0..1	Full message with additional info in system language
`systemMessage`	`xsd:string` / 0..1	Error message in system language
`systemShortMessage`	`xsd:string` / 0..1	Short error description in system language

Namespace: `types_authentication`

URL: http://dpd.com/common/service/types/Authentication/2.0

authentication

Field	Type / Occurrence	Description
`delisId`	`xsd:string` / 1..1 · 8–10 chars	DELIS user ID
`authToken`	`xsd:string` / 1..1 · 0–64 chars	Token from `LoginService.getAuth`
`messageLanguage`	`xsd:string` / 1..1 · length 5	`de_CH`, `fr_CH`, `it_CH`, or `en_CH`

Simple Types

Namespace: `types`

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

Type	Base type	Constraint	Description
`CodeType`	`xsd:string`	length 3	Service or service detail code
`CountryType`	`xsd:string`	1–3 chars	ISO 3166-1 alpha-2 (e.g. `CH`) or numeric (e.g. `756`)
`DescriptionType`	`xsd:string`	max 500	Description of a service or service detail

Entry Points

Environment	URL
Stage — by geo	`https://shivah-st.dpd.ch/external/pudo/GetPudoListByLongLat`
Stage — by address	`https://shivah-st.dpd.ch/external/pudo/GetPudoList`
Stage — details	`https://shivah-st.dpd.ch/external/pudo/GetPudoDetails`
Live — by geo	`https://shivah.dpd.ch/external/pudo/GetPudoListByLongLat`
Live — by address	`https://shivah.dpd.ch/external/pudo/GetPudoList`
Live — details	`https://shivah.dpd.ch/external/pudo/GetPudoDetails`

Methods​

findCities​

findParcelShops​

findParcelShopsByGeoData​

Examples​

findCities — SOAP​

findParcelShops — SOAP​

findParcelShopsByGeoData — SOAP​

Complex Types​

Namespace: types​

CityType​

DataFaultType​

FindCitiesType​

FindCitiesResponseType​

FindParcelShopsType​

FindParcelShopsResponseType​

FindParcelShopsByGeoDataType​

FindParcelShopsByGeoDataResponseType​

ParcelShopType​

OpeningHoursType​

HolidayType​

ServicesRequestType​

ServiceRequestType​

ServicesType​

ServiceType​

SystemFaultType​

Namespace: types_authentication​

authentication​

Simple Types​

Namespace: types​

Entry Points​

Methods

findCities

findParcelShops

findParcelShopsByGeoData

Examples

findCities — SOAP

findParcelShops — SOAP

findParcelShopsByGeoData — SOAP

Complex Types

Namespace: `types`

CityType

DataFaultType

FindCitiesType

FindCitiesResponseType

FindParcelShopsType

FindParcelShopsResponseType

FindParcelShopsByGeoDataType

FindParcelShopsByGeoDataResponseType

ParcelShopType

OpeningHoursType

HolidayType

ServicesRequestType

ServiceRequestType

ServicesType

ServiceType

SystemFaultType

Namespace: `types_authentication`

authentication

Simple Types

Namespace: `types`

Entry Points