FREQUENTLY ASKED QUESTIONS
Integrations
-
None! The usage of our API is free for all of our customers. In case you want to resell our API via integrating it somewhere - get in touch with us to ensure, that we do not block services in case of excessive usage.
-
After signing up for our shipping or fullfillment services, the provided credentials will give you access to all of our services via a standard restful API. From consolidating orders to creating picklists and printing shipping labels or calling the latest rates, everything in a responsive and fast, direct access.
-
No, not at all.
-
No, all that is necessary for using our DHL eCommerce web service is a connection to the internet and developer resources on your side to code against it - this also works without any internet presence.
-
You have to be a registered user to get credentials for our DHL eCommerce API. Please let us know your customer account number via an Email to Integration@dhl.com and we will return you your individual client_id and client_secret. In case you want to test your application, you can also use our public sandbox credentials (please ensure that you are just calling the sanbox environment too) Client_id: e9ed82a8-4237-4185-8e36-47264aa9e718 and Client_secret: b1ed1bfa-689b-4d5b-bbf2-39dde64ccb64
-
DHL eCommerce expose OAuth authentication service, where you have to pass your credentials to receive access token.
-
Yes, the Swagger Specification is available. Please refer to the API Catalogue to find a link for your desired API.
-
Status Code
HTTP Status
Description
200
OK
Successful Response
202
ACCEPTED
Sales Order / Purchase Order / Item Creation
Request Accepted
400
BAD_REQUEST
Invalid URI parameters or querystring
400
VALIDATION_ERROR
An input parameter may be missing or invalid.
401
UNAUTHORIZED
Invalid token or Authentication Header
parameter403
ACCESS_DENIED
User does not have access to this resource
429
TOO_MANY_REQUESTS
Too many requests in given amount of time
(more than 5 calls per second)503
SERVICE_UNAVAILABLE
-
There are a variaty of services available at marketplaces like Alibaba, Amazon, eBay, Rakuten and more as well as standard plugins for webshop systems like Magento, WooCommerce or Shopify. Additionally, we have our services available via the standard 3PV systems (Metapack, Endichia , etc.) as well as for your ERP, TMS, OMS or WMS System like IBM Sterling, Sage or SAP - detailed information can be found
-
Depending on your region and your core requirements, DHL eCommerce offers two business customer portals. Registered customers can log in the and the undefined.
-
Instead of using the API, there are alternative ways for you to access our shipping services that do not require developer resources as e.g. the usage of our portals.
- With very limited coding effort you can also just install one of our plugins, extensions or add-ons if you are using one of the
- For higher shipping volumes we also recommend you having a look into our Look into our
-
There are various entry points for support depending on the type of questions your IT department has. Next to documentation available on the a more general support is available via our undefined. In case you need some direct support, we also have a team of highly skilled integration experts to support you in your endavours.
-
Authentification is required to ensure that only someone authorized can request access to confidential information. DHL eCommerce uses the OAuth 2.0 protocol for authentication and authorization. DHL eCommerce provides authorization server to clients to request and obtain the access token. The access token is used to access data from the DHL eCommerce business global APIs (e.g. eFulfillment API, Label API). Detailed information on how the authenthification process works can be found Detailed information can be found
Products
-
This depends on your own trust in your printing capabilities. In case the generated labels are coming from the API and the printing quality as well as the requirements towards size and orientation are met as described Find out more about the requirementshere you do not need a label certification from us. In case you are composing your own labels by using our EDI integration, just provide us a testlabel upfront to certifiy that it meets the standards.
-
Through the DHL eCommerce Business Customer Portals; customers can evaluate performance results, track parcels and analyze shipping costs to effectively manage shipping. Next to reporting, they also offer the ability to manage your orders, generate labels and even do standard warehouse operations. Depending on your region and requirements we recommend either the Americas or the Asia Pacific portal. More details can be found More details can be foundhere.
-
Manifesting is a term used to describe the process in which customers electronically transmit the shipment data for all packages tendered that day for processing. It's an end of day process completed before the driver arrives and that returns a BOL for yours and our reference.
-
No. The objective of the certification process is to ensure a customer's setup (hardware, software and printer label output) is compliant to DHL eCommerce specifications and can successfully run through our automation equipment.
-
Not yet since we do not yet offer rating calls on our web service. This feature will be available via the API in 2017 - then you can get rates back for a variety of shipments as well as for a variety of products.
-
No. At this time pick lists are not available in our technology offering.
-
No. At this time customized labels are not available in our technology offering unless you do build the labels on your own including the certification and EDI integration process.
-
Currently we are offering shipping services in Australia, Canada, Chile, Hong Kong, Israel, Japan, Malaysia, Philippines, Singapore, Thailand, the U.S., and Vietnam. undefined on our offering in the respective country please visit the country website.
-
No. Thermal labels require special label stock and printer heads. More information can be retrieved from your printer manufacturer (like Zebra, Datamax, Sato, etc.).
Tracking
-
Yes. On our tracking website you can enter up to 50 tracking numbers and receive the aggregated tracking status in return.
-
As DHL eCommerce Customer you will have access to our Business Customer Portal which enables you among other features to track your shipments with a tracking number. Please be aware that different products include different levels of tracking detail. For detailed tracking status updates, please visit our undefined.