Skip to main content

How to set up DHL Express

DHL Express’s integration with Starshipit allows you to use all of Starshipit's features including generation of packing slips and shipping labels, auto-correction of addresses, branded tracking and notifications and many more.

This article outlines how to set up DHL Express as a courier service in Starshipit.

Before you begin

You need your: 

  • DHL Account Number
  • XML-PI username
  • XML-PI password

If you don't have these credentials, please contact with your DHL account number, or contact your DHL account manager explaining that you need XML-PI access to use Starshipit.

If you use BBX (Break Bulk Express), you'll need to request DHL to whitelist you for using XML-PI for it. See also DHL Express Break Bulk Express (BBX) Setup.

Setting up your DHL Express in Starshipit

1. Enter your DHL credentials in Starshipit

  1. Go to Settings > Couriers > Add Courier > DHL Express.
  2. Check the Enable DHL checkbox.
  3. Fill in your account number, username, and password.
  4. Click Save.


2. Set up your product codes

Add your product codes to complete the integration.

  1. Click Add new product codes.
  2. Fill in details as required.
  3. Click Add.

NOTE: The most common product code for DHL Express is WPX for international and DOM for domestic.

3. Order DHL labels

To order DHL labels (100*200) request a supply here.

4. Commercial Invoices & Archive Waybills

International shipments sent via DHL Express require a Commercial Invoice and a Archive Waybill (label) to be supplied with the shipment. The Commercial Invoice should be attached to package and the Archive Waybill is to be given to the DHL driver.

In most cases DHL will approve your account to be setup with a service called Paperless Trade.

Paperless Trade allows the Commercial Invoice and Archive Waybill to be uploaded electronically to DHL instead of being printed.

If you are setup with Paperless Trade in Starshipit, then you will only receive a single DHL label. This is all that is required for international shipments. Alternatively, if you are not approved to use Paperless Trade you will always receive a single DHL label, Commercial Invoice and Archive Waybill.

Some countries do not support Paperless Trade. When you create a shipment to a country which does not support Paperless Trade, Starshipit will automatically supply you with a Commercial Invoice and Archve Waybill.

To enable Paperless Trade:

  1. Contact your DHL account manager to confirm you are approved to use Paperless Trade.
  2. In your Starshipit account, go to Settings, then select Couriers.
  3. Select Settings, next to DHL Express.
  4. Under the Advanced tab, tick the option Paperless Trade.
  5. Scroll to the very bottom of the page, and click Save.

Optional: Adding custom information to the commercial invoice

If you have information you would like to include on the commercial invoice which only applies in certain scenarios, you can use the rules engine.

  1. Go to Settings > Rules > Create a new Rule
  2. For the condition, select when you would like it to apply (For example Destination Country contains US)
  3. For the action, select "Set Invoice Declaration Text" and then enter what you would like to include
  4. Click Save

The commercial invoice will now include this on the invoice like so:



1) Error: "Please provide a package description"

In Settings > Options > Package Description, provide a general description of your products (e.g. Clothing, Cosmetic Product, Swimwear).

2) Error: "The system could not verify your shipping account number. Please correct this number and resubmit. For assistance call your DHL customer services representative."

Contact your DHL account manager because there is an issue with your DHL account.


Other relevant information for you:

For more information on DHL Express WayBills, click here



Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.