# DHL Express integration

> Book DHL Express shipments over the MyDHL API when a forwarded trip is confirmed — labels, waybill numbers and customs invoices on the consignment, tracking back on the stops.

**Category:** Parcel & express carriers

## What is DHL Express?

DHL Express is DHL’s time-definite international courier service, delivering documents and parcels door to door in more than 220 countries and territories. Business customers book and follow shipments in MyDHL and connect their own software through the MyDHL API — the interface Transportial uses.

## What syncs between DHL Express and Transportial

- **Consignments → DHL Express shipments** (To DHL Express): When a trip forwarded under a capacity contract that uses the DHL Express integration is confirmed, each of its consignments is booked as a DHL Express shipment. Shipper and receiver come from the first load and last unload, the pieces from the goods with weight and dimensions, and the consignment number is the reference. Planners can also book a single consignment by hand and pick the product.
- **Label, waybill number and customs invoice** (Into Transportial): The label — PDF, or ZPL for thermal printers — and the waybill number are stored on the consignment. For shipments that need customs clearance, DHL’s commercial invoice is saved next to it.
- **Customs data from the goods** (To DHL Express): International shipments that need customs clearance carry a declaration built from the goods: description, quantity, weight, value, HS code and origin country, with the incoterm. Shipments within the EU customs union and document products go without one.
- **Courier pickup (optional)** (To DHL Express): Switch on courier pickup and DHL is asked to collect each shipment when it is booked, with the end of the loading window as the latest pickup time. Canceling the trip cancels that pickup.
- **Tracking, ETA and stop completion** (Into Transportial): Every checkpoint DHL reports is shown on the shipment with the status and the estimated delivery. The first pickup event completes the loading stop and delivery completes the unloading stop, at the time DHL recorded them.
- **Shipments booked elsewhere** (Into Transportial): Add any DHL Express waybill number to a consignment to follow it in Transportial. Numbers booked under another DHL account can be tracked through the DHL Shipment Tracking – Unified API once you add its key.

## How to connect DHL Express

1. Parcel carriers are switched on per platform: ask us to enable them for your Transportial account.
2. Request MyDHL API access from DHL Express. You get an API key and secret that work with your own DHL Express account number.
3. Add the DHL Express integration in Transportial: enter the key and secret, your account number, the default product and the label format (PDF or ZPL). You can start in DHL’s test environment.
4. Set a capacity contract’s communication method to this integration. Trips forwarded under that contract are booked at DHL Express as soon as you confirm them.

## Sync frequency and limits

- Shipments are booked when the trip is confirmed; consignments added to a confirmed trip later are booked on its next update. A consignment is never booked twice with the same integration.
- Open tracking numbers are checked every 60 minutes by default — the interval is set per integration — until the shipment is delivered, returned or canceled.
- MyDHL tracks up to ten waybill numbers per call.
- The MyDHL API cannot cancel a shipment: an unused waybill is simply never handed to DHL. Only a courier pickup booked with it is canceled.

## Typical use case

A forwarder sends urgent spare parts from Rotterdam to customers in the UK, Switzerland and the US. The shipments are planned on a trip under a DHL Express capacity contract; on confirmation every shipment gets its waybill, label and commercial invoice, and DHL is asked to collect them that afternoon. Customer service follows the checkpoints on the shipment, and the delivery stop closes itself when DHL reports the parcel delivered.


## Frequently asked questions

### Can I cancel a DHL Express shipment from Transportial?

The MyDHL API has no cancellation for shipments. A waybill that is never handed to DHL does not ship; if a courier pickup was booked with it, Transportial cancels that pickup when the trip is canceled.

### Does Transportial book DHL Express pickups?

Only if you switch on courier pickup on the integration: DHL is then asked to collect each shipment when it is booked. Otherwise hand the parcels over at your regular DHL pickup or a DHL service point.

### Which DHL Express products can I book?

Express Worldwide, Express 12:00, 10:30 and 9:00, Economy Select, Express Envelope and the domestic Express products. Without a choice, Express Worldwide is used abroad and Express Domestic at home; planners can pick another product per shipment.

### Can Transportial compare DHL Express rates with other carriers?

No. The integration books, labels, cancels pickups and tracks with your own DHL Express account; it does not shop rates across carriers. You choose the carrier through the capacity contract, or by hand on the shipment.


---
Canonical page: https://transportial.com/en-us/integration/dhl-express
