Tax Account

Taxes Management System

Add taxes rules on an export country

POST https://api.transiteo.io/v1/customer/countries

This endpoint allows you to add a country where you accept to export your products

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string

Json Request Format

{
    "iso3_country": string,
    "statut": boolean,
    "annual_revenue": {"2020": number, "2021": number, "2022": number},
    "currency": string,
    "tax_id": string,
    "eori": string,
    "uk_rules": string,
    "origin_tax": string,
    "incoterm": string,
    "duty_fees": {
        "percentage": number,
        "amount": number,
        "currency": string,
        "on_global": boolean,
        "on_product_price": boolean,
        "on_shipping_products_price"
    }
}

Request fields & values

"iso3_country"

You need to fill the "iso3_country" field with the Iso Alpha 2 or 3. Download the list of countries. Examples : "GLP" Type : string Required : yes

"statut"

You need to fill this field with true or false. true = country available / false = country do not distribute. Type : boolean Required : yes

"annual_revenue"

You need to fill this field with total amount of your order in the year. Examples : 10390 Type : number Required : No

"currency"

You need to fill this field with your annual revenue's currency. Examples : EUR Type : string Required : No

"tax_id"

You need to fill this field with your tax id. Examples : 876GHJ3HUY Type : string Required : No

"eori"

You need to fill this field with your EORI number. Examples : FR890765432 Type : string Required : No

"uk_rules"

You need to fill this field with your uk rules. Type : string Required : No

"origin_tax"

You need to fill the "origin_tax" field with the Iso Alpha 2 or 3. Download the list of countries. Examples : "CHE" Type : string Required : No

"incoterm"

You need to fill this field with CIF or FOB. CIF = Duty & Taxes will be calculate on product + shipping price in this country / FOB = Duty & Taxes will be calculate only on product price in this country. Examples : CIF or FOB Type : string Required : No

"duty_fees" / "percentage"

You need to fill this field with a percentage. Type : number Required : No

"duty_fees" / "amount"

You need to fill this field with an amount. Type : number Required : No

"duty_fees" / "currency"

You need to fill this field with the currency's amount. Type : string Required : No

"duty_fees" / "on_global"

You need to fill this field with true or false. true = Duty fees will be calculate or add to the product + shipping in this country / false = Duty fees will be not calculate or add to the product + shipping in this country. Type : boolean Required : No

"duty_fees" / "on_product_price"

You need to fill this field with true or false. true = Duty fees will be calculate or add to the product in this country / false = Duty fees will be not calculate or add to the product in this country. Type : boolean Required : yes

"duty_fees" / "on_shipping_products_price"

You need to fill this field with true or false. true = Duty fees will be calculate or add to the shipping in this country / false = Duty fees will be not calculate or add to the shipping in this country. Type : boolean Required : yes

JSON Examples - Request & Response

It exist many possibilities. Please book a call with our support team.

Video explainer

in progress...

Update taxes rules of an export country

PUT https://api.transiteo.io/v1/customer/countries/{Base64}

This endpoint allows you to update exports country informations

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	"your id_token"

200

POST https://api.transiteo.io/v1/customer/countries

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	"your id_token"

200

Get exports country informations

GET https://api.transiteo.io/v1/customer/countries/{Base64}

This endpoint allows you to get informations of a specific exports country

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	"your id_token"

200

Get exports countries list

GET https://api.transiteo.io/v1/customer/countries

This endpoint allows you to get the list of all yours exports countries

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	"your id_token"

200