> For the complete documentation index, see [llms.txt](https://transiteo.gitbook.io/transiteo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://transiteo.gitbook.io/transiteo/management-system/countries-cms.md).

# Tax Account

Taxes Management System

## 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).\
***Examples : "**&#x47;LP"* \
***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](https://f.hubspotusercontent20.net/hubfs/3856821/Dico%20-%20countries.csv).\
***Examples : "**&#x43;HE"* \
***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" */ "*&#x70;ercentage"

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" */ "*&#x63;urrency"

You need to fill this field with the currency's amount.\
***Type :** string*\
***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.\
***Type :** boolean*\
***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*\
***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.\
***Type :** boolean*\
***Required :** yes*

### JSON Examples - Request & Response

It exist many possibilities. Please [book a call ](https://meetings.hubspot.com/gauthier11/gauthier)with our support team.<br>

### 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 %}