Connect your DHL eCommerce account to Zonos
-
Go to Zonos Dashboard -> Settings -> Rates.
-
Click Add carrier.
-
Select DHL eCommerce.
-
Enter your DHL eCommerce account information as follows:
- API key - your DHL eCommerce client ID.
- API password - the password paired with that client ID.
- Account number - your DHL eCommerce pickup account number.
-
Click Save to finish.
DHL issues these during your onboarding. If you do not have them, contact your DHL eCommerce account representative.
Use the correct account number
The Account number field is your DHL eCommerce pickup account, which is the account DHL bills for each shipment. Enter the account that belongs to your business.
Zonos uses this same account as the sold-to account. If DHL has told you to bill a different account than the one you ship on, contact Zonos support before you begin shipping so we can configure it for you.
Enable your DHL eCommerce service levels
Connecting the account does not enable any service levels on its own. To start quoting and shipping:
- Create shipping zones - Shipping zones let you offer different service levels and rates to different countries.
- Enable DHL eCommerce service levels - Turn on the service levels you ship in each zone.
- Test your shipping - Confirm rates return as expected before going live.
Create your first label
Create a label the same way as any other carrier - see Create a label.
Run one test shipment as soon as you connect the account. Zonos stores your DHL eCommerce credentials without calling DHL to verify them, so an incorrect client ID, password, or account number is reported when you create your first label rather than when you save the form.
Supported service levels
| Service level↕ | Code↕ |
|---|---|
| DHL eCommerce AU Parcel International Direct | dhl_ecommerce.parcel_direct_au |
| DHL Parcel International Direct - EWR | dhl_ecommerce.dhl_parcel_international_direct |
| DHL Parcel International Direct - LAX | dhl_ecommerce.dhl_parcel_international_direct_LAX |
| DHL Parcel International Direct - ORD | dhl_ecommerce.dhl_parcel_international_direct_ORD |
| DHL Packet Plus International Standard | dhl_ecommerce.packet_plus_international_standard |
| DHL Packet Standard | dhl_ecommerce.packet_standard |
| DHL Smartmail Parcel Plus Expedited | dhl_ecommerce.smartmail_parcel_plus_expedited |
Which of these you can ship depends on what DHL has enabled on your account. If a service level you expect is missing from your zones, or a label is rejected for an unsupported product, contact your DHL representative to confirm what your account is entitled to.
Connect via API
If you connect carrier accounts programmatically rather than through Dashboard, use the carrierAccountConnect mutation with the DHL_ECOMMERCE carrier code.
{ "input": { "carrierCode": "DHL_ECOMMERCE", "rateType": "NEGOTIATED", "credentials": [ { "type": "API_KEY", "value": "your_client_id" }, { "type": "API_PASSWORD", "value": "your_password" }, { "type": "ACCOUNT_NUMBER", "value": "your_pickup_account_number" } ] }}DHL eCommerce requires the following credential types:
API_KEY- your DHL eCommerce client IDAPI_PASSWORD- the password for that client IDACCOUNT_NUMBER- your DHL eCommerce pickup account number
For the full mutation, response shape, and error examples, see Connect via API. Unlike DHL Express, connecting a DHL eCommerce account does not make a test rating call, so the mutation succeeds as long as the credential types are valid.
Next steps
- Create a label - Generate labels on your connected account
- DDP coverage - See supported DDP countries for DHL and DHL eCommerce
- Label errors - Troubleshoot a failed label
DHL eCommerce labels
Create DHL eCommerce labels on your own carrier account.Connect your DHL eCommerce account to Zonos Dashboard and create DHL eCommerce shipping labels directly from your shipments, on your own account and your own negotiated pricing.
This guide covers connecting the account, enabling the service levels you ship, and creating your first label.