DHL Express

ShipEngine's integration with DHL Express allows you to ship packages to more than 25 supported countries all over the world. Visit the DHL Express website to open a business account today!

For instructions on programmatically connecting DHL Express via the ShipEngine REST API, go to our DHL Express Guide in the ShipEngine Developer Docs.

Connection Requirements

  • An active account with DHL Express.

  • Your DHL Express Account Number, Site ID, and Password.

    To obtain your Site ID and Password, you must register for the DHL Express XML Developer Portal. Contact your DHL Express Account Manager to register your account for XML Services.

Connect a DHL Express Account to ShipEngine

To connect your DHL Express account in your ShipEngine dashboard:

  1. Select the DHL Express tile for your country. You can hover over each tile to view the country and integration details.

    "DHL Express" is entered in search box of Available Carriers window. Multiple results returned with mouse hovered over each tile to see country details.
  2. Enter your DHL Express Account Number, Site ID, and Password into the corresponding fields.

    US Accounts

    For DHL Express US accounts, you must select your Account Country. This is the country where your DHL Express account is registered in.

  3. Click Connect.

Available Features for DHL Express Integration

ShipEngine's integration with DHL Express supports these standard features:

DHL Express Services

ShipEngine's integration with DHL Express supports the following services:

US

Domestic Service:

  • Domestic Express

International Services:

  • Economy Select

  • Express Worldwide

  • Express Worldwide Documents

  • Express Worldwide EU

  • Express Envelope

Australia

International Services:

  • Express Worldwide Dutiable

  • Express Worldwide Non-Dutiable

Canada

International Services:

  • Economy Select

  • Express Worldwide

  • Express Worldwide Documents

  • Express 9:00

  • Express 9:00 Documents

  • Express 10:30

  • Express 10:30 Documents

  • Express 12:00

  • Express 12:00 Documents

UK

Domestic Services:

  • Domestic Express

  • Domestic Express 9:00

  • Domestic Express 12:00

International Services:

  • Economy Select

  • Economy Select EU

  • Express Worldwide

  • Express Worldwide Documents

  • Express Worldwide EU

  • Express 9:00

  • Express 9:00 Documents

  • Express 10:30

  • Express 10:30 Documents

  • Express 12:00

  • Express 12:00 Documents

Additional Features

The DHL Express integration provides the following additional features:

Feature

Description

Paperless Trade (PLT)

ShipEngine will automatically try to submit customs information electronically through the DHL Express PLT service.

If ShipEngine is not able to submit customs information through PLT (either because it's not enabled for your DHL Express account or because the destination country does not support PLT), you must instead print any necessary customs forms to include with your shipments.

Third-Party and Recipient billing

You can bill a third-party or recipient DHL Express account using Advanced Options.

Schedule Pickup

You can use the Schedule Pickup endpoint to book pickups with DHL Express.

The carrier can be used to create domestic shipping labels.

The carrier can be used to create international shipping labels.

ShipEngine will submit international customs declarations electronically to the carrier.

The carrier can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Shipment insurance, provided by the shipment's selected carrier, can be added to the shipment in ShipEngine. This insurance would be in addition to any default coverage already provided by that carrier.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

This carrier can be used to create multi-package shipments, where multiple labels are created for a single shipment and the individual packages are linked together in a single shipment record with a master tracking number.

You can connect this carrier to ShipEngine multiple times using different accounts and choose which account will be used to create each shipment.

Notes About the DHL Express Integration

  • Shipping to the Republic of Ireland: As of July 2, 2023, the inclusion of the correct Eircode (Postal Code) for shipments entering the Republic of Ireland (ROI) is mandatory on all DHL Express shipments. Learn more about and look up Eircodes on the Eircode website.

  • The maximum weight for an Express Envelope shipment (US accounts) is 10 oz, and you must use DHL's branded envelope packaging.

  • DHL Express UK manifests are not submitted automatically. You must use the Create a Manifest endpoint to manifest your DHL Express UK shipments.

  • When you use the multi-package shipping option, there is a limit of 99 packages with a maximum total weight of 2200 lb (1000 kg).

  • DHL Express requires a Company Name in both the Ship To and Ship From address fields. If no Company Name is available, ShipEngine will reuse the Name field.

  • ShipEngine will combine all three Label Messages into a message that will display as Ref #1 on the DHL Express shipping label.

  • ShipEngine does not provide the required EEI/ECCN for shipments sent to China, Russia, Venezuela, or Hong Kong. See the DHL website for more information on US export regulation changes.

  • DHL FEE ADJUSTMENTS: DHL reserves the right to charge adjustments for administrative and other costs. It is the shipper's responsibility to address all DHL shipment fees and subsequent adjustments. To ensure your rates in ShipEngine are accurate, be sure to always enter the true weight and dimensions of all shipments before creating the labels.

Troubleshooting

Issue

Solution

Error - A shipping carrier error occurred: (1) Paperless shipment service is not allowed for one of these reasons: Shipper or receiver\n country doesn't support Paperless Service, the product selected doesn't support Paperless\n or the declared value entered is greater than the allowed limit. Please contact DHL representative\n for further information or resubmit as regular shipment.

What it means: The DHL Express shipment is blocked from processing due to Paperless Trade (PLT) settings. You can still get rates for the shipment even though a label cannot be created.

What to do: Contact ShipEngine Support and ask that we disable your account’s Paperless Trade (PLT) for customs.

I'm getting an error that indicates DHL Express can't find the recipient address when attempting to create labels. What should I do?

Typically these errors will be displayed in one of two ways:

  1. Cannot determine destination service. Check recipient information and resubmit. If this problem reoccurs contact your technical service representative.

  2. The destination country X location postal code Y or City Z is invalid. Please check the destination country location details.

Both of these errors indicate that the recipient address is not formatted properly for DHL Express shipments. Compare the address details using the DHL Compatibility Tool and correct the address where needed.

The carrier can be used to create domestic shipping labels.

The carrier can be used to create international shipping labels.

ShipEngine will submit international customs declarations electronically to the carrier.

The carrier can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Shipment insurance, provided by the shipment's selected carrier, can be added to the shipment in ShipEngine. This insurance would be in addition to any default coverage already provided by that carrier.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

This carrier can be used to create multi-package shipments, where multiple labels are created for a single shipment and the individual packages are linked together in a single shipment record with a master tracking number.

You can connect this carrier to ShipEngine multiple times using different accounts and choose which account will be used to create each shipment.