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.
Enter your Account number - your DHL eCommerce pickup account number.
Click Save to finish.
That is the only value we need. You do not need a DHL API key or password: DHL issues API credentials to the integrating software provider rather than to the shipper, so Zonos authenticates with its own credentials and sends your account number as the account DHL bills.
Your account number is on your DHL eCommerce contract and in the DHL portal. If you cannot find it, contact your DHL eCommerce account representative.
2
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.
DHL also has to enable your account for API access through Zonos. This is a one-time step on DHL's side, separate from your account number. If your first label is rejected with a message about the accounts provided being invalid, that step has not been completed yet - contact your DHL eCommerce representative and ask them to enable your account for use with Zonos.
3
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.
Test your shipping - Confirm rates return as expected before going live.
4
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 account number without calling DHL to verify it, so an incorrect account number - or an account DHL has not yet enabled for API access through Zonos - is reported when you create your first label rather than when you save the form.
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.
If you connect carrier accounts programmatically rather than through Dashboard, use the carrierAccountConnect mutation with the DHL_ECOMMERCE carrier code.
1{
2"input":{
3"carrierCode":"DHL_ECOMMERCE",
4"rateType":"NEGOTIATED",
5"credentials":[
6{
7"type":"ACCOUNT_NUMBER",
8"value":"your_pickup_account_number"
9}
10]
11}
12}
DHL eCommerce requires one credential type:
ACCOUNT_NUMBER - your DHL eCommerce pickup account number
No API key or password is sent. Zonos authenticates with its own DHL credentials and uses your account number to tell DHL which account to bill.
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.
Labels
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.
Connect your DHL eCommerce account to Zonos
That is the only value we need. You do not need a DHL API key or password: DHL issues API credentials to the integrating software provider rather than to the shipper, so Zonos authenticates with its own credentials and sends your account number as the account DHL bills.
Your account number is on your DHL eCommerce contract and in the DHL portal. If you cannot find it, 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.
DHL also has to enable your account for API access through Zonos. This is a one-time step on DHL's side, separate from your account number. If your first label is rejected with a message about the accounts provided being invalid, that step has not been completed yet - contact your DHL eCommerce representative and ask them to enable your account for use with Zonos.
Enable your DHL eCommerce service levels
Connecting the account does not enable any service levels on its own. To start quoting and shipping:
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 account number without calling DHL to verify it, so an incorrect account number - or an account DHL has not yet enabled for API access through Zonos - is reported when you create your first label rather than when you save the form.
Supported service levels
dhl_ecommerce.parcel_direct_audhl_ecommerce.dhl_parcel_international_directdhl_ecommerce.dhl_parcel_international_direct_LAXdhl_ecommerce.dhl_parcel_international_direct_ORDdhl_ecommerce.packet_plus_international_standarddhl_ecommerce.packet_standarddhl_ecommerce.smartmail_parcel_plus_expeditedWhich 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
carrierAccountConnectmutation with theDHL_ECOMMERCEcarrier code.{"input": {"carrierCode": "DHL_ECOMMERCE","rateType": "NEGOTIATED","credentials": [{"type": "ACCOUNT_NUMBER","value": "your_pickup_account_number"}]}}DHL eCommerce requires one credential type:
ACCOUNT_NUMBER- your DHL eCommerce pickup account numberNo API key or password is sent. Zonos authenticates with its own DHL credentials and uses your account number to tell DHL which account to bill.
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
Was this page helpful?