Welcome to the documentation database for the Shipper Webservices, the web based API for DPD Belux.
This wiki describes how to integrate DPD Shipper Webservices into your own application. The DPD Shipper Webservices provides five web services:
- The Login Service to authenticate the user,
- The Shipment Service to generate parcel labels
- The ParcelShopFinder Service to find the nearest Parcel Shop.
- The Parcel LifeCycle Service to request the status of your parcel.
- The End-of-Day service to compose a list of your shipments.
All five services are SOAP WSDL services. This means the XML protocol is used to communicate between your application and the DPD Shipper Webservices. For the time being, only SOAP 1.1 calls are supported. REST services will be made available later on.
Please use the 'GET' method to obtain valid responses.
By integrating your system via our services your integration will always be up to speed with the latest developments in the DPD System.
The ParcelShopFinder service will provide you the latest data about our Pickup parcel shop network.
The Shipment service will provide you with a PDF label generated using the latest routing specs this way you won't have to update your system every few months.
And will forward the data directly into our system so we know your parcel is coming our way.
The KPI's mentioned here are the system response times for the live environment. The stage environment have no KPI's. External factors like narrow-band internet, routings and other factors outside DPD systems, are non measurable and out of scope.
What you can expect
- Login Service (max 0.5 sec.)
- ParcelShopFinder Service (max 1 sec.)
- Shipment Service :: Depending on the amount of labels in the request (between 1 and 20) max 5 sec.
What we expect
- Maximum of 10 login requests every 24hours
- Local retention of parcel shop data (vs reloading it via the service) for lookup purposes. Each new shipment however requires a new call to obtain valid parcelshops.
- Minimal amount of orders (multiple parcels possible) per shipment request
- Maximal request of 30 labels / min.
To ensure the stability and performance of our services for all shippers we maintain the following optimizations:
- Not more than necessary - 10 at the most - login requests per day. (cache your Token, refresh on LOGIN_x)
- Cache ParcelShop finder responses per client request/checkout.
- Try to make one shipment request per order (order may contain multiple parcels)
What to do to go live
- Contact your sales contact and request a staging account for the DPD Shipper Webservices.
- You will receive stage credentials from DPD Customer IT.
- Start developing against our web services (Put your IT dep. in contact with DPD IT for sparring purposes)
- Generate a label for each product you wish to use
- Send these labels (PDF) to your responsible DPD IT department (IT.CS@dpd.be)
- Fix possible issues requested by DPD IT
- Go back to step 4 (if applicable)
- Request switch to live environment
- (optional) Test products with live parcels.