DHL eCommerce (US)

DHL eCommerce is a cost-effective delivery service for eCommerce merchants. ShipEngine’s integration with DHL eCommerce allows users to create domestic labels as well as international labels destined for any country in DHL's extensive delivery network. For international shipments, ShipEngine automatically generates and submits your customs documentation.

This article includes:


Connection Requirements:

To add your DHL eCommerce (formerly DHL Global Mail) account to ShipEngine, you'll first need to reach out to your DHL account rep to get the following information regarding your account.

  • Client ID
  • API Username
  • API Password
  • Pickup Account Number
  • Rating API Client ID and Secret (if you wish to view rates with ShipEngine)
  • Distribution Center

Connect a DHL eCommerce Account to ShipEngine

To add your DHL eCommerce account to ShipEngine:

  1. Once you have this information from DHL, log in to ShipEngine and go to the Connections page.
  2. Select Add a Carrier.
  3. Select DHL eCommerce from the options. 
  4. Fill in your DHL account information on the page that appears. 
  5. Click Connect.
  6. Generate a sample label for each of the services you will be utilizing to complete the setup process.
  7. Submit a manifest back to DHL for these generated labels. When you have completed this step, your DHL eCommerce account will be fully connected and ready to use!

Available Features

Common ShipEngine Features:



Domestic Shipping


International Shipping


Electronic Customs Submission


Return Labels


Estimated Rates


Carrier Insurance




Automatic Tracking


End of Day (Electronic)



End of Day (PDF)


Label Branding


Label Messages


Multi-package Shipping



Shipping Options:

Domestic Services

DHL SmartMail Parcel Ground

DHL SmartMail Parcel Plus Ground

DHL SmartMail Parcel Plus Expedited

DHL SmartMail BPM Ground

DHL SmartMail BPM Expedited

DHL SM Marketing Parcel Expedited

DHL SM Marketing Parcel Ground


International Services

DHL Globalmail Packet IPA

DHL Globalmail Packet ISAL

DHL Globalmail Packet Plus

DHL Globalmail Packet Priority

DHL Globalmail Packet Standard

DHL Parcel Direct International Expedited - DDP

DHL Parcel Direct International Expedited - DDU

DHL Parcel Direct International Priority - DDP

DHL Parcel Direct International Priority - DDU

DHL Parcel International Priority

DHL Parcel International Standard


Package Options



Confirmation Options



Additional Features:



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 our documentation for instructions on how to print EOD forms in ShipEngine.

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.


Integration Notes

Remember these points about ShipEngine's integration with DHL eCommerce:

  • DHL eCommerce Domestic will not display rates in ShipEngine unless the Rating API is activated.
  • Labels can and will appear differently when they ship to different destinations. Because shipments go to different DHL eCommerce stations to be sorted by destination, their labels will look differently depending on the shipment destination.
  • Does not support messages or store logos on labels.
  • Shipments generated through our direct DHL eCommerce must be closed out and manifested through ShipEngine. See our Create Manifests article to learn more.




What do I need to do if DHL says my mail is on hold?

If you receive a notice from DHL Global Mail that says "Mail on HOLD at DHL Global Mail" this means you have not electronically transmitted the daily manifest for your DHL shipments. You will need to create a manifest for your DHL labels and download the manifest PDF that is returned.

Please note that when the shipments are manifested, the Ship Date on the Shipments page will update to reflect the date the manifest was submitted.

Why am I not able to create a DHL Global Mail label for a specific service?

If you're getting the error "Failed to retrieve DHL Sort code: Service Type Code provided as input to the request does not match the USPS Product as determined by DHL GM;. Error encountered (Log ID: XXXXX)", this means that your DHL account does not have that specific USPS service enabled by your DHL account.

To fix this, you'll need to contact your DHL representative to make sure that the service is enabled. If your DHL representative says that the service is correctly enabled, please contact our ShipEngine support team so that we can investigate the issue for you.