# For Marketplace ## Duty & Taxes calculation thanks to a product's HSCODE `POST` `https://api.transiteo.io/v1/taxsrv/dutyCalculation` This endpoint allows you to calculate landest cost for a product HSCode. #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ---------------- | | Content-type\* | string | application/json | | Authorization\* | string | "your id\_token" | {% tabs %} {% tab title="200 Ok Response" %} ``` { "products": [{ "identification": { "value": string, "type": string }, "product_statut": "Autorisé à l'importation dans ce pays", "amount_exclusive": 1080, "amount_inclusive_vat": 1290.74, "amout_duty_and_tax": 239.9, "amount_total": 1319.9, "percentage_duty_and_tax": 0.22213, "duty": { "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "vat_taxes_amount": number, "agreement": string }, "vat": [{ "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number }], "special_taxes": [{ "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "vat_taxes_amount": number, "agreement": string }], "duty_fees":{ "amount": number } }], "shipping_global": { "duty": { "label": string, "percentage": number, "amount": number, "vat_taxes_amount": number, "agreement": string }, "vat": [{ "label": string, "percentage": number, "amount": number }], "special_taxes": [{ "label": string, "percentage": number, "amount": number, "vat_taxes_amount": number, "agreement": string }] }, "duty_fees_global": { "amount": number }, "global": { "amount": number } } ``` {% endtab %} {% tab title="400: Bad Request " %} ```javascript 1. value in json is not recognized or incorrect a) Possible causes : Lang is required and should be fill with one of these values from_country should be ISO3 to_country should be ISO3 shipment_type should be one of these values global_ship_price is not a number currency_global_ship_price not string and has more than 3 char if pro : currency_revenue_country_annual should be string with max 3 char revenue_country_annual should be number activity_id should be string ReqProduct : identification : type identification should be fill with one of these values value should not be empty weight should be positive number weight_unit should be one of these values unit (optional) should be number if unit unit_types should be one of these values quantity should be min 1 unit_price should be positive unit_ship_price or global ship price should be a number currency_unit_price should be max 3 char if not global_ship_price Transport type should be fill with one of these values id should not be empty b) Error Response Example: { "code": "INCORRECT_JSON", "httpCode": 400, "name": "ClientError", "message": "Requête Json incorrecte", "details": [ { "parameter": { "name": "Product", "value": { "value": "TEXT", "type": "Voiture de sport" } }, "causes": [ "[\"quantity must not be less than 1\",\"quantity must be an integer number\"]" ] } ] } 2. Invalid HSCODE (hscode has whitespace) a) Response { "code": "INCORRECT_JSON", "httpCode": 400, "name": "ClientError", "message": "This is not a valid hs17 code", "details": [] } 3. Not a barcode { "code": "NOT_BARCODE", "httpCode": 400, "name": "ClientError", "message": "This is not a valid barcode", "details": [] } ``` {% endtab %} {% tab title="403: Forbidden " %} ```javascript 1. Max requests exceed { "code": "MAX_REQUESTS_EXCEED", "httpCode": 403, "name": "ClientError", "message": "You've reached the max requests authorized for your account. Please contact our service to upgrade your account", "details": [ { "parameter": { "name": "UserRequests", "value": "${leftCredits}" }, "causes": [ "Max requests authorized for your account is ${capacity}. Left credits is ${leftCredits}" ] } ] } 2. TRIAL_LIMIT_EXCEED { "code": "TRIAL_LIMIT_EXCEED", "httpCode": 403, "name": "ClientError", "message": "You have exceeded the trial limit. Please contact our service to upgrade your account", "details": [ { "parameter": { "name": "UserTrialLimit", "value": "${validity} days" }, "causes": [ "User trial is limited to ${validity} days of usage" ] } ] } ``` {% endtab %} {% tab title="404: Not Found " %} ```javascript 1. Product.identification.value not found in our system { "code": "PRODUCT_NOT_FOUND", "httpCode": 404, "name": "BusinessError", "message": "Cannot find product with barcode, Hs17, or Text", "details": [ { "parameter": { "name": "product.identification.value", "value": "" }, "causes": [ "productFromClient was not identified in the database" ] } ] } 2. CATEGORY_NOT_FOUND with barcode (Did not find category from CATEGORY_DYNAMO with dynamoProduct.node) { "code": "CATEGORY_NOT_FOUND", "httpCode": 404, "name": "ClientError", "message": "No category data found for categoryCode", "details": [] } 3. Machine Learning did not recognize text (maybee text with special characters or text is a barcode){ "code": "TEXT_NOT_FOUND", "httpCode": 404, "name": "ClientError", "message": "Did not find your text in our database", "details": [] } 4. Duty not found. Happened when both below return nothing : findDuty(toCountry.iso3, `${hsCodeDesignation.reporter_hscode}#${fromCountry.iso3}`) const hs06 = hsCodeDesignation.reporter_hscode.substr(0, 6) findDutyBeginsWithHsCode(toCountry.iso3, hs06, fromCountry.iso3) { "code": "DUTY_NOT_FOUND", "httpCode": 404, "name": "BusinessError", "message": "No duty data found", "details": [] } ``` {% endtab %} {% tab title="500: Internal Server Error " %} ```javascript { "code": "UNEXPECTED_ERROR", "httpCode": 500, "reason": "Please try again or contact our service", } ``` {% endtab %} {% endtabs %} ### All JSON Request fields ``` { "products": [{ "identification":{"type": "HSCODE", "value": string}, "weight": number, "weight_unit": string, "quantity": number, "unit_price": number, "currency_unit_price": string, "unit_ship_price": number, "unit_packaging_price": number, "unit_insurance_price": number, "group_shipping_price": string, "group_packaging_price": number, "group_insurance_price": number, "origin_country": string, "from_country": string, "to_country": string, "to_district": string, "included_tax": boolean, "incoterm": string, "sender": { "pro": boolean, "revenue_country_annual": number, "currency_revenue_country_annual": string }, "duty_fees" : { "percentage": number, "amount" : number, "currency" : string, "on_products_price": boolean, "on_shipping_products_price": boolean, "on_global": boolean } } ], "shipment_type": string, "ecommerce_type": string, "sales_term" : string, "extra_fees": number, "receiver": { "pro": boolean, "activity_id": string } } ```
JSON request format :
For 1 product and 1 product unit + 1 seller ``` { "products": [{ "identification":{"type": "HSCODE", "value": string}, "weight": number, "weight_unit": string, "quantity": number, "unit_price": number, "currency_unit_price": string, "unit_ship_price": number, "unit_packaging_price": number, "unit_insurance_price": number, "origin_country": string, "from_country": string, "to_country": string, "included_tax": boolean, "incoterm": string, "sender": { "pro": boolean, "revenue_country_annual": number, "currency_revenue_country_annual": string }, "duty_fees" : { "percentage": number, "amount" : number, "currency" : string, "on_products_price": boolean, "on_shipping_products_price": boolean, "on_global": boolean } } ], "shipment_type": string, "ecommerce_type": string, "extra_fees": number, "receiver": { "pro": boolean, "activity_id": string } } ```
JSON request format :
For 1 product and more than 2 product units + 1 seller ``` { "products": [{ "identification":{"type": "HSCODE", "value": string}, "weight": number, "weight_unit": string, "quantity": number, "unit_price": number, "currency_unit_price": string, "group_shipping_price": string, "group_packaging_price": number, "group_insurance_price": number, "origin_country": string, "from_country": string, "to_country": string, "included_tax": boolean, "incoterm": string, "sender": { "pro": boolean, "revenue_country_annual": number, "currency_revenue_country_annual": string }, "duty_fees" : { "percentage": number, "amount" : number, "currency" : string, "on_products_price": boolean, "on_shipping_products_price": boolean, "on_global": boolean } } ], "shipment_type": string, "ecommerce_type": string, "extra_fees": number, "receiver": { "pro": boolean, "activity_id": string } } ```
JSON request format :
For more than 2 products and minimum 2 differents sellers ``` { "products": [{ "identification":{"type": "HSCODE", "value": string}, "weight": number, "weight_unit": string, "quantity": number, "unit_price": number, "currency_unit_price": string, "group_shipping_price": number, "group_packaging_price": number, "group_insurance_price": number, "origin_country": string, "from_country": string, "to_country": string, "included_tax": boolean, "incoterm": string, "sender": { "pro": boolean, "revenue_country_annual": number, "currency_revenue_country_annual": string }, "duty_fees" : { "percentage": number, "amount" : number, "currency" : string, "on_products_price": boolean, "on_shipping_products_price": boolean, "on_global": boolean } }, { "identification":{"type": "HSCODE", "value": string}, "weight": number, "weight_unit": string, "quantity": number, "unit_price": number, "currency_unit_price": string, "group_shipping_price": number, "group_packaging_price": number, "group_insurance_price": number, "origin_country": string, "from_country": string, "to_country": string, "included_tax": boolean, "incoterm": string, "sender": { "pro": boolean, "revenue_country_annual": number, "currency_revenue_country_annual": string }, "duty_fees" : { "percentage": number, "amount" : number, "currency" : string, "on_products_price": boolean, "on_shipping_products_price": boolean, "on_global": boolean } } ], "shipment_type": string, "ecommerce_type": string, "extra_fees": number, "receiver": { "pro": boolean, "activity_id": string } } ```
### For others It exist many possibilities. Please [book a call ](https://meetings.hubspot.com/gauthier11/gauthier)with our support team. ### ### Request fields & values #### "products" / "identification" / "type" You need to fill this field with HSCODE. \ \&#xNAN;***Examples :** HSCODE*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes* #### "products" / "identification" / "value" You need to fill this field with a product's HSCode of "to\_country". Between 8 to 13 digits numbers.\ \&#xNAN;***Examples :** 9503006100*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes* #### "products" / "weight" You need to fill the "weight" field of the product with a number.\ \&#xNAN;***Examples :** 12 **or** 3.5*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes* #### "products" / "weight\_unit" You can fill the "weight\_unit" field with one of this two labels : \ \&#xNAN;**- "kg"** : if you use the international metric system\ \&#xNAN;**- "lbs"** : if you use the imperial system\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes* #### "products" / "quantity" You need to fill the "quantity" field with a entire number representing your product units.\ \&#xNAN;***Examples :** 1 **or** 9*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes* #### "products" / "unit\_price" You need to fill the "unit\_price" field with a number representing the price of one item.\ \&#xNAN;***Examples :** 39 **or** 99.90*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes.* #### "products" / "currency\_unit\_price" You need to fill the "currency\_unit\_price" field of the product with a currency iso Alpha 3.\ Download the [list of currencies](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20currency.csv) with them name and code.\ \&#xNAN;***Examples : "**EUR" **or "**CAD"*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes* #### "products" / "unit\_ship\_price" You need to fill the "unit\_ship\_price" field of the product with a number.\ \&#xNAN;***Examples :** 19 **or** 34.37*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes if you fill "shipment\_type" with ARTICLE.* #### "products" / "unit\_packaging\_price" You need to fill the "unit\_packaging\_price" field of the product with a number.\ \&#xNAN;***Examples :** 19 **or** 34.37*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes if you fill "shipment\_type" with ARTICLE.* #### "products" / "unit\_insurance\_price" You need to fill the "unit\_insurance\_price" field of the product with a number.\ \&#xNAN;***Examples :** 19 **or** 34.37*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes if you fill "shipment\_type" with ARTICLE.* #### "products" / "group\_shipping\_price" You need to fill the "group\_shipping\_price" field with a number representing the shipping price of all products.\ \&#xNAN;***Examples :** 39 **or** 99.90*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** Yes if you fill "shipment\_type" with GROUP.* #### "products" / "group\_packaging\_price" You need to fill the "group\_shipping\_price" field with a number representing the packaging price of all products.\ \&#xNAN;***Examples :** 39 **or** 99.90*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** Yes if you fill "shipment\_type" with GROUP.* #### "products" / "group\_insurance\_price" You need to fill the "group\_shipping\_price" field with a number representing the insurance price of all products.\ \&#xNAN;***Examples :** 39 **or** 99.90*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** Yes if you fill "shipment\_type" with GROUP.* #### "products" / "origin\_country" You need to fill the "origin\_country" field with the Iso Alpha 2 or 3 code from where the product had build.\ Download the [list of countries](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20countries.csv).\ \&#xNAN;***Examples : "**FRA" **or "**VEN*"\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** no. If you don't fill this field, we will consider that the country of "origin\_country" is the country of "from\_country".* #### "products" / "from\_country" You need to fill the "from\_country" field with the Iso Alpha 2 or 3 from where the product is sent.\ Download the [list of countries](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20countries.csv).\ \&#xNAN;***Examples : "**CHN*"\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes* #### "products" / "to\_country" You need to fill the "to\_country" field with the Iso Alpha 2 or 3 from where the product arrives.\ Download the [list of countries](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20countries.csv).\ \&#xNAN;***Examples : "**GLP"* \ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes* #### "products" / "to\_district" You need to fill the "to\_district" field with the Iso codes of the district from where the product arrives.\ Download the [list of districts](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20districts.csv).\ \&#xNAN;***Examples : "**AL-11" **or "**FR-GES"*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes if the to\_country is USA, CAN or BRA.* #### "products" / "included\_tax" If you fill with true, we consider that the product(s) price is tax incl. so we will deduct the taxes attached to the departure country from the duties & taxes amount. If you fill with false or no value, we consider that the product(s) price is tax excl.\ \&#xNAN;***Examples :** true **or** false*\ \&#xNAN;***Type :** boolean*\ \&#xNAN;***Required :** yes* #### "products" / "incoterm" 2 choices : if it's CIF, we calcul the duties and taxes on product(s) and shipping price(s). If it's FOB, only on product(s).\ \&#xNAN;***Examples :** CIF **or** FOB*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes (by default fill the field with CIF)* #### "products" / "sender" / "pro" You need to fill the "pro" field with **true** or **false** dependind if the sender is a business company or not.\ \&#xNAN;***Type :** boolean*\ \&#xNAN;***Required :** yes* #### "products" / "sender" / "revenue\_country\_annual" You need to fill the "revenue\_country\_annual" field with a number.\ \&#xNAN;***Examples :** 34560 **or** 234567.98*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes if "sender" / "pro" field is "true" and that "to\_country" field is an european country.* #### "products" / "sender" / "currency\_revenue\_country\_annual" You need to fill the "currency\_global\_ship\_price" field with a currency iso Alpha 3.\ Download the [list of currencies](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20currency.csvhttps://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20currency.csv).\ \&#xNAN;***Examples : "**USD" **or "**AUD"*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes if "sender" / "pro" field is "true" and that "to\_country" field is an european country.* #### "products" / "transit\_fees" / "percentage" You can fill the "percentage" field of your duty fees.\ \&#xNAN;***Examples :** "0.01" **or** "0.3" (0.01 = 1% / 0.3 = 30%)*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** optional* #### "products" / "transit\_fees" / "amount" You can fill the "amount" field of your duty fees.\ \&#xNAN;***Examples :** "10" **or** "29.99"*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** optional* #### "products" / "transit\_fees" / "currency" You can fill the "amount" field of your duty fees.\ \&#xNAN;***Examples :** "10" **or** "29.99"*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** optional (required if you fill* "transit\_fees" / "amount" field ) #### "products" / "transit\_fees" / "on\_products\_price" You have three choices : on\_products\_price / on\_shipping\_products\_price / on\_global\ If on\_products\_price = true, the transit\_fees will be calculated only on the price of product(s).\ **Examples :** "true" **or** "false"\ **Type :** boolean\ **Required :** optional but required if you fill "transit\_fees" / "percentage" or "transit\_fees" / "amount" #### "products" / "transit\_fees" / "on\_shipping\_products\_price" You have three choices : on\_products\_price / on\_shipping\_products\_price / on\_global\ If on\_shipping\_products\_price = true, the transit\_fees will be calculated only on the price of shipping.\ \&#xNAN;***Examples :** "true" **or** "false"*\ \&#xNAN;***Type :** boolean*\ \&#xNAN;***Required :*** optional but required if you fill "transit\_fees" / "percentage" or "transit\_fees" / "amount" #### "products" / "transit\_fees" / "on\_global" You have three choices : on\_products\_price / on\_shipping\_products\_price / on\_global\ If on\_global = true, the transit\_fees will be calculated only on the price of product(s) and the shipping.\ \&#xNAN;***Examples :** "true" **or** "false"*\ \&#xNAN;***Type :** boolean*\ \&#xNAN;***Required :*** optional but required if you fill "transit\_fees" / "percentage" or "transit\_fees" / "amount" #### "from\_country" You need to fill the "from\_country" field with the Iso Alpha 2 or 3 from where the product is sent.\ Download the [list of countries](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20countries.csv).\ \&#xNAN;***Examples : "**CHN*"\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes* #### "to\_country" You need to fill the "to\_country" field with the Iso Alpha 2 or 3 from where the product arrives.\ Download the [list of countries](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20countries.csv).\ \&#xNAN;***Examples : "**GLP"* \ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes* #### "to\_district" You need to fill the "to\_district" field with the Iso codes of the district from where the product arrives.\ Download the [list of districts](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20districts.csv).\ \&#xNAN;***Examples : "**AL-11" **or "**FR-GES"*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes if the to\_country is USA, CAN or BRA.* **"shipment\_type"** *GLOBAL : global shipping / ARTICLE : One ship price per article / GROUP : One ship price for all articles*\ **Type :** string\ **Required:** yes **"ecommerce\_type"** *Marketplace*\ **Type :** string\ **Required:** yes **"sales\_term"** *2 options : "btoc" or "btob"*\ **Type :** string\ **Required:** optional #### "global\_ship\_price" You need to fill the "global\_ship\_price" field with a number. \ \&#xNAN;***Examples :** 450 **or** 3451.87*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes if you fill "shipment\_type" with GLOBAL.* #### "currency\_global\_ship\_price" You need to fill the "currency\_global\_ship\_price" field of the product with a currency iso Alpha 3.\ Download the [list of currencies](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20currency.csv).\ \&#xNAN;***Examples : "**USD" **or "**AUD"*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes if you fill "shipment\_type" with GLOBAL.* #### "global\_packaging\_price" You need to fill the "global\_packaging\_price" field with a number. \ \&#xNAN;***Examples :** 450 **or** 3451.87*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes if you fill "shipment\_type" with GLOBAL.* #### "currency\_global\_packaging\_price" You need to fill the "currency\_global\_packaging\_price" field of the product with a currency iso Alpha 3.\ Download the [list of currencies](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20currency.csv).\ \&#xNAN;***Examples : "**USD" **or "**AUD"*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes if you fill "shipment\_type" with GLOBAL.* #### "global\_insurance\_price" You need to fill the "global\_insurance\_price" field with a number. \ \&#xNAN;***Examples :** 450 **or** 3451.87*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes if you fill "shipment\_type" with GLOBAL.* #### "currency\_global\_insurance\_price" You need to fill the "currency\_global\_insurance\_price" field of the product with a currency iso Alpha 3.\ Download the [list of currencies](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20currency.csv).\ \&#xNAN;***Examples : "**USD" **or "**AUD"*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes if you fill "shipment\_type" with GLOBAL.* #### "included\_tax" If you fill with true, we consider that the product(s) price is tax incl. so we will deduct the taxes attached to the departure country from the duties & taxes amount. If you fill with false or no value, we consider that the product(s) price is tax excl.\ \&#xNAN;***Examples :** true **or** false*\ \&#xNAN;***Type :** boolean*\ \&#xNAN;***Required :** yes* #### "incoterm" 2 choices : if it's CIF, we calcul the duties and taxes on product(s) and shipping price(s). If it's FOB, only on product(s).\ \&#xNAN;***Examples :** CIF **or** FOB*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes (by default fill the field with CIF)* #### "extra\_fees" You can add extra fees to duties & taxes amount. You need to fill the "extra\_fees" field with a number. \ \&#xNAN;***Examples :** 0.02 **or** 0.1 (0.02 = 2% / 0.1 = 10%)*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** optional* #### "sender" / "pro" You need to fill the "pro" field with **true** or **false** dependind if the sender is a business company or not.\ \&#xNAN;***Type :** boolean*\ \&#xNAN;***Required :** yes* #### "sender" / "revenue\_country\_annual" You need to fill the "revenue\_country\_annual" field with a number.\ \&#xNAN;***Examples :** 34560 **or** 234567.98*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** yes if "sender" / "pro" field is "true" and that "to\_country" field is an european country.* #### "sender" / "currency\_revenue\_country\_annual" You need to fill the "currency\_global\_ship\_price" field with a currency iso Alpha 3.\ Download the [list of currencies](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20currency.csvhttps://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20currency.csv).\ \&#xNAN;***Examples : "**USD" **or "**AUD"*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes if "sender" / "pro" field is "true" and that "to\_country" field is an european country.* #### "receiver" / "pro" You need to fill the "pro" field by "**true"** or "**false"** dependind if the receiver is a business company or not.\ \&#xNAN;***Type :** boolean*\ \&#xNAN;***Required :** yes* #### "receiver" / "activity\_id" You need to fill the "activity\_id" field with an activity code.\ Download the [list of companies activities](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20activity.csv).\ \&#xNAN;***Examples :** "0112Z" **or** "7161A"*\ \&#xNAN;***Type :** string*\ \&#xNAN;***Required :** yes if "receiver" / "pro" field is "true".* #### "transit\_fees" / "percentage" You can fill the "percentage" field of your duty fees.\ \&#xNAN;***Examples :** "0.01" **or** "0.3" (0.01 = 1% / 0.3 = 30%)*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** optional* #### "transit\_fees" / "amount" You can fill the "amount" field of your duty fees.\ \&#xNAN;***Examples :** "10" **or** "29.99"*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** optional* #### "transit\_fees" / "currency" You can fill the "amount" field of your duty fees.\ \&#xNAN;***Examples :** "10" **or** "29.99"*\ \&#xNAN;***Type :** number*\ \&#xNAN;***Required :** optional (required if you fill* "transit\_fees" / "amount" field ) #### "transit\_fees" / "on\_products\_price" You have three choices : on\_products\_price / on\_shipping\_products\_price / on\_global\ If on\_products\_price = true, the transit\_fees will be calculated only on the price of product(s).\ **Examples :** "true" **or** "false"\ **Type :** boolean\ **Required :** optional but required if you fill "transit\_fees" / "percentage" or "transit\_fees" / "amount" #### "transit\_fees" / "on\_shipping\_products\_price" You have three choices : on\_products\_price / on\_shipping\_products\_price / on\_global\ If on\_shipping\_products\_price = true, the transit\_fees will be calculated only on the price of shipping.\ \&#xNAN;***Examples :** "true" **or** "false"*\ \&#xNAN;***Type :** boolean*\ \&#xNAN;***Required :*** optional but required if you fill "transit\_fees" / "percentage" or "transit\_fees" / "amount" #### "transit\_fees" / "on\_global" You have three choices : on\_products\_price / on\_shipping\_products\_price / on\_global\ If on\_global = true, the transit\_fees will be calculated only on the price of product(s) and the shipping.\ \&#xNAN;***Examples :** "true" **or** "false"*\ \&#xNAN;***Type :** boolean*\ \&#xNAN;***Required :*** optional but required if you fill "transit\_fees" / "percentage" or "transit\_fees" / "amount" ### All JSON Response fields ``` [ { "products": [ { "identification": { "type": "HSCODE", "value": string }, "product_statut": string, "amount_exclusive": number, "amount_inclusive_vat": number, "amount_duty_and_tax": number, "amount_ecoTax": number, "amount_total": number, "percentage_duty_and_tax": number, "duty": { "label": number, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "message": string, "vat_product_taxes_amount": number, "vat_shipping_taxes_amount": number, "vat_packaging_taxes_amount": number, "vat_insurance_taxes_amount": number, "vat_taxes_amount": number, "agreement": string }, "transit_fees": { "amount": number }, "special_taxes": [{ "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "vat_product_taxes_amount": number, "vat_shipping_taxes_amount": number, "vat_packaging_taxes_amount": number, "vat_insurance_taxes_amount": number, "vat_taxes_amount": number, "message": string }], "vat": [ { "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "message": string } ] } ], "incoterm": string, "extra_fees": { "percentage": number, "amount": number, "currency": string }, "global": { "amount": number, "amount_exclusive": number, "amount_inclusive_vat": number, "amount_total": number, "amount_duty_and_tax": number, "percentage_duty_and_tax": number, "amount_ecoTax": number }, "timestamp": number } ] ```
JSON response format :
For 1 product and 1 product unit + 1 seller ``` [ { "products": [ { "identification": { "type": "HSCODE", "value": string }, "product_statut": string, "amount_exclusive": number, "amount_inclusive_vat": number, "amount_duty_and_tax": number, "amount_ecoTax": number, "amount_total": number, "percentage_duty_and_tax": number, "duty": { "label": number, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "message": string, "vat_product_taxes_amount": number, "vat_shipping_taxes_amount": number, "vat_packaging_taxes_amount": number, "vat_insurance_taxes_amount": number, "vat_taxes_amount": number, "agreement": string }, "transit_fees": { "amount": number }, "special_taxes": [{ "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "vat_product_taxes_amount": number, "vat_shipping_taxes_amount": number, "vat_packaging_taxes_amount": number, "vat_insurance_taxes_amount": number, "vat_taxes_amount": number, "message": string }], "vat": [ { "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "message": string } ] } ], "incoterm": string, "extra_fees": { "percentage": number, "amount": number, "currency": string }, "global": { "amount": number, "amount_exclusive": number, "amount_inclusive_vat": number, "amount_total": number, "amount_duty_and_tax": number, "percentage_duty_and_tax": number, "amount_ecoTax": number }, "timestamp": number } ] ```
JSON response format :
For 1 product and more than 2 product units + 1 seller ``` [ { "products": [ { "identification": { "type": "HSCODE", "value": string }, "product_statut": string, "amount_exclusive": number, "amount_inclusive_vat": number, "amount_duty_and_tax": number, "amount_ecoTax": number, "amount_total": number, "percentage_duty_and_tax": number, "duty": { "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "message": string, "vat_product_taxes_amount": number, "vat_shipping_taxes_amount": number, "vat_packaging_taxes_amount": number, "vat_insurance_taxes_amount": number, "vat_taxes_amount": number, "agreement": string }, "transit_fees": { "amount": number }, "special_taxes": [{ "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "vat_product_taxes_amount": number, "vat_shipping_taxes_amount": number, "vat_packaging_taxes_amount": number, "vat_insurance_taxes_amount": number, "vat_taxes_amount": number, "message": string }], "vat": [ { "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "message": string } ] } ], "incoterm": string, "extra_fees": { "percentage": number, "amount": number, "currency": string }, "global": { "amount": number, "amount_exclusive": number, "amount_inclusive_vat": number, "amount_total": number, "amount_duty_and_tax": number, "percentage_duty_and_tax": number, "amount_ecoTax": number }, "timestamp": number } ] ```
JSON response format :
For more than 2 products and minimum 2 differents sellers ``` [ { "products": [ { "identification": { "type": "HSCODE", "value": string }, "product_statut": string, "amount_exclusive": number, "amount_inclusive_vat": number, "amount_duty_and_tax": number, "amount_ecoTax": number, "amount_total": number, "percentage_duty_and_tax": number, "duty": { "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "message": string, "vat_product_taxes_amount": number, "vat_shipping_taxes_amount": number, "vat_packaging_taxes_amount": number, "vat_insurance_taxes_amount": number, "vat_taxes_amount": number, "agreement": string }, "transit_fees": { "amount": number }, "special_taxes": [{ "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "vat_product_taxes_amount": number, "vat_shipping_taxes_amount": number, "vat_packaging_taxes_amount": number, "vat_insurance_taxes_amount": number, "vat_taxes_amount": number, "message": string }], "vat": [ { "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "message": string } ] } ], "incoterm": string, "extra_fees": { "percentage": number, "amount": number, "currency": string }, "global": { "amount": number, "amount_exclusive": number, "amount_inclusive_vat": number, "amount_total": number, "amount_duty_and_tax": number, "percentage_duty_and_tax": number, "amount_ecoTax": number }, "timestamp": number }, { "products": [ { "identification": { "type": "HSCODE", "value": string }, "product_statut": string, "amount_exclusive": number, "amount_inclusive_vat": number, "amount_duty_and_tax": number, "amount_ecoTax": number, "amount_total": number, "percentage_duty_and_tax": number, "duty": { "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "message": string, "vat_product_taxes_amount": number, "vat_shipping_taxes_amount": number, "vat_packaging_taxes_amount": number, "vat_insurance_taxes_amount": number, "vat_taxes_amount": number, "agreement": string }, "transit_fees": { "amount": number }, "special_taxes": [{ "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "vat_product_taxes_amount": number, "vat_shipping_taxes_amount": number, "vat_packaging_taxes_amount": number, "vat_insurance_taxes_amount": number, "vat_taxes_amount": number, "message": string }], "vat": [ { "label": string, "percentage": number, "product_taxes_amount": number, "shipping_taxes_amount": number, "packaging_taxes_amount": number, "insurance_taxes_amount": number, "message": string } ] } ], "incoterm": string, "extra_fees": { "percentage": number, "amount": number, "currency": string }, "global": { "amount": number, "amount_exclusive": number, "amount_inclusive_vat": number, "amount_total": number, "amount_duty_and_tax": number, "percentage_duty_and_tax": number, "amount_ecoTax": number }, "timestamp": number } ] ```
### For others It exist many possibilities. Please [book a call ](https://meetings.hubspot.com/gauthier11/gauthier)with our support team. ### Response fields & values #### "products" / "identification" / "type" The value is HSCODE\ \&#xNAN;***File type :** string* #### "products" / "identification" / "value" The value is the product's HSCode. A code between 8 and 13 digits.\ \&#xNAN;***File type :** string* #### "products" / "product\_statut" The value is the product's statut : Authorized, Restricted or Prohibited for importation\ \&#xNAN;***File type :** string* #### "products" / "amount\_exclusive" The value is the amount of the product excluding duty and taxes.\ \&#xNAN;***File type :** number* #### "products" / "amount\_inclusive\_vat" The value is the amount of the product including vat taxes.\ \&#xNAN;***File type :** number* #### "products" / "amount\_duty\_and\_tax" The value is the amount of duty and taxes\ \&#xNAN;***File type :** number* #### "products" / "amount\_total" The value is total amount of product including duty and taxes\ \&#xNAN;***File type :** number* #### "products" / "product\_co2" The value is the CO2 weight of 1kg of the product.\ \&#xNAN;***File type :** number* #### "products" / "percentage\_duty\_and\_tax" The value is the percentage of duty and taxes on product's amount.\ \&#xNAN;***File type :** number* #### "products" / "transit\_fees" / "amount" The value is the amount of your carrier transit fees by product. The currency of this amount depends on "currency\_unit\_price".\ \&#xNAN;***Examples :** 16.75 **or** 80*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "label" The value is the label "DUTY"\ \&#xNAN;***File type :** string* #### "products" / "duty" / "percentage" The value is the percentage (%) of custom duties called "DUTY"\ \&#xNAN;***Examples :** 10 **or** 3.5*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "product\_taxes\_amount" The value is the amount of : ("unit\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_price".\ \&#xNAN;***Examples :** 12.87 **or** 20*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "shipping\_taxes\_amount" The value is the amount of : ("unit\_ship\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "packaging\_taxes\_amount" The value is the amount of : ("unit\_packaging\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "insurance\_taxes\_amount" The value is the amount of : ("unit\_insurance\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "vat*\_*product\_taxes\_amount" The value is the amount of : (("unit\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_price".\ \&#xNAN;***Examples :** 12.87 **or** 20*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "vat*\_*shipping\_taxes\_amount" The value is the amount of : (("unit\_ship\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "vat*\_*packaging\_taxes\_amount" The value is the amount of : (("unit\_packaging\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "vat*\_*insurance\_taxes\_amount" The value is the amount of : (("unit\_insurance\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "vat\_taxes\_amount" The value is the amount of vat on "duty" taxes:\ \&#xNAN;***Examples :** 5.39 **or** 21*\ \&#xNAN;***File type :** number* #### "products" / "duty" / "agreement" The value is the agreement name between "from\_country" to "to\_country".\ \&#xNAN;***Examples :** "Preferential tariff for ..."*\ \&#xNAN;***File type :** number* #### "products" / "vat" / "label" The value is the label of VAT tax. It depends on the "to\_country" field in the request.\ \&#xNAN;***Examples :** vat **or** gst*\ \&#xNAN;***File type :** string* #### "products" / "vat" / "percentage" The value is the percentage (%) of VAT tax.\ \&#xNAN;***Examples :** 3 **or** 1.5*\ \&#xNAN;***File type :** number* #### "products" / "vat" / "product\_taxes\_amount" The value is the amount of : ("unit\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 3.45 **or** 2*\ \&#xNAN;***File type :** number* #### "products" / "vat" / "shipping\_taxes\_amount" The value is the amount of : ("unit\_ship\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "products" / "vat" / "packaging\_taxes\_amount" The value is the amount of : ("unit\_packaging\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "products" / "vat" / "insurance\_taxes\_amount" The value is the amount of : ("unit\_insurance\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "products" / "vat" / "message" The message is the VAT, GST, IVA, TVA, ... rule.\ \&#xNAN;***Examples :** No VAT for this company's activity*\ \&#xNAN;***File type :** string* #### "products" / "special\_taxes" / "label" The value is the label of the special tax. It depends on the "to\_country" field in the request.\ \&#xNAN;***Examples :** om **or** omr*\ \&#xNAN;***File type :** string* #### "products" / "special\_taxes" / "percentage" The value is the percentage (%) of the special tax.\ \&#xNAN;***Examples :** 3.1 **or** 1.9*\ \&#xNAN;***File type :** number* #### "products" / "special\_taxes" / "product\_taxes\_amount" The value is the amount of : ("unit\_price" x "products" / "special\_taxes" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 5.45 **or** 8*\ \&#xNAN;***File type :** number* #### "products" / "special\_taxes" / "shipping\_taxes\_amount" The value is the amount of : ("unit\_ship\_price" x "products" / "special\_taxes" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.18 **or** 4*\ \&#xNAN;***File type :** number* #### "products" / "special\_taxes" / "packaging\_taxes\_amount" The value is the amount of : ("unit\_packaging\_price" x "products" / "special\_taxes" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.18 **or** 4*\ \&#xNAN;***File type :** number* #### "products" / "special\_taxes" / "insurance\_taxes\_amount" The value is the amount of : ("unit\_insurance\_price" x "products" / "special\_taxes" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.18 **or** 4*\ \&#xNAN;***File type :** number* #### "products" / "special\_taxes" / "vat*\_*product\_taxes\_amount" The value is the amount of : (("unit\_price*" x "products" / "special*\_taxes*" / "percentage") x "*vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 5.45 **or** 8*\ \&#xNAN;***File type :** number* #### "products" / "special\_taxes" / "vat*\_*shipping\_taxes\_amount" The value is the amount of : (("unit\_ship\_price*" x "products" / "special*\_taxes*" / "percentage") x "*vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.18 **or** 4*\ \&#xNAN;***File type :** number* #### "products" / "special\_taxes" / "vat*\_*packaging\_taxes\_amount" The value is the amount of : (("unit\_packaging\_price*" x "products" / "special*\_taxes*" / "percentage") x "*vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.18 **or** 4*\ \&#xNAN;***File type :** number* #### "products" / "special\_taxes" / "vat*\_*insurance\_taxes\_amount" The value is the amount of : (("unit\_insurance\_price*" x "products" / "special*\_taxes*" / "percentage") x "*vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.18 **or** 4*\ \&#xNAN;***File type :** number* #### "products" / "special\_taxes" / "vat\_taxes\_amount" The value is the amount of vat on "special\_taxes" taxes:\ \&#xNAN;***Examples :** 2.33 **or** 8*\ \&#xNAN;***File type :** number* #### "products" / "special\_taxes" / "message" The message is the specials taxes rule.\ \&#xNAN;***Examples :** No taxes between the from and to country*\ \&#xNAN;***File type :** string* #### "shipping\_global" / "duty" / "label" The value is the label "DUTY"\ \&#xNAN;***File type :** string* #### "shipping\_global" / "duty" / "percentage" The value is the percentage (%) of custom duties called "DUTY"\ \&#xNAN;***Examples :** 10 **or** 3.5*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "duty" / "product\_taxes\_amount" The value is the amount of : ("global\_ship\_price" x "shipping\_global" / "duty" / "percentage"). The currency of this amount depends on "currency\_global\_ship\_price".\ \&#xNAN;***Examples :** 1.87 **or** 20*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "duty" / "shipping\_taxes\_amount" The value is the amount of : ("unit\_ship\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "duty" / "packaging\_taxes\_amount" The value is the amount of : ("unit\_packaging\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "duty" / "insurance\_taxes\_amount" The value is the amount of : ("unit\_insurance\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "duty" / "vat*\_*product\_taxes\_amount" The value is the amount of : (("unit\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_price".\ \&#xNAN;***Examples :** 12.87 **or** 20*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "duty" / "vat*\_*shipping\_taxes\_amount" The value is the amount of : (("unit\_ship\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "duty" / "vat*\_*packaging\_taxes\_amount" The value is the amount of : (("unit\_packaging\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "duty" / "vat*\_*insurance\_taxes\_amount" The value is the amount of : (("unit\_insurance\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "duty" / "vat\_taxes\_amount" The value is the amount of vat on "duty" taxes:\ \&#xNAN;***Examples :** 5.39 **or** 21*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "duty" / "agreement" The value is the agreement name between "from\_country" to "to\_country".\ \&#xNAN;***Examples :** "Preferential tariff for ..."*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "vat" / "label" The value is the label of VAT tax. It depends on the "to\_country" field in the request.\ \&#xNAN;***Examples :** vat **or** gst*\ \&#xNAN;***File type :** string* #### "shipping\_global" / "vat" / "percentage" The value is the percentage (%) of VAT tax.\ \&#xNAN;***Examples :** 3 **or** 1.5*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "vat" / "product\_taxes\_amount" The value is the amount of : ("global\_ship\_price" x "shipping\_global" / "vat" / "percentage"). The currency of this amount depend of "currency\_global\_ship\_price".\ \&#xNAN;***Examples :** 345 **or** 29.99*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "vat" / "shipping\_taxes\_amount" The value is the amount of : ("unit\_ship\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "vat" / "packaging\_taxes\_amount" The value is the amount of : ("unit\_packaging\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "vat" / "insurance\_taxes\_amount" The value is the amount of : ("unit\_insurance\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "vat" / "message" The message is the VAT, GST, IVA, TVA, ... rule.\ \&#xNAN;***Examples :** No VAT for this company's activity*\ \&#xNAN;***File type :** string* #### "shipping\_global" / "special\_taxes" / "label" The value is the label of special taxe. It depends on the "to\_country" field in the request.\ \&#xNAN;***Examples :** om **or** omr*\ \&#xNAN;***File type :** string* #### "shipping\_global" / "special\_taxes" / "percentage" The value is the percentage (%) of VAT tax.\ \&#xNAN;***Examples :** 3.1 **or** 1.9*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "special\_taxes" / "product\_taxes*\_*amount" The value is the amount of : ("global\_ship\_price" x "products" / "special\_taxes" / "percentage"). The currency of this amount depends on "currency\_global\_ship\_price".\ \&#xNAN;***Examples :** 5.45 **or** 8*\ \&#xNAN;***File type :** number* #### "shipping\_global" / "*special\_taxes*" / "vat\_taxes\_amount" The value is the amount of vat on "special\_taxes" shipping taxes:\ \&#xNAN;***Examples :** 2.33 **or** 8*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "label" The value is the label "DUTY"\ \&#xNAN;***File type :** string* #### "packaging\_global" / "duty" / "percentage" The value is the percentage (%) of custom duties called "DUTY"\ \&#xNAN;***Examples :** 10 **or** 3.5*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "product\_taxes\_amount" The value is the amount of : ("global\_ship\_price" x "shipping\_global" / "duty" / "percentage"). The currency of this amount depends on "currency\_global\_ship\_price".\ \&#xNAN;***Examples :** 1.87 **or** 20*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "shipping\_taxes\_amount" The value is the amount of : ("unit\_ship\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "packaging\_taxes\_amount" The value is the amount of : ("unit\_packaging\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "insurance\_taxes\_amount" The value is the amount of : ("unit\_insurance\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "vat*\_*product\_taxes\_amount" The value is the amount of : (("unit\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_price".\ \&#xNAN;***Examples :** 12.87 **or** 20*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "vat*\_*shipping\_taxes\_amount" The value is the amount of : (("unit\_ship\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "vat*\_*packaging\_taxes\_amount" The value is the amount of : (("unit\_packaging\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "vat*\_*insurance\_taxes\_amount" The value is the amount of : (("unit\_insurance\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "vat\_taxes\_amount" The value is the amount of vat on "duty" taxes:\ \&#xNAN;***Examples :** 5.39 **or** 21*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "duty" / "agreement" The value is the agreement name between "from\_country" to "to\_country".\ \&#xNAN;***Examples :** "Preferential tariff for ..."*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "vat" / "label" The value is the label of VAT tax. It depends on the "to\_country" field in the request.\ \&#xNAN;***Examples :** vat **or** gst*\ \&#xNAN;***File type :** string* #### "packaging\_global" / "vat" / "percentage" The value is the percentage (%) of VAT tax.\ \&#xNAN;***Examples :** 3 **or** 1.5*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "vat" / "product\_taxes\_amount" The value is the amount of : ("global\_ship\_price" x "shipping\_global" / "vat" / "percentage"). The currency of this amount depend of "currency\_global\_ship\_price".\ \&#xNAN;***Examples :** 345 **or** 29.99*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "vat" / "shipping\_taxes\_amount" The value is the amount of : ("unit\_ship\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "vat" / "packaging\_taxes\_amount" The value is the amount of : ("unit\_packaging\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "vat" / "insurance\_taxes\_amount" The value is the amount of : ("unit\_insurance\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "vat" / "message" The message is the VAT, GST, IVA, TVA, ... rule.\ \&#xNAN;***Examples :** No VAT for this company's activity*\ \&#xNAN;***File type :** string* #### "packaging\_global" / "special\_taxes" / "label" The value is the label of special taxe. It depends on the "to\_country" field in the request.\ \&#xNAN;***Examples :** om **or** omr*\ \&#xNAN;***File type :** string* #### "packaging\_global" / "special\_taxes" / "percentage" The value is the percentage (%) of VAT tax.\ \&#xNAN;***Examples :** 3.1 **or** 1.9*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "special\_taxes" / "product\_taxes*\_*amount" The value is the amount of : ("global\_ship\_price" x "products" / "special\_taxes" / "percentage"). The currency of this amount depends on "currency\_global\_ship\_price".\ \&#xNAN;***Examples :** 5.45 **or** 8*\ \&#xNAN;***File type :** number* #### "packaging\_global" / "*special\_taxes*" / "vat\_taxes\_amount" The value is the amount of vat on "special\_taxes" shipping taxes:\ \&#xNAN;***Examples :** 2.33 **or** 8*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "label" The value is the label "DUTY"\ \&#xNAN;***File type :** string* #### "insurance\_global" / "duty" / "percentage" The value is the percentage (%) of custom duties called "DUTY"\ \&#xNAN;***Examples :** 10 **or** 3.5*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "product\_taxes\_amount" The value is the amount of : ("global\_ship\_price" x "shipping\_global" / "duty" / "percentage"). The currency of this amount depends on "currency\_global\_ship\_price".\ \&#xNAN;***Examples :** 1.87 **or** 20*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "shipping\_taxes\_amount" The value is the amount of : ("unit\_ship\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "packaging\_taxes\_amount" The value is the amount of : ("unit\_packaging\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "insurance\_taxes\_amount" The value is the amount of : ("unit\_insurance\_price" x "products" / "duty" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "vat*\_*product\_taxes\_amount" The value is the amount of : (("unit\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_price".\ \&#xNAN;***Examples :** 12.87 **or** 20*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "vat*\_*shipping\_taxes\_amount" The value is the amount of : (("unit\_ship\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "vat*\_*packaging\_taxes\_amount" The value is the amount of : (("unit\_packaging\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "vat*\_*insurance\_taxes\_amount" The value is the amount of : (("unit\_insurance\_price" x "products" / "duty" / "percentage")) x "vat" / "percentage". The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 45.89 **or** 90*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "vat\_taxes\_amount" The value is the amount of vat on "duty" taxes:\ \&#xNAN;***Examples :** 5.39 **or** 21*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "duty" / "agreement" The value is the agreement name between "from\_country" to "to\_country".\ \&#xNAN;***Examples :** "Preferential tariff for ..."*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "vat" / "label" The value is the label of VAT tax. It depends on the "to\_country" field in the request.\ \&#xNAN;***Examples :** vat **or** gst*\ \&#xNAN;***File type :** string* #### "insurance\_global" / "vat" / "percentage" The value is the percentage (%) of VAT tax.\ \&#xNAN;***Examples :** 3 **or** 1.5*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "vat" / "product\_taxes\_amount" The value is the amount of : ("global\_ship\_price" x "shipping\_global" / "vat" / "percentage"). The currency of this amount depend of "currency\_global\_ship\_price".\ \&#xNAN;***Examples :** 345 **or** 29.99*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "vat" / "shipping\_taxes\_amount" The value is the amount of : ("unit\_ship\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "vat" / "packaging\_taxes\_amount" The value is the amount of : ("unit\_packaging\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "vat" / "insurance\_taxes\_amount" The value is the amount of : ("unit\_insurance\_price" x "products" / "vat" / "percentage"). The currency of this amount depends on "currency\_unit\_ship\_price".\ \&#xNAN;***Examples :** 2.88 **or** 9*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "vat" / "message" The message is the VAT, GST, IVA, TVA, ... rule.\ \&#xNAN;***Examples :** No VAT for this company's activity*\ \&#xNAN;***File type :** string* #### "insurance\_global" / "special\_taxes" / "label" The value is the label of special taxe. It depends on the "to\_country" field in the request.\ \&#xNAN;***Examples :** om **or** omr*\ \&#xNAN;***File type :** string* #### "insurance\_global" / "special\_taxes" / "percentage" The value is the percentage (%) of VAT tax.\ \&#xNAN;***Examples :** 3.1 **or** 1.9*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "special\_taxes" / "product\_taxes*\_*amount" The value is the amount of : ("global\_ship\_price" x "products" / "special\_taxes" / "percentage"). The currency of this amount depends on "currency\_global\_ship\_price".\ \&#xNAN;***Examples :** 5.45 **or** 8*\ \&#xNAN;***File type :** number* #### "insurance\_global" / "special\_taxes" / "vat\_taxes\_amount" The value is the amount of vat on "special\_taxes" shipping taxes:\ \&#xNAN;***Examples :** 2.33 **or** 8*\ \&#xNAN;***File type :** number* #### "transit\_fees\_global" / "amount" The value is the amount of your carrier duty fees for global order. The currency of this amount depends on "currency\_unit\_price".\ \&#xNAN;***Examples :** 16.75 **or** 80*\ \&#xNAN;***File type :** number* #### "incoterm" The value is the value of "incoterm" in your request.\ \&#xNAN;***Examples :** CIF **or** FOB*\ \&#xNAN;***Type :** string* #### "extra\_fees" / "percentage" The value is the *percentage of you account's extra fees.*\ \&#xNAN;***Examples :** 20*\ \&#xNAN;***Type :** number* #### "extra\_fees" / "amount" The value is the *amount of extra fees on duty and taxes total.*\ \&#xNAN;***Examples :** 0.76*\ \&#xNAN;***Type :** number* #### "extra\_fees" / "currency" The value is the *currency of extra fees of duty and taxes total.*\ \&#xNAN;***Examples :** EUR*\ \&#xNAN;***Type :** string* #### "global" / "amount" The value is the sum of all amount fields.\ \&#xNAN;***Examples :** 1675 **or** 80.98*\ \&#xNAN;***File type :** number* #### "global" / "amount\_exclusive" The value is the global sum excluding duty and taxes.\ \&#xNAN;***Examples :** 1675 **or** 80.98*\ \&#xNAN;***File type :** number* #### "global" / "amount\_inclusive\_vat" The value is the global sum including vat taxes.\ \&#xNAN;***Examples :** 1675 **or** 80.98*\ \&#xNAN;***File type :** number* #### "global" / "amount\_total" The value is the global sum including duty and taxes.\ \&#xNAN;***Examples :** 1675 **or** 80.98*\ \&#xNAN;***File type :** number* #### "global" / "amout\_duty\_and\_tax" The value is the global sum of duty and taxes.\ \&#xNAN;***Examples :** 1675 **or** 80.98*\ \&#xNAN;***File type :** number* #### "global" / "percentage\_duty\_and\_tax" The value is the percentage of duty and taxes on the global sum.\ \&#xNAN;***Examples :** 1675 **or** 80.98*\ \&#xNAN;***File type :** number* #### "global" / "amount\_ecoTax" The value is the amount of eco taxe.\ \&#xNAN;***Examples :** 2,67*\ \&#xNAN;***File type :** number* #### "global" / "products\_*co2*" The value is the CO2 weight of 1kg of the product + the CO2 of shipping, packaging and insurance.\ \&#xNAN;***File type :** number* #### "timestamp" The value is a time stamp.\ \&#xNAN;***Examples :*** 1635349537562\ \&#xNAN;***File type :** number* ### JSON Examples - Request & Response It exist many possibilities. Please [book a call ](https://meetings.hubspot.com/gauthier11/gauthier)with our support team.
### Video explainer in progress... {% hint style="danger" %} **Warning :** 1 product = 1 request / 3 products = 3 requests {% endhint %} {% hint style="warning" %} If you prefer get the rates (duty, vat, salestaxes, ...), use [this API](/transiteo/duties-and-taxes-services/trade-tariff-rates-data.md) ! {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://transiteo.gitbook.io/transiteo/duties-and-taxes-services/duty-and-taxes-calculator/taxes-calculation/hscode-1.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.