Calculates the duties, taxes and governmental fees for any international shipment, taking into consideration country de minimis values and preferential tariff rates that may apply. The Duty and Tax Calculator API does not provide shipping rates, but instead uses the shipping rate charged to the consignee as an input.
Any carrier, not just DHL, and have a Worldwide scope.
Free 30-day trial
Get immediate access and 30 days of free calculations (API calls).
With this API you can provide and charge your customers an estimated, pre-payable amount for duty and tax charges. Alternatively, you can calculate an amount for informational purposes if you choose not to collect it at time of order completion, so that they know at a minimum how much will be charged upon delivery.
Collecting the estimated amount ensures a streamlined post-purchase journey. Additionally, local currency is supported for the returned duty & tax estimations should you request a different output currency from the input currency. However, a payment provider of your choice may already be doing this for you (along with your product prices and shipping costs).
The correct HS Codes will ensure a more accurate estimation displayed at checkout. You can also manage your own pricing strategy by collecting the maximum, minimum, average at the 6-digit, 4-digit and 2-digit HS code level. Exact pricing strategy is supported, however you must have the full >6-digit code which can differ for each country. Only at the 6-digit level are they standardized across all countries in the World Trade Organization.
To sign up and acquire credentials for using the DHL Duty and Tax Calculator API, or to receive more information about our offerings, please check the get access section.
This API offers Duty and Tax Calculation, including foreign exchange conversion where necessary, for shipments from any country and to any country (must be different) in the supported countries list.
The following operations are allowed in the DTC API:
|Create Duty & Tax Quote||POST||/dtc/v1/quotes|
Using The API
The API has been designed for use by developers. You will need basic knowledge of REST APIs, JSON, and HTTPS.
To Get Access to the API please verify the different processes in the User Guide section.
To have access to Duty and Tax Calculator please follow the following steps:
- Click in Get Access on top right of your screen
- Choose the DTC subscription that better fits your business
- Enter your payment details
- You immediately find the ClientID and Secret on the admin are of the Developer Portal
- Start the integration!
The following objects are utilized in the Duty and Tax Calculator API request and response.
|pricingStrategy||Required this will determine which rate to use if no exact match is found or there are multiple rates that apply to the first 6 digits provided|
|senderAddress: state||optional for Canada and Brazil only, can be left blank for all other countries|
|senderAddress: country||Required Should be the ISO-2 digit code i.e. US, CA, GB, AE, IN|
|consigneeAddress: state||Required for Canada and Brazil only, can be left blank for all other countries|
|consigneeAddress: country||Required Should be the ISO-2 digit code i.e. US, CA, GB, AE, IN|
|freightCharge: value & currency||Required||Can be a flat rate hardcoded or can be passed on from another rating API. This is recommended as some countries calculate duties and taxes on the freight value as well. Can be any currency on the list of supported currency, subject to exchange rate fluctuation.|
|outputCurrency||Required||Can be any currency on the list of supported currency, subject to exchange rate fluctuation.|
|clearanceMode||Required||Courier is a carrier like DHL- if it is a DDP shipment it must say COURIER. Also accept POST, however postal carriers do not accept DDP shipments so this calculated amount should not be collected from shopper, but only shown for informational purposes should your webstore require it. i.e. COURIER = collect estimated duty and tax amount from shopper and ship DDP with desired carrier, POSTAL = do not collect estimated duty and tax amount from shopper and ship DDU with postal carrier. This can be presented on the screen as "approximate amount that could be due upon delivery".|
|endUse||Required||PERSONAL, which could be a B2C or C2C shipment. BUSINESS = B2B. GIFTS also accepted, but not recommended as each country has paperwork that needs to accompany the shipment to qualify for the reduction in applied duties and taxes.|
|transportMode||Required||Typically AIR is used, but could be OCEAN or GROUND depending on network set up of the carrier that would ship this item.|
|itemId||Required||MUST BE UNIQUE when different SKUs/items i.e. 1, 2, 3, 4. Can be 1 to 20 numerical characters. Read as a string.|
|HS code||Required||Suggest to provide at least the first 6 digits of the commodity code - standardized across all countries in the WTO. After 6 digits, it becomes country-specific. Can include spaces, hyphens and periods. The API engine will strip these. Example: 2106.90|
Weight & Volume Units
|Unit Of Measure||Description|
|ML||milliliter must be provided for beverages, especially alcoholic|
|L||liter must be provided for beverages, especially alcoholic|
|T||ton must provide for mass-imports i.e. logging, fuel, cars, heavy machinery|
Dimensional Units - for the actual product on a singular level
|Unit Of Measure||Description|
De minimis - Low Value Thresholds
Exempting duties & taxes at varying declared values upon import. A customs duty de minimis value (or VAT de minimis value) is the minimum threshold which an imported good's value must exceed in order to incur customs (or VAT) charges.
Canadian Provinces REQUIRED
|NEWFOUNDLNAD AND LABRADOR||NL|
|PRINCE EDWARD ISLAND||PE|
Brazilian Provinces REQUIRED
|MATO GROSSO DO SUL||MS|
|RIO DE JANEIRO||RJ|
|RIO GRANDE DO NORTE||RN|
|RIO GRANDE DO SUL||RS|
Duty & Tax Supported Countries & Currencies
|Country Code||World Atlas Country Name||Currency Code|
|AE||United Arab Emirates||AED|
|AG||Antigua and Barbuda||XCD|
|BA||Bosnia and Herzegovina||BAM|
|CD||Democratic Republic of the Congo||CDF|
|CF||Central African Republic||XAF|
|IM||Isle of Man||GBP|
|KN||Saint Kitts and Nevis||XCD|
|KR||Korea, Republic of||KRW|
|LA||Lao People's Democratic Republic||LAK|
|LY||Libyan Arab Jamahiriya||LYD|
|MF||Saint Martin (French part)||EUR|
|MK||Macedonia,the Former Yugoslav Republic of||MKD|
|PG||Papua New Guinea||PGK|
|PM||Saint Pierre and Miquelon||EUR|
|ST||Sao Tome and Principe||STN|
|TC||Turks and Caicos Islands||USD|
|TF||The French Southern and Antarctic Lands||EUR|
|TT||Trinidad and Tobago||TTD|
|TZ||United Republic of Tanzania||TZS|
|VC||Saint Vincent and the Grenadines||XCD|
|VG||British Virgin Islands||USD|
|VI||US Virgin Islands||USD|
|WF||Wallis and Futuna||XPF|
International Destinations Restricted
|Belarus, Cuba, Iran, North Korea, Russia, Sudan, Somalia, Ukraine, Yemen, Syria||Due to U.S. Government trade embargos, the API does not currently support any facilitation of importation to any of these countries. Most carriers will not ship, so be sure to prohibit at time of checkout to avoid returned shipments|
Specifics for the use of duty and tax calculator API:
- Definitions The terms "You" and "Your" means you personally (if you are an individual user) or the legal entity you represent (if your registration is on behalf of an entity). In the event that You represent a legal entity, You warrant that You can legally bind the legal entity that You represent. The term "DHL" means Global Mail, Inc. dba DHL eCommerce Solutions. The term "Service Data" means the data that You provided to DHL.
- Duty and Tax Calculator Service Description
The Duty and Tax Calculator Service is a service to support You to identify associated duty and tax rates and other government fees, as part of estimated landed cost calculations. Duty and Tax Calculator Service is based on the product information that You provide. The Duty and Tax Calculator Service is intended as an estimate and illustration in the checkout process e.g. in a merchant's online web store, in a way that enables the end user to make a rough assessment of landed costs. The parties are in particular aware that the estimated duty and tax calculations do not constitute offers by DHL to conclude a transportation contract. The Duty and Tax Calculator Service cannot be used for customs entry purposes or any other submission to a government and You agree that You will seek the advice of a licensed customs broker in the applicable country on the proper tariff classification of the subject items for customs entry and any other required governmental purposes. Duty and Tax Calculator Service is not a tool to prepare products for shipment or that provides restricted party screening or corroboration with trade requirements. Duty and Tax Calculator Service does not replace any thorough research on and review of respective data of specific products, including corroboration of items against harmonized tariff codes and export compliance requirements. Duty and Tax Calculator Service does not replace the need for any insurance and the respective risk assessment by the user's insurance provider. Duty and Tax Calculator Services are solely offered to business customers.
- Duty and Tax Calculator Service Agreement
The Duty and Tax Calculator Service is provided to You by DHL and is subject to these Duty and Tax Calculator Service terms and conditions (referred to as Duty and Tax Calculator Service T&Cs for the remainder of the document). By registering for the Duty and Tax Calculator Service, or requesting the Duty and Tax Calculator Service and transmitting the information from Your product catalogue, You agree that You are entering a legally binding agreement with DHL. The Duty and Tax Calculator Service T&Cs explain DHL's obligations to You and Your obligations to DHL for the Duty and Tax Calculator Service. When You use the Duty and Tax Calculator Service or permit someone else to use the Duty and Tax Calculator Service, these Duty and Tax Calculator Service T&Cs govern exclusively such Duty and Tax Calculator Services or actions.
- Access to the Duty and Tax Calculator Service
You agree to keep your Duty and Tax Calculator Service account access information, including your client ID, client secret and authorization token, confidential, to safeguard it and your computer(s) from access by others. You are responsible for any use of the Duty and Tax Calculator Service made under your client ID. If You become aware of or suspect any unauthorized use of Your Duty and Tax Calculator Service account, or any known or suspected security breach such as disclosure or loss of Your account access information or theft of Your Duty and Tax Calculator Service account information, You should notify DHL promptly at DHLeC_FLC_Product_Management@dhl.com.
- Fees and Payment
Fees may be applicable and You agree to pay to DHL for each API call to the Duty and Tax Calculator Service a fee as applicable. DHL may increase the fees at any time by means of a general notice.
- Information provided by You, Your obligations
You are responsible for the completeness and accuracy of the information and data You submit to DHL. You will provide applicable shipping values such as freight and insurance to DHL in order to calculate taxes, duties, and other government fees of the fully landed costs. Any information related to shipping values from any carrier including DHL does not reflect the actual freight charges paid by you to any carrier through separate agreements, but rather a fixed set shipping rate as provided by You to consumers i,e; free shipping for orders of a certain value, or a set fee for expedited shipping or other values depending on the different modes of transportation. DHL does not have any access to freight rates actually paid by You to other carriers. Restricted and prohibited commodities need to be managed by You. You are responsible for identifying all restricted products within the catalog and ensuring that You can provide all of the required documentation and licenses for each market the products will be shipped to. DHL will not assume any merchant/exporter of record risk on behalf of the merchant. You are responsible for taking any and all measures required to back up and secure the Service Data and Duty and Tax Calculator Service on Your devices. The Service Data You submit when using Duty and Tax Calculator Services are subject to DHL's Privacy Notice. You shall be solely responsible for the specific use and integration of Duty and Tax Calculator Services provided to You when using Duty and Tax Calculator Services. It shall be Your exclusive responsibility to observe statutory regulations, particularly those involving customs laws, export control, VAT, and consumer protection.
All texts, graphics, user interfaces, databases, trademarks, logos, and computer code ("Content") including but not limited to the design, structure, selection, expression, "look and feel", and arrangement of such Content in the Duty and Tax Calculator Services is owned or licensed by DHL and is protected by copyright and trademark laws and other intellectual property rights. Except as expressly provided in these Duty and Tax Calculator Service T&Cs, no part of the Duty and Tax Calculator Services and no Content may be copied, reproduced, republished, uploaded, transmitted or distributed in any way to any other computer, server, website or other medium for publication or distribution, without DHL's express prior written consent. Any information or code acquired by You via the Developer Portal and/or other resources provided by Deutsche Post AG, DHL and/or another affiliated company of Deutsche Post AG must be treated as confidential and cannot be disclosed to any third party.
- Duty and Tax Calculator Service and Service Data License, Indemnification
DHL grants to You a non-exclusive, non-transferable, non-sublicensable, worldwide, revocable right and license for the duration of the use of the Duty and Tax Calculator Services, i.e. for the term of the Duty and Tax Calculator Service Service Agreement, for Your personal use or for use by the entity You represent for the purpose of calculating landed duty costs. DHL grants You the unrestricted, worldwide, sublicensable and transferable right to use the Service Data for the purposes as agreed in these Duty and Tax Calculator Service T&Cs. This Right includes the right to any commercial exploitation, publication, development and reproduction. DHL, however, does not grant You the right to use this data for customs entries or the preparation of customs entries or other government filings. You agree that you will not use this data in any filings with any government agency without first confirming the tariff classification with applicable experts in the importing country. You also agree to indemnify DHL in the event that You use this data to file any document with a government agency and the government pursues penalty actions against DHL.
- Use restrictions, DHL´s rights
You may terminate Your use of the Duty and Tax Calculator Service, i.e. the Duty and Tax Calculator Service Agreement at any time. DHL may suspend or terminate Your use of the Duty and Tax Calculator Service if You fail to comply with these Duty and Tax Calculator Service T&Cs or in other appropriate circumstances, including for convenience or in cases where DHL determines Your use of the Duty and Tax Calculator Service is incompatible with our services, in all cases with no liability to You. You, however, agree that the indemnification provisions of paragraph 14 and Your obligation to not use tariff classification data for filing any documentation with government agencies will survive termination of the Duty and Tax Calculator Service Agreement.
You accept that the information used to provide the Duty and Tax Calculator Service is subject to regular updates and changes and is therefore time-sensitive and may change frequently. Furthermore, You accept that the information and data used to provide Duty and Tax Calculator Services are provided by third parties that are not under direct control of DHL. You authorize DHL to provide Your Service Data to these third parties to provide this service. DHL will use commercially reasonable efforts to ensure the correctness of the Duty and Tax Calculator Service. It is Your responsibility to check the Duty and Tax Calculator Service for completeness and accuracy and to check the extent to which the Duty and Tax Calculator Service is appropriate to achieve landed duty cost calculations. You understand that the tariff classification data received most likely does not meet Your standard of care as an importer and that You may be required to obtain tariff classification advice from a customs expert in a particular country. DHL is not a customs expert in the country or countries where it is providing tariff classifications. YOUR USE OF THE DUTY AND TAX CALCULATOR SERVICE IS AT YOUR OWN RISK, AND YOU ACKNOWLEDGE THAT THE DUTY AND TAX CALCULATOR SERVICES AND THE DUTY AND TAX CALCULATOR SERVICE PRODUCT ARE PROVIDED ON AN "AS IS" AND "AS AVAILABLE" BASIS. TO THE FULL EXTENT PERMISSIBLE BY APPLICABLE LAW, DHL DISCLAIMS ALL WARRANTIES, EXPRESS AND IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A SPECIFIC PURPOSE, AND NON-INFRINGEMENT. DHL DISCLAIMS ANY WARRANTY ON THE ACCURACY OF THE TARIFF CLASSIFICATION DATA IN THE DUTY AND TAX CALCULATOR SERVICE PRODUCT AND ANY WARRANTY THAT THE SERVICE MEETS YOUR STANDARD OF CARE AS AN IMPORTER. DUTY AND TAX CALCULATOR SERVICE IS NOT WARRANTED TO BE UNINTERRUPTED OR ERROR-FREE. DHL IS NOT LIABLE FOR ANY INABILITY TO ACCESS OR DELAY IN ACCESSING DUTY AND TAX CALCULATOR SERVICE DUE TO UNAVAILABLE OR UNRELIABLE TELECOMMUNICATIONS NETWORKS OR INTERNET SERVICE PROVIDERS, INCOMPATIBLE EQUIPMENT OR SOFTWARE YOU USE FOR SUCH ACCESS, OR OTHER CAUSES BEYOND DHL'S CONTROL.
In no event will DHL be liable for any indirect, special, consequential, incidental, punitive or exemplary damages (including but not limited to loss of business, loss of revenue, loss of profits, loss of goodwill, lost opportunity, business interruption, or loss of information) arising out of Your use of or inability to use the Duty and Tax Calculator Service, even if DHL has been advised of the possibility of such damages. WHILE DHL ENDEAVOURS TO PROVIDE ACCURATE AND CURRENT INFORMATION VIA THE DUTY AND TAX CALCULATOR SERVICE, DHL CANNOT GUARANTEE THAT THE DUTY AND TAX CALCULATOR SERVICE WILL BE FREE FROM ERRORS. DHL'S MAXIMUM LIABILITY, AND YOUR EXCLUSIVE REMEDY WITH RESPECT TO ANY ERRORS IN DUTY AND TAX CALCULATOR SERVICES PROVIDED TO YOU UNDER THESE DUTY AND TAX CALCULATOR SERVICE T&CS IS LIMITED TO THE FEE YOU PAID (IF ANY) FOR THE ERRONEOUS TRANSACTION. THE LAWS OF CERTAIN COUNTRIES OR STATES DO NOT ALLOW LIMITATIONS ON IMPLIED WARRANTIES OR THE EXCLUSION OR LIMITATION OF CERTAIN DAMAGES.
You agree to indemnify, defend and hold harmless DHL and DHL's affiliates, subsidiaries, directors, officers, employees, and agents from all claims, losses, damages, liabilities and costs (including reasonable attorney's fees) resulting from Your use of Duty and Tax Calculator Service and/or Your failure to comply with the Duty and Tax Calculator Service T&Cs.
After you have logged in to https://developer.dhl.com page, select User Dashboard on the top right and click on Subscriptions to go to the billing screen
In the Next billing screen, you have a choice to cancel the plan.
If you wish to cancel your subscription, you may confirm the same on the next screen
- Initial release