Details about ShipStation's integration with DHL eCommerce. Includes requirements, connection process, features, notes, and troubleshooting tips.
DHL eCommerce is a cost-effective delivery service for ecommerce merchants. ShipStation's direct integration with DHL eCommerce allows you to create domestic labels as well as international labels destined for any country in DHL's extensive delivery network. For international shipments, ShipStation automatically generates and submits your customs documentation.
Contact your DHL representative to request a quote and begin the DHL eCommerce certification process.
DHL eCommerce v4 API!
ShipStation has completed the work needed to integrate with the new DHL eCommerce v4 API. If you connected your DHL eCommerce account to ShipStation before June 28th, 2021, ShipStation will soon migrate you automatically to the new connection. No action is required on your part.
Connection Requirements:
An active account with DHL eCommerce.
A Platinum, Enterprise, or High Volume plan in ShipStation.
-
Account Client ID and Secret
Provided by DHL via email.
Pickup Account Number
Distribution Center Name
Manifest Requirements:
DHL eCommerce requires a printed manifest for each day's shipments. To manifest your shipments, use ShipStation's End of Day process.
To connect your DHL eCommerce account to ShipStation:
-
Contact your DHL account representative and request the following information if you do not already have it:
DHL eCommerce Client ID and Client Secret
DHL eCommerce Pickup Number
Distribution Center
Log in to your ShipStation account.
-
Select the DHL eCommerce tile and click Connect.
-
Enter your Client Id, Secret, and Pickup Account number. Then, choose a Distribution Center from the drop-down menu.
Select the DHL eCommerce services approved for use with your account.
Click Connect.
You can now create shipping labels in ShipStation using your DHL eCommerce account.
ShipStation's integration with DHL eCommerce supports the following standard features:
ShipStation's integration with DHL eCommerce allows for the following additional features:
Feature |
Description |
|---|---|
Dangerous Goods |
You can ship Dangerous Goods or Hazardous material using DHL eCommerce. Select the option in Other Shipping Options in the Order Details and select the type of goods from the drop-down menu. This will print the appropriate warnings on the label.  ImportantYour DHL eCommerce account must be enabled by DHL to ship Dangerous Goods. Please contact your account representative if you are unsure your account is enabled for shipping dangerous goods. |
USPS tracking number associated with a DHL-created label (International Shipments) |
DHL eCommerce uses the USPS for the US domestic part of the journey and the local postal service in the destination country to make the final delivery. Use the DHL tracking number to track your package with USPS and through the DHL eCommerce site. |
An End-of-Day Driver Summary Manifest is REQUIRED for both Domestic & International Shipments |
DHL eCommerce requires a printed EOD form for their drivers to collect at pickup. See Close and Print Shipments for instructions on how to print EOD forms in ShipStation. |
DHL eCommerce Domestic will not display rates in ShipStation unless the Rating API is activated for your DHL account.
DHL eCommerce supports 1 label message only. You must use Label Message 3.
Labels can and will appear differently when they ship to different destinations. This is because shipments go to different DHL eCommerce stations to be sorted by destination.
DHL eCommerce does not support printing store logos on labels.
All DHL eCommerce shipments must be closed out, manifested, and printed through ShipStation using our End of Day forms process.
Here are some common issues, potential causes, and troubleshooting tips.
Issue |
How to troubleshoot or resolve |
|---|---|
Error: The requested Special Service Codes AA is not available. Please make sure data entered is valid before proceeding or contact our customer service. |
What it means: You have likely selected non-supported options for your DHLX shipments. This error likely indicates that incorrect Other Shipping Options are being used. What to do: See the Label Options section of the Available Shipping Options by Carrier help article to confirm which options are supported. Or, try removing the options one by one to see which option is causing the error. Then proceed with the shipment without selecting that option. |
Error message: Product Finder is not available from DHL for this account. Please contact your DHL account manager. |
Your DHL eCommerce account does not have the Rating API enabled. Contact your DHL account manager and request this be enabled for you. |
|
Duplicate Tracking Numbers Tracking numbers created in the seller will always be unique. However, if one DHL eCommerce account (with the same pickup number) is connected to a different ShipStation account, duplicate tracking numbers can occur. |
To prevent this from happening, create a new DHL eCommerce sub-account to generate a new unique pickup number. When you connect your DHL eCommerce account to the secondary ShipStation account, use the unique pickup number for the new sub-account. If you aren't sure how to do this, contact DHL eCommerce directly to help set up the sub-accounts (or potentially add multiple pickup numbers to one account). |
DHL Express Error Message: "The destination country code XX could not be found. Please check the destination country code." |
The country code is not valid in DHL’s system. This is common for very small countries that may have multiple country codes. For example, Curacao has an ISO address country code CW, but DHL is looking for ‘XC’ as the country code. Use this DHL Shipping Guide to find out if a country needs a DHL-specific country code. |