Connecting DHL Express

allverto creates DHL Express shipments via the official MyDHL API. Billing is via your DHL Express account number – you bring your own contract.

#Before you start

• a DHL Express customer account with a 9-digit account number,
• access to the MyDHL API: sign in at developer.dhl.com, choose DHL Express – MyDHL API and click Get Access. DHL Express reviews the request and sends you the API key and API secret (separate for test and live operation).
• a Phone number in the sender address – DHL Express requires it.
• for destinations outside the EU: Customs tariff number and Country of origin in the items (Shipping & customs).

#Step by step

1. Open Shipping → Settings → Carriers and fill in the Sender address including phone.
2. Click Connect carrier and choose DHL Express.
3. Choose the Default product: Express Worldwide (goods worldwide), Express Worldwide EU, Express Worldwide documents, Express 12:00, Express 9:00 or Express Domestic (within Germany).
4. Enter the DHL Express account number as well as the API key and API secret.
5. Choose the Label format: PDF or ZPL for thermal printers.
6. Click Test login – allverto requests a rate Berlin → Bonn for this – and then Connect.

#Labels and customs

For the label, allverto transmits weight, recipient and – outside the EU – goods value, customs tariff number, country of origin and quantity of each line. DHL Express uses this to create the commercial invoice; with a PDF label it is attached as an additional page. With ZPL you retrieve the invoice in the MyDHL portal.

#Requesting a pickup

1. On the account's card, open Manage → Request pickup.
2. Choose the Day, Ready from, Latest by, the number of Parcels, the total weight and where the parcels are located.
3. Click Book pickup. The confirmation number then appears on the card.

You cancel a booked pickup via the × next to the pickup.

#Cancelling

The MyDHL API doesn't support cancelling shipments. If you cancel a shipment in allverto, it is marked as cancelled on our side; then simply don't hand over the parcel – DHL Express doesn't charge for shipments that weren't handed over.

#Test mode

With API access, test mode uses the DHL Express test environment (the labels are invalid). Without credentials, allverto simulates the service with sample labels.

#Frequently asked questions

#“DHL Express rejects the login”

API key or secret is wrong, or you entered test credentials for live operation (or vice versa).

#“DHL Express needs the sender's phone number”

Enter a phone number under Sender address.

#“For domestic shipments please choose DHL Express Domestic”

Express Worldwide is intended for shipments abroad. Within Germany, use Express Domestic.