DHL eCommerce is a cost-effective delivery service for ShipStation merchants based in the. US, Canada, Australia, and the UK. ShipStation's direct integration with DHL eCommerce includes international services to all eligible accounts, as well as domestic services for US-based accounts. For international shipments, ShipStation automatically generates and submits your customs documentation.
To request a quote and begin the DHL eCommerce certification process, contact your DHL representative in your country:
-
🇺🇸 DHL US
-
🇨🇦 DHL Canada
-
🇬🇧 DHL UK
Connection Requirements:
-
A ShipStation account based in the US, Canada, Australia, or the UK
-
An active account with DHL eCommerce
-
🇺🇸 🇨🇦 🇬🇧 US, Canada, UK accounts:
-
Account Client ID and Secret (provided by DHL via email)
-
Pickup account number and distribution center name
-
-
🇦🇺 Australia accounts:
-
Account Client ID & password (provided by DHL via email)
-
Sold To account ID and pickup account ID
-
Manifest Requirements:
-
DHL eCommerce requires a printed manifest for each day's shipments. To manifest your shipments, use the ShipStation End of Day process.
🇦🇺 Australia Estimated Rate Requirements
-
🇦🇺 Australia DHL eCommerce accounts have rating disabled by default. To view Estimated Rates in your ShipStation account you will need to have this enabled by your DHL account rep.
-
New accounts, please contact your DHL account rep to have this setting enabled.
-
For accounts with rating already enabled, make sure to uncheck 'skip rates' during setup.
-
To connect your DHL eCommerce account to ShipStation:
-
Contact your DHL account representative and request the following information if you do not already have it:
-
🇺🇸 🇨🇦 🇬🇧 US, Canada, and UK accounts: DHL eCommerce client ID, client secret, pickup number, and distribution center number
-
🇦🇺 Australia accounts: DHL eCommerce pickup account ID, Sold To account ID, shipment identifier prefix, and rating enablement
-
-
Log in to your ShipStation account.
-
Select Add Carrier .
-
Select DHL eCommerce and click Connect.
-
🇺🇸 🇨🇦 🇬🇧 US, Canada, or UK-based accounts: Enter your client Id, secret, and pickup account number. Then, choose a Distribution Center from the drop-down menu.
🇦🇺 Australia-based accounts: Enter your pickup account ID, sold to account ID, and shipment identifier prefix.
To see Estimated Rates in your account uncheck the 'skip rating' box.
-
Select the DHL eCommerce services approved for use with your account (not applicable to Australia-based accounts).
-
Click Connect.
You can now create DHL eCommerce shipping labels in ShipStation.
The ShipStation integration with DHL eCommerce supports the following standard features:
|
Feature |
Supported? |
|---|---|
|
🇺🇸 US accounts: 🇨🇦 🇬🇧 🇦🇺 Canada, UK, Australia accounts: |
|
|
|
|
|
|
|
|
|
|
|
*🇦🇺 Rates must be enabled for Australian Accounts |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
ShipStation integration with DHL eCommerce allows for the following additional features:
|
Feature |
Description |
|---|---|
|
🇺🇸 🇨🇦 🇬🇧 Supports shipping dangerous goods |
For US, Canada, and UK-based accounts, you can ship dangerous goods/hazardous materials using DHL eCommerce services. For accounts based in Australia, the dangerous goods shipping option is not available. Select the option This package contains dangerous goods in Other Shipping Options. Then, select the type of goods from the drop-down menu. This will print the appropriate warnings on the label. ImportantYour DHL eCommerce account must be enabled by DHL to ship dangerous goods. Please contact your account representative if you are unsure if your account is enabled for shipping dangerous goods. |
|
An End-of-Day Driver Summary Manifest is required for all shipments. |
DHL eCommerce requires a printed manifest for their drivers to collect at pickup. See Create Shipment Manifests for instructions on how to print manifests in ShipStation. |
|
Ship From Locations with the same address will be consolidated into one manifest. |
DHL eCommerce requires one manifest per Ship From Location. If you have multiple Ship From Locations that use the same address, all DHL eCommerce shipments will be consolidated into a single manifest for that address. Please note: The addresses in the Ship From Locations must match exactly for the manifests to consolidate properly. For example, if the addresses are technically the same, such as N. Lamar St and North Lamar St, the addresses do not match each other exactly and so will print as separate manifests. |
|
Ancillary Endorsements |
DHL eCommerce allows you to select the following ancillary endorsements on a per-shipment basis. Go to Other Shipping Options in Order Details. You can choose from Forward Service Requested, Change Service Requested, Return Service Requested. |
|
🇦🇺 Bill duties and taxes to payor of shipping charges (DDP) available for cross-border shipments. |
Australia-based accounts: Select Bill duties and taxes to payor of shipping charges to make your shipment DDP (Delivered Duty Paid). Please note: If you select Parcel International Direct Standard (PLT) as your service with this option unchecked, the Incoterm for this shipment will be set as DDU. You may need to contact DHL to enable your account for DDU, if it is not already. |
|
🇺🇸 USPS tracking number associated with a DHL-created label (International Shipments) |
US-based accounts: DHL eCommerce uses the USPS for the US domestic part of the journey and the local postal service in the destination country to make the final delivery. Use the DHL tracking number to track your package with USPS and through the DHL eCommerce site. |
To ensure smooth customs clearance and minimize the risk of shipment inspections or delays, it is critical to provide high-quality data for every international shipment. Poor data quality, specifically vague descriptions and missing HS codes, often triggers manual reviews by destination authorities.
-
Be Literal: Describe the item as if you are explaining it to someone who cannot see it.
-
Include Part Numbers: If your product has a Part Number (PAN), include it in the reference field to help customs verify the item.
-
The "Rule of Three": A great description usually answers What it is, What it's made of, and What it's for.
Customs authorities need to know exactly what is being imported, what it is made of, and its intended use. Avoid using internal marketing descriptions or vague terms.
-
Avoid Stop Words: Words like "Sample," "Variety," or "Gift" are frequently flagged and may trigger an automatic inspection. For a List of Common Stop Words, see the PDF attachment at the end of this article.
-
Include Material Composition: For items like footwear or apparel, specify the materials (e.g., "Men’s jeans, 80% cotton, 20% polyester" instead of just "Jeans").
-
Detail the Product Type: Instead of "VINTAGE FOOTWEAR," use "Women’s shoes - leather upper and rubber sole."
-
Be Specific: Instead of "Wheel adjusted," use "Bicycle rear pivot part."
Providing a correct HS code (or Commodity Code) is the most effective way to help customs officials categorize your goods.
-
🇺🇸 US-Based Shippers: Use the US Census Bureau’s Schedule B Search Engine to find the correct code.
-
Global Shippers: Ensure you are using the most current codes required by the destination country to avoid incorrect duty/tax calculations.
When possible, include the specific part or item number in your commercial invoice data. Mapping these to the correct reference fields in your shipping tool (e.g., the "PAN" reference type) provides an extra layer of clarity for clearance agents and helps verify the item against the provided description.
Using vague language is the fastest way to get a shipment flagged for inspection. Below are examples of poor descriptions found in recent audit data versus the clear, detailed descriptions required by customs authorities. For a List of Common Stop Words, see the PDF attachment at the end of this article.
|
Poor Description (Vague) |
Better Description (Detailed) |
Why it Matters |
|---|---|---|
|
VINTAGE FOOTWEAR |
Women's shoes: leather upper, rubber sole |
Defines gender, material, and sole type. |
|
JEANS |
Men’s jeans: 80% cotton, 20% polyester |
Specifies material composition for textiles. |
|
SAMPLE / VARIETY |
Stainless steel kitchen whisk (K792) |
Stop Words like "Sample" or "Variety" trigger automatic flags. |
|
HAIR PRODUCT |
Organic argan oil hair serum (100ml) |
Identifies the specific substance and volume. |
|
The Mesa - Medium |
Canvas messenger bag with brass buckles |
Moves past marketing names to actual physical traits. |
To ensure your international shipments clear customs without delay, use this checklist to review your data before printing your labels.
-
[ ] Is the description specific? (e.g., "Men's 100% cotton t-shirt" instead of "Apparel")
-
[ ] Did you avoid Stop Words? (Ensure "Sample," "Gift," and "Variety" are not used)
-
[ ] Is the material composition listed? (e.g., "Stainless steel," "Leather," "Plastic")
-
[ ] Is the HS code/Commodity code included? (Use a search tool if you aren't 100% sure)
-
[ ] Is the Part Number (PAN) mapped correctly? (Helps verify the item in the clearance system)
-
[ ] Is the unit value and currency accurate? (Ensure values match your commercial invoice)
When writing descriptions, ignore your marketing names. Customs authorities don't know what a Polaris IGX 144+ Linkage Kit is. Instead, describe the physical object: Steel mechanical linkage parts for vehicle suspension.
When integrating with international carriers, how you map data fields in your API payload directly impacts customs clearance rates. While the UI may show a single "Description" field, the backend mapping should prioritize the following:
-
Reference Field Mapping (PAN)
To assist customs authorities in verifying shipments against digital records, ensure that product part numbers are mapped to the correct reference type.
-
Reference Type: PAN (Part Number)
-
Usage: Map your internal SKU or manufacturer part number here. This allows clearance systems to match the physical item to the digital declaration more efficiently.
-
-
Data Integrity vs. UX Display
It is important to note that what the customer sees in the ShipStation or Shopify UI may not always reflect the full data payload sent to the carrier.
-
Payload Enrichment: Even if a merchant uses a short marketing title in their store, the integration should attempt to send the most granular description available in the product database to the
descriptionfield in the customs object. -
Stop Word Scrubbing: Consider implementing a validation layer that flags or prevents the use of Stop Words (Sample, Gift, Variety) in the
descriptionfield before the API call is finalized.
-
-
HS Code Automation
Automating the
harmonized_tariff_codefield is the highest-value optimization you can provide. Ensuring this field is populated with a 6 to 10-digit code reduces the reliance on the text description alone, as the code provides a universal language for customs agents worldwide.
-
DHL Shipping Unavailable to US Territories: Services for DHL (Express and Ecommerce) and DHL Express by ShipStation no longer support shipments to US territories.
-
All DHL eCommerce shipments must be closed out, manifested, and printed through ShipStation using our End of Day process.
-
DHL eCommerce supports one label message only. You must use Label Message 3.
-
DHL eCommerce does not support printing store logos on labels.
-
Labels can and will appear differently when they ship to different destinations. This is because shipments go to different DHL eCommerce stations to be sorted by destination.
-
DHL is likely to return shipments sent to residential addresses in Russia back to the sender. This is because Russian customs authorities examine all dutiable shipments with extreme scrutiny and there is no guarantee the package will be sent to its destination after inspection. You may wish to use a different carrier for shipments bound for a residential address in Russia.
DHL will deliver shipments to commercial addresses without issue.
-
🇺🇸 🇨🇦 US & Canada accounts: DHL eCommerce Domestic will not display rates in ShipStation unless the Rating API is activated for your DHL account.
-
🇨🇦 Canada accounts: Rating is not available for Canada-based “pick up accounts” using DHL eCommerce API V4.
-
🇦🇺 Australia accounts:
-
DHL eCommerce Australia does not support shipping dangerous goods. Learn how DHL eCommerce Australia defines Prohibited and Restricted Goods.
-
The Ship From address is not displayed on DHL eCommerce shipping labels.
-
If you cannot view rates in ShipStation, check with your DHL account rep if you have rating is enabled. If DHL makes a change to your rate settings, please reconfigure the carrier connection in ShipStation.
-
Here are some common issues, potential causes, and troubleshooting tips.
|
Issue |
How to Troubleshoot or Resolve |
|---|---|
|
Error: The requested Special Service Codes AA is not available. Please make sure data entered is valid before proceeding or contact our customer service. |
What it means: You have likely selected non-supported options for your DHL Express shipments. This error likely indicates that incorrect Other Shipping Options are being used. What to do: See the Label Options section of the Available Shipping Options by Carrier help article to confirm which options are supported. Or, try removing the options one by one to see which option is causing the error. Then proceed with the shipment without selecting that option. |
|
Duplicate Tracking Numbers Tracking numbers created in the seller will always be unique. However, if one DHL eCommerce account (with the same pickup number) is connected to a different ShipStation account, duplicate tracking numbers can occur. |
What to do: To prevent this from happening, create a new DHL eCommerce sub-account to generate a new unique pickup number. When you connect your DHL eCommerce account to the secondary ShipStation account, use the unique pickup number for the new sub-account. If you aren't sure how to do this, contact DHL eCommerce directly to help set up the sub-accounts (or potentially add multiple pickup numbers to one account). |
|
Error: The destination country code XX could not be found. Please check the destination country code. |
What it means: The country code is not valid in DHL’s system. This is common for very small countries that may have multiple country codes. For example, Curacao has an ISO address country code CW, but DHL is looking for ‘XC’ as the country code. What to do: Use this DHL Shipping Guide to find out if a country needs a DHL-specific country code. |
|
🇺🇸 🇨🇦 Error: Product Finder is not available from DHL for this account. Please contact your DHL account manager. |
What it means: For US and Canada accounts, your DHL eCommerce account does not have the Rating API enabled. What to do: Contact your DHL account manager and request this be enabled for you. |
|
🇦🇺 🇳🇿 Error: Customer does not have permission on this sold-to account. Status code: 400 |
What it means: For AU/NZ account, your account is not yet added to the Gemini API. What to do: Contact DHL eCommerce at ci-ecom.au@dhl.com and request that they add your account to the Gemini API. |
|
🇦🇺 🇳🇿 Error: Create Label Failed: Destination Country is not supported for selected service product |
What it means: For AU/NZ account, this error most likely means you have configured the shipment with the Parcel International Direct Standard service, not selected the Bill duties and taxes to payor of shipping charges option, and your DHL account is not enable for DDU. What to do: Contact DHL eCommerce AU to add DDU support to your DHL account. |