1. Home
Live Chat

DHL Implementation Guide

Introduction

Globally certified DHL solution supporting all regions including Europe, US and Asia. Generate labels, electronic trade documents and special services.

Preferences

To setup a DHL Express preference you need to know your Account Number and Webservice Site ID and Webservice Password. If you do not have these details already please contact your DHL Express representative and they will be able to email you the details.
Alternatively, you can register with DHL XML Services, and DHL will provide you test/production credentials.

Service Types

Service Types Value Description
DOMESTIC EXPRESS 12:00 domestic_express_1200 DHL Domestic Express 12:00: National Express shipping of goods and documents. Domestic door-to-door delivery before 12:00 noon on the next possible business day (only available to specific areas) Copy
B2C 2 b2c2 Parcel shipment to your business customers across Europe Copy
B2C 3 b2c3 Parcel shipment to your consumers across Benelux and Germany Copy
JETLINE jetline Next available flight out and delivery door-to-door to any global destination within the shortest possible time Copy
SPRINTLINE sprintline Next available van or truck delivery door-to-door to any regional destination within the shortest possible time Copy
EXPRESS EASY 7 express_easy_7 Delivery by the end of the next possible working day for shipments handed over at a DHL Service Point Copy
EXPRESS EASY 8 express_easy_8 Delivery by the end of the next possible working day for shipments handed over at a DHL Service Point Copy
EUROPACK 9 europack_9 Europack Shipments Copy
BREAKBULK EXPRESS breakbulk_express DHL Express Breakbulk offers door-to-door consignments that are consolidated in their country of origin and transported from one customs zone to another as a single entity. DHL then deconsolidates the consignments in the destination country for delivery to various addresses within the same country or within the same customs union. Copy
MEDICAL EXPRESS C medical_express_c DHL MEDICAL EXPRESS manages the transportation of time and temperature sensitive shipments for the Life Science industry. The solution comprises the outbound shipping of investigational medicines and clinical supplies to clinics and hospitals, through to the inbound return shipping of patient specimens to laboratories and research organizations. Copy
EXPRESS WORLDWIDE D express_worldwide_d DHL Express Worldwide (doc): International express shipping of non-dutiable shipments outside the EU with delivery before 18:00 on the next possible business day Copy
EXPRESS 9:00 E express_900_e DHL Express 09:00 (nondoc): International express shipping of dutiable shipments with delivery before 9 am in USA, Canada and Mexico (only available to specific areas) Copy
FREIGHT WORLDWIDE freight_worldwide DHL Freight Shipments Copy
DOMESTIC ECONOMY SELECT domestic_economy_select Door-to-door delivery of single or multi-piece shipments and pallets within a certain number of days Copy
ECONOMY SELECT H economy_select_h Door-to-door delivery of single or multi-piece shipments and pallets within a certain number of days Copy
DOMESTIC EXPRESS 9:00 I domestic_express_900_i DHL Domestic Express 09:00: National Express shipping of goods and documents. Domestic door-to-door delivery before 9:00 a.m. on the next possible business day (only available to specific areas) Copy
JUMBO BOX jumbo_box Only for use with Jumbo Box Packaing Types Copy
EXPRESS 9:00 express_900 DHL Express 09:00 (doc): International express shipping of non-dutiable shipments with delivery before 9 am in USA, Canada and Mexico (only available to specific areas) Copy
EXPRESS 10:30 L express_1030_l DHL Express 10:30 (doc): International express shipping of non-dutiable shipments with delivery before 10.30 am in USA, Canada and Mexico (only available to specific areas) Copy
EXPRESS 10:30 M express_1030_m DHL Express 10:30 (nondoc): International express shipping of dutiable shipments with delivery before 10.30 am in USA, Canada and Mexico (only available to specific areas) Copy
DOMESTIC EXPRESS domestic_express DHL Domestic Express: National Express shipping of goods and documents. Domestic delivery by the end of the next possible working day Copy
DOMESTIC EXPRESS 10:30 domestic_express_1030 DHL Domestic Express: National Express shipping of goods and documents. Domestic delivery by 10:30 by the end of the next possible working day Copy
EXPRESS WORLDWIDE P express_worldwide_p DHL Express Worldwide (nondoc): International express shipping of dutiable shipments outside the EU with delivery before 18:00 on the next possible business day Copy
MEDICAL EXPRESS Q medical_express_q DHL MEDICAL EXPRESS manages the transportation of time and temperature sensitive shipments for the Life Science industry. The solution comprises the outbound shipping of investigational medicines and clinical supplies to clinics and hospitals, through to the inbound return shipping of patient specimens to laboratories and research organizations Copy
GLOBALMAIL BUSINESS globalmail_business Your international business correspondence, magazines, newspapers or other regular publications efficiently delivered Copy
SAME DAY same_day DHL Same Day will pick up a shipment of virtually any size or weight and get it to its destination within hours. DHL Same Day features include: Next flight out service to more than 220 countries and territories. Door-to-door service, 24 hours a day, 7 days a week, 365 days a year Copy
EXPRESS 12:00 T express_1200_t DHL Express 12:00 (doc): International express shipping of non-dutiable shipments and documents with delivery before 12 noon (only available to specific areas) Copy
EXPRESS WORLDWIDE U express_worldwide_u DHL Express Worldwide (EU): International express shipping within the EU with delivery before 18:00 on the next possible business day Copy
EUROPACK V europack_v Europack Shipments Copy
ECONOMY SELECT W economy_select_w Door-to-door delivery of single or multi-piece shipments and pallets within a certain number of days Copy
EXPRESS ENVELOPE express_envelope With DHL EXPRESS ENVELOPE you can ensure documents that are not subject to customs processes, up to a weight of 300 grams, are delivered before the end of the working day. All over the world Copy
EXPRESS 12:00 Y express_1200_y DHL Express 12:00 (nondoc): International express shipping of dutiable shipments and documents with delivery before 12 noon (only available to specific areas) Copy

Packaging Types

Packaging Types Value
Jumbo Document jumbo_document Copy
Customer-provided DC - Document customer-provided_dc_document Copy
DHL Flyer dhl_flyer Copy
Domestic domestic Copy
Express Document express_document Copy
DHL Express Envelope FR - Freight dhl_express_envelope_fr_freight Copy
Jumbo box jumbo_box Copy
Jumbo Junior Document jumbo_junior_document Copy
Junior jumbo Box junior_jumbo_box Copy
Jumbo Junior Parcel jumbo_junior_parcel Copy
Other DHL Packaging Pa - Parcel other_dhl_packaging_pa_parcel Copy
Your packaging your_packaging Copy
Jumbo Parcel jumbo_parcel Copy

Special Services

These are special services offered by the carrier which can be selected either during the Shipment creation, or can be defaulted in the Custom Address Source. In this section you can find the most commonly used services.

Duties & Taxed Paid

This checkbox requires a TRUE value.

Paperless Trade

This service allows you to electronically transmit customs documents for Non Document shipments to dutiable destinations i.e. ROW, eliminating the need to print and physically attach them to your shipments. Please note, that PLT designed to provide electronic customs documentation and therefore is not available to EU or Domestic destinations as no customs information is required.
The Paperless Trade checkbox field requires a TRUE value.

International Shipping

In this section you'll find the required or recommended fields and settings for international shipments.

Mandatory fields for Customs items

  • Description
  • Value
  • Weight
  • Gross Weight
  • Country of Manufacture

Sender/Recipient Tax ID

If Sender or Recipient Tax ID is required for international shipping, those can be filled in the wizard before the Shipment is created.

International Transaction Number

Some international shipments might require to include an International Transaction Number. This can be filled in the wizard before the Shipment is created.

Billing and Reference Information

If the duties/taxes are billed to the Recipient, then the below fields must be filled.

Other documents

Any documents not required elsewhere can be uploaded to the Other Documents. These items are not forwarded to DHL.

Hazardous Materials

Settings relating to Dangerous Goods need to be defaulted in the Packages section.

  • Content ID: See below
  • Label Description: standard text field or set a static value
  • Net Weight: standard number field or set a static value
  • UN Code: standard text field or set a static value
Content ID Label Value
Dry Ice UN1845 (411) 901
Ion PI965 Section IA (LiBa) (409) 910
Ion PI965 Section IB (LiBa) (409) 911
Ion PI966 Section I (LiBa with equipment) (409) 912
Ion PI967 Section I (LiBa in equipment) (409) 913
Ion PI965 Section II (LiBa) (613) 965
Ion PI966 Section II (LiBa with equipment) (611) 966
Ion PI967 Section II (LiBa in equipment) (615) 967
Metal PI968 Section IA (LiBa) (409) 930
Metal PI968 Section IB (LiBa) (409) 931
Metal PI969 Section I (LiBa with equipment) (409) 932
Metal PI970 Section I (LiBa in equipment) (409) 933
Metal PI969 Section II (LiBa with equipment) (612) 969
Metal PI970 Section II (LiBa in equipment) (616) 970
Limited quantities to the limits of ADR (614) A01
Excepted quantities in accordance with IATA (203) E01
Biological substances UN3373 (617) 650
Perishable Cargo (n/a) P01
Class 2 Division 2.1 Flammable gas (409) 210
Class 2 Division 2.2 Non-flammable, non toxic gas (409) 220
Class 3 Flammable Liquids (409) 300
Class 4 Division 4.1 Flammable solids (409) 410
Class 4 Division 4.2 Substances liable to spontaneous combustion (409) 420
Class 4 Division 4.3 Substances (Dangerous when wet) (409) 433
Class 5 Division 5.1 Oxidizer (409) 510
Class 5 Division 5.2 Organic Peroxides (409) 520
Class 6 Division 6.1 Toxic Substances (409) 610
Class 8 Corrosives (409) 800
Class 9 Miscellaneous Dangerous Goods (409) 900
Consumer Goods ID8000 (408) 700

Label Formats

Available label formats

ZPL2
  • 8X4_thermal
  • 6X4_thermal
PDF
  • 8X4_A4_PDF
  • 8X4_A4_TC_PDF
  • 8X4_CI_PDF
  • 6X4_A4_PDF
  • 6X4_PDF
  • 8X4_PDF
EPL2

Error Messages

In this section you can find the most common error messages, what they mean and how to solve them.

'No billing address found' when trying to schedule a pickup

Make sure your account number used to schedule the pickup is an account number based in your country. If you are trying to schedule a pickup in the UK, for example, you cannot use a US based account to schedule the pickup. The account you're using to schedule the pickup MUST be based in the UK.

'Response error: DHL Express API cancel is not supported' when trying to cancel a shipment

DHL does not allow shipment cancellation.

Common Questions

In this section you can find our most commonly asked questions regarding this carrier. If you have a question not listed here please contact us.

Will shipments created via Multi Carrier / API show up on MyDHL+?

No. These are two separate systems that are not interlinked so anything made via the API would not show in MyDHL+. It would only show and provide updates for shipments made by that user on the portal.

Does DHL Tracking return estimated delivery dates?

DHL doesn't provide this information via the API. This estimated delivery date is an internal (to DHL) process which they said they can't expose to us at the moment.

How do I enable my customers to use ODD (change delivery date, deliver to a neighbour, etc) ?

This is a contractual service that you need to have on your account. To enable your customer to have this possibility to need to set the notifications section to have your clients email/mobile number populated.

Back to Top