Parcelshopfinder service

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 12 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

    With this function you can find a Parcelshop by using geocoordinates. Useful when combined with Google Maps for example.

    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 10 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>

     

    <findParcelShops> section

    This function can be used to search for Parcelshops based on zipcode, country and city.

    Node Type Length Description Mandatory?
    <country> String 2 Country of address Sender’s owner in ISO 3166-1 alpha-2 code Yes
    <zipCode> String 9 Zip code of address Sender’s owner. Please do not add prefixes. Yes
    <city> String 35 City/town of address Sender’s owner 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

     

    Sample call

    <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:findParcelShops>
             <country>BE</country>
             <zipCode>2800</zipCode>
             <city>Mechelen</city>  
             <limit>10</limit>      
          </ns1:findParcelShops>
       </soapenv:Body>
    </soapenv:Envelope>
Was this post helpful?(Required)