GetPostalCodeServices Method

This method allows you to verify the correctness of a given postal code and to download DHL services available for that code. The result of this method may depend on the time when the method is called (availability of Domestic 9 and Domestic 12 services).

In the case of a postal code that is not supported by DHL (or is incorrect), the method will return an indication that there are no services available for that postal code. When checking the restrictions for the current day, the method will return a possible time window only if ordering a courier is still possible on that day.

Input Parameters

Field Name	Type	Required?	Description
authData	AuthData	Yes	Authorisation structure
postCode	string	Yes	Postal code in 5-digit format (without dash)
pickupDate	string	Yes	Date for which the availability of services is checked (YYYY-MM-DD)
city	string	No	City name
street	string	No	Street name
houseNumber	string	No	House number
apartmentNumber	string	No	Apartment number

Output Parameters

Field Name	Type	Required?	Description
domesticExpress9	bool	-	Availability of Domestic 09 service
domesticExpress12	bool	-	Availability of Domestic 12 service
deliveryEvening	bool	-	Availability of Evening Delivery service
pickupOnSaturday	bool	-	Availability of Saturday Shipment service
deliverySaturday	bool	-	Availability of Saturday Delivery service
exPickupFrom	string	-	Time from which express shipments can be collected
exPickupTo	string	-	Time to which express shipments can be collected
drPickupFrom	string	-	Time from which general shipments can be collected
drPickupTo	string	-	Time to which general shipments above 31.5kg can be collected

Examples of Calls

<getPostalCodeServices>
    <authData>
        <username>testan</username>
        <password>testington</password>
    </authData>
    <postCode>00909</postCode>
    <pickupDate>2012-11-23</pickupDate>
</getPostalCodeServices>

Go back to topic list