DHL eCommerce (US and Canada)

ShipEngine’s integration with DHL eCommerce allows you to create domestic labels (US accounts only) as well as international labels (US and Canada accounts) for shipments from the US and Canada.

For international shipments, ShipEngine automatically generates and submits your customs documentation.

If you'd like to open a DHL eCommerce account, contact your DHL representative to request a quote and begin the DHL eCommerce certification process.

Looking for DHL eCommerce Australia?

ShipEngine offers a separate DHL eCommerce integration for Australia-based accounts. Please see our DHL eCommerce (AU) help article for details.

This article contains:

DHL eCommerce Requirements

Connection Requirements:

Contact your DHL account representative if you do not have any of the following information.

  • An active account with DHL eCommerce

  • Client ID

  • Client Secret

  • Sold To Account Number (optional)

  • Pickup Account Number

  • Distribution Center Name

Manifest Requirements:

  • DHL eCommerce requires a printed manifest for each day's shipments. To manifest your shipments, use ShipEngine's End of Day process.

Connect DHL eCommerce to ShipEngine

To connect your DHL eCommerce account to ShipEngine:

  1. Select the DHL eCommerce tile.

    DHL Ecommerce logo
  2. Fill in your DHL account information on the page that appears.

  3. Click Connect.

Available Features for DHL eCommerce

Feature

Supported?

Domestic Shipping

US accounts: Green checkmark. Supported feature. Yes.

CA accounts: Red X mark. Unsupported feature. No.

International Shipping

Green checkmark. Supported feature. Yes.

Electronic Customs Submission

Red X mark. Unsupported feature. No.

Return Labels

Red X mark. Unsupported feature. No.

Estimated Rates

Green checkmark. Supported feature. Yes.

Carrier Insurance

Red X mark. Unsupported feature. No.

Tracking

Green checkmark. Supported feature. Yes.

Automatic Tracking

Red X mark. Unsupported feature. No.

End of Day (Electronic)

*Required

Green checkmark. Supported feature. Yes.*

End of Day (PDF)

Red X mark. Unsupported feature. No.

Label Branding

Red X mark. Unsupported feature. No.

Label Messages

Green checkmark. Supported feature. Yes.

Multi-package Shipping

Red X mark. Unsupported feature. No.

Additional Features for DHL eCommerce

ShipEngine's integration with DHL eCommerce allows for the following additional features:

Feature

Description

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

US Int'l Shipments only:

A USPS tracking number associated with a DHL-created label.

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.

DHL eCommerce Services & Package Types

The following services are available for US-based and Canada-based DHL eCommerce accounts.

US Domestic Services:

  • DHL SmartMail Parcel Ground

  • DHL SmartMail Parcel Plus Ground

  • DHL SmartMail Parcel Expedited

  • DHL SmartMail Parcel Plus Expedited

  • DHL SmartMail BPM Ground

  • DHL SmartMail BPM Expedited

  • DHL SM Marketing Parcel Expedited

  • DHL SM Marketing Parcel Ground

US Return Services:

  • DHL SmartMail Parcel Return Light

  • DHL SmartMail Return Plus

  • DHL SmartMail Parcel Return Ground

US International Services:

  • DHL Globalmail Packet IPA

  • DHL Globalmail Packet ISAL

  • DHL Globalmail Packet Standard

  • DHL GlobalMail Business IPA

  • DHL Parcel International Priority

  • DHL Parcel International Expedited - DDP

  • DHL Parcel International Expedited - DDU

  • DHL Parcel International Direct - DDP

  • DHL Parcel International Direct - DDU

  • DHL Parcel International Standard

  • DHL Packet International

  • DHL Packet Plus International

Canada International Services:

  • DHL Packet International

  • DHL Packet Plus International

  • DHL Parcel International Standard

  • DHL Parcel International Direct Priority

  • DHL Parcel International Direct Standard

Package Types (US & CA):

  • Package

  • Custom Packages

Confirmation Options (US & CA):

  • Delivery

Domestic ShippingInternational ShippingElectronic Customs SubmissionReturn LabelsEstimated RatesCarrier InsuranceTrackingAutomatic TrackingEnd of Day (PDF)Label BrandingLabel MessagesMulti-package Shipping

Notes About the DHL eCommerce Integration

  • DHL eCommerce Domestic will not display rates in ShipEngine unless the Rating API is activated.

  • DHL eCommerce supports 1 label message. You must use the "reference3" field in your label request body.

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

  • Shipments generated through our direct DHL eCommerce must be closed out and manifested through ShipEngine. See our Create Manifests page to learn more.

Troubleshooting Tips

Here are some common issues, potential causes, and troubleshooting tips.

Issue

How to troubleshoot or resolve

Received a notice 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.

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.

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

Domestic ShippingInternational ShippingElectronic Customs SubmissionReturn LabelsEstimated RatesCarrier InsuranceTrackingAutomatic TrackingEnd of Day (PDF)Label BrandingLabel MessagesMulti-package Shipping