# For International Carrier ## 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, "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 #### "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](https://transiteo.gitbook.io/transiteo/duties-and-taxes-services/trade-tariff-rates-data) ! {% endhint %}