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


---

# 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/management-system/countries-cms.md?ask=<question>
```

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.