Parcelshopfinder Service

The ParcelShopFinder service returns a list of the nearest parcel shops. A request to the ParcelShopFinder service will only succeed after a call to the login service to get a unique token to access the ParcelShopFinder service.The token will be valid 24 hours. It is not advised and not necessary to call the Login Service every time for a call to the ParcelShopFinder service.

If you work with a Google Map to show up a list of parcelshops

Most webshops work with an embedded map from Google Maps to show up a list of Parcelshops. This implies that you will need a Google API key. Please keep in mind that obtaining a Google API key is entirely out of DPD's hands and you will have to create Google account yourself to obtain one. DPD is unable provide you with such a key.

Connection URLs

Live: https://wsshipper.dpd.be/soap/WSDL/ParcelShopFinderServiceV50.wsdl
Stage: https://shipperadmintest.dpd.be/PublicApi/soap/WSDL/ParcelShopFinderSer…

 

Process

The following diagram illustrates how the process works.

 

 

Request parameters

<authentication> section

Node Type Length Description Mandatory?
<delisId> String 6-10 Your Delis ID provided by DPD Yes
<authToken> String 128 Authentication token acquired from the login service Yes
<messageLanguage> String 5 This can be set to the default value of en_EN Yes

 

<findParcelShopsByGeoData> section

Node Type Length Description Mandatory?
<longitude> Decimal 18,12 The longitude of search origin in format minutes,seconds Yes
<latitude> Decimal 18,12 The latitude of search origin in format minutes,seconds Yes
<limit> Integer 3 Maximum number of parcel shops returned. Server side limit of 100 results Yes
 <availabilityDate> String 16 If set, will only show PUDOs that are open and available on that specific date. Usually used to filter out shops that are on holiday for example. Format yyyy-MM-dd No
<hideClosed> Boolean n/a If set to true, parcelshops, which are closed now are
not returned.
No
<searchCountry> String 2 Only shows results in this specified country. Format: alpha-2 code ISO3166 (example BE or FR) No
<services> n/a n/a Specifies which service the PUDO should provide. See <services> section below. Currently not in use. No

 

Sample call

Basic

<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>KD*****</delisId>
         <authToken>****</authToken>
         <messageLanguage>en_EN</messageLanguage>
      </ns:authentication>
   </soapenv:Header>
   <soapenv:Body>
      <ns1:findParcelShopsByGeoData>
         <longitude>4.478</longitude>
         <latitude>51.026</latitude>
         <limit>10</limit>         
      </ns1:findParcelShopsByGeoData>
   </soapenv:Body>
</soapenv:Envelope>

 

With extra options

<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>KD*****</delisId>
         <authToken>****</authToken>
         <messageLanguage>en_EN</messageLanguage>
      </ns:authentication>
   </soapenv:Header>
   <soapenv:Body>
      <ns1:findParcelShopsByGeoData>
         <longitude>4.478</longitude>
         <latitude>51.026</latitude>
         <limit>10</limit>
         <availabilityDate>2019-06-16</availabilityDate> 
         <hideClosed>true</hideClosed>
         <searchCountry>BE</searchCountry>      
      </ns1:findParcelShopsByGeoData>
   </soapenv:Body>
</soapenv:Envelope>

 

Submitted by CustomerIT on Tue, 07/02/2019 - 14:41