Overview

This document will cover how to connect your DHL Express account to your ShipperHQ account. In order to connect, you will need to create a DHL API Username and Password. The instructions below will tell you where to go and how to get them. You will then add a DHL Express carrier in ShipperHQ that will use this username and password to connect directly to the DHL API and retrieve live shipping rates.
In addition to DHL Express, ShipperHQ also supports DHL eCommerce. These two services are separate and installed separately within ShipperHQ.
Requirements
Follow these directions to obtain/set-up the necessary credentials and add the DHL Express carrier in ShipperHQ.
Register for DHL Express API credentials
- To obtain the API username and password that is needed, follow the steps provided by DHL on the DHL Express – MyDHL API guide
- When registering please indicate you are using ShipperHQ in the field titled, “Describe the application and business process where XML Services will be used.”
- Once complete, DHL will send a set of production credentials by the next business day to the email address that was entered during the registration.
Adding DHL Express
Now that you have your credentials ready, use the steps below to set up DHL Express in ShipperHQ.
1. Log into your ShipperHQ account & navigate to the Carriers link on the left navigation menu.
2. Click + New to add a new carrier
3. Choose the Live Rate Carrier option
4. Use the Search Carriers option to search for DHL Express or scroll down to find DHL Express from the list of available carriers
5. Click to continue in connecting your carrier account to ShipperHQ.
Steps to Validate This Carrier
1. Enter the following credentials provided by DHL Express
- DHL Express Site ID
- DHL Express Password
- DHL Express Payor Account Number
- DHL Express Unit of Weight
- DHL Express Unit of Measurement
- DHL Express Payor Country

2. Once these details have been entered, blick the Validate button to complete the validation process.
If validation is successful, click the toggle button to enable the DHL Express carrier.
If validation fails, please Contact ShipperHQ Support for further assistance, or review what has been entered for accuracy & attempt to enter your credentials once more.
3. Click the Configure This Carrier button if the validation process was successful.
4. Edit any settings for this carrier then click Save to complete the setup.
5. Your DHL Express carrier is now enabled and ready for configuration.
Configuring DHL Express
VAT-inclusive or -exclusive pricing
A DHL Express carrier can be configured to return prices including a VAT charge. New DHL Express carriers will not include VAT by default. There is a checkbox on the Advanced tab of the carrier to control this, see the below image. Note that the amount returned will be based only on the shipping amount, not on the value of goods in the order.

Import Duties/Taxes Apply Setting
In Account Settings on your DHL Express Carrier, you’ll see the “Import Duties/Taxes Apply to My Products” setting. We recommend leaving this setting checked unless shipping only documents which are not dutiable.
This setting does not add customs duties to the calculation but instead will ensure the services returned are services which support shipment of dutiable products. This means services which are only available for non-dutiable documents will not be returned. In nearly all cases for eCommerce retailers, you will be shipping dutiable items.
Calculating Duties & Taxes that apply to international shipments is supported by the ShipperHQ Duties & Taxes feature which can be used along with DHL Express to calculate and display shipping costs along with all applicable duties & taxes.
Troubleshooting
Your carrier can be installed and configured, but not validated. Successful validation depends on the accurate entry of the account information required by each carrier. If you do not have the correct information you will not be able to validate your carrier and receive live rates.