DHL eCommerce

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:

  • Connect a DHL eCommerce account to ShipEngine
  • Available DHL eCommerce services
  • Troubleshooting

Connect a DHL eCommerce Account to ShipEngine

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
  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.

Generate a sample label for each of the services you will be utilizing to complete the setup process. 

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 DHL eCommerce Services

Domestic Services

 DHL SmartMail Parcel Ground

DHL SmartMail Parcel Plus Ground

DHL SmartMail Parcel Plus Expedited

DHL SmartMail Parcel Expedited

DHL SmartMail BPM Expedited

DHL SmartMail BPM Ground

DHL SM Marketing Parcel Expedited

DHL SM Marketing Parcel Ground

DHL SmartMail Parcel Return Light

DHL SmartMail Parcel Return Plus

DHL SmartMail Parcel Return Ground


International Services 

  DHL Packet International

DHL Globalmail Packet Standard

DHL Packet Plus International

DHL Globalmail Packet IPA

DHL Globalmail Packet ISAL

DHL Parcel International Priority

DHL Parcel International Standard

DHL Parcel International Direct - DDP

DHL Parcel International Direct - DDU

DHL Parcel International Expedited - DDP

DHL Parcel International Expedited - DDU

DHL GlobalMail Business IPA





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.