---
description: Taxes Management System
---

# Tax Account

## Add taxes rules on an export country

<mark style="color:green;">`POST`</mark> `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](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20countries.csv).\
&#xNAN;_**Examples : "**&#x47;LP"_ \
&#xNAN;_**Type :** string_\
&#xNAN;_**Required :** yes_

#### "statut"

You need to fill this field with true or false. true = country available / false = country do not distribute.\
&#xNAN;_**Type :** boolean_\
&#xNAN;_**Required :** yes_

#### "annual\_revenue"

You need to fill this field with total amount of your order in the year.\
&#xNAN;_**Examples :** 10390_ \
&#xNAN;_**Type :** number_\
&#xNAN;_**Required :** No_

#### "currency"

You need to fill this field with your annual revenue's currency.\
&#xNAN;_**Examples :** EUR_ \
&#xNAN;_**Type :** string_\
&#xNAN;_**Required :** No_

#### "tax\_id"

You need to fill this field with your tax id.\
&#xNAN;_**Examples :** 876GHJ3HUY_ \
&#xNAN;_**Type :** string_\
&#xNAN;_**Required :** No_

#### "eori"

You need to fill this field with your EORI number.\
&#xNAN;_**Examples :** FR890765432_ \
&#xNAN;_**Type :** string_\
&#xNAN;_**Required :** No_

#### "uk\_rules"

You need to fill this field with your uk rules.\
&#xNAN;_**Type :** string_\
&#xNAN;_**Required :** No_

#### "origin\_tax"

You need to fill the "_origin\_tax_" field with the Iso Alpha 2 or 3.\
Download the [list of countries](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20countries.csv).\
&#xNAN;_**Examples : "**&#x43;HE"_ \
&#xNAN;_**Type :** string_\
&#xNAN;_**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.\
&#xNAN;_**Examples :** CIF or FOB_ \
&#xNAN;_**Type :** string_\
&#xNAN;_**Required :** No_

#### "duty\_fees" _/ "_&#x70;ercentage"

You need to fill this field with a percentage.\
&#xNAN;_**Type :** number_\
&#xNAN;_**Required :** No_

#### "duty\_fees" _/ "amount_"

You need to fill this field with an amount.\
&#xNAN;_**Type :** number_\
&#xNAN;_**Required :** No_

#### "duty\_fees" _/ "_&#x63;urrency"

You need to fill this field with the currency's amount.\
&#xNAN;_**Type :** string_\
&#xNAN;_**Required :** No_

#### "duty\_fees" _/ "_&#x6F;n\_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.\
&#xNAN;_**Type :** boolean_\
&#xNAN;_**Required :** No_

#### "duty\_fees" _/ "_&#x6F;n\_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_\
&#xNAN;_**Required :** yes_

#### "duty\_fees" _/ "_&#x6F;n\_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.\
&#xNAN;_**Type :** boolean_\
&#xNAN;_**Required :** yes_



### 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...



## Update taxes rules of an export country

<mark style="color:orange;">`PUT`</mark> `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" |

{% tabs %}
{% tab title="200 " %}
```
```
{% endtab %}
{% endtabs %}

<mark style="color:green;">`POST`</mark> `https://api.transiteo.io/v1/customer/countries`

#### Headers

| Name          | Type   | Description      |
| ------------- | ------ | ---------------- |
| Content-type  | string | application/json |
| Authorization | string | "your id\_token" |

{% tabs %}
{% tab title="200 " %}
```
```
{% endtab %}
{% endtabs %}

## Get exports country informations

<mark style="color:blue;">`GET`</mark> `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" |

{% tabs %}
{% tab title="200 " %}
```
```
{% endtab %}
{% endtabs %}

## Get exports countries list

<mark style="color:blue;">`GET`</mark> `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" |

{% tabs %}
{% tab title="200 " %}
```
```
{% endtab %}
{% endtabs %}
