1. Home
Log a Case

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.

If you want to use the latest version of DHL for tracking you also need to register on DHL Developers, and create an app for Tracking and then enter the API Key you see into the API section of the preference creation.

If you are wanting to upload PLT documents after shipment creation then you will need to request to be part of this invitation only API. Please contact your DHL account manager for help with this.

How to Test

If you don't have your live credentials available during implementation phase, Zenkraft can provide test credentials. Please log a case and we will provide test credentials to test with!

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

References

It is possible to add shipment or package level references to your DHL Express shipping label, and even to barcode the reference on the shipping label.

The shipment level reference is called Customer Reference.

This can be added in the Shipment Wizard:

Or mapped from the Custom Address Source:

The package level references can be added to the Reference field in the wizard

or mapped from the custom address source.

Example of a DHL Express label with the barcoded reference:

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.
NOTE: Due to the current geopolitical situation, although Norther Ireland is technically part of the UK, it is still considered to be in the EU.
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
  • Quantity Unit
  • Value
  • Weight
  • Country of Manufacture
  • Harmonised Code

You can map the Quantity Unit from the Custom Address Source.

Some of the most common quantity units are: Boxes (box), Each (2no), No Unit Required (x)

Sender/Recipient VAT and EORI number

If Sender or Recipient VAT number and/or EORI number are required for international shipping, those can be filled in the wizard before the Shipment is created or mapped from the custom address source.

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.

However, bear in mind that these documents will transmit to DHL.

Commercial Invoice

Commercial Invoices are generated automatically by DHL. However, please bear in mind that you need to select a service type that supports the CI generation. For example, Express Worldwide D if for documents (no commercial value, no CI), while Express Worldwide P is for products (commercial value, CI generated).

You can see more about commercial invoices in our International Documents guide.

DHL Express specific field mappings can be added under Specific Carrier Fields in the Custom Address Source.

  • DHL Express: Signature Name
  • DHL Express: Signature Title
  • DHL Express: Export Reason
  • DHL Express: Export Reason Code - Permanent (permanent), Temporary (temporary), Re-Export (re_export)
  • DHL Express: Terms of Payment
  • DHL Express: Terms of Trade - Ex Works (EXW), Free Carrier (FCA), Carriage Paid To (CPT), CFR Cost and Freight (CFR), Carriage and Insurance Paid to (CTP), CIF Cost, Insurance and Freight (CIF), Deliver at Terminal (DAT), Deliver at Place (DAP), Delivery Duty Paid (DDP), FAS Free Alongside Ship (FAS), Delivered at Frontier (DAF), Delivery Duty Unpaid (DDU), Delivered Ex Quay (DEQ), Understanding Delivered Ex Ship (DES), Split Duty-VAT (DVU), Delivered at Place Unloaded (DPU)
  • DHL Express: Add Decl Text - place to map declaration text, character limit: 255
  • DHL Express: Add Decl Text 2 - place to map declaration text, character limit: 140
  • DHL Express: Add Decl Text 3 - place to map declaration text, character limit: 140

EEI/AES filing

For international shipments from the US over $2500 in value an AES citation needs to be submitted. For more details please read the DHL Internal Transaction Number guide on EEI/AES filing.

Payer of GST/VAT

This information is only transmitted if the shipment is sent to Australia or New Zealand.

Upload Documents

DHL allows uploading documents such as your own documents to attach to the DHL shipment. Documents can include things such as commercial invoice or certificates of origin . Zenkraft offer this functionality via an invocable method called "Upload ETD".

Once your shipment has been created, you can then utilize the invocable method via a process builder to upload your documents.

The documents need to be stored on your original object, so for example if you are shipping from an Order object, you need to store the files that you would like to upload on the Order object under the Notes and Attachments or the Files related list.

Below is an example of the process builder that you can set up:

  • Salesforce Object Id - specify the salesforce ID of the object that holds the files to be uploaded.
  • Attachment Or File - specify File or Attachment, depending on how you store your objects.
  • SoQL Condition - specify the criteria to choose the files to upload. You might have a situation where you store other files but only want to upload the PDF documents. An example value you could use is : FileType= 'PDF'
  • Tracking Number - please specify the tracking number that needs to uploaded to.
  • Custom Address Source Id - please specify the custom address source Salesforce id that was used to create this shipment.
  • Preference ID - please specify the Preference Salesforce ID that was used for this shipment.

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

Description Values
ZPL2
  • ZPL2__8X4_thermal
  • ZPL2__6X4_thermal
PDF
  • PDF__8X4_A4_PDF
  • PDF__8X4_A4_TC_PDF
  • PDF__8X4_CI_PDF
  • PDF__6X4_A4_PDF
  • PDF__6X4_PDF
  • PDF__8X4_PDF
EPL2
  • 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.

I received an invalid address error in the application. How can I check if DHL delivers to this location?

DHL provides an address checker solution on their site. If an address comes back as invalid in the application, DHL advises to validate if services are available on their capability tool.

Is it common for DHL shipping labels to have the Customer Name repeated twice, when a Company is not available?

Yes, confirmed by DHL "That is correct, the individuals name will need to be populated into the Company Name field."

Is it possible to removal the WayBill document on the DHL shipping label?

Not at this point - Waybills are automatically created for all shipments out of the EU to facilitate the duty process.

I am not getting a commercial invoice for Northern Ireland when shipping from the EU

Due to the current geopolitical situation (Brexit), although Northern Ireland is technically part of the UK, it is still considered to be in the EU. As EU-EU shipments are considered domestic, therefore no CI is generated for Northern Ireland.

Back to Top