Public API Doc

Introduction

Introduction

Onboarding

We study the e-commerce and the logistic industry everyday in order to optimize the supply chain process and making it easier for our clients .

Transiteo API is the easiest way to integrate our solutions, services, systems into your system.

The transiteo API allows developers to build applications that interface with the transiteo web services. The API can be used to automate many tasks including :

  • Find the good HS Code thanks to our A.I on any product (Description, title, barcodes, ...)
  • Calculate the duty & taxes (landed cost) from & to 198 countries
  • Generate Custom documents .(CN23, Cross Border commercial invoice, ...)
  • Get taxes rates (Duties, Locals Taxes, Specials Taxes, SalesTax, ...)
  • ...

Endpoints

The endpoints are located at: https://api.transiteo.io

We can develop customized API for you. Just contact us via live chat or at support@transiteo.com

To get your Access tokens to call API

Plan a call with a transiteo team member - click here - for creating an API transiteo account.

\ When you will receive your access codes, you will have to log in to the transiteo web application : https://www.app.transiteo.io/#/login\ \ To run API, you have to get tokens. The tokens are available when you subscribe to a plan. \ \ To request the transiteo API, you need your id_token. There are 2 ways to get it. \ 1. From the platform, go this page : https://www.app.transiteo.io/#/settings or via the main menu : Parameters.

2. From API, go this page : Authentification API

For security, the id_token is available 1 hour. Don't forget to refresh it every hour.

Setup / Subscriptions / Consumption

About API setup, subscription and consumption. Please contact : gauthier@transiteo.com

POSTMAN Collection (Update 06/08/24)

You can download the POSTMAN API Collection. It's a JSON file that you could import in Postman.

{% file src="https://2749093152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M72Sazc4Ua4Dthy_cKt%2Fuploads%2FL6nbnHi9lMg5FUlv335I%2FTransiteo%20-%20Public%20API.postman_collection.json?alt=media&token=43925c33-7f43-4d3f-8e99-4d513457526b" %}

Authentification

Authentification

Get "id_token" (Authorization)

POST https://auth.transiteo.io/oauth2/token

This endpoint allows you to get the "id_token" thanks to the "client_id" & "refresh_token"

Headers

Name Type Description
content-type string application/x-www-form-urlencoded

Request Body

Name Type Description
client_id string "your client_id"
grant_type string refresh_token
refresh_token string "your refresh_token"

200

{
    "id_token": string,
    "access_token": string,
    "expires_in": number,
    "token_type": string
}

400

{
    "error": "invalid_grant"
}

Response fields

{
    "id_token": "your id_token",
    "access_token": "your access_token",
    "expires_in": 3600,
    "token_type": "Bearer"
}

"id_token"

Examples : "eyJraWQiOiI4eXVTYUd5WHNEUCtIOTU0UjYxd1Z4QkMyNHUydzRUclF5NEZ..."\ &#xNAN;Type : string

"access_token"

Examples : "eyJraWQiOiJNUHE3ZFJydk1FaTZqRXB1cGdsa1BhN3ZuV0dWWE94MjJTY..."\ &#xNAN;Type : string

"expire_in"

The id-token and access_token will expire in 3 600 seconds\ Value : "3600"\ &#xNAN;Type : number

"token_type"

Value : "Bearer"\ &#xNAN;Type : string

The "id_token" and "access_token" are available 1 hour.

E-CUSTOMS SERVICES

Harmonized System Code

Harmonized System Code

There are 2 differents endpoints to find a HSCode from a product tittle, description & barcode, url, image, it depends of your products :

  • Fret & Ecommerce - En / Fr (Text only) > Response in 300ms
  • Fret & Ecommerce - All languages (Text & barcode) > Response between 5 and 20 s

Fret & Ecommerce - En / Fr

Post product title, description or barcode to get the importation HS Code

POST https://api.transiteo.io/v4.1/taxsrv/hscodefinder

Headers

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

200 Response OK

[{
    "result": {
        "hs_code": string,
        "hs_version": string,
        "designation": string,
        "splitted_designation": {
            "chapter_designation": string,
            "heading_designation": string,
            "subheading_designation": string,
            "national_designation": string
        }
        "ai_score": number
    },
    "timestamp": number
}]
{
    "message": "Unauthorized"
}

JSON Request Format

{
  "product": {
    "identification": {
      "value": string,
      "type": string
    }
  },
  "to_country": string,
  "ai_score": boolean,
  "multi_results": number
}

Request fields

"products" / "identification" / "value"

You need to fill this field with a product's title, description, sku or barcode. We manage 2 languages (English & French)\ &#xNAN;Examples : \ &#xNAN;TEXT : "Ballon de football" or "Eggs" or "WASHERS FOR SPRINGING"\ SKU : "JHYU8_^ù/76YH" \ IMAGE_URL : “data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABpAAAA...DGPUZFVAZF”\ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "type"

You need to fill with "TEXT", "SKU" or "IMAGE_URL" to use the transiteo I.A\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\ Download the list of countries.\ &#xNAN;Examples : "CHE"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"ai_score"

Get the scoring of the AI in the result.\ &#xNAN;Examples : "true"\ &#xNAN;Type : boolean\ &#xNAN;Required : yes

"multi_results"

Get multi HSCode results.\ &#xNAN;Examples : 3\ &#xNAN;Type : number\ &#xNAN;Required : yes

JSON Response Format

[{
    "result": {
        "hs_code": string,
        "hs_version": string,
        "designation": string,
        "splitted_designation": {
            "chapter_designation": string,
            "heading_designation": string,
            "subheading_designation": string,
            "national_designation": string
        }
        "ai_score": number
    },
    "timestamp": number
}]

Response fields & values

"hs_code"

We provide a HSCode of length between 8 and 13. It depends on the "to_country" field and product attributes.\ &#xNAN;Example : "9503006100"\ &#xNAN;Type : string

"hs_version"

Each country uses a specific HSCode version.\ &#xNAN;Examples : "HS17" or "HS12"\ &#xNAN;Type : string

"designation"

We provide the HSCode designation.\ &#xNAN;Example : "Toys, games and sports requisites; parts and accessories thereof -- heading_designation : Articles and equipment for general physical exercise, gymnastics, athletics, other sports (including table-tennis) or outdoor games, not specified or included elsewhere in this chapter; swimming pools and paddling pools. -- subheading_designation : Inflatable balls -- national_designation : Inflatable balls"\ &#xNAN;Type : string

"product_statut"

We provide the product statut in the destination country. There are 3 cases. \ &#xNAN;Example : "'Autorised" or "'Restricted" or "'Prohibited"\ &#xNAN;Type : string

"splitted_designation" / "chapter_designation"

We provide the HSCode chapter designation. \ &#xNAN;Example : "Toys, games and sports requisites; parts and accessories thereof"\ &#xNAN;Type : string

"splitted_designation" / "heading_designation"

We provide the HSCode heading designation. \ &#xNAN;Example : "Articles and equipment for general physical exercise, gymnastics, athletics, other sports (including table-tennis) or outdoor games, not specified or included elsewhere in this chapter; swimming pools and paddling pools."\ &#xNAN;Type : string

"splitted_designation" / "subheading_designation"

We provide the HSCode subheading designation. \ &#xNAN;Example : "Inflatable balls"\ &#xNAN;Type : string

"splitted_designation" / "national_designation"

We provide the HSCode nation designation. \ &#xNAN;Example : "Inflatable balls"\ &#xNAN;Type : string

"timestamp"

We provide the result timestamp. \ &#xNAN;Example : "1638440602271"\ &#xNAN;Type : string

Fret & Ecommerce - All languages

Post product title, description or barcode to get the importation HS Code

POST https://api.transiteo.io/v1/taxsrv/hscodefinder

Headers

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

200 Response OK

{
  "product": {
    "identification": {
      "value": string,
      "type": string
    }
  },
  "lang": "fr" ,
  "to_country": string
}
{
    "message": "Unauthorized"
}

JSON Request Format

{
  "product": {
    "identification": [{
      "value": string,
      "type": string
    }]
  },
  "to_country": string,
  "ai_score": boolean,
  "multi_results": number
}

Request fields

"products" / "identification" / "value"

You need to fill this field with a product's title, description, sku or barcode. We manage 3 languages (English, French & Spanish)\ &#xNAN;Examples : \ &#xNAN;TEXT : "Ballon de football" or "Snacks Feringa, laits Catessy et My Star pour répondre aux besoins des chats et chatons... ils vont se régaler ! Faites découvrir les friandises au lait à votre chat grâce à ce lot mixte à prix mini !" or "0711719407577"\ SKU : "JHYU8_^ù/76YH" \ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "type"

You need to fill with "TEXT" to use the transiteo I.A\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\ Download the list of countries.\ &#xNAN;Examples : "CHE"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"ai_score"

Get the scoring of the AI in the result.\ &#xNAN;Examples : "true"\ &#xNAN;Type : boolean\ &#xNAN;Required : yes

"multi_results"

Get multi HSCode results.\ &#xNAN;Examples : 3\ &#xNAN;Type : number\ &#xNAN;Required : yes

JSON Response Format

[{
    "result": {
        "hs_code": string,
        "hs_version": string,
        "designation": string,
        "splitted_designation": {
            "chapter_designation": string,
            "heading_designation": string,
            "subheading_designation": string,
            "national_designation": string
        }
        "ai_score": number
    },
    "timestamp": number
}]

Response fields & values

"hs_code"

We provide a HSCode of length between 8 and 13. It depends on the "to_country" field and product attributes.\ &#xNAN;Example : "9503006100"\ &#xNAN;Type : string

"hs_version"

Each country uses a specific HSCode version.\ &#xNAN;Examples : "HS17" or "HS12"\ &#xNAN;Type : string

"designation"

We provide the HSCode designation.\ &#xNAN;Example : "Toys, games and sports requisites; parts and accessories thereof -- heading_designation : Articles and equipment for general physical exercise, gymnastics, athletics, other sports (including table-tennis) or outdoor games, not specified or included elsewhere in this chapter; swimming pools and paddling pools. -- subheading_designation : Inflatable balls -- national_designation : Inflatable balls"\ &#xNAN;Type : string

"product_statut"

We provide the product statut in the destination country. There are 3 cases. \ &#xNAN;Example : "'Autorised" or "'Restricted" or "'Prohibited"\ &#xNAN;Type : string

"splitted_designation" / "chapter_designation"

We provide the HSCode chapter designation. \ &#xNAN;Example : "Toys, games and sports requisites; parts and accessories thereof"\ &#xNAN;Type : string

"splitted_designation" / "heading_designation"

We provide the HSCode heading designation. \ &#xNAN;Example : "Articles and equipment for general physical exercise, gymnastics, athletics, other sports (including table-tennis) or outdoor games, not specified or included elsewhere in this chapter; swimming pools and paddling pools."\ &#xNAN;Type : string

"splitted_designation" / "subheading_designation"

We provide the HSCode subheading designation. \ &#xNAN;Example : "Inflatable balls"\ &#xNAN;Type : string

"splitted_designation" / "national_designation"

We provide the HSCode nation designation. \ &#xNAN;Example : "Inflatable balls"\ &#xNAN;Type : string

"timestamp"

We provide the result timestamp. \ &#xNAN;Example : "1638440602271"\ &#xNAN;Type : string

https://youtu.be/P-tXdwHZ34s

United Nations Code

United Nations Code

Get the UN Code (Hazardous Material Code) from a product title, description, SKU or Barcode.

POST https://api.transiteo.io/v2/taxsrv/aiclassify

JSON Request Format

{
  "product": {
    "identification": {
      "value": string,
      "type": string
    }
  },
  "to_country": string
}

Request fields

"products" / "identification" / "value"

You need to fill this field with a product's title, description, sku or barcode. We manage 5 languages (English, French, Spanish, Italian & Deutsch)\ &#xNAN;Examples : \ &#xNAN;TEXT : "Ballon de football" or "0711719407577" or SKU : "JHYU8_^ù/76YH" \ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "type"

You need to fill with "TEXT", "BARCODE" or "SKU"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\ Download the list of countries.\ &#xNAN;Examples : "CHE"\ &#xNAN;Type : string\ &#xNAN;Required : yes

JSON Response Format

{
    “result”: {
        “un_code”: [
            string
        ]
    },
    “timestamp”: 1646674954208
}

Response fields & values

"un_code"

We provide the UN Code(s) attached to your product.\ &#xNAN;Examples : "3481"\ &#xNAN;Type : string

"timestamp"

We provide the result timestamp. \ &#xNAN;Example : "1638440602271"\ &#xNAN;Type : string

Dimensions & Weight

Dimensions & Weight

Get the Dimensions and Weight from any product.

POST https://api.transiteo.io/v3/taxsrv/aiclassify

JSON Request Format

{
  "product": {
    "identification": {
      "value": string,
      "type": string
    }
  },
  "to_country": string
}

Request fields

"products" / "identification" / "value"

You need to fill this field with a product's title, description, sku or barcode. We manage 5 languages (English, French, Spanish, Italian & Deutsch)\ &#xNAN;Examples : \ &#xNAN;TEXT : "Ballon de football" or "0711719407577" or SKU : "JHYU8_^ù/76YH" \ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "type"

You need to fill with "TEXT", "BARCODE" or "SKU"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\ Download the list of countries.\ &#xNAN;Examples : "FRA"\ &#xNAN;Type : string\ &#xNAN;Required : yes

JSON Response Format

{
    “result”: {
        “weight”: {
            “min”: number,
            “max”: number,
            “median”: number,
            “unit”: string
        },
        “width”: {
            “min”: number,
            “max”: number,
            “median”: number,
            “unit”: string
        },
        “height”: {
            “min”: number,
            “max”: number,
            “median”: number,
            “unit”: string
        },
        “length”: {
            “min”: number,
            “max”: number,
            “median”: number,
            “unit”: string
        }
    },
    “timestamp”: 1646674995727
}

Response fields & values

"weight" / "min"

We provide the minimum weight of the product. \ &#xNAN;Example : 3.56\ &#xNAN;Type : string

"weight" / "max"

We provide the maximum weight of the product. \ &#xNAN;Example : 9.22\ &#xNAN;Type : string

"weight" / "median"

We provide the median weight of the product. \ &#xNAN;Example : 4.77\ &#xNAN;Type : string

"weight" / "unit"

We provide the unit of product weight. \ &#xNAN;Example : kg\ &#xNAN;Type : string

"width" / "min"

We provide the minimum width of the product. \ &#xNAN;Example : 3.56\ &#xNAN;Type : string

"width" / "max"

We provide the maximum width of the product. \ &#xNAN;Example : 9.22\ &#xNAN;Type : string

"width" / "median"

We provide the median width of the product. \ &#xNAN;Example : 4.77\ &#xNAN;Type : string

"width" / "unit"

We provide the unit of product width. \ &#xNAN;Example : kg\ &#xNAN;Type : string

"height" / "min"

We provide the minimum height of the product. \ &#xNAN;Example : 3.56\ &#xNAN;Type : string

"height" / "max"

We provide the maximum height of the product. \ &#xNAN;Example : 9.22\ &#xNAN;Type : string

"height" / "median"

We provide the median height of the product. \ &#xNAN;Example : 4.77\ &#xNAN;Type : string

"height" / "unit"

We provide the unit of height weight. \ &#xNAN;Example : kg\ &#xNAN;Type : string

"length" / "min"

We provide the minimum length of the product. \ &#xNAN;Example : 3.56\ &#xNAN;Type : string

"length" / "max"

We provide the maximum length of the product. \ &#xNAN;Example : 9.22\ &#xNAN;Type : string

"length" / "median"

We provide the median length of the product. \ &#xNAN;Example : 4.77\ &#xNAN;Type : string

"length" / "unit"

We provide the unit of product length. \ &#xNAN;Example : kg\ &#xNAN;Type : string

"timestamp"

We provide the result timestamp. \ &#xNAN;Example : "1638440602271"\ &#xNAN;Type : string

Carbon footprint

Carbon footprint

Get the carbon footprint of manufactured product.

POST https://api.transiteo.io/v1/greensrv/product

JSON Request Format

{
  “product”: {
    “identification”: {
      “value”: string,
      “type”: string
    },
    “weight”: number,
    “weight_unit”: string
  },
  “to_country”: string
}

Request fields

"products" / "identification" / "value"

You need to fill this field with a product's title, description, sku or barcode. We manage 5 languages (English, French, Spanish, Italian & Deutsch)\ &#xNAN;Examples : \ &#xNAN;TEXT : "Ballon de football" or "0711719407577" or SKU : "JHYU8_^ù/76YH" \ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "type"

You need to fill with "TEXT", "BARCODE" or "SKU"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"weight"

You need to fill this field with the product weight.\ &#xNAN;Examples : 3.40\ &#xNAN;Type : number\ &#xNAN;Required : yes

"weight_unit"

You need to fill this field with the product weight unit.\ &#xNAN;Examples : kg\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\ Download the list of countries.\ &#xNAN;Examples : "CHE"\ &#xNAN;Type : string\ &#xNAN;Required : yes

JSON Response Format

{
    “product”: {
        “identification”: {
            “value”: string,
            “type”: string
        },
        “weight”: number,
        “weight_unit”: string
    },
    “to_country”: string,
    “co2_product”: number,
    “timestamp”: number
}

Response fields & values

"products" / "identification" / "value"

Same info than the request body\ &#xNAN;Type : string

"products" / "identification" / "type"

Same info than the request body\ &#xNAN;Type : string

"weight"

Same info than the request body\ &#xNAN;Examples : 3.40\ &#xNAN;Type : number

"weight_unit"

Same info than the request body\ &#xNAN;Examples : kg\ &#xNAN;Type : string

"to_country"

Same info than the request body.\ &#xNAN;Examples : "CHE"\ &#xNAN;Type : string

"co2_product"

We provide the CO2 in kg for product manufacture.\ &#xNAN;Examples : "3.54"\ &#xNAN;Type : string

"timestamp"

We provide the result timestamp. \ &#xNAN;Example : "1638440602271"\ &#xNAN;Type : string

Eco Codes and Taxes

Eco Codes and Taxes

Create a new user

POST https://api.transiteo.io/v1/ecocode/find

Get all REP codes and taxes associated

Headers

Name Description Type
Content-Type application/json string
Authorization id token from cognito string

JSON REQUEST EXEMPLE

{
  "title": "Smartphone",
  "weight": 700,
  "weight_unit": "g"
}

OU SI PLUSIEURS REQUÊTES

{
    "ecoCodeFinderRequests": [
        {
            "title": "Télévision UHD Samsung",
            "weight": 20,
            "weight_unit": "kg"
        },
        {
            "title": "Smartphone",
            "weight": 280,
            "weight_unit": "g"
        },
        {
            "title": "Vélo de route",
            "weight": 2805,
            "weight_unit": "g"
        }
    ]
}

Request fields & values

"title"

You need to fill this field with a product's title or description. \ &#xNAN;Examples : Samsung Galaxy 8\ &#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 need 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

Response

200

{
    "EMBM_Citeo_id": "P120304#Citeo",
    "EMBM_Citeo_tarif": 0.0204,
    "EMBM_Leko_id": "P120304#Leko",
    "EMBM_Leko_tarif": 0.0168,
    "PAPIER_Citeo_id": "notice_MatérielGrandPublic#Citeo",
    "PAPIER_Citeo_tarif": 0.005849999999999999
}

OU SI PLUSIEURS REQUÊTES

[
    {
        "EMBM_Citeo_id": "P120304#Citeo",
        "EMBM_Citeo_tarif": 0.0204,
        "EMBM_Leko_id": "P120304#Leko",
        "EMBM_Leko_tarif": 0.0168,
        "PAPIER_Citeo_id": "notice_MatérielGrandPublic#Citeo",
        "PAPIER_Citeo_tarif": 0.005849999999999999
    },
    {
        "EMBM_Citeo_id": "P120304#Citeo",
        "EMBM_Citeo_tarif": 0.0204,
        "EMBM_Leko_id": "P120304#Leko",
        "EMBM_Leko_tarif": 0.0168,
        "PAPIER_Citeo_id": "notice_MatérielGrandPublic#Citeo",
        "PAPIER_Citeo_tarif": 0.005849999999999999
    },
    {
        "EMBM_Citeo_id": "P120304#Citeo",
        "EMBM_Citeo_tarif": 0.0204,
        "EMBM_Leko_id": "P120304#Leko",
        "EMBM_Leko_tarif": 0.0168,
        "PAPIER_Citeo_id": "notice_MatérielGrandPublic#Citeo",
        "PAPIER_Citeo_tarif": 0.005849999999999999
    }
]

400

Incorrect Json (json body request incorrect) : a description of the error will be returned

403

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"
            ]
        }
    ]
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

World Product Pricing

World Product Pricing

Get the cheaper price of your product in 90 countries.

POST https://api.transiteo.io/v1/aiproductpricing

JSON Request Format

{
  "product": {
    "identification": {
      "value": string,
      "type": string
    }
  },
  "to_country": string
}

Request fields

"products" / "identification" / "value"

You need to fill this field with a product's title or description. We manage 5 languages (English, French, Spanish, Italian & Deutsch)\ &#xNAN;Examples : \ &#xNAN;TEXT : "Ballon de football" or "0711719407577" or SKU : "JHYU8_^ù/76YH" \ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "type"

You need to fill with "TEXT"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\ Download the list of countries.\ &#xNAN;Examples : "CHE"\ &#xNAN;Type : string\ &#xNAN;Required : yes

JSON Response Format

{
    “picture_url”: string,
    “shop_url”: string,
    “product_price_currency”: string,
    “product_price_min”: number,
    “timestamp”: number
}

Response fields & values

"picture_url"

Get the url of product picture. \ &#xNAN;Example : https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSK5v2_tagTJjMlV7McHBCuKclKRTo96zgPiuV-NHG24crXJeV_DkDmaFrt4ZiS_XZDHJuBhMUVBelLWCPQb0naGDPw1mKYNDbBD-Y29_6aPSnAAeTWh-Jz\&usqp=CAE\ &#xNAN;Type : string

"shop_url"

Get the url of product shop. \ &#xNAN;Example : https://www.cdiscount.com/maison/fauteuil-pouf-poire/chaise-fauteuil-de-table-velours-noir-pieds/f-117200302-sqkiahchnr1.html#mpos=0|cd\ &#xNAN;Type : string

"product_price_currency"

Get the currency of product price. \ &#xNAN;Example : "EUR"\ &#xNAN;Type : string

"product_price_min"

Get the min price of product. \ &#xNAN;Example : 79.90\ &#xNAN;Type : number

"timestamp"

We provide the result timestamp. \ &#xNAN;Example : "1638440602271"\ &#xNAN;Type : string

Link (HSCode > HSCode)

Link (HSCode > HSCode)

HSCode to get the HSCode

POST https://api.transiteo.io/v1/taxsrv/hscodefinder

You can transform any HTS Code of any country to another one.

Headers

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

200 Cake successfully retrieved.

{    "name":{
    "result": {
        "hs_code": number,
        "hs_version": string,
        "designation": string,
        "product_statut": string
    }
}
{
  "product": {
    "identification": {
      "value": string,
      "type": string
    }
  },
  "from_country" string,
  "to_country": string
}

Request fields

"products" / "identification" / "type"

You need to fill with "HSCODE"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "value"

You need to fill this field with a HSCode 8 to 13 digits.\ &#xNAN;Examples : 9503006100\ &#xNAN;Type : string\ &#xNAN;Required : yes

"from_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\ Download the list of countries.\ &#xNAN;Examples : "USA"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\ Download the list of countries.\ &#xNAN;Examples : "USA"\ &#xNAN;Type : string\ &#xNAN;Required : yes

JSON Response Format

{
    "result": {
        "hs_code": string,
        "hs_version": string,
        "product_statut": string,
        "designation": string,
        "splitted_designation": {
            "chapter_designation": string,
            "heading_designation": string,
            "subheading_designation": string,
            "national_designation": string
        }
    },
    "timestamp": number
}

Response fields & values

"hs_code"

We provide a HSCode of length between 8 and 13. It depends on the "to_country" field and product attributes.\ &#xNAN;Example : "9503006100"\ &#xNAN;Type : string

"hs_version"

Each country uses a specific HSCode version.\ &#xNAN;Examples : "HS17" or "HS12"\ &#xNAN;Type : string

"designation"

We provide the HSCode designation.\ &#xNAN;Example : "Electrical machinery and equipment and parts thereof; sound recorders and reproducers, television image and sound recorders and reproducers, and parts and accessories of such articles -- heading_designation : Vacuum cleaners. -- subheading_designation : Vacuum cleaners, incl. dry cleaners and wet vacuum cleaners, with self-contained electric motor ( excl. of a power <= 1?500?w and having a dust bag or other receptacle capacity <= 20?l) -- national_designation : Aspirateurs: a moteur électrique incorporé: autres: aspirateurs de poussièers, y compris les aspirateurs de matières sèches et de matières liquides"\ &#xNAN;Type : string

"product_statut"

We provide the product statut in the destination country. There are 3 cases. \ &#xNAN;Example : "'Authorized' à l'importation dans ce pays" or "'Restricted' à l'importation dans ce pays" or "'Prohibited' à l'importation dans ce pays"\ &#xNAN;Type : string

"splitted_designation" / "chapter_designation"

We provide the HSCode chapter designation. \ &#xNAN;Example : "Electrical machinery and equipment and parts thereof; sound recorders and reproducers, television image and sound recorders and reproducers, and parts and accessories of such articles", "heading_designation": "Vacuum cleaners."\ &#xNAN;Type : string

"splitted_designation" / "heading_designation"

We provide the HSCode heading designation. \ &#xNAN;Example : "Vacuum cleaners."\ &#xNAN;Type : string

"splitted_designation" / "subheading_designation"

We provide the HSCode subheading designation. \ &#xNAN;Example : "Vacuum cleaners, incl. dry cleaners and wet vacuum cleaners, with self-contained electric motor ( excl. of a power <= 1?500?w and having a dust bag or other receptacle capacity <= 20?l)"\ &#xNAN;Type : string

"splitted_designation" / "national_designation"

We provide the HSCode nation designation. \ &#xNAN;Example : "Aspirateurs: a moteur électrique incorporé: autres: aspirateurs de poussièers, y compris les aspirateurs de matières sèches et de matières liquides"\ &#xNAN;Type : string

"timestamp"

We provide the result timestamp. \ &#xNAN;Example : "1638441460961"\ &#xNAN;Type : string

Nomenclature

Nomenclature

Get HScode nomenclature designation

POST https://api.transiteo.io/v1/taxsrv/harmonizedSystemCodes

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

JSON REQUEST FORMAT

{
  "hscode": "6505009090",
  "to_country": "FRA", // ISO2 or ISO3 country
  "lang": "fr"
}

Response

200

{
    "hscode_request": "6505009090",
    "to_country": "FRA",
    "version": "HS17",
    "hscode": {
        "chapter": "65",
        "heading": "05",
        "hscode_designation": "COIFFURES ET PARTIES DE COIFFURES - Chapeaux et autres coiffures en bonneterie ou confectionnés à l'aide de dentelles, de feutre ou d'autres produits textiles, en pièces (mais non en bandes), même garnis; résilles et filets à cheveux en toutes matières, même garnis - autres, autres - autres",
        "subdivision": "9090",
        "subheading": "00"
    }
}

400

1. Incorrect Json (json body request incorrect)

Response Example: 
{
    "code": "INCORRECT_JSON",
    "name": "ClientError",
    "message": "Incorrect Json Request",
    "details": [
        {
            "parameter": {
                "name": "to_country",
                "value": "FRANCE"
            },
            "causes": [
                "to_country should be ISO3 or ISO2"
            ]
        }
    ]
}

403

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"
            ]
        }
    ]
}

404

{
    "code": "DATA_NOT_FOUND",
    "name": "BusinessError",
    "message": "Sorry, we did not find the data you are trying to retrieve",
    "details": []
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

RTC / BTI

RTC / BTI

Get RTC/BTI of any HScode

POST https://api.transiteo.io/v1/taxsrv/harmonizedSystemCodes

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

JSON REQUEST FORMAT

{
    "requests": [
        {
            "hscode": "8517130000",
            "product_text" : parfum à spray"
            "image_url" : “data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABpAAAA...DGPUZFVAZF”
            "to_country": "FRA",
            "lang": "fr",
            "bti": true
        },
    ]
}


</code></pre>

**Response**



<div class="tabs" markdown="1">


<div class="tab" markdown="1">
<p class="tab-t">200</p>

```json
[
    {
        "hscode_request": "8517130000",
        "to_country": "FRA",
        "version": "HS22",
        "hscode": {
            "chapter": "85",
            "heading": "17",
            "hscode_designation": "MACHINES, APPAREILS ET MATÉRIELS ÉLECTRIQUES ET LEURS PARTIES; APPAREILS D'ENREGISTREMENT OU DE REPRODUCTION DU SON, APPAREILS D'ENREGISTREMENT OU DE REPRODUCTION DES IMAGES ET DU SON EN TÉLÉVISION, ET PARTIES ET ACCESSOIRES DE CES APPAREILS - Postes téléphoniques d’usagers, y compris les téléphones intelligents et autres téléphones pour réseaux cellulaires et pour autres réseaux sans fil; autres appareils pour l'émission, la transmission ou la réception de la voix, d’images ou d'autres données, y compris les appareils pour la communication dans un réseau filaire ou sans fil (tel qu'un réseau local ou étendu), autres que ceux des nos 8443, 8525, 8527 ou 8528 -  - Postes téléphoniques d’usagers, y compris les téléphones intelligents et autres téléphones pour réseaux cellulaires et pour autres réseaux sans fil, Téléphones intelligents",
            "subdivision": "0000",
            "subheading": "13"
        },
        "bti": [
            {
                "hscode": "8517130000",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-04026",
                "designation": "Appareil communicant se présentant sous la forme d’une montre. Cet appareil est munie d’un port carte SIM, compatible tout opérateur (abonnement ou carte prépayé) sur réseau 2G . Caractéristiques de l’appareil: - Écran tactile 1.44 Pouces - Écran TF 128x128 pixels - Microprocesseur: RDA8955 - Compatible tout opérateur (Abonnement ou carte prépayée) - Port carte SIM - 2G - Numéros SOS - Compatible ANDROID 3.0 et IOS 6.0 et antérieur - RAM: 128MB / ROM: 32MB - Port micro USB - Caméra 8MP - Flash - Jeux inclus Contrôle parental par application - Rejeter les appels inconnus par application - Temps réglable pour ne pas être dérangé par application - Fonction main libre - Date, heure, alarme - Multi -langage par application - Micro et haut-parleur intégrés - Batterie rechargeable li-ion polymère 350mAh incluse - Autonomie batterie: - en mode appel: 5 à 6 heures - en mode standby: 5 à 6 jours - Câble USB inclus - Bracelet silicone",
                "expiry_date": "03/10/2025 ",
                "keywords": " / TÉLÉPHONE CELLULAIRE / TÉLÉPHONE SANS FIL / TÉLÉPHONE PORTABLE / RECHARGEABLE, BATTERIE / PAR BATTERIE / AVEC CARTE SIM / MONTRE / ",
                "issue": "04/10/2022",
                "language": "fr"
            },
            {
                "hscode": "8517130000",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-04795",
                "designation": "Téléphone mobile correspondant à un téléphone pour réseaux cellulaires avec un certain nombre de fonctionnalités supplémentaires. Il sert principalement à passer des appels téléphoniques. Il dispose également de fonctionnalités de navigation sur internet, d’appareil photographique, de caméra, de GPS et de radio. Il comprend un processeur de 2GHz, une mémoire RAM de 4Go, une batterie en Lithium 4940mAh, d’une mémoire de 64Go, d’un écran tactile, d’une prise jack mesurant 3,5mm et de deux emplacements pour carte SIM. Il est fourni avec des écouteurs filaires, un câble USB, un chargeur, un manuel d’utilisation, un outil sous la forme de tige en métal pour éjecter le tiroir à carte SIM et d’un X-Blocker (partie plastique permettant de fixer l’appareil téléphonique sur les accessoires de la marque). Il est conditionné dans un emballage. Dimensions 182 x 176 x 33,5 mm. Poids 557g.",
                "expiry_date": "07/08/2025 ",
                "keywords": " / TÉLÉPHONE PORTABLE / POUR RÉSEAU / AVEC CAMÉRA / AVEC ÉCRANS TACTILES / ",
                "issue": "08/08/2022",
                "language": "fr"
            },
            {
                "hscode": "8517130000",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-05208",
                "designation": "Téléphone portable (smartphone). L'appareil est un téléphone intelligent. Ecran tactile 5,72 pouces QHD +IPS. / Résolution 850 x 480 pixels. / Compatible tout opérateur (abonnement ou carte prépayée). / Microprocesseur : MTK6737 / 4cores / 1,3 GHZ. / GSM900/1800/850/1900,WCDMA2100. / 4G : LTE800(B20)/1800(B3)/2100(B1)/2600(B7). / Système d’exploitation : ANDROID 6.0. / Double carte SIM. / Mémoire interne (ROM) : 16 GB. / RAM : 2 GB. / 2G/3G/4G. / WIFI. / GPS. / Bluetooth. / G-SENSOR. / GSM/GPRS. / Port micro USB. / Port carte micro SD jusqu’à 32 GB. / 2 caméras : Face 2 MP / Dos 8 MP. / Flash. / Messagerie SMS, MMS, EMAIL. / Radio FM. / Lit formats : MP3/MP4/WMA/MP2/OGG/AAC/M4A/MA4/ FLAC/APE/3GP/WAV/JPEG/JPG/GIF/BMP/PNG. / Organiseur, éditeur image/vidéo, Google search, Maps, Gmail, Youtube, calendrier, Google talk, jeux, etc... / Haut-parleur intégré. / Entrée jack 3,5 millimètres. / Batterie rechargeable li-on 1800 mAh incluse. / Autonomie : jusqu’à 100 heures en standby et jusqu’à 5 heures en utilisation appel (selon réseau). / Adaptateur secteur, câble USB et écouteurs inclus.",
                "expiry_date": "04/08/2025 ",
                "keywords": " / TÉLÉPHONE PORTABLE / DESTINÉ À LA COMMUNICATION / POUR TÉLÉCOMMUNICATIONS / RECHARGEABLE, BATTERIE / ",
                "issue": "05/08/2022",
                "language": "fr"
            },
            {
                "hscode": "8517130000",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-05597",
                "designation": "Appareil de communication se présentant sous la forme d’une montre intelligente permettant de passer des appels ou de répondre à des appels. Il se compose de : - Écran tactile 1.54 Pouces - Écran TF 240x240 pixels - Microprocesseur : MTK6261D - Compatible tout opérateur (Abonnement ou carte prépayée) - Port carte SIM (carte SIM non incluse) - 2G - Compatible ANDROID et IOS - RAM : 32MB / ROM : 32MB - Bluetooth V3.0 - Port micro USB - Port carte mémoire micro SD jusqu’à 32GB - G-SENSOR Caméra 0.3MPX Formats audio : MP3/WMA - Formats photos : PNG/JPEG - Fonction télécommande pour prise photos(pour ANDROID uniquement) - Fonction main libre - Répondre ou rejeter les appels de votre poignet - Alerte par vibration - Podomètre (seulement pour la marche) - Alarme de sédentarité - Horloge avec alarme, calendrier, répertoire, calculatrice - Multi-langage - Micro et haut-parleur intégrés - Batterie rechargeable li-ion polymère 230mAh incluse (autonomie en standby : 100 heures et autonomie en mode appel : 3 heures) - Câble USB inclus.",
                "expiry_date": "15/12/2025 ",
                "keywords": " / APPAREILS DE COMMUNICATION / AVEC LA TECHNOLOGIE BLUETOOTH / RECHARGEABLE, BATTERIE / CÂBLES USB / MONTRE BRACELET / TÉLÉPHONE CELLULAIRE / ",
                "issue": "16/12/2022",
                "language": "fr"
            },
            {
                "hscode": "8517130000",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2023-04383",
                "designation": "Appareil communicant indépendant se présentant sous la forme d’une montre avec bracelet interchangeable. Cet appareil est muni d’un port carte e-SIM. Il permet la gestion des appels, d'écouter de la musique, télécharger des applications sans être connecté à un téléphone. Il est équipé d'une unité de contrôle micro-électronique et d'une batterie au lithium à recharge rapide. Ses principales caractéristiques sont : appels vocaux (appeler, recevoir, rejeter), répertoire téléphonique, historique des messages, rappels géo-localisés, calendrier, charge sans fil USB-C, appels Bluetooth (appeler, recevoir, rejeter, appel en attente), fonctions d'entraînement (par ex.enregistrement), fonctions sport & bien-être (par exemple : course, surveillance de la fréquence cardiaque en continu, analyses corporelles et cycle de fertilité…), mode de vie (par exemple, surveillance du sommeil), suivis des performances sportives sur l’application Samsung Health, messagerie, fonction d'horloge, navigation en temps réel (GPS), télécommande de l’appareil photo du smartphone, télécommande de présentation Power Point, smart switch et déverrouillage automatique de son smartphone ou tablette. Caractéristiques de l’appareil : - Affichage : 1,19 pouces, écran couleur, super AMOLED. (Prend en charge les opérations tactiles plein écran, y compris balayage, tapotement, pression et maintien). - Processeur Exynos W920. Système d'exploitation Wear OS 3.5 Samsung Surcouche One UI Watch 4.5. - Mémoire : 16 Go de ROM interne ; 1.5 Go de RAM interne. - Microphone et haut-parleur. - Se connecte à un téléphone mobile via Bluetooth. - Carte e-SIM (4G/LTE), ce qui lui permet de passer et de recevoir des appels avec ou sans dispositif couplé (par exemple, un téléphone).",
                "expiry_date": "13/05/2027 ",
                "keywords": " / TÉLÉPHONE CELLULAIRE / TÉLÉPHONE SANS FIL / TÉLÉPHONE PORTABLE / RECHARGEABLE, BATTERIE / AVEC CARTE SIM / MONTRE / ",
                "issue": "14/05/2024",
                "language": "fr"
            },
            {
                "hscode": "8517130000",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2023-08552",
                "designation": "Appareil de communication, se présentant sous la forme d’une montre intelligente permettant de passer des appels ou de répondre à des appels. La montre présente les caractéristiques suivantes : - port carte SIM (carte SIM non incluse), - prendre des appels et répondre aux messages sans téléphone, - espace de stockage 2 GO, - compatible avec les systèmes ANDROID, - 4G, - d’un écran tactile AMOLED 1.43 Pouces, - résolution d’affichage 466x466 pixels, - applications Google, - batterie haute capacité, - étanchéité 5ATM. La montre dispose de plusieurs fonctions permettant d’afficher différentes informations telles que : - le rythme cardiaque, - oxygène dans le sang, - composition corporelle, - sport suivi, - agenda, - la qualité du sommeil, - caméra contrôle, - météo, - enregistreur boussole, - contrôle de la musique, - pression atmosphérique, - portefeuille.",
                "expiry_date": "25/04/2027 ",
                "keywords": " / APPAREILS DE COMMUNICATION / MONTRE / AVEC LA TECHNOLOGIE BLUETOOTH / RECHARGEABLE, BATTERIE / MONTRE BRACELET / AVEC CARTE SIM / APPAREIL DE MESURE DES PULSATIONS CARDIAQUES / AVEC ÉCRANS TACTILES / ",
                "issue": "26/04/2024",
                "language": "fr"
            }
        ]
    },
    {
        "hscode_request": "6505009090",
        "to_country": "FRA",
        "version": "HS22",
        "hscode": {
            "chapter": "65",
            "heading": "05",
            "hscode_designation": "COIFFURES ET PARTIES DE COIFFURES - Chapeaux et autres coiffures en bonneterie ou confectionnés à l'aide de dentelles, de feutre ou d'autres produits textiles, en pièces (mais non en bandes), même garnis; résilles et filets à cheveux en toutes matières, même garnis - autres, autres, autres - ",
            "subdivision": "9090",
            "subheading": "00"
        },
        "bti": [
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2021-05790",
                "designation": "Coiffure en bonneterie (100 % coton), de type bonnet pour bébés, de forme conique, confectionné en étoffe de bonneterie (coton), avec un revers sur la base. Existe en plusieurs modèles pouvant comporter sur ce revers : un nœud, un dessin imprimé ou brodé.",
                "expiry_date": "03/10/2024 ",
                "keywords": " / COIFFURES / EN BONNETERIE / DE COTON / BONNET / POUR BÉBÉS / AVEC REVERS / AVEC DÉCORATION, TEXTILE / ",
                "issue": "04/10/2021",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2021-06984",
                "designation": "Coiffure confectionnée en matière textile, de type serviette pour cheveux, comportant un système d’attache au moyen d’un bouton et d’un élastique, afin de maintenir les cheveux et d’en faciliter leur séchage. L’article se décline en différents coloris. Dimensions : 25 x 68 cm.",
                "expiry_date": "21/09/2024 ",
                "keywords": " / COIFFE / TURBAN / DE MATIÈRE TEXTILE / AVEC BOUCLE / AVEC BOUTON / ",
                "issue": "22/09/2021",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2021-07633",
                "designation": "Capuche amovible, confectionnée, en tissu enduit majoritairement en polyester et se fixant à l’aide de boutons-pression. Cette capuche contient une doublure en coton, une fermeture par 4 boutons-pression, des élastiques resserrant et une patte de serrage. Cet article est destiné à être fixé sur une veste. La capuche sert de protection contre la pluie et le vent.",
                "expiry_date": "23/11/2024 ",
                "keywords": " / CAPUCHON, PARTIE DE VÊTEMENT / AMOVIBLE / CONFECTIONNÉ / DE TISSU / ENDUIT, SAUF PAPIER / VESTE IMPERMÉABLE / DE POLYESTER / AVEC BOUTON-PRESSION / AVEC DOUBLURE INTÉRIEURE / DE COTON / AVEC ÉLÉMENT RESSERRANT / AVEC ÉLASTIQUE / AVEC VELCRO / BANDE VELCRO / PARTIE SUPÉRIEURE, VÊTEMENTS / POUR VÊTEMENTS / ",
                "issue": "24/11/2021",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2021-09315",
                "designation": "Assortiment de deux articles, confectionnés en étoffe de bonneterie de fibres acryliques (100 %) doublée de fibres de polyester (100 %), se décomposant en : - un bonnet, muni d'un pompon, - un tour du cou assorti aux couleurs du bonnet.",
                "expiry_date": "06/02/2025 ",
                "keywords": " / BONNET / AVEC BANDE AUTOUR DU COU / ÉTOFFE DE BONNETERIE / DE FIBRE SYNTHÉTIQUE / D'ACRYLIQUE / DE POLYESTER / ASSORTIMENT, VÊTEMENTS / MARCHANDISE PRÉS. EN ASSORTIMENT / AVEC POMPON / AVEC DOUBLURE / ",
                "issue": "07/02/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2021-09364",
                "designation": "Chapeau, de type haut-de-forme, confectionné à partir d’une seule pièce en feutrine, dont la calotte est de forme cylindrique et d’une hauteur de 13 cm, et dont les bords sont légèrement courbés. Existe en deux modèles : blanc ou gris avec des têtes de mort imprimées.",
                "expiry_date": "07/02/2025 ",
                "keywords": " / CHAPEAU / CHAPEAU HAUT DE FORME / CALOTTE / DE FORME CYLINDRIQUE / CONFECTIONNÉ / DE FEUTRINE / BORD, CHAPEAU / AVEC MOTIF / IMPRIMÉ / ",
                "issue": "08/02/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-00060",
                "designation": "Filet à cheveux, confectionné à partir de fibres synthétiques (100 % polyamide), avec une base élastiquée comportant un élément décoratif de type dentelle.",
                "expiry_date": "11/04/2025 ",
                "keywords": " / FILET, RÉSEAU DE MAILLES / FILET À CHEVEUX / CONFECTIONNÉ / DE FIBRE SYNTHÉTIQUE / POLYAMIDE / AVEC ÉLASTIQUE / À LA BASE / AVEC DENTELLE / ",
                "issue": "12/04/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-01073",
                "designation": "Cagoule de protection pour soudeur, recouvrant entièrement la tête (sauf le visage), le cou et les épaules, de couleur bleu foncé, composé majoritairement de pièces de tissu de coton (98%), et de carbone (2%). Cette cagoule est composée d'un tissu retardateur de flammes (ignifugée), et est dotée de bandes auto-agrippantes sur le dessus de la tête, et d'un système de fermeture avec bandes auto-agrippantes sous le menton. Densité : 350 g/m².",
                "expiry_date": "19/06/2025 ",
                "keywords": " / CAGOULE / POUR SOUDAGE / POUR PROTECTION CONTRE LA CHALEUR / DE TISSU / DE COTON / COMPRENANT DES FERMETURES VELCRO / ",
                "issue": "20/06/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-01080",
                "designation": "Cagoule de type « passe-montagne », de couleur noire, couvrant la tête et le cou, avec une ouverture sur le devant laissant apparaître les yeux. Elle est composée de fibres modal (46 %), coton (47 %) et élasthanne (7 %). Grammage : 200 g/m².",
                "expiry_date": "06/04/2025 ",
                "keywords": " / CAGOULE / DE FIBRE SYNTHÉTIQUE / DE FIBRE ARTIFICIELLE / FIBRE TEXTILE / DE MODAL / D'ELASTHANE / DE COTON / AVEC OUVERTURE PARTIELLE / ",
                "issue": "07/04/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-01767",
                "designation": "Serviette pour cheveux, confectionnée en microfibres synthétiques absorbantes (polyester 85 % et polyuréthane 15 %), comportant un système d’attache. Elle est destinée à recouvrir les cheveux, de part sa forme anatomique, pour les sécher. Dimensions : 67 x 27 cm.",
                "expiry_date": "22/06/2025 ",
                "keywords": " / COIFFE / TURBAN / SERVIETTE / SERVIETTE DE BAIN / CONFECTIONNÉ / MICROFIBRE / DE FIBRE SYNTHÉTIQUE / DE POLYESTER / DE POLYURÉTHANE / ",
                "issue": "23/06/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-01781",
                "designation": "Bonnet fantaisiste, en bonneterie de fibres synthétiques de polyester (100 %), ayant l’aspect d’une peluche représentant un léopard, par la présence des yeux, des oreilles, du museau rembourré et du pelage moucheté. Ce couvre-chef est aussi une écharpe à nouer au moyen des pompons suspendus aux extrémités de ce qui s'apparente à des pattes avant de l'animal imité. Poids : 115 g. Dimensions (L x l x h) : 25 x 9 x 19 cm.",
                "expiry_date": "26/10/2025 ",
                "keywords": " / COIFFURES / BONNET / ÉCHARPE / EN BONNETERIE / DE POLYESTER / DE FANTAISIE / BONNETERIE PELUCHE / EN FORME D'ANIMAL / FÉLIN SAUVAGE / DE MATIÈRE TEXTILE / ",
                "issue": "27/10/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-01803",
                "designation": "Coiffure, de type serviette pour cheveux,confectionnée en matière textile (microfibres). Cet article est destiné à être porté sur la tête afin de faciliter le séchage des cheveux, en réduisant les frottements et en évitant de les casser.",
                "expiry_date": "13/06/2025 ",
                "keywords": " / COIFFURES / CHEVEUX / TURBAN / DE MATIÈRE TEXTILE / MICROFIBRE / ",
                "issue": "14/06/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-02750",
                "designation": "Chapeau de déguisement de couleur rose, confectionné en feutrine, décoré de plumes organiques et revêtue de différentes mentions en fonction du modèle telles que l'âge, miss retraite... Cet article est destiné à un usage festif.",
                "expiry_date": "18/07/2025 ",
                "keywords": " / CHAPEAU / CONFECTIONNÉ / DE FEUTRINE / À USAGE FESTIF / POUR FEMMES / COIFFE / DÉGUISEMENT / ",
                "issue": "19/07/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-04239",
                "designation": "Bonnet pour bébé confectionné en bonneterie (jersey, 100% coton), de forme conique, comportant un revers sur la base. Il peut comporter un dessin brodé ou imprimé, ainsi que des oreilles.",
                "expiry_date": "29/08/2025 ",
                "keywords": " / ARTICLE TEXTILE / CONFECTIONNÉ / BONNET / POUR BÉBÉS / BONNETERIE / COTON / ",
                "issue": "30/08/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-04697",
                "designation": "Cagoule avec masque de protection en non tissé de polypropylène, utilisée comme protection individuelle jetable dans des secteurs tels que l’agro-alimentaire ou l’industrie. Ce produit est conditionné par sachet de 50, et carton de 500 unités, mis sur palette.",
                "expiry_date": "10/10/2025 ",
                "keywords": " / CAGOULE / MASQUE / DE NONTISSÉ / POUR PROTECTION / COIFFE / JETABLE / CONDITIONNÉ POUR VENTE AU DÉTAIL / ",
                "issue": "11/10/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-06601",
                "designation": "Ensemble de naissance pour bébés, conditionné pour la vente au détail, d’un coffret comprenant : - Un bonnet de forme conique, en étoffe de bonneterie de coton, avec un revers sur la base. Il peut comporter un dessin brodé ou imprimé, ainsi que des oreilles. - Une paire de moufles en étoffe de bonneterie de coton avec un revers au niveau des poignets. Le coffret se décline en plusieurs modèles.",
                "expiry_date": "06/11/2025 ",
                "keywords": " / COFFRET / MARCHANDISE PRÉS. EN ASSORTIMENT / BONNET / POUR BÉBÉS / ÉTOFFE DE BONNETERIE / COTON / AVEC REVERS / MOUFLE / IMPRIMÉ / AVEC MOTIF / AVEC BRODERIE / PRÉSENTÉ EN EMBALLAGE / CONFECTIONNÉ / ",
                "issue": "07/11/2022",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-07564",
                "designation": "Bonnet de nuit, confectionné en tissu de matière textile en satin, de fibres synthétiques (100 % polyester). L’article existe en différents modèles et couleurs. Certains modèles se présentent sous forme de turban, froncé sur tout le pourtour. Cet article est utilisé pour la protection de la chevelure et éviter les frisottis.",
                "expiry_date": "16/02/2026 ",
                "keywords": " / BONNET / DE MATIÈRE TEXTILE / CONFECTIONNÉ / SATIN / DE FIBRE SYNTHÉTIQUE / POLYESTER / AVEC BORD ÉLASTIQUE / POUR PROTECTION / CHEVEUX / VÊTEMENT DE NUIT / ",
                "issue": "17/02/2023",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-08653",
                "designation": "Bonnet à revers pour adulte, confectionné en bonneterie de fibres synthétiques (de polyester ou acrylique selon les modèles). Cet article est destiné à un usage lors d’intervention dans des milieux froids dans les domaines du B.T.P, l'agriculture, l'horticulture, la pêche, l'entretien des espaces verts ou les loisirs. Le bonnet existe en une déclinaison de modèles et en divers coloris. L’article est conditionné par lot de 10 dans un sachet, puis dans des cartons par 100.",
                "expiry_date": "01/01/2026 ",
                "keywords": " / BONNET / AVEC REVERS / UNISEXE / POUR ADULTES / CONFECTIONNÉ / ÉTOFFE DE BONNETERIE / DE FIBRE SYNTHÉTIQUE / POLYESTER / ACRYLIQUE / TÊTE / POUR PROTECTION / POUR PROTECTION CONTRE LE FROID / CONDITIONNÉ POUR VENTE AU DÉTAIL / PRÉSENTÉ EN EMBALLAGE / CARTON / ",
                "issue": "02/01/2023",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2022-08699",
                "designation": "Bonnet, de type « chapka » fantaisiste, en tissu peluché de fibres synthétiques (100 % polyester), pouvant représenter divers animaux ou personnages stylisés, dotés d’une tête, d’oreilles et de deux longues pattes (ou pieds) couvrant les oreilles jusqu’aux épaules. Ces pattes peuvent bouger et se relever ponctuellement au moyen de poires de gonflage situées à l’extrémité des pattes. L’article dispose également d’un bouton poussoir, doté d’une fonction ON/OFF, permettant d’activer des diodes électroluminescentes (LED), fonctionnant avec des piles. Modèles : licorne, lapin, chien, père noël. Dimensions à plat : 70 cm.",
                "expiry_date": "20/03/2026 ",
                "keywords": " / COIFFURES / BONNET / TISSU / DE MATIÈRE TEXTILE SYNTHÉTIQUE / POLYESTER / PELUCHE, TISSU / EN FORME D'ANIMAL / DIODE / ÉLECTROLUMINESCENT / LED / ",
                "issue": "21/03/2023",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2023-02522",
                "designation": "Coiffure, de type turban, confectionnée en matière textile de fibres synthétiques (polyester), comportant un système d’attache. Elle est destinée à recouvrir les cheveux grâce à sa forme anatomique.",
                "expiry_date": "19/06/2026 ",
                "keywords": " / COIFFE / TURBAN / CONFECTIONNÉ / DE FIBRE SYNTHÉTIQUE / DE POLYESTER / ",
                "issue": "20/06/2023",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2023-03247-02",
                "designation": "Assortiment d'articles de déguisement, pour enfants, composé de 3 pièces : - un vêtement destiné à couvrir le haut du corps effet trompe l’œil chemise/veste/ceinture, non reconnaissable comme étant pour hommes ou pour femmes dont la majeure partie de la surface extérieure est confectionné d’étoffe de bonneterie de fibres synthétiques de polyester, - un pantalon confectionné majoritairement en étoffe de bonneterie de fibres synthétiques de polyester, sans ouverture ni fermeture, non reconnaissable comme étant pour hommes ou pour femmes, - un chapeau de pirate confectionné en matière textile de polyester. L’ensemble représente un costume d’un personnage de fiction : Jack Sparrow. Ce RTC reprend uniquement le classement du chapeau de pirate, les autres marchandises feront l’objet d’un classement séparé.",
                "expiry_date": "03/07/2026 ",
                "keywords": " / MARCHANDISE PRÉS. EN ASSORTIMENT / PARTIE SUPÉRIEURE, VÊTEMENTS / ÉTOFFE DE BONNETERIE / CONFECTIONNÉ / DE FIBRE SYNTHÉTIQUE / DE POLYESTER / DÉGUISEMENT / PANOPLIE DE DÉGUISEMENT / POUR ENFANTS / PANTALON / CHAPEAU / PRÉSENTÉ EN EMBALLAGE / ",
                "issue": "04/07/2023",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2023-05493",
                "designation": "Coiffure confectionnée en matière textile de fibres artificielles de bambou (90%) et de fibres synthétiques de polyester (10%), de type serviette pour cheveux, de forme anatomique, comportant un système d’attache au moyen d’un bouton et d’un lien, afin de recouvrir et maintenir les cheveux et d’en faciliter leur séchage.",
                "expiry_date": "06/02/2027 ",
                "keywords": " / COIFFURES / TURBAN / DE MATIÈRE TEXTILE / TEXTILES ET ARTICLES TEXTILES / DE TISSU / TISSU BOUCLE DU GENRE ÉPONGE / AVEC BOUTON / CHEVEUX / ",
                "issue": "07/02/2024",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2023-05952",
                "designation": "Ensemble de naissance pour bébés, conditionné pour la vente au détail dans un coffret comprenant : - Un bonnet de forme conique, en étoffe de bonneterie de coton (100%), doté d’un revers sur la base. Celui-ci peut comporter un dessin brodé ou imprimé, ainsi que des oreilles. - Une paire de moufles en étoffe de bonneterie de coton (100%), dotée d’un revers au niveau des poignets.",
                "expiry_date": "25/10/2026 ",
                "keywords": " / MARCHANDISE PRÉS. EN ASSORTIMENT / ARTICLE TEXTILE / POUR BÉBÉS / BONNET / MOUFLE / CONFECTIONNÉ / ÉTOFFE DE BONNETERIE / COTON / IMPRIMÉ / AVEC MOTIF / AVEC BRODERIE / AVEC REVERS / CONDITIONNÉ POUR VENTE AU DÉTAIL / COFFRET / ",
                "issue": "26/10/2023",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2024-00639",
                "designation": "Bonnet, de type « chapka » fantaisiste, en tissu peluché de fibres synthétiques (100 % polyester), pouvant représenter une citrouille ou un fantôme, dotés d’une tête, d’oreilles et de deux longues pattes (ou pieds) couvrant les oreilles jusqu’aux épaules. Les oreilles peuvent bouger et se relever ponctuellement au moyen de poires de gonflage situées à l’extrémité des pattes.",
                "expiry_date": "06/05/2027 ",
                "keywords": " / BONNET / COIFFURES / DE MATIÈRE TEXTILE / TISSU / DE MATIÈRE TEXTILE SYNTHÉTIQUE / POLYESTER / PELUCHE, TISSU / EN FORME D'ANIMAL / ",
                "issue": "07/05/2024",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2024-00841-01",
                "designation": "Assortiment de marchandises conditionnées ensemble pour la vente au détail dans un coffret pour adultes, en carton imprimé, comprenant : - 1 livret de 32 pages contenant des conseils pour la vie quotidienne, l’art de vivre etc, - un mug en céramique (porcelaine), - un bonnet en acrylique doté d’une étiquette brodée et d’un revers à la base. Ce RTC ne reprend que le bonnet, les autres articles faisant l'objet d'un classement séparé.",
                "expiry_date": "17/03/2027 ",
                "keywords": " / MARCHANDISE PRÉS. EN ASSORTIMENT / CONDITIONNÉ POUR VENTE AU DÉTAIL / COFFRET / ARTICLE TEXTILE / CONFECTIONNÉ / ACRYLIQUE / AVEC BRODERIE / AVEC REVERS / BONNET / ",
                "issue": "18/03/2024",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2024-00843-03",
                "designation": "Assortiment de marchandises conditionnées ensemble pour la vente au détail dans un coffret pour adultes, en carton imprimé, comprenant : - 1 livret de 32 pages contenant des recettes gourmandes, - un mug en céramique (porcelaine), - un bonnet en acrylique doté d’une étiquette brodée et d’un revers à la base. Ce RTC ne reprend que le bonnet, les autres articles faisant l'objet d'un classement séparé.",
                "expiry_date": "01/04/2027 ",
                "keywords": " / MARCHANDISE PRÉS. EN ASSORTIMENT / CONDITIONNÉ POUR VENTE AU DÉTAIL / COFFRET / ARTICLE TEXTILE / CONFECTIONNÉ / BONNET / ACRYLIQUE / AVEC BRODERIE / AVEC REVERS / ",
                "issue": "02/04/2024",
                "language": "fr"
            },
            {
                "hscode": "6505009090",
                "country": "FRA",
                "id": "FRBTIFR-BTI-2024-00850-03",
                "designation": "Assortiment de marchandises conditionnées ensemble pour la vente au détail, dans une boite en carton, imprimée, dotée d’une cloche en matière plastique, comprenant : - un livre de 48 pages contenant des conseils pour l'entretien et le soin des barbes et moustaches ; - un mug en céramique (porcelaine) ; - un bonnet en acrylique (100%) ; - une paire de ciseaux en métal ; - une pince à épiler en métal ; - un peigne en bois acajou ; Ce RTC ne reprend que le bonnet en acrylique (100%), les autres articles du coffret faisant l’objet de classements séparés.",
                "expiry_date": "01/04/2027 ",
                "keywords": " / MARCHANDISE PRÉS. EN ASSORTIMENT / CONDITIONNÉ POUR VENTE AU DÉTAIL / COFFRET / CARTON / IMPRIMÉ / LIVRE / TASSE / DE CÉRAMIQUE / PORCELAINE / AVEC ACCESSOIRES / BONNET / ACRYLIQUE / ",
                "issue": "02/04/2024",
                "language": "fr"
            }
        ]
    }
]

400

1. Incorrect Json (json body request incorrect)

Response Example: 
{
    "code": "INCORRECT_JSON",
    "name": "ClientError",
    "message": "Incorrect Json Request",
    "details": [
        {
            "parameter": {
                "name": "to_country",
                "value": "FRANCE"
            },
            "causes": [
                "to_country should be ISO3 or ISO2"
            ]
        }
    ]
}

403

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"
            ]
        }
    ]
}

404

{
    "code": "DATA_NOT_FOUND",
    "name": "BusinessError",
    "message": "Sorry, we did not find the data you are trying to retrieve",
    "details": []
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

Check

Check

Check if the hscode is a right hscode for a specific country

POST https://api.transiteo.io/v1/taxsrv/verifyhscode

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

JSON REQUEST FORMAT

{
  "origin_country": "FRA",
  "hscode": "6505009090"
}

Response

200

{
    "isRightHscode": false
}

400

1. Incorrect Json (json body request incorrect
a)
    @ValidateNested()
    product: {
        identification: HsCodeFinderIdentification
    };
    @IsNotEmpty()
    @Length(3, 3, {message: "to_country should be ISO3"})
    to_country: string;

    @ValidateIf(o => o.product.identification.type == HsCodeFinderEnum.HSCODE)
    @IsNotEmpty()
    @Length(3, 3, {message: "from_country should be ISO3"})
    from_country: string;

    @IsEnum(LANG_ENUM, {
        message: `Lang is required and should be fill with one of these values : ${JSON.stringify(Object.keys(LANG_ENUM).map(k => k.toLowerCase()))}`
    })
    lang: string;

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": [
                "[\"from_country should be ISO3"]"
            ]
        }
    ]
}

2. The barcode given in the request is not a barcode

{
    "code": "NOT_BARCODE",
    "httpCode": 400,
    "name": "ClientError",
    "message": "This is not a valid barcode",
    "details": []
}

Untitled

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

A.I Customs Code Control

A.I Customs Code Control

Control with A.I if the HSCode be equivalent to product title or description

POST https://api.transiteo.io/v1/customscode/control

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

JSON REQUEST FORMAT

{
    "requests": [
        {
            "hscode": "9506620090",
            "to_country": "FRA",
            "text": "Ballon de football"
        },
        {
            "hscode": "6505003100",
            "to_country": "FRA",
            "text": "Boite de thon"
        }
    ]
}

Response

200

[
    {
        "scoring_control": 86.9,
        "hscodes_proposals": [
            {
                "hscode": "9506620000",
                "score": 69
            },
            {
                "hscode": "9506699000",
                "score": 25.9
            },
            {
                "hscode": "9506999000",
                "score": 1.2
            }
        ]
    },
    {
        "scoring_control": 3.56,
        "hscodes_proposals": [
            {
                "hscode": "1604142100",
                "score": 35.6
            },
            {
                "hscode": "1604142800",
                "score": 24.7
            },
            {
                "hscode": "1604144890",
                "score": 14.1
            }
        ]
    }
]

400

Incorrect Json (json body request incorrect) : a description of the error will be returned

403

wrong token id or token has expired

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

Landed Cost

Landed Cost

Get duty and taxes calculation from an invoice pdf

STEP 1

POST https://api.transiteo.io/v1/importFileService/invoicePdf/landedCost

Get a timestamp to request the step 2

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

JSON REQUEST FORMAT

{
  "content": "data:application/pdf;base64,JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PA..."
}

Response

200

{
    "timestamp": 1671483327236
}

400

Incorrect Json (json body request incorrect)

403

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"
            ]
        }
    ]
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

STEP 2

GET https://api.transiteo.io/v1/importFileService/invoicePdf/landedCost/{timestamp}

Get Duty and Taxes caclulation result

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

Path parameters

Name Type Description
timestamp string timestamp in millis

Response

200

{
    "dutyCalculationResponse": {
        "products": [
            {
                "identification": {
                    "type": "HSCODE",
                    "value": "6109100010"
                },
                "product_statut": "Authorized for importation into this country",
                "amount_exclusive": 998,
                "amount_inclusive_vat": 998,
                "amount_duty_and_tax": 0,
                "amount_total": 998,
                "percentage_duty_and_tax": 0,
                "duty": null,
                "special_taxes": [],
                "vat": []
            },
            {
                "identification": {
                    "type": "HSCODE",
                    "value": "9507900000"
                },
                "product_statut": "Restricted for importation into this country",
                "amount_exclusive": 998,
                "amount_inclusive_vat": 998,
                "amount_duty_and_tax": 0,
                "amount_total": 998,
                "percentage_duty_and_tax": 0,
                "duty": null,
                "special_taxes": [],
                "vat": []
            },
            {
                "identification": {
                    "type": "HSCODE",
                    "value": "9506999000"
                },
                "product_statut": "Restricted for importation into this country",
                "amount_exclusive": 998,
                "amount_inclusive_vat": 998,
                "amount_duty_and_tax": 0,
                "amount_total": 998,
                "percentage_duty_and_tax": 0,
                "duty": null,
                "special_taxes": [],
                "vat": []
            },
            {
                "identification": {
                    "type": "HSCODE",
                    "value": "6302910090"
                },
                "product_statut": "Authorized for importation into this country",
                "amount_exclusive": 937.5,
                "amount_inclusive_vat": 937.5,
                "amount_duty_and_tax": 0,
                "amount_total": 937.5,
                "percentage_duty_and_tax": 0,
                "duty": null,
                "special_taxes": [],
                "vat": []
            }
        ],
        "shipping_global": {
            "vat": null,
            "duty": null,
            "special_taxes": null,
            "amount_exclusive": 0,
            "amount_inclusive_vat": 0,
            "amount_total": 0,
            "amount_duty_and_tax": 0,
            "percentage_duty_and_tax": null
        },
        "packaging_global": {
            "vat": null,
            "duty": null,
            "special_taxes": null,
            "amount_exclusive": 0,
            "amount_inclusive_vat": 0,
            "amount_total": 0,
            "amount_duty_and_tax": 0,
            "percentage_duty_and_tax": null
        },
        "insurance_global": {
            "vat": null,
            "duty": null,
            "special_taxes": null,
            "amount_exclusive": 0,
            "amount_inclusive_vat": 0,
            "amount_total": 0,
            "amount_duty_and_tax": 0,
            "percentage_duty_and_tax": null
        },
        "transit_fees_global": null,
        "global": {
            "amount": 0,
            "amount_exclusive": 3931.5,
            "amount_inclusive_vat": 3931.5,
            "amount_total": 3931.5,
            "amount_duty_and_tax": 0,
            "percentage_duty_and_tax": 0
        }
    },
}

401

{
    "message": "The incoming token has expired"
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

Taxes Invoice

Taxes Invoice

Get taxes invoice from an invoice pdf

STEP 1

POST https://api.transiteo.io/v1/importFileService/invoicePdf/taxesInvoice

Get a timestamp to request the step 2

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

JSON REQUEST FORMAT

{
  "content": "data:application/pdf;base64,JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PA..."
}

Response

200

{
    "timestamp": 1671483327236
}

400

Incorrect Json (json body request incorrect)

403

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"
            ]
        }
    ]
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

STEP 2

GET https://api.transiteo.io/v1/importFileService/invoicePdf/taxesInvoice/{timestamp}

Get Taxes invoice result

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

Path parameters

Name Type Description
timestamp string timestamp in millis

Response

200

{
    "documents": [
        {
            "id": "sub_HIHEBIHCGBHGBTi6pfFQ3ismC66hkQ",
            "url": "https://services.dev.transiteo.io/templates/taxesInvoice/sub_HIHEBIHCGBHGBTi6pfFQ3ismC66hkQ.pdf"
        }
    ]
}

401

{
    "message": "The incoming token has expired"
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

Export invoice

Export invoice

Get export invoice from a local invoice

STEP 1

POST https://api.transiteo.io/v1/importFileService/invoicePdf/exportInvoice

Get a timestamp to request the step 2

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

JSON REQUEST FORMAT

{
  "content": "data:application/pdf;base64,JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PA..."
}

Response

200

{
    "timestamp": 1671483327236
}

400

Incorrect Json (json body request incorrect)

403

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"
            ]
        }
    ]
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

STEP 2

GET https://api.transiteo.io/v1/importFileService/invoicePdf/exportInvoice``/{timestamp}

Get export invoice result

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

Path parameters

Name Type Description
timestamp string timestamp in millis

Response

200

{
    "documents": [
        {
            "id": "sub_HIHEBIHCGBHGBTi6pfFQ3ismC66hkQ",
            "url": "https://services.dev.transiteo.io/templates/exportInvoice/sub_HIHEBIHCGBHGBTi6pfFQ3ismC66hkQ.pdf"
        }
    ]
}

401

{
    "message": "The incoming token has expired"
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

H7 Declaration (Akanea)

H7 Declaration (Akanea)

Get XML File to import in AKANEA Customs software from an invoice

STEP 1

POST https://api.transiteo.io/v1/importFileService/invoicePdf/h7Declaration

Get a timestamp to request the step 2

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

JSON REQUEST FORMAT

{
  "content": "data:application/pdf;base64,JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PA..."
}

Response

200

{
    "timestamp": 1671483327236
}

400

Incorrect Json (json body request incorrect)

403

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"
            ]
        }
    ]
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

STEP 2

GET https://api.transiteo.io/v1/importFileService/invoicePdf/h7Declaration/{timestamp}

Get export invoice result

Headers

Name Value
Content-Type application/json
Authorization id token from cognito

Path parameters

Name Type Description
timestamp string timestamp in millis

Response

200

<CustomsH7DeclarationMessage>
    <Header>
        <CustomsHeader>
            <DecHeader>
                <DecLrn>TNICOLASB1718491591353</DecLrn>
            </DecHeader>
        </CustomsHeader>
        <InternalHeader>
            <DatTimMsg>2024-06-15T22:46:31</DatTimMsg>
            <UsrGroupe>TRANSITEO</UsrGroupe>
            <UsrCode>TRANSITEO_DEMO</UsrCode>
            <DecSchemaIntern>1</DecSchemaIntern>
            <DecAppId>H7T</DecAppId>
            <DecRefintdos>2022-02-11</DecRefintdos>
            <CusActCod>1</CusActCod>
            <IntActCod>0</IntActCod>
        </InternalHeader>
    </Header>
    <Declaration>
        <DecTypDec>CO</DecTypDec>
        <DecAddDecTyp>A</DecAddDecTyp>
        <DecAgrNum>12341234</DecAgrNum>
        <DecDeclOffice>FRA12345</DecDeclOffice>
        <DecPresOffice>FRA12345</DecPresOffice>
        <DecLocGds>STORE WAREHOUSE</DecLocGds>
        <DecGroMass>120</DecGroMass>
        <DecImporter>
            <DecImpName>Ma compagnie</DecImpName>
            <DecImpCountry>FRA</DecImpCountry>
            <DecImpPostcode>65000</DecImpPostcode>
            <DecImpCity>Tarbes</DecImpCity>
            <DecImpStreet>Rue du maréchal Foch</DecImpStreet>
        </DecImporter>
        <DecExporter>
            <DecExpName>Ma compagnie</DecExpName>
            <DecExpCountry>FRA</DecExpCountry>
            <DecExpPostcode>65000</DecExpPostcode>
            <DecExpCity>Tarbes</DecExpCity>
            <DecExpStreet>Rue du maréchal Foch</DecExpStreet>
        </DecExporter>
        <DecRepresentative>
            <DecRepStatus>1</DecRepStatus>
            <DecRepConName>NICOLAS BERTUOL</DecRepConName>
            <DecRepConPhone>+33601020304</DecRepConPhone>
            <DecRepConEmail>n.icola.s.b.ertuo.l@gmail.com</DecRepConEmail>
        </DecRepresentative>
        <DecDeclarant>
            <DecDecName>Ma compagnie</DecDecName>
            <DecDecCountry>FRA</DecDecCountry>
            <DecDecPostcode>65000</DecDecPostcode>
            <DecDecCity>Tarbes</DecDecCity>
            <DecDecStreet>Rue du maréchal Foch</DecDecStreet>
            <DecDecConName>NICOLAS BERTUOL</DecDecConName>
            <DecDecConPhone>+33601020304</DecDecConPhone>
            <DecDecConEmail>n.icola.s.b.ertuo.l@gmail.com</DecDecConEmail>
        </DecDeclarant>
        <GoodsList>
            <Goods>
                <GdsIteNum>1</GdsIteNum>
                <GdsAddProc1>F48</GdsAddProc1>
                <GdsNbPackages>1</GdsNbPackages>
                <GdsDescription>Smartphone</GdsDescription>
                <GdsNomenc>8517130000</GdsNomenc>
                <GdsIntrValue>14400</GdsIntrValue>
                <GdsIntrValueCur>EUR</GdsIntrValueCur>
                <GdsTrspCost>0</GdsTrspCost>
                <GdsTrspCostCur>EUR</GdsTrspCostCur>
                <GdsGroMass>120</GdsGroMass>
            </Goods>
        </GoodsList>
    </Declaration>
    <requestType>1</requestType>
</CustomsH7DeclarationMessage>

401

{
    "message": "The incoming token has expired"
}

500

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

Duty & Taxes Calculator

Duty & Taxes Calculator

For E-Commerce

For E-Commerce

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"

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

400: Bad Request

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": []
}

403: Forbidden

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"
            ]
        }
    ]
}

404: Not Found

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": "<productFromClient>"
            },
            "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": []
}

500: Internal Server Error

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

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,
    "sales_term" : 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 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 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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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"

E-Commerce\ Type : string\ Required: yes

"sales_term"

2 options : "btoc" or "btob"\ Type : string\ Required: optional

"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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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 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 with our support team.

Video explainer

in progress...

Warning : 1 product = 1 request / 3 products = 3 requests

If you prefer get the rates (duty, vat, salestaxes, ...), use this API !

For Marketplace

For Marketplace

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"

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

400: Bad Request

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": []
}

403: Forbidden

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"
            ]
        }
    ]
}

404: Not Found

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": "<productFromClient>"
            },
            "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": []
}

500: Internal Server Error

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

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,
    "sales_term" : 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 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 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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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

"sales_term"

2 options : "btoc" or "btob"\ Type : string\ Required: optional

"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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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 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 with our support team.

Video explainer

in progress...

Warning : 1 product = 1 request / 3 products = 3 requests

If you prefer get the rates (duty, vat, salestaxes, ...), use this API !

For Shipping Comparator

For Shipping Comparator

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"

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

400: Bad Request

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": []
}

403: Forbidden

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"
            ]
        }
    ]
}

404: Not Found

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": "<productFromClient>"
            },
            "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": []
}

500: Internal Server Error

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

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 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 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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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 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 with our support team.

Video explainer

in progress...

Warning : 1 product = 1 request / 3 products = 3 requests

If you prefer get the rates (duty, vat, salestaxes, ...), use this API !

For International Carrier

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"

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

400: Bad Request

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": []
}

403: Forbidden

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"
            ]
        }
    ]
}

404: Not Found

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": "<productFromClient>"
            },
            "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": []
}

500: Internal Server Error

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

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 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 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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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 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 with our support team.

Video explainer

in progress...

Warning : 1 product = 1 request / 3 products = 3 requests

If you prefer get the rates (duty, vat, salestaxes, ...), use this API !

Using Product's HS Code

Using Product's HS Code

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"

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

400: Bad Request

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": []
}

403: Forbidden

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"
            ]
        }
    ]
}

404: Not Found

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": "<productFromClient>"
            },
            "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": []
}

500: Internal Server Error

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

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": number, 
        "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
        },
        "transit_fees" : {
            "percentage": number,
            "amount" : number, 
            "currency" : string,  
            "on_products_price": boolean, 
            "on_shipping_products_price": boolean, 
            "on_global": boolean
        }
    }
],
    "from_country": string,
    "to_country": string,
    "to_district": string,
    "shipment_type": string,
    "ecommerce_type": string, 
    "global_ship_price": number,
    "currency_global_ship_price": string,
    "global_packaging_price": number,
    "currency_global_packaging_price": string,
    "global_insurance_price": number,
    "currency_global_insurance_price": string,
    "included_tax": boolean,
    "incoterm": string,
    "extra_fees": number,
    "sender": {
      "pro": boolean,
      "revenue_country_annual": number,
      "currency_revenue_country_annual": string
    },
    "receiver": {
      "pro": boolean,
      "activity_id": string
    },
    "transit_fees" : {
      "percentage": number,
      "amount" : number, 
      "currency" : string,  
      "on_products_price": boolean, 
      "on_shipping_products_price": boolean, 
      "on_global": boolean
    }
}

For Sellers

JSON request format :
For 1 product and 1 product unit.
{
    "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,
    "shipment_type": string,
    "included_tax": boolean,
    "incoterm": string,
    "extra_fees": number,
    "sender": {
      "pro": boolean,
      "revenue_country_annual": number,
      "currency_revenue_country_annual": string
    },
    "receiver": {
      "pro": boolean,
      "activity_id": string
    },
    "duty_fees" : {
      "percentage": number,
      "amount" : number, 
      "currency" : string,  
      "on_products_price": boolean, 
      "on_shipping_products_price": boolean, 
      "on_global": boolean
    }
}
JSON request format :
For 1 product and more than 2 product units.
{
    "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,
    "shipment_type": string,
    "included_tax": boolean,
    "incoterm": string,
    "extra_fees": number,
    "sender": {
      "pro": boolean,
      "revenue_country_annual": number,
      "currency_revenue_country_annual": string
    },
    "receiver": {
      "pro": boolean,
      "activity_id": string
    },
    "duty_fees" : {
      "percentage": number,
      "amount" : number, 
      "currency" : string,  
      "on_products_price": boolean, 
      "on_shipping_products_price": boolean, 
      "on_global": boolean
    }
}
JSON request format :
For more than 2 differents products
{
    "products": [{
        "identification":{"type": "HSCODE", "value": string},
        "weight": number,
        "weight_unit": string,
        "quantity": number,
        "unit_price": number,
        "currency_unit_price": string,
        "origin_country": string
      },
      {
        "identification":{"type": "HSCODE", "value": string},
        "weight": number,
        "weight_unit": string,
        "quantity": number,
        "unit_price": number,
        "currency_unit_price": string,
        "origin_country": string
      }
    ],
    "from_country": string,
    "to_country": string,
    "shipment_type": string,
    "global_ship_price": number,
    "currency_global_ship_price": string,
    "global_packaging_price": number,
    "currency_global_packaging_price": string,
    "global_insurance_price": number,
    "currency_global_insurance_price": string,
    "included_tax": boolean,
    "incoterm": string,
    "extra_fees": number,
    "sender": {
      "pro": boolean,
      "revenue_country_annual": number,
      "currency_revenue_country_annual": string
    },
    "receiver": {
      "pro": boolean,
      "activity_id": string
    },
    "duty_fees" : {
      "percentage": number,
      "amount" : number, 
      "currency" : string,  
      "on_products_price": boolean, 
      "on_shipping_products_price": boolean, 
      "on_global": boolean
    }
}

For Marketplaces

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 Shipping platforms

JSON request format :
For 1 parcel with 1 product unit
{
    "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
        }
    }
],
    "shipment_type": string,
    "ecommerce_type": string, 
    "extra_fees": number,
    "receiver": {
      "pro": boolean,
      "activity_id": string
    }
}
JSON request format :
For 1 parcel and more than 2 differents products
{
    "products": [{
        "identification":{"type": "HSCODE", "value": string},
        "weight": number,
        "weight_unit": string,
        "quantity": number,
        "unit_price": number,
        "currency_unit_price": string,        
        "origin_country": string
    },
{
        "identification":{"type": "HSCODE", "value": string},
        "weight": number,
        "weight_unit": string,
        "quantity": number,
        "unit_price": number,
        "currency_unit_price": string,        
        "origin_country": string
    }
],
    "from_country": string,
    "to_country": string,
    "shipment_type": string,
    "ecommerce_type": string, 
    "global_ship_price": number,
    "currency_global_ship_price": string,
    "global_packaging_price": number,
    "currency_global_packaging_price": string,
    "global_insurance_price": number,
    "currency_global_insurance_price": string,
    "included_tax": boolean,
    "incoterm": string,
    "extra_fees": number,
    "sender": {
      "pro": boolean,
      "revenue_country_annual": number,
      "currency_revenue_country_annual": string
    },
    "receiver": {
      "pro": boolean,
      "activity_id": string
    },
    "duty_fees" : {
      "percentage": string,
      "amount" : number, 
      "currency" : string,  
      "on_products_price": boolean, 
      "on_shipping_products_price": boolean, 
      "on_global": boolean
    }
}
JSON request format :
For more than 2 parcels and minimum 2 differents products
{
    "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": "EUR"
        },
        "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 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 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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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"

ESHOP or 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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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": {
                "value": string,
                "type": string
            },
            "product_statut": string,
            "amount_exclusive": number,
            "amount_inclusive_vat": number,
            "amout_duty_and_tax": number,
            "amount_total": number,
            "product_co2": number,
            "percentage_duty_and_tax": number,
            “amount_ecoTax”: number,
            “transit_fees”: {
                “amount”: 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
            },
            "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],
            "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
            }
        ]
    }
],
        “shipping_global”: {
            "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }  
        },
        “packaging_global”: {
            "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
        ]        
        },
        “insurance_global”: {
            "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
        ]        
        },
        “transit_fees_global”: {
            “amount”: number
         },       
        “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,
            “products_co2": number
        },
        “timestamp”: number
    },

For Sellers

JSON response format :
For 1 product and 1 product unit.
{
    "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": null
                }
            ]
        }
    ],
    "shipping_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "packaging_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "insurance_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "transit_fees_global": {
        “amount”: number
     },
    "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.
{
    "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
                }
            ]
        }
    ],
    "shipping_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "packaging_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "insurance_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "transit_fees_global": number,
    "incoterm": 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 differents products
{
    "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
            },
            "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
                }
            ]
        },
        {
            "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
            },
            "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
                }
            ]
        }
    ],
    "shipping_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            },
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "packaging_global": {
               "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            },
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "insurance_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            },
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "transit_fees_global": number,
    "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 Marketplaces

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 Shipping platforms

JSON response format :
For 1 parcel with 1 product unit
[
    {
        "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 1 parcel and more than 2 differents products
{
    "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": sring,
                "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
            },
            "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
                }
            ]
        },
        {
            "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
            },
            "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
                }
            ]
        }
    ],
    "shipping_global": {
        "duty": {
            "label": string,
            "amount": number,
            "vat_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,
                "amount": number,
                "percentage": number,
                "vat_amount": number
            }
        ],
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "packaging_global": {
        "duty": {
            "label": string,
            "amount": number,
            "vat_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,
                "amount": number,
                "percentage": number,
                "vat_amount": number
            }
        ],
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "insurance_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            },
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "transit_fees_global": {
        "amount": number
    },
    "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 parcels and minimum 2 differents products
[
    {
        "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 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 with our support team.

Video explainer

in progress...

Warning : 1 product = 1 request / 3 products = 3 requests

If you prefer get the rates (duty, vat, salestaxes, ...), use this API !

Using Product's SKU

Using Product's SKU

Duty & Taxes calculation thanks to a product's SKU

POST https://api.transiteo.io/v1/taxsrv/dutyCalculation

This endpoint allows you to calculate landest cost for a product in your catalog.

Headers

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

200

{
    "products": [{
        "identification": {
      "value": string,
      "type": string
    },
        "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
    }
}

All JSON Request fields

{
    "products": [{
        "identification":{"type": "SKU", "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": number, 
        "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
        },
        "transit_fees" : {
            "percentage": number,
            "amount" : number, 
            "currency" : string,  
            "on_products_price": boolean, 
            "on_shipping_products_price": boolean, 
            "on_global": boolean
        }
    }
],
    "from_country": string,
    "to_country": string,
    "to_district": string,
    "shipment_type": string,
    "ecommerce_type": string, 
    "sales_term": string,
    "global_ship_price": number,
    "currency_global_ship_price": string,
    "global_packaging_price": number,
    "currency_global_packaging_price": string,
    "global_insurance_price": number,
    "currency_global_insurance_price": string,
    "included_tax": boolean,
    "incoterm": string,
    "extra_fees": number,
    "sender": {
      "pro": boolean,
      "revenue_country_annual": number,
      "currency_revenue_country_annual": string
    },
    "receiver": {
      "pro": boolean,
      "activity_id": string
    },
    "transit_fees" : {
      "percentage": number,
      "amount" : number, 
      "currency" : string,  
      "on_products_price": boolean, 
      "on_shipping_products_price": boolean, 
      "on_global": boolean
    }
}

For Sellers

JSON request format :
For 1 product and 1 product unit.
{
    "products": [{
        "identification":{"type": "SKU", "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,
    "shipment_type": string,
    "included_tax": boolean,
    "incoterm": string,
    "extra_fees": number,
    "sender": {
      "pro": boolean,
      "revenue_country_annual": number,
      "currency_revenue_country_annual": string
    },
    "receiver": {
      "pro": boolean,
      "activity_id": string
    },
    "duty_fees" : {
      "percentage": number,
      "amount" : number, 
      "currency" : string,  
      "on_products_price": boolean, 
      "on_shipping_products_price": boolean, 
      "on_global": boolean
    }
}
JSON request format :
For 1 product and more than 2 product units.
{
    "products": [{
        "identification":{"type": "SKU", "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,
    "shipment_type": string,
    "included_tax": boolean,
    "incoterm": string,
    "extra_fees": number,
    "sender": {
      "pro": boolean,
      "revenue_country_annual": number,
      "currency_revenue_country_annual": string
    },
    "receiver": {
      "pro": boolean,
      "activity_id": string
    },
    "duty_fees" : {
      "percentage": number,
      "amount" : number, 
      "currency" : string,  
      "on_products_price": boolean, 
      "on_shipping_products_price": boolean, 
      "on_global": boolean
    }
}
JSON request format :
For more than 2 differents products
{
    "products": [{
        "identification":{"type": "SKU", "value": string},
        "weight": 1,
        "weight_unit": string,
        "quantity": number,
        "unit_price": number,
        "currency_unit_price": string,
        "origin_country": string
      },
      {
        "identification":{"type": "SKU", "value": string},
        "weight": number,
        "weight_unit": string,
        "quantity": number,
        "unit_price": number,
        "currency_unit_price": string,
        "origin_country": string
      }
    ],
    "from_country": string,
    "to_country": string,
    "shipment_type": string,
    "global_ship_price": number,
    "currency_global_ship_price": string,
    "global_packaging_price": number,
    "currency_global_packaging_price": string,
    "global_insurance_price": number,
    "currency_global_insurance_price": string,
    "included_tax": boolean,
    "incoterm": string,
    "extra_fees": number,
    "sender": {
      "pro": boolean,
      "revenue_country_annual": number,
      "currency_revenue_country_annual": string
    },
    "receiver": {
      "pro": boolean,
      "activity_id": string
    },
    "duty_fees" : {
      "percentage": number,
      "amount" : number, 
      "currency" : string,  
      "on_products_price": boolean, 
      "on_shipping_products_price": boolean, 
      "on_global": boolean
    }
}

For Marketplaces

JSON request format :
For 1 product and 1 product unit + 1 seller
{
    "products": [{
        "identification":{"type": "SKU", "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": "SKU", "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
    }
}
JSON request format :
For more than 2 products and minimum 2 differents sellers
{
    "products": [{
        "identification":{"type": "SKU", "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": "SKU", "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 Shipping platforms

JSON request format :
For 1 parcel with 1 product unit
{
    "products": [{
        "identification":{"type": "SKU", "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
    }
}
JSON request format :
For 1 parcel and more than 2 differents products
{
    "products": [{
        "identification":{"type": "SKU", "value": string},
        "weight": number,
        "weight_unit": string,
        "quantity": number,
        "unit_price": number,
        "currency_unit_price": string,        
        "origin_country": string
    },
{
        "identification":{"type": "SKU", "value": string},
        "weight": number,
        "weight_unit": string,
        "quantity": number,
        "unit_price": number,
        "currency_unit_price": string,        
        "origin_country": string
    }
],
    "from_country": string,
    "to_country": string,
    "shipment_type": string,
    "ecommerce_type": string, 
    "global_ship_price": number,
    "currency_global_ship_price": string,
    "global_packaging_price": number,
    "currency_global_packaging_price": string,
    "global_insurance_price": number,
    "currency_global_insurance_price": string,
    "included_tax": boolean,
    "incoterm": string,
    "extra_fees": number,
    "sender": {
      "pro": boolean,
      "revenue_country_annual": number,
      "currency_revenue_country_annual": string
    },
    "receiver": {
      "pro": boolean,
      "activity_id": string
    },
    "duty_fees" : {
      "percentage": number,
      "amount" : number, 
      "currency" : string,  
      "on_products_price": boolean, 
      "on_shipping_products_price": boolean, 
      "on_global": boolean
    }
}
JSON request format :
For more than 2 parcels and minimum 2 differents products
{
    "products": [{
        "identification":{"type": "SKU", "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": number,
        "from_country": number,
        "to_country": number,
        "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": "SKU", "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 with our support team.

Request fields & values

"products" / "identification" / "type"

You need to fill this field with SKU. \ &#xNAN;Examples : SKU\ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "value"

You need to fill this field with your product SKU in your catalog.\ &#xNAN;Examples : ARE-987UY\ &#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 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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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"

ESHOP or MARKETPLACE\ Type : string\ Required: yes

"ecommerce_type"

btoc or btob\ Type : string\ Required: no

"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.\ &#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.\ &#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.\ &#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.\ &#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.\ &#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": {
                "value": string,
                "type": string
            },
            "product_statut": string,
            "amount_exclusive": number,
            "amount_inclusive_vat": number,
            "amout_duty_and_tax": number,
            "amount_total": number,
            "product_co2": number,
            "percentage_duty_and_tax": number,
            “transit_fees”: {
                “amount”: 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
            },
            "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],
            "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
            }
        ]
    }
],
        “shipping_global”: {
            "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }  
        },
        “packaging_global”: {
            "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
        ]        
        },
        “insurance_global”: {
            "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
        ]        
        },
        “transit_fees_global”: {
            “amount”: number
         },       
        “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,
            “products_co2": number
        },
        “timestamp”: number
    },

For Sellers

JSON response format :
For 1 product and 1 product unit.
{
    "products": [
        {
            "identification": {
                "type": "SKU",
                "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
                }
            ]
        }
    ],
    "shipping_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "packaging_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "insurance_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "transit_fees_global": {
        "amount": number
    },
    "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.
{
    "products": [
        {
            "identification": {
                "type": "SKU",
                "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
                }
            ]
        }
    ],
    "shipping_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "packaging_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "insurance_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            }
    },
    "transit_fees_global": {
        "amount": number
    },
    "incoterm": 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 differents products
{
    "products": [
        {
            "identification": {
                "type": "SKU",
                "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
            },
            "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
                }
            ]
        },
        {
            "identification": {
                "type": "SKU",
                "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
            },
            "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
                }
            ]
        }
    ],
    "shipping_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            },
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "packaging_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            },
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "insurance_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            },
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "transit_fees_global": {
        "amount": number
    },
    "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 Marketplaces

JSON response format :
For 1 product and 1 product unit + 1 seller
[
    {
        "products": [
            {
                "identification": {
                    "type": "SKU",
                    "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 1 product and more than 2 product units + 1 seller
[
    {
        "products": [
            {
                "identification": {
                    "type": "SKU",
                    "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": number
                },
                "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": "SKU",
                    "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": "SKU",
                    "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 Shipping platforms

JSON response format :
For 1 parcel with 1 product unit
[
    {
        "products": [
            {
                "identification": {
                    "type": "SKU",
                    "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 1 parcel and more than 2 differents products
{
    "products": [
        {
            "identification": {
                "type": "SKU",
                "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
            },
            "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
                }
            ]
        },
        {
            "identification": {
                "type": "SKU",
                "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
            },
            "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
                }
            ]
        }
    ],
    "shipping_global": {
        "duty": {
            "label": string,
            "amount": number,
            "vat_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,
                "amount": number,
                "percentage": number,
                "vat_amount": number
            }
        ],
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "packaging_global": {
        "duty": {
            "label": string,
            "amount": number,
            "vat_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,
                "amount": number,
                "percentage": number,
                "vat_amount": number
            }
        ],
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "insurance_global": {
        "vat": [{
                "label": string,
                "percentage": number,
                "product_taxes_amount": number,
                "shipping_taxes_amount": number,
                "packaging_taxes_amount": number,
                "insurance_taxes_amount": number,
                "message": string
            }],            
            "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
            },        
            "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
            },
        "amount_exclusive": number,
        "amount_inclusive_vat": number,
        "amount_total": number,
        "amount_duty_and_tax": number,
        "percentage_duty_and_tax": number
    },
    "transit_fees_global": {
        "amount": number
    },
    "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 parcels and minimum 2 differents products
[
    {
        "products": [
            {
                "identification": {
                    "type": "SKU",
                    "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": "SKU",
                    "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 with our support team.

Response fields & values

"products" / "identification" / "type"

The value is SKU\ &#xNAN;File type : string

"products" / "identification" / "value"

The value is the product's SKU. A intern reference code.\ &#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 with our support team.

Video explainer

in progress...

Warning : 1 product = 1 request / 3 products = 3 requests

If you prefer get the rates (duty, vat, salestaxes, ...), use this API !

Using Product's description

Using Product's description

If you want calculate the duties & taxes of your order, first of all you have to classify your product to HSCode then request the Landed Cost Calculation API using Product's HSCode.

First step : Classify your product to HSCode in the arrival country

<../../product-infos-generator-a.i/text>

text

Second step : Calculate the duty & taxes thanks your product's HSCode

hscode-4

Video explainer

in progress...

If you prefer get the rates (duty, vat, salestaxes, ...), use this API !

Using Product's barcode

Using Product's barcode

If you want calculate the duties & taxes of your order, first of all you have to classify your product to HSCode then request the Landed Cost Calculation API using Product's HSCode.

First step : Classify your product to HSCode in the arrival country

<../../product-infos-generator-a.i/text>

text

Second step : Calculate the duty & taxes thanks your product's HSCode

hscode-4

Video explainer

in progress...

If you prefer get the rates (duty, vat, salestaxes, ...), use this API !

Reverse Landed Cost Calculator

Reverse Landed Cost Calculator

POST https://api.transiteo.io/v1/reverseLandedCost

This endpoint allows to get a reverse landed cost

Headers

Name Type Description
Content-Type String application/json
Authorization String idToken

200: OK

# landed cost request : ecommerce_type = MARKETPLACE
{
    "refund": [
        {
            "order_id": "My_Order_0000001",
            "identification": {
                "type": "HSCODE",
                "value": "6505009090"
            },
            "product_statut": "Autorisé à l'importation dans ce pays",
            "amount_exclusive": 1013,
            "amount_inclusive_vat": 1215.6,
            "amount_duty_and_tax": 202.6,
            "amount_ecoTax": 0,
            "amount_total": 1215.6,
            "percentage_duty_and_tax": 20,
            "duty": {
                "label": "duty",
                "percentage": 0,
                "product_taxes_amount": 0,
                "shipping_taxes_amount": 0,
                "packaging_taxes_amount": 0,
                "insurance_taxes_amount": 0,
                "message": "Votre marchandise n'est pas soumise aux droits et taxes de douanes dans la même union douanière",
                "vat_product_taxes_amount": 0,
                "vat_shipping_taxes_amount": 0,
                "vat_packaging_taxes_amount": 0,
                "vat_insurance_taxes_amount": 0,
                "vat_taxes_amount": 0,
                "agreement": "No agreement"
            },
            "transit_fees": null,
            "special_taxes": [],
            "vat": [
                {
                    "label": "VAT",
                    "percentage": 20,
                    "product_taxes_amount": 200,
                    "shipping_taxes_amount": 2,
                    "packaging_taxes_amount": 0.6,
                    "insurance_taxes_amount": 0,
                    "message": null
                }
            ]
        },
        {
            "order_id": "My_Order_0000002",
            "identification": {
                "type": "HSCODE",
                "value": "6505009090"
            },
            "product_statut": "Restreint à l'importation dans ce pays",
            "amount_exclusive": 613,
            "amount_inclusive_vat": 741.73,
            "amount_duty_and_tax": 128.74,
            "amount_ecoTax": 0,
            "amount_total": 741.73,
            "percentage_duty_and_tax": 21.01,
            "duty": {
                "label": "duty",
                "percentage": 0,
                "product_taxes_amount": 0,
                "shipping_taxes_amount": 0,
                "packaging_taxes_amount": 0,
                "insurance_taxes_amount": 0,
                "message": "Votre marchandise n'est pas soumise aux droits et taxes de douanes dans la même union douanière",
                "vat_product_taxes_amount": 0,
                "vat_shipping_taxes_amount": 0,
                "vat_packaging_taxes_amount": 0,
                "vat_insurance_taxes_amount": 0,
                "vat_taxes_amount": 0,
                "agreement": "No agreement"
            },
            "transit_fees": null,
            "special_taxes": [],
            "vat": [
                {
                    "label": "VAT",
                    "percentage": 21,
                    "product_taxes_amount": 126,
                    "shipping_taxes_amount": 2.1,
                    "packaging_taxes_amount": 0.63,
                    "insurance_taxes_amount": 0,
                    "message": null
                }
            ]
        }
    ],
    "landedCostResponse": [
        {
            "orders": [
                {
                    "order_id": "My_Order_0000001",
                    "identification": {
                        "type": "HSCODE",
                        "value": "6112499000"
                    },
                    "product_statut": "Autorisé à l'importation dans ce pays",
                    "amount_exclusive": 10013,
                    "amount_inclusive_vat": 12015.6,
                    "amount_duty_and_tax": 2002.61,
                    "amount_ecoTax": 0,
                    "amount_total": 12015.6,
                    "percentage_duty_and_tax": 20.01,
                    "duty": {
                        "label": "duty",
                        "percentage": 0,
                        "product_taxes_amount": 0,
                        "shipping_taxes_amount": 0,
                        "packaging_taxes_amount": 0,
                        "insurance_taxes_amount": 0,
                        "message": "Votre marchandise n'est pas soumise aux droits et taxes de douanes dans la même union douanière",
                        "vat_product_taxes_amount": 0,
                        "vat_shipping_taxes_amount": 0,
                        "vat_packaging_taxes_amount": 0,
                        "vat_insurance_taxes_amount": 0,
                        "vat_taxes_amount": 0,
                        "agreement": "No agreement"
                    },
                    "transit_fees": null,
                    "special_taxes": [],
                    "vat": [
                        {
                            "label": "VAT",
                            "percentage": 20,
                            "product_taxes_amount": 2000,
                            "shipping_taxes_amount": 2,
                            "packaging_taxes_amount": 0.6,
                            "insurance_taxes_amount": 0,
                            "message": null
                        }
                    ]
                }
            ],
            "incoterm": "CIF",
            "global": {
                "amount": 2002.6,
                "amount_exclusive": 10013,
                "amount_inclusive_vat": 12015.6,
                "amount_total": 12015.6,
                "amount_duty_and_tax": 2002.61,
                "percentage_duty_and_tax": 20.01,
                "amount_ecoTax": 0
            },
            "timestamp": 1661377002588
        }
    ],
    "global_refund": {
        "amount": 331.33,
        "amount_duty_and_tax": 331.34,
        "amount_exclusive": 1626,
        "amount_inclusive_vat": 1957.33,
        "amount_total": 1957.33,
        "amount_ecoTax": 0
    }
}



# landed cost request with ecommerce_type != MARKETPLACE
{
    "refund": [
        {
            "order_id": "My_Order_0000001",
            "identification": {
                "type": "HSCODE",
                "value": "6505009090"
            },
            "product_statut": "Autorisé à l'importation dans ce pays",
            "amount_exclusive": 1013,
            "amount_inclusive_vat": 1215.6,
            "amount_duty_and_tax": 202.6,
            "amount_ecoTax": 0,
            "amount_total": 1215.6,
            "percentage_duty_and_tax": 20,
            "duty": {
                "label": "duty",
                "percentage": 0,
                "product_taxes_amount": 0,
                "shipping_taxes_amount": 0,
                "packaging_taxes_amount": 0,
                "insurance_taxes_amount": 0,
                "message": "Votre marchandise n'est pas soumise aux droits et taxes de douanes dans la même union douanière",
                "vat_product_taxes_amount": 0,
                "vat_shipping_taxes_amount": 0,
                "vat_packaging_taxes_amount": 0,
                "vat_insurance_taxes_amount": 0,
                "vat_taxes_amount": 0,
                "agreement": "No agreement"
            },
            "transit_fees": null,
            "special_taxes": [],
            "vat": [
                {
                    "label": "VAT",
                    "percentage": 20,
                    "product_taxes_amount": 200,
                    "shipping_taxes_amount": 2,
                    "packaging_taxes_amount": 0.6,
                    "insurance_taxes_amount": 0,
                    "message": null
                }
            ]
        },
        {
            "order_id": "My_Order_0000002",
            "identification": {
                "type": "HSCODE",
                "value": "6505009090"
            },
            "product_statut": "Autorisé à l'importation dans ce pays",
            "amount_exclusive": 613,
            "amount_inclusive_vat": 735.6,
            "amount_duty_and_tax": 122.61,
            "amount_ecoTax": 0,
            "amount_total": 735.6,
            "percentage_duty_and_tax": 20.01,
            "duty": {
                "label": "duty",
                "percentage": 0,
                "product_taxes_amount": 0,
                "shipping_taxes_amount": 0,
                "packaging_taxes_amount": 0,
                "insurance_taxes_amount": 0,
                "message": "Votre marchandise n'est pas soumise aux droits et taxes de douanes dans la même union douanière",
                "vat_product_taxes_amount": 0,
                "vat_shipping_taxes_amount": 0,
                "vat_packaging_taxes_amount": 0,
                "vat_insurance_taxes_amount": 0,
                "vat_taxes_amount": 0,
                "agreement": "No agreement"
            },
            "transit_fees": null,
            "special_taxes": [],
            "vat": [
                {
                    "label": "VAT",
                    "percentage": 20,
                    "product_taxes_amount": 120,
                    "shipping_taxes_amount": 2,
                    "packaging_taxes_amount": 0.6,
                    "insurance_taxes_amount": 0,
                    "message": null
                }
            ]
        }
    ],
    "landedCostResponse": {
        "orders": [
            {
                "order_id": "My_Order_0000001",
                "identification": {
                    "type": "HSCODE",
                    "value": "6112499000"
                },
                "product_statut": "Autorisé à l'importation dans ce pays",
                "amount_exclusive": 10013,
                "amount_inclusive_vat": 12015.6,
                "amount_duty_and_tax": 2002.61,
                "amount_ecoTax": 0,
                "amount_total": 12015.6,
                "percentage_duty_and_tax": 20.01,
                "duty": {
                    "label": "duty",
                    "percentage": 0,
                    "product_taxes_amount": 0,
                    "shipping_taxes_amount": 0,
                    "packaging_taxes_amount": 0,
                    "insurance_taxes_amount": 0,
                    "message": "Votre marchandise n'est pas soumise aux droits et taxes de douanes dans la même union douanière",
                    "vat_product_taxes_amount": 0,
                    "vat_shipping_taxes_amount": 0,
                    "vat_packaging_taxes_amount": 0,
                    "vat_insurance_taxes_amount": 0,
                    "vat_taxes_amount": 0,
                    "agreement": "No agreement"
                },
                "transit_fees": null,
                "special_taxes": [],
                "vat": [
                    {
                        "label": "VAT",
                        "percentage": 20,
                        "product_taxes_amount": 2000,
                        "shipping_taxes_amount": 2,
                        "packaging_taxes_amount": 0.6,
                        "insurance_taxes_amount": 0,
                        "message": null
                    }
                ]
            }
        ],
        "shipping_global": {
            "vat": null,
            "duty": null,
            "special_taxes": null
        },
        "packaging_global": {
            "vat": null,
            "duty": null,
            "special_taxes": null
        },
        "insurance_global": {
            "vat": null,
            "duty": null,
            "special_taxes": null
        },
        "transit_fees_global": null,
        "incoterm": "CIF",
        "global": {
            "amount": 2002.6,
            "amount_exclusive": 10013,
            "amount_inclusive_vat": 12015.6,
            "amount_total": 12015.6,
            "amount_duty_and_tax": 2002.61,
            "percentage_duty_and_tax": 20.01,
            "amount_ecoTax": 0
        },
        "timestamp": 1661377132600
    },
    "global_refund": {
        "amount": 325.2,
        "amount_duty_and_tax": 325.2,
        "amount_exclusive": 1626,
        "amount_inclusive_vat": 1951.2,
        "amount_total": 1951.2,
        "amount_ecoTax": 0
    }
}

400: Bad Request

value in json is not recognized or incorrect

{
    "code": "INCORRECT_JSON",
    "name": "ClientError",
    "message": "Incorrect Json Request",
    "details": [
        {
            "parameter": {
                "name": "timestamp"
            },
            "causes": [
                "timestamp must be a positive number"
            ]
        }
    ]
}

403: Forbidden

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"
            ]
        }
    ]
}

404: Not Found

DATA_NOT_FOUND when timestamp does not correspond to any User-Request-History-V2 landed cost

{
    "code": "DATA_NOT_FOUND",
    "name": "ClientError",
    "message": "Sorry, we did not find the data you are trying to retrieve",
    "details": []
}

500: Internal Server Error

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

JSON Body Request Exemple

{
    "timestamp": 1661361450508,
    "refund_items": [
        {
            "order_id": "My_Order_0000001",
            "items": [
                {
                    "identification": {
                        "type": "HSCODE",
                        "value": "6505009090"
                    }
                }
            ]
        },
        {
            "order_id": "My_Order_0000002",
            "items": [
                {
                    "identification": {
                        "type": "HSCODE",
                        "value": "6505009090"
                    }
                }
            ]
        }
    ]
}

Using Product's HSCode

Using Product's HSCode

HSCode for taxes calculation

POST https://api.transiteo.io/v1/taxsrv/taxCalculationHscode

This endpoint allows you to calculate locales taxes for a product HSCode.

Headers

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

200

{
    "products": [
        {
            "vat": [
                {
                    "label": "string",
                    "percentage": number,
                    "product_taxes_amount": number,
                    "shipping_taxes_amount": number,
                    "packaging_taxes_amount": number,
                    "insurance_taxes_amount": number,
                    "message": "string"
                }
            ],
    ],
    "shipping_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "packaging_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "insurance_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "incoterm": "string",
    "extra_fees": {
        "percentage": number,
        "amount": number,
        "currency": "string"
    },
    "global": {
        "amount": number
    },
    "timestamp": number
}

JSON Request Body Format

{
  "products": [
      {
        "identification": {
          "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,
        "transport": {
          "type": string,
          "id": number
        },
      }
  ],
  "lang": string,
  "from_country": string,
  "to_country": string,
  "from_district": string,
  "to_district": string,
  "shipment_type": string,
  "global_ship_price": number,
  "currency_global_ship_price": string,
  "global_packaging_price": number,
  "currency_global_packaging_price": string,
  "global_insurance_price": number,
  "currency_global_insurance_price": string,
  "included_tax": boolean,
  "incoterm": string,
  "extra_fees": number,
  "sender": {
    "pro": boolean,
    "revenue_country_annual": number,
    "currency_revenue_country_annual": string
  },
  "transport": {
    "type": string,
    "id": number
  },
  "transit_fees" : {
    "percentage": null,
    "amount" : 10, 
    "currency" : "EUR",  
    "on_products_price": false, 
    "on_shipping_products_price": false, 
    "on_global": true
  },
  "receiver": {
    "pro": boolean,
    "activity_id": string
  }
}

Request fields

"products" / "identification" / "value"

You need to fill this field with a HTS Code version 2017. 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 if "unit_ship_price" and "currency_unit_ship_price"are not mentionned. Or if you request Switzerland in "from_country".

"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 if "unit_ship_price" and "currency_unit_ship_price"are not mentionned. Or if you request Switzerland in "from_country".

"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 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

"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

"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

"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.\ &#xNAN;Examples : "FRA" or "VEN"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "transport" / "type"

You need to fill the "transport" field of the shipping product(s) price.\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to know the duty fees by product)

"products" / "transport" / "id"

You need to fill the "transport" field of the shipping product(s) price with an id number.\ Download the list of carriers and freight forwarder.\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to know the duty fees by product)

"products" / "unit"

You need to fill the "unit" field with a entire number representing an other feature of product \ &#xNAN;Examples : 1 or 9\ &#xNAN;Type : number\ &#xNAN;Required : optional

"products" / "unit_type"

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 : optional and yes es if "unit" is mentioned.

"lang"

You need to fill this field with a web language code of your product name or description. 3 languages are available :\ fr = french\ en = english\ es = spanish\ &#xNAN;Examples : "fr"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"from_country"

You need to fill the "from_country" field with the country english label or Iso Alpha 2 or 3 from where the product is sent.\ Download the list of countries.\ &#xNAN;Examples : "Bulgaria" or "ZHN"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"from_district"

You need to fill the "from_district" field with the Iso codes of the district from where the product is sent.\ Download the list of districts.\ &#xNAN;Examples : "AL-11" or "FR-GES"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill the "to_country" field with the country english label or Iso Alpha 2 or 3 from where the product arrives.\ Download the list of countries.\ &#xNAN;Examples : "Brazil" or "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.\ &#xNAN;Examples : "AL-11" or "FR-GES"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"shipment_type"\ GLOBAL : global shipping\ ARTICLE : One ship price per article\ Type : enum\ 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 shipment_type is 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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if shipment_type is 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 shipment_type is 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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if shipment_type is 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 shipment_type is 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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if shipment_type is 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 : optional

"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 : optional

"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 "pro" and from_country & to_country are European countries.

"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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if "sender" / pro" field is "pro" and from_country & to_country are European countries.

"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.\ &#xNAN;Examples : "0112Z" or "7161A"\ &#xNAN;Type : string\ &#xNAN;Required : yes if "receiver" / "pro" field is "pro".

"transport" / "type"

You can fill the "type" field of the transport company with "CARRIER" or "FREIGHT_FORWARDER".\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to know the duty fees)

"transport" / "id"

You can fill the "id" field of the transport company with an entire number.\ Download the list of carriers and freight forwarders.\ &#xNAN;Examples : "01" or "28"\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to add automaticaly the duty fees)

"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 you filled "transit_fees" / "amount" )

"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 a value in transit_fees, percentage or amount/currency

"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 a value in transit_fees, percentage or amount/currency

"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 a value in transit_fees, percentage or amount/currency

JSON Response Format

{
    "products": [
        {
            "vat": [
                {
                    "label": "string",
                    "percentage": number,
                    "product_taxes_amount": number,
                    "shipping_taxes_amount": number,
                    "packaging_taxes_amount": number,
                    "insurance_taxes_amount": number,
                    "message": "string"
                }
            ],
    ],
    "shipping_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "packaging_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "insurance_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "incoterm": "string",
    "extra_fees": {
        "percentage": number,
        "amount": number,
        "currency": "string"
    },
    "global": {
        "amount": number
    },
    "timestamp": number
}

Response fields & values

"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_ship_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_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_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_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

"message"

The value is the locale rule.\ &#xNAN;Examples : European Country\ &#xNAN;File type : string

"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" / "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" / "percentage"

The value is the percentage (%) of VAT tax.\ &#xNAN;Examples : 3 or 1.5\ &#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" / "amount"

The value is the amount of : ("global_ship_price" x "packaging_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" / "percentage"

The value is the percentage (%) of VAT tax.\ &#xNAN;Examples : 3 or 1.5\ &#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" / "amount"

The value is the amount of : ("global_ship_price" x "insurance_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" / "percentage"

The value is the percentage (%) of VAT tax.\ &#xNAN;Examples : 3 or 1.5\ &#xNAN;File type : number

"Incoterm"

The value is CIF or FOB dependind of your request.\ &#xNAN;Type : string\ &#xNAN;Required : yes

"extra_fees" / "percentage"

The value is the percentage (%) of VAT tax.\ &#xNAN;Examples : 3 or 1.5\ &#xNAN;File type : number

"extra_fees" / "amount"

The value is the amount of : ("global_ship_price" x "extra_fees" / "vat" / "percentage"). The currency of this amount depend of "currency_global_ship_price".\ &#xNAN;Examples : 345 or 29.99\ &#xNAN;File type : number

"extra_fees" / "currency"

The value is the currency.\ &#xNAN;Examples : EUR\ &#xNAN;File type : string

"global" / "amount"

The value is the sum of all amount fields.\ &#xNAN;Examples : 1675 or 80.98\ &#xNAN;File type : number

Warning : 1 product = 1 request / 3 products = 3 requests

JSON Examples - Request & Response

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

Video explainer

in progress...

Using Product's SKU

Using Product's SKU

SKU for taxes calculation

POST https://api.transiteo.io/v1/taxsrv/taxCalculation

This endpoint allows you to calculate locales taxes for a product in your catalog.

Headers

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

200

{
    "products": [
        {
            "vat": [
                {
                    "label": "string",
                    "percentage": number,
                    "product_taxes_amount": number,
                    "shipping_taxes_amount": number,
                    "packaging_taxes_amount": number,
                    "insurance_taxes_amount": number,
                    "message": "string"
                }
            ],
    ],
    "shipping_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "packaging_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "insurance_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "incoterm": "string",
    "extra_fees": {
        "percentage": number,
        "amount": number,
        "currency": "string"
    },
    "global": {
        "amount": number
    },
    "timestamp": number
}

JSON Request Body Format

{
  "products": [
      {
        "identification": {
          "type": SKU,
          "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,
        "transport": {
          "type": string,
          "id": number
        },
      }
  ],
  "lang": string,
  "from_country": string,
  "to_country": string,
  "from_district": string,
  "to_district": string,
  "shipment_type": string,
  "global_ship_price": number,
  "currency_global_ship_price": string,
  "global_packaging_price": number,
  "currency_global_packaging_price": string,
  "global_insurance_price": number,
  "currency_global_insurance_price": string,
  "included_tax": boolean,
  "incoterm": string,
  "extra_fees": number,
  "sender": {
    "pro": boolean,
    "revenue_country_annual": number,
    "currency_revenue_country_annual": string
  },
  "transport": {
    "type": string,
    "id": number
  },
  "transit_fees" : {
    "percentage": null,
    "amount" : 10, 
    "currency" : "EUR",  
    "on_products_price": false, 
    "on_shipping_products_price": false, 
    "on_global": true
  },
  "receiver": {
    "pro": boolean,
    "activity_id": string
  }
}

Request fields

"products" / "identification" / "type"

You need to fill this field with SKU. \ &#xNAN;Examples : A-98-ERT54\ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "value"

You need to fill this field with your product SKU in your catalog.\ &#xNAN;Examples : ARE-987UY\ &#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 if "unit_ship_price" and "currency_unit_ship_price"are not mentionned. Or if you request Switzerland in "from_country".

"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 if "unit_ship_price" and "currency_unit_ship_price"are not mentionned. Or if you request Switzerland in "from_country".

"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 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

"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

"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

"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.\ &#xNAN;Examples : "FRA" or "VEN"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "transport" / "type"

You need to fill the "transport" field of the shipping product(s) price.\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to know the duty fees by product)

"products" / "transport" / "id"

You need to fill the "transport" field of the shipping product(s) price with an id number.\ Download the list of carriers and freight forwarder.\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to know the duty fees by product)

"products" / "unit"

You need to fill the "unit" field with a entire number representing an other feature of product \ &#xNAN;Examples : 1 or 9\ &#xNAN;Type : number\ &#xNAN;Required : optional

"products" / "unit_type"

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 : optional and yes es if "unit" is mentioned.

"lang"

You need to fill this field with a web language code of your product name or description. 3 languages are available :\ fr = french\ en = english\ es = spanish\ &#xNAN;Examples : "fr"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"from_country"

You need to fill the "from_country" field with the country english label or Iso Alpha 2 or 3 from where the product is sent.\ Download the list of countries.\ &#xNAN;Examples : "Bulgaria" or "ZHN"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"from_district"

You need to fill the "from_district" field with the Iso codes of the district from where the product is sent.\ Download the list of districts.\ &#xNAN;Examples : "AL-11" or "FR-GES"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill the "to_country" field with the country english label or Iso Alpha 2 or 3 from where the product arrives.\ Download the list of countries.\ &#xNAN;Examples : "Brazil" or "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.\ &#xNAN;Examples : "AL-11" or "FR-GES"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"shipment_type"\ GLOBAL : global shipping\ ARTICLE : One ship price per article\ Type : enum\ 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 shipment_type is 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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if shipment_type is 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 shipment_type is 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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if shipment_type is 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 shipment_type is 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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if shipment_type is 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 : optional

"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 : optional

"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 "pro" and from_country & to_country are European countries.

"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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if "sender" / pro" field is "pro" and from_country & to_country are European countries.

"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.\ &#xNAN;Examples : "0112Z" or "7161A"\ &#xNAN;Type : string\ &#xNAN;Required : yes if "receiver" / "pro" field is "pro".

"transport" / "type"

You can fill the "type" field of the transport company with "CARRIER" or "FREIGHT_FORWARDER".\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to know the duty fees)

"transport" / "id"

You can fill the "id" field of the transport company with an entire number.\ Download the list of carriers and freight forwarders.\ &#xNAN;Examples : "01" or "28"\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to add automaticaly the duty fees)

"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 you filled "transit_fees" / "amount" )

"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 a value in transit_fees, percentage or amount/currency

"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 a value in transit_fees, percentage or amount/currency

"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 a value in transit_fees, percentage or amount/currency

JSON Response Format

{
    "products": [
        {
            "vat": [
                {
                    "label": "string",
                    "percentage": number,
                    "product_taxes_amount": number,
                    "shipping_taxes_amount": number,
                    "packaging_taxes_amount": number,
                    "insurance_taxes_amount": number,
                    "message": "string"
                }
            ],
    ],
    "shipping_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "packaging_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "insurance_global": {
        "vat": [
            {
                "label": "string",
                "amount": number,
                "percentage": number
            }
        ]
    },
    "incoterm": "string",
    "extra_fees": {
        "percentage": number,
        "amount": number,
        "currency": "string"
    },
    "global": {
        "amount": number
    },
    "timestamp": number
}

Response fields & values

"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_ship_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_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_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_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

"message"

The value is the locale rule.\ &#xNAN;Examples : European Country\ &#xNAN;File type : string

"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" / "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" / "percentage"

The value is the percentage (%) of VAT tax.\ &#xNAN;Examples : 3 or 1.5\ &#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" / "amount"

The value is the amount of : ("global_ship_price" x "packaging_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" / "percentage"

The value is the percentage (%) of VAT tax.\ &#xNAN;Examples : 3 or 1.5\ &#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" / "amount"

The value is the amount of : ("global_ship_price" x "insurance_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" / "percentage"

The value is the percentage (%) of VAT tax.\ &#xNAN;Examples : 3 or 1.5\ &#xNAN;File type : number

"Incoterm"

The value is CIF or FOB dependind of your request.\ &#xNAN;Type : string\ &#xNAN;Required : yes

"extra_fees" / "percentage"

The value is the percentage (%) of VAT tax.\ &#xNAN;Examples : 3 or 1.5\ &#xNAN;File type : number

"extra_fees" / "amount"

The value is the amount of : ("global_ship_price" x "extra_fees" / "vat" / "percentage"). The currency of this amount depend of "currency_global_ship_price".\ &#xNAN;Examples : 345 or 29.99\ &#xNAN;File type : number

"extra_fees" / "currency"

The value is the currency.\ &#xNAN;Examples : EUR\ &#xNAN;File type : string

"global" / "amount"

The value is the sum of all amount fields.\ &#xNAN;Examples : 1675 or 80.98\ &#xNAN;File type : number

Warning : 1 product = 1 request / 3 products = 3 requests

JSON Examples - Request & Response

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

Video explainer

in progress...

Using Product's description

Using Product's description

If you want calculate the locals taxes of your order, first of all you have to classify your product to HSCode then request the Locals Taxes Calculation API using Product's HSCode.

First step : Classify your product to HSCode in the arrival country

<../../product-infos-generator-a.i/text>

text

Second step : Calculate the locals taxes thanks your product's HSCode

using-hscode

Using Product's barcode

Using Product's barcode

If you want calculate the locals taxes of your order, first of all you have to classify your product's barcode to HSCode then request the Locals Taxes Calculation API using Product's HSCode.

First step : Classify your product's barcode to HSCode in the arrival country

<../../product-infos-generator-a.i/text>

text

Second step : Calculate the locals taxes thanks your product's HSCode

using-hscode

Duties

Duties

Infos to get Duties Rates

POST https://api.transiteo.io/v1/data/duties

Headers

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

200

{
    "hscode_description": "Hats and other headgear, knitted or crocheted, or made up from lace, felt or other textile fabric, in the piece (but not in strips), whether or not lined or trimmed; hairnets of any material, whether or not lined or trimmed",
    "import_statut": "Authorized for importation into this country",
    "order_duty_minimis": "150",
    "order_vat_minimis": "22",
    "tariff": 0,
    "tariff_ave": 0,
    "tariff_regime": "European Union rate"
}

400

1. Incorrect Json (json body request incorrect
a)
    @ValidateIf(o => o.sku === undefined && o.product_text === undefined)
    @IsNotEmpty()
    hs_code: string;
    @ValidateIf(o => o.hs_code === undefined && o.product_text === undefined)
    @IsNotEmpty()
    sku: string;
    @ValidateIf(o => o.sku === undefined && o.hs_code === undefined)
    @IsNotEmpty()
    product_text: string;

    @IsNotEmpty()
    @Length(3, 3, {message: "from_country should be ISO3"})
    from_country: string;

    @IsNotEmpty()
    @Length(3, 3, {message: "to_country should be ISO3"})
    to_country: string;
    to_district: string;

b) Error Response Example: 
{
    "code": "INCORRECT_JSON",
    "name": "ClientError",
    "message": "Incorrect Json Request",
    "details": [
        {
            "parameter": {
                "name": "hs_code / product_text / sku"
            },
            "causes": [
                "hs_code or product_text or sku must be filled"
            ]
        }
    ]
}



403

wrong token id or token has expired

404

1. Country not match

{
    "code": "COUNTRY_NOT_MATCH",
    "httpCode": 404,
    "name": "BusinessError",
    "message": "Sorry, we did not match any country. Please make sure it's spelled correctly",
    "details": []
}

2. HScode not found. Happened when eu hscode is given but no correspondance was found in DUTY_DYNAMO

{
    "code": "HSCODE_NOT_FOUND",
    "httpCode": 404,
    "name": "BusinessError",
    "message": "No duty data found",
    "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": []
}

500 Unexpected error (Mostly cause with wrong data type in database. exemple : string instead of number)

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

Json Request Format

{
    “sku”: string,
    “hs_code”: string,
    “from_country”: string,
    “to_country”: string
}

Request fields & values

"sku"

You need to fill this field with the product's SKU of your catalog\ &#xNAN;Examples : HUYYUU37Y\ &#xNAN;Type : string\ &#xNAN;Required : yes if you don't fill hs_code & product_text fields

"hs_code"

You need to fill this field with the product's HSCode (8 to 13 digits) of the arrival country.\ &#xNAN;Examples : 4202310000\ &#xNAN;Type : string\ &#xNAN;Required : yes if you don't fill sku & product_text fields

"from_country"

You need to fill the "from_country" field with the Iso Alpha 2 or 3 from where the product leaves.\ Download the list of countries.\ &#xNAN;Examples : "FRA"\ &#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.\ &#xNAN;Examples : "VEN" \ &#xNAN;Type : string\ &#xNAN;Required : yes

Json Response Format

{
    "hscode_description": string,
    "import_statut": string,
    "order_duty_minimis": number,
    "order_vat_minimis": number,
    "tariff": number,
    "tariff_ave": number,
    "tariff_regime": string
}

Result fields & values

"hscode_description"

It's the entire HSCode (customs code) description/designation\ &#xNAN;Examples : chapter_designation : Articles of leather; saddlery and harness; travel goods, handbags and similar containers; articles of animal gut (other than silk- worm gut) -- heading_designation : Trunks, suit-cases, vanity-cases, executive-cases, brief-cases, school satchels, spectacle cases, binocular cases, camera cases, musical instrument cases, gun cases, holsters and similar containers; travelling-bags, insulated food or beverages bags, toilet bags, rucksacks, handbags, shopping-bags, wallets, purses, map-cases, cigarette-cases, tobacco-pouches, tool bags, sports bags, bottle-cases, jewellery boxes, powder-boxes, cutlery cases and similar containers, of leather or of composition leather, of sheeting of plastics, of textile materials, of vulcanised fibre or of paperboard, or wholly or mainly covered with such materials or with paper. -- subheading_designation : Wallets, purses, key-pouches, cigarette-cases, tobacco-pouches and similar articles carried in the pocket or handbag, with outer surface of leather, composition leather or patent leather -- national_designation : Baúles maletas (valijas) maletines incluidos los de aseo y los portadocumentos portafolios (carteras de mano) cartapacios fundas y estuches para gafas (anteojos) binoculares cámaras fotográficas o cinematográficas instrumentos musicales o armas y continentes similares; sacos de viaje sacos (bolsas) aislantes para alimentos y bebidas bolsas de aseo mochilas bolsos de mano (carteras) bolsas para la compra billeteras portamonedas portamapas petacas pitilleras y bolsas para tabaco bolsas para herramientas y para artículos de deporte estuches para frascos y botellas estuches para joyas polveras estuches para orfebrería y continentes similares de cuero natural o regenerado hojas de plástico materia textil fibra vulcanizada o cartón o recubiertos totalmente o en su mayor parte con esas materias o papel: artículos de bolsillo o de bolsos de mano (cartera): con la superficie exterior de cuero natural o cuero regenerado\ &#xNAN;Type : string

"import_statut"

There are 3 differents values : Authorized for importation into this country / Restricted for importation into this country / Prohibited for importation into this country. It's the product statut for importation in the to_country.\ &#xNAN;Examples : Authorized for importation into this country\ &#xNAN;Type : string

"order_duty_minimis"

Each country have an order minimis (threshold). This one is for the duty taxes. If your order is less than the threshold you don't need to pay duty. If your order is more than the threshold you have to pay duty.\ &#xNAN;Examples : 100\ &#xNAN;Type : string

"order_vat_minimis"

Each country have an order minimis (threshold). This one is for the value added tax. If your order is less than the threshold you don't need to pay vat. If your order is more than the threshold you have to pay vat.\ &#xNAN;Examples : 100\ &#xNAN;Type : string

"tariff"

It's the rate of duty to apply.\ &#xNAN;Examples : 0.2\ &#xNAN;Type : string

"tariff_ave"

It's the average rate of duty to apply if your HSCode is not precise.\ &#xNAN;Examples : 0.2\ &#xNAN;Type : string

"tariff_regime"

It's the regime between the country of departure and arrival to apply.\ &#xNAN;Examples : MFN duties (Applied)\ &#xNAN;Type : string

JSON Examples - Request & Response

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

Video Explainer

https://youtu.be/B4UWkcoXCHY

Locals Taxes (VAT, GST, ...)

Locals Taxes (VAT, GST, ...)

Infos to get the locales Taxes

POST https://api.transiteo.io/v1/data/taxes

Headers

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

200

{
    "hscode_description": "Hats and other headgear, knitted or crocheted, or made up from lace, felt or other textile fabric, in the piece (but not in strips), whether or not lined or trimmed; hairnets of any material, whether or not lined or trimmed",
    "import_statut": "Authorized for importation into this country",
    "threshold_tax": "22",
    "threshold_tax_currency": "EUR",
    "annual_revenue_union_locals_taxes_minimis": 0,
    "locals_taxes": [
        {
            "label": "VAT",
            "percentage": 21
        }
    ]
}

400

1. Incorrect Json (json body request incorrect
a)
    @ValidateIf(o => o.sku === undefined && o.product_text === undefined)
    @IsNotEmpty()
    hs_code: string;
    @ValidateIf(o => o.hs_code === undefined && o.product_text === undefined)
    @IsNotEmpty()
    sku: string;
    @ValidateIf(o => o.sku === undefined && o.hs_code === undefined)
    @IsNotEmpty()
    product_text: string;

    @IsNotEmpty()
    @Length(3, 3, {message: "from_country should be ISO3"})
    from_country: string;

    @IsNotEmpty()
    @Length(3, 3, {message: "to_country should be ISO3"})
    to_country: string;
    to_district: string;

b) Error Response Example: 
{
    "code": "INCORRECT_JSON",
    "name": "ClientError",
    "message": "Incorrect Json Request",
    "details": [
        {
            "parameter": {
                "name": "hs_code / product_text / sku"
            },
            "causes": [
                "hs_code or product_text or sku must be filled"
            ]
        }
    ]
}



403

wrong token id or token has expired

404

1. Country not match

{
    "code": "COUNTRY_NOT_MATCH",
    "httpCode": 404,
    "name": "BusinessError",
    "message": "Sorry, we did not match any country. Please make sure it's spelled correctly",
    "details": []
}

2. HScode not found. Happened when eu hscode is given but no correspondance was found in DUTY_DYNAMO

{
    "code": "HSCODE_NOT_FOUND",
    "httpCode": 404,
    "name": "BusinessError",
    "message": "No duty data found",
    "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": []
}

500 Unexpected error (Mostly cause with wrong data type in database. exemple : string instead of number)

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

Json Request Format

{
    "sku": string,
    "hs_code": string,
    "from_country": string,
    "to_country": string,
    "to_district": string
}

Request fields & values

"sku"

You need to fill this field with the product's SKU of your catalog\ &#xNAN;Examples : HUYYUU37Y\ &#xNAN;Type : string\ &#xNAN;Required : yes if you don't fill hs_code & product_text fields

"hs_code"

You need to fill this field with the product's HSCode (8 to 13 digits) of the arrival country.\ &#xNAN;Examples : 4202310000\ &#xNAN;Type : string\ &#xNAN;Required : yes if you don't fill sku & product_text fields

"from_country"

You need to fill the "from_country" field with the Iso Alpha 2 or 3 from where the product leaves.\ Download the list of countries.\ &#xNAN;Examples : "FRA"\ &#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.\ &#xNAN;Examples : "VEN" \ &#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.\ &#xNAN;Examples : "AL-11" or "FR-GES"\ &#xNAN;Type : string\ &#xNAN;Required : yes if the to_country is USA, CAN or BRA.

Json Response Format

{
    "hscode_description": string,
    "import_statut": string,
    "threshold_tax": number,
    "threshold_tax_currency": string,
    "locals_taxes": [
        {
            "label": string,
            "percentage": number
        }
    ]
}

Result fields & values

"hscode_description"

It's the entire HSCode (customs code) description/designation\ &#xNAN;Examples : chapter_designation : Articles of leather; saddlery and harness; travel goods, handbags and similar containers; articles of animal gut (other than silk- worm gut) -- heading_designation : Trunks, suit-cases, vanity-cases, executive-cases, brief-cases, school satchels, spectacle cases, binocular cases, camera cases, musical instrument cases, gun cases, holsters and similar containers; travelling-bags, insulated food or beverages bags, toilet bags, rucksacks, handbags, shopping-bags, wallets, purses, map-cases, cigarette-cases, tobacco-pouches, tool bags, sports bags, bottle-cases, jewellery boxes, powder-boxes, cutlery cases and similar containers, of leather or of composition leather, of sheeting of plastics, of textile materials, of vulcanised fibre or of paperboard, or wholly or mainly covered with such materials or with paper. -- subheading_designation : Wallets, purses, key-pouches, cigarette-cases, tobacco-pouches and similar articles carried in the pocket or handbag, with outer surface of leather, composition leather or patent leather -- national_designation : Baúles maletas (valijas) maletines incluidos los de aseo y los portadocumentos portafolios (carteras de mano) cartapacios fundas y estuches para gafas (anteojos) binoculares cámaras fotográficas o cinematográficas instrumentos musicales o armas y continentes similares; sacos de viaje sacos (bolsas) aislantes para alimentos y bebidas bolsas de aseo mochilas bolsos de mano (carteras) bolsas para la compra billeteras portamonedas portamapas petacas pitilleras y bolsas para tabaco bolsas para herramientas y para artículos de deporte estuches para frascos y botellas estuches para joyas polveras estuches para orfebrería y continentes similares de cuero natural o regenerado hojas de plástico materia textil fibra vulcanizada o cartón o recubiertos totalmente o en su mayor parte con esas materias o papel: artículos de bolsillo o de bolsos de mano (cartera): con la superficie exterior de cuero natural o cuero regenerado\ &#xNAN;Type : string

"import_statut"

There are 3 differents values : Authorized for importation into this country / Restricted for importation into this country / Prohibited for importation into this country. It's the product statut for importation in the to_country.\ &#xNAN;Examples : Authorized for importation into this country\ &#xNAN;Type : string

"threshold_tax"

Each country have an order threshold. This one is for the locals taxes taxes. If your order is less than the threshold you don't need to pay locals tax. If your order is more than the threshold you have to pay locals tax.\ &#xNAN;Examples : 100\ &#xNAN;Type : string

"threshold_tax_currency"

It's the currency iso 3 code of threshold tax. Download the list of currencies with them name and code.\ &#xNAN;Examples : EUR\ &#xNAN;Type : string

"locals_taxes" / "label"

It's the local tax name.\ &#xNAN;Examples : VAT\ &#xNAN;Type : string

"locals_taxes" / "percentage"

It's the local tax percentage to apply.\ &#xNAN;Examples : 16\ &#xNAN;Type : string

JSON Examples - Request & Response

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

Video explainer

https://youtu.be/NVnRyLKJlz8

Specials Taxes (OM, OMR, ...)

Specials Taxes (OM, OMR, ...)

Infos to get the Special Taxes

POST https://api.transiteo.io/v1/data/specialTaxes

Headers

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

200

{
    "hscode_description": "Hats and other headgear, knitted or crocheted, or made up from lace, felt or other textile fabric, in the piece (but not in strips), whether or not lined or trimmed; hairnets of any material, whether or not lined or trimmed",
    "import_statut": "Authorized for importation into this country",
    "threshold_tax": "22",
    "threshold_tax_currency": "EUR",
    "annual_revenue_union_locals_taxes_minimis": 0,
    "other_taxes": []
}

400

1. Incorrect Json (json body request incorrect
a)
    @ValidateIf(o => o.sku === undefined && o.product_text === undefined)
    @IsNotEmpty()
    hs_code: string;
    @ValidateIf(o => o.hs_code === undefined && o.product_text === undefined)
    @IsNotEmpty()
    sku: string;
    @ValidateIf(o => o.sku === undefined && o.hs_code === undefined)
    @IsNotEmpty()
    product_text: string;

    @IsNotEmpty()
    @Length(3, 3, {message: "from_country should be ISO3"})
    from_country: string;

    @IsNotEmpty()
    @Length(3, 3, {message: "to_country should be ISO3"})
    to_country: string;
    to_district: string;

b) Error Response Example: 
{
    "code": "INCORRECT_JSON",
    "name": "ClientError",
    "message": "Incorrect Json Request",
    "details": [
        {
            "parameter": {
                "name": "hs_code / product_text / sku"
            },
            "causes": [
                "hs_code or product_text or sku must be filled"
            ]
        }
    ]
}



403

wrong token id or token has expired

404

1. Country not match

{
    "code": "COUNTRY_NOT_MATCH",
    "httpCode": 404,
    "name": "BusinessError",
    "message": "Sorry, we did not match any country. Please make sure it's spelled correctly",
    "details": []
}

2. HScode not found. Happened when eu hscode is given but no correspondance was found in DUTY_DYNAMO

{
    "code": "HSCODE_NOT_FOUND",
    "httpCode": 404,
    "name": "BusinessError",
    "message": "No duty data found",
    "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": []
}

500 Unexpected error (Mostly cause with wrong data type in database. exemple : string instead of number)

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

Json Request Format

{
    “sku”: string,
    “hs_code”: string,
    “from_country”: string,
    “to_country”: string
}

Request fields & values

"sku"

You need to fill this field with the product's SKU of your catalog\ &#xNAN;Examples : HUYYUU37Y\ &#xNAN;Type : string\ &#xNAN;Required : yes if you don't fill hs_code & product_text fields

"hs_code"

You need to fill this field with the product's HSCode (8 to 13 digits) of the arrival country.\ &#xNAN;Examples : 4202310000\ &#xNAN;Type : string\ &#xNAN;Required : yes if you don't fill sku & product_text fields

"from_country"

You need to fill the "from_country" field with the Iso Alpha 2 or 3 from where the product leaves.\ Download the list of countries.\ &#xNAN;Examples : "FRA"\ &#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.\ &#xNAN;Examples : "VEN" \ &#xNAN;Type : string\ &#xNAN;Required : yes

Json Response Format

{
    "hscode_description": string,
    "import_statut": string,
    "threshold_tax": number,
    "threshold_tax_currency": string,
    "other_taxes": [
        {
            "label": string,
            "percentage": number
        },
    ]
}

Result fields & value

"hscode_description"

It's the entire HSCode (customs code) description/designation\ &#xNAN;Examples : chapter_designation : Articles of leather; saddlery and harness; travel goods, handbags and similar containers; articles of animal gut (other than silk- worm gut) -- heading_designation : Trunks, suit-cases, vanity-cases, executive-cases, brief-cases, school satchels, spectacle cases, binocular cases, camera cases, musical instrument cases, gun cases, holsters and similar containers; travelling-bags, insulated food or beverages bags, toilet bags, rucksacks, handbags, shopping-bags, wallets, purses, map-cases, cigarette-cases, tobacco-pouches, tool bags, sports bags, bottle-cases, jewellery boxes, powder-boxes, cutlery cases and similar containers, of leather or of composition leather, of sheeting of plastics, of textile materials, of vulcanised fibre or of paperboard, or wholly or mainly covered with such materials or with paper. -- subheading_designation : Wallets, purses, key-pouches, cigarette-cases, tobacco-pouches and similar articles carried in the pocket or handbag, with outer surface of leather, composition leather or patent leather -- national_designation : Baúles maletas (valijas) maletines incluidos los de aseo y los portadocumentos portafolios (carteras de mano) cartapacios fundas y estuches para gafas (anteojos) binoculares cámaras fotográficas o cinematográficas instrumentos musicales o armas y continentes similares; sacos de viaje sacos (bolsas) aislantes para alimentos y bebidas bolsas de aseo mochilas bolsos de mano (carteras) bolsas para la compra billeteras portamonedas portamapas petacas pitilleras y bolsas para tabaco bolsas para herramientas y para artículos de deporte estuches para frascos y botellas estuches para joyas polveras estuches para orfebrería y continentes similares de cuero natural o regenerado hojas de plástico materia textil fibra vulcanizada o cartón o recubiertos totalmente o en su mayor parte con esas materias o papel: artículos de bolsillo o de bolsos de mano (cartera): con la superficie exterior de cuero natural o cuero regenerado\ &#xNAN;Type : string

"import_statut"

There are 3 differents values : Authorized for importation into this country / Restricted for importation into this country / Prohibited for importation into this country. It's the product statut for importation in the to_country.\ &#xNAN;Examples : Authorized for importation into this country\ &#xNAN;Type : string

"threshold_tax"

Each country have an order threshold. This one is for the locals taxes taxes. If your order is less than the threshold you don't need to pay locals tax. If your order is more than the threshold you have to pay locals tax.\ &#xNAN;Examples : 0\ &#xNAN;Type : string

"threshold_tax_currency"

It's the currency iso 3 code of threshold tax. Download the list of currencies with them name and code.\ &#xNAN;Examples : EUR\ &#xNAN;Type : string

"locals_taxes" / "label"

It's the local tax name.\ &#xNAN;Examples : OM\ &#xNAN;Type : string

"locals_taxes" / "percentage"

It's the special tax percentage to apply.\ &#xNAN;Examples : 7\ &#xNAN;Type : string

JSON Examples - Request & Response

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

Video explainer

in progress...

SalesTaxes (USA)

SalesTaxes (USA)

Infos to get the USA Sales Taxes

POST https://api.transiteo.io/v1/data/salestaxes

Headers

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

200

{
    "hscode_description": "Hats and other headgear, knitted or crocheted, or made up from lace, felt or other textile fabric, in the piece (but not in strips), whether or not lined or trimmed; hairnets of any material, whether or not lined or trimmed",
    "import_statut": "Authorized for importation into this country",
    "threshold_tax": "22",
    "threshold_tax_currency": "EUR",
    "annual_revenue_union_locals_taxes_minimis": 0,
    "other_taxes": []
}

400

1. Incorrect Json (json body request incorrect
a)
    @ValidateIf(o => o.sku === undefined && o.product_text === undefined)
    @IsNotEmpty()
    hs_code: string;
    @ValidateIf(o => o.hs_code === undefined && o.product_text === undefined)
    @IsNotEmpty()
    sku: string;
    @ValidateIf(o => o.sku === undefined && o.hs_code === undefined)
    @IsNotEmpty()
    product_text: string;

    @IsNotEmpty()
    @Length(3, 3, {message: "from_country should be ISO3"})
    from_country: string;

    @IsNotEmpty()
    @Length(3, 3, {message: "to_country should be ISO3"})
    to_country: string;
    to_district: string;

b) Error Response Example: 
{
    "code": "INCORRECT_JSON",
    "name": "ClientError",
    "message": "Incorrect Json Request",
    "details": [
        {
            "parameter": {
                "name": "hs_code / product_text / sku"
            },
            "causes": [
                "hs_code or product_text or sku must be filled"
            ]
        }
    ]
}



403

wrong token id or token has expired

404

1. Country not match

{
    "code": "COUNTRY_NOT_MATCH",
    "httpCode": 404,
    "name": "BusinessError",
    "message": "Sorry, we did not match any country. Please make sure it's spelled correctly",
    "details": []
}

2. HScode not found. Happened when eu hscode is given but no correspondance was found in DUTY_DYNAMO

{
    "code": "HSCODE_NOT_FOUND",
    "httpCode": 404,
    "name": "BusinessError",
    "message": "No duty data found",
    "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": []
}

500 Unexpected error (Mostly cause with wrong data type in database. exemple : string instead of number)

{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}

Json Request Format

{
    “sku”: string,
    “hs_code”: string,
    “from_country”: string,
    “to_country”: string,
    “to_district”: string    
}

Request fields & values

"sku"

You need to fill this field with the product's SKU of your catalog\ &#xNAN;Examples : HUYYUU37Y\ &#xNAN;Type : string\ &#xNAN;Required : yes if you don't fill hs_code & product_text fields

"hs_code"

You need to fill this field with the product's HSCode (8 to 13 digits) of the arrival country.\ &#xNAN;Examples : 4202310000\ &#xNAN;Type : string\ &#xNAN;Required : yes if you don't fill sku & product_text fields

"from_country"

You need to fill the "from_country" field with the Iso Alpha 2 or 3 from where the product leaves.\ Download the list of countries.\ &#xNAN;Examples : "FRA"\ &#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.\ &#xNAN;Examples : "VEN" \ &#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.\ &#xNAN;Examples : "AL-11" or "FR-GES"\ &#xNAN;Type : string\ &#xNAN;Required : yes if the to_country is USA, CAN or BRA.

Json Response Format

{
    "hscode_description": string,
    "import_statut": string,
    "threshold_tax": number,
    "threshold_tax_currency": string,
    "locals_taxes": [
        {
            "label": string,
            "percentage": number
        }
    ]
}

Result fields & values

"hscode_description"

It's the entire HSCode (customs code) description/designation\ &#xNAN;Examples : chapter_designation : Headgear and parts thereof -- heading_designation : Hats and other headgear, knitted or crocheted, or made up from lace, felt or other textile fabric, in the piece (but not in strips), whether or not lined or trimmed; hair-nets of any material, whether or not lined or trimmed. -- subheading_designation : Hats and other headgear, knitted or crocheted, or made up from lace, felt or other textile fabric, in the piece (but not in strips), whether or not lined or trimmed; hairnets of any material, whether or not lined or trimmed (excl. headgear for animals, and toy and carnival headgear) -- national_designation : Hats and headgear, of man-made fibers, made up from felt or of textile material, not knitted or crocheted, not in part of braid\ &#xNAN;Type : string

"import_statut"

There are 3 differents values : Authorized for importation into this country / Restricted for importation into this country / Prohibited for importation into this country. It's the product statut for importation in the to_country.\ &#xNAN;Examples : Authorized for importation into this country\ &#xNAN;Type : string

"threshold_tax"

Each country have an order threshold. This one is for the locals taxes taxes. If your order is less than the threshold you don't need to pay locals tax. If your order is more than the threshold you have to pay locals tax.\ &#xNAN;Examples : 800\ &#xNAN;Type : string

"threshold_tax_currency"

It's the currency iso 3 code of threshold tax. Download the list of currencies with them name and code.\ &#xNAN;Examples : USD\ &#xNAN;Type : string

"locals_taxes" / "label"

It's the local tax name.\ &#xNAN;Examples : SalesTaxes\ &#xNAN;Type : string

"locals_taxes" / "percentage"

It's the local tax percentage to apply.\ &#xNAN;Examples : 16\ &#xNAN;Type : string

JSON Examples - Request & Response

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

Video explainer

in progress...

Exports invoice

Exports invoice

Infos to generate an export invoice

POST https://api.transiteo.io/v1/pdf/generate/export_inv/en

Headers

Name Type Description
Content-Type* String application/json
Authentication* String "id_token"

200: OK

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}
{
    "additional_fees_amount_currency": string,
    "additional_fees_amount_global": number,
    "air_port_of_lading": string,
    "buyer_zipcode": string,
    "buyer_city": string,
    "buyer_country": string,
    "buyer_address": string,
    "buyer_name": string,
    "company_id": string,
    "cubic_meters": string,
    "customer_service_info": string,
    "Date": string,
    "discount": number,
    "discount_currency": string,
    "exporting_carrier": string,
    "incoterm": string,
    "invoice_id": string,
    "marks_numbers": string,
    "named_point": string,
    "order_date": string,
    "order_id": string,
    "order_payment_date": string,
    "order_payment_type": string,
    "origin_country_product_1": string,
    "origin_country_product_2": string,
    "origin_country_product_3": string,
    "origin_country_product_4": string,
    "origin_country_product_5": string,
    "origin_country_product_6": string,
    "other_seller_informations": string,
    "packages_quantity": number,
    "product_global_currency_1": string,
    "product_global_currency_2": string,
    "product_global_currency_3": string,
    "product_global_currency_4": string,
    "product_global_currency_5": string,
    "product_global_currency_6": string,
    "product_global_price_1": number,
    "product_global_price_2": number,
    "product_global_price_3": number,
    "product_global_price_4": number,
    "product_global_price_5": number,
    "product_global_price_6": number,
    "product_hscode_1": string,
    "product_hscode_2": string,
    "product_hscode_3": string,
    "product_hscode_4": string,
    "product_hscode_5": string,
    "product_hscode_6": string,
    "origin_country_1": string,
    "origin_country_2": string,
    "origin_country_3": string,
    "origin_country_4": string,
    "origin_country_5": string,
    "origin_country_6": string,
    "product_quantity_1": number,
    "product_quantity_2": number,
    "product_quantity_3": number,
    "product_quantity_4": number,
    "product_quantity_5": number,
    "product_quantity_6": number,
    "product_unit_currency_1": string,
    "product_unit_currency_2": string,
    "product_unit_currency_3": string,
    "product_unit_currency_4": string,
    "product_unit_currency_5": string,
    "product_unit_currency_6": string,
    "product_unit_price_1": number,
    "product_unit_price_2": number,
    "product_unit_price_3": number,
    "product_unit_price_4": number,
    "product_unit_price_5": number,
    "product_unit_price_6": number,
    "product_value_1": string,
    "product_value_2": string,
    "product_value_3": string,
    "product_value_4": string,
    "product_value_5": string,
    "product_value_6": string,
    "products_amount_ex_taxes": number,
    "products_amount_global": number,
    "products_amount_global_currency": string,
    "products_delivery_amount_global": number,
    "products_delivery_amount_global_currency": string,
    "products_duty_amount_global": number,
    "products_duty_amount_global_currency": string,
    "products_insurance_amount_currency": string,
    "products_insurance_amount_global": number,
    "products_packing_amount_currency": string,
    "products_packing_amount_global": number,
    "products_special_taxes_amount_global": number,
    "products_special_taxes_amount_global_currency": string,
    "products_vat_amount_global": number,
    "products_vat_amount_global_currency": string,
    "receiver_address": string,
    "receiver_city": string,
    "receiver_country": string,
    "receiver_name": string,
    "receiver_zipcode": string,
    "mkt_address": string,
    "mkt_city": string,
    "mkt_country": string,
    "mkt_name": string,
    "mkt_zipcode": string,
    "refund_amount": number,
    "reverse_logistic_terms": string,
    "seller_zipcode": string,
    "seller_city": string,
    "seller_country": string,
    "seller_address": string,
    "seller_address_1": string,
    "seller_brand": string,
    "seller_eori": string,
    "seller_logo": string, // URL of a picture (png, jpg, svg)
    "seller_name": string,
    "signature_url": string, // URL of a picture (png, jpg, svg)
    "terms_of_sale": string,
    "vat_id": string,
    "vat_rates": string,
    "weight_global_kg": number,
    "product_measure_1": number,
    "product_measure_2": number,
    "product_measure_3": number,
    "product_measure_4": number,
    "product_measure_5": number,
    "product_measure_6": number,
    "weight_unit_product_1": string,
    "weight_unit_product_2": string,
    "weight_unit_product_3": string,
    "weight_unit_product_4": string,
    "weight_unit_product_5": string,
    "weight_unit_product_6": string,
    "buyer_phone": string,
    "seller_phone": string,
    "buyer_vat_id": string,
    "buyer_eori": string
}

JSON Response Format

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

View of Export Invoice (pdf)

Rectified Export invoice

Rectified Export invoice

Infos to generate a rectified export invoice

POST https://api.transiteo.io/v1/pdf/generate/rectifiedExport_inv/en

Headers

Name Type Description
Content-Type String application/json
Authorization String "id_token"

200: OK

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

JSON Request Format

{
    "rectifiedexportinvoice_id": string,
    "additional_fees_amount_currency": string,
    "additional_fees_amount_global": number,
    "air_port_of_lading": string,
    "buyer_zipcode": string,
    "buyer_city": string,
    "buyer_country": string,
    "buyer_address": string,
    "buyer_name": string,
    "company_id": string,
    "cubic_meters": string,
    "customer_service_info": string,
    "Date": string,
    "discount": number,
    "discount_currency": string,
    "exporting_carrier": string,
    "incoterm": string,
    "invoice_id": string,
    "marks_numbers": string,
    "named_point": string,
    "rectifiedexportinvoice_date": string,
    "order_id": string,
    "order_payment_date": string,
    "order_payment_type": string,
    "origin_country_product_1": string,
    "origin_country_product_2": string,
    "origin_country_product_3": string,
    "origin_country_product_4": string,
    "origin_country_product_5": string,
    "origin_country_product_6": string,
    "other_seller_informations": string,
    "packages_quantity": number,
    "product_global_currency_1": string,
    "product_global_currency_2": string,
    "product_global_currency_3": string,
    "product_global_currency_4": string,
    "product_global_currency_5": string,
    "product_global_currency_6": string,
    "product_global_price_1": number,
    "product_global_price_2": number,
    "product_global_price_3": number,
    "product_global_price_4": number,
    "product_global_price_5": number,
    "product_global_price_6": number,
    "product_hscode_1": string,
    "product_hscode_2": string,
    "product_hscode_3": string,
    "product_hscode_4": string,
    "product_hscode_5": string,
    "product_hscode_6": string,
    "origin_country_1": string,
    "origin_country_2": string,
    "origin_country_3": string,
    "origin_country_4": string,
    "origin_country_5": string,
    "origin_country_6": string,
    "product_quantity_1": number,
    "product_quantity_2": number,
    "product_quantity_3": number,
    "product_quantity_4": number,
    "product_quantity_5": number,
    "product_quantity_6": number,
    "product_unit_currency_1": string,
    "product_unit_currency_2": string,
    "product_unit_currency_3": string,
    "product_unit_currency_4": string,
    "product_unit_currency_5": string,
    "product_unit_currency_6": string,
    "product_unit_price_1": number,
    "product_unit_price_2": number,
    "product_unit_price_3": number,
    "product_unit_price_4": number,
    "product_unit_price_5": number,
    "product_unit_price_6": number,
    "product_value_1": string,
    "product_value_2": string,
    "product_value_3": string,
    "product_value_4": string,
    "product_value_5": string,
    "product_value_6": string,
    "products_amount_ex_taxes": number,
    "products_amount_global": number,
    "products_amount_global_currency": string,
    "products_delivery_amount_global": number,
    "products_delivery_amount_global_currency": string,
    "products_duty_amount_global": number,
    "products_duty_amount_global_currency": string,
    "products_insurance_amount_currency": string,
    "products_insurance_amount_global": number,
    "products_packing_amount_currency": string,
    "products_packing_amount_global": number,
    "products_special_taxes_amount_global": number,
    "products_special_taxes_amount_global_currency": string,
    "products_vat_amount_global": number,
    "products_vat_amount_global_currency": string,
    "receiver_address": string,
    "receiver_city": string,
    "receiver_country": string,
    "receiver_name": string,
    "receiver_zipcode": string,
    "mkt_address": string,
    "mkt_city": string,
    "mkt_country": string,
    "mkt_name": string,
    "mkt_zipcode": string,
    "refund_amount": number,
    "reverse_logistic_terms": string,
    "seller_zipcode": string,
    "seller_city": string,
    "seller_country": string,
    "seller_address": string,
    "seller_address_1": string,
    "seller_brand": string,
    "seller_eori": string,
    "seller_logo": string, // URL of a picture (png, jpg, svg)
    "seller_name": string,
    "signature_url": string, // URL of a picture (png, jpg, svg)
    "terms_of_sale": string,
    "vat_id": string,
    "vat_rates": string,
    "weight_global_kg": string,
    "product_measure_1": number,
    "product_measure_2": number,
    "product_measure_3": number,
    "product_measure_4": number,
    "product_measure_5": number,
    "product_measure_6": number,
    "weight_unit_product_1": string,
    "weight_unit_product_2": string,
    "weight_unit_product_3": string,
    "weight_unit_product_4": string,
    "weight_unit_product_5": string,
    "weight_unit_product_6": string,
    "buyer_phone": string,
    "seller_phone": string,
    "buyer_vat_id": string,
    "buyer_eori": string
}

JSON Response Format

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

View of Rectified Export Invoice (pdf)

Credit Note

Credit Note

Infos to generate a credit note

POST https://api.transiteo.io/v1/pdf/generate/creditNote/en

Headers

Name Type Description
Content-Type String application/json
Authorization Srting "id_token"

200: OK

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

JSON Request Format

{
    "creditnote_id": string,
    "creditnote_date": string,
    "additional_fees_amount_currency": string,
    "additional_fees_amount_global": number,
    "air_port_of_lading": string,
    "buyer_zipcode": string,
    "buyer_city": string,
    "buyer_country": string,
    "buyer_address": string,
    "buyer_name": string,
    "company_id": string,
    "cubic_meters": string,
    "customer_service_info": string,
    "Date": string,
    "discount": number,
    "discount_currency": string,
    "exporting_carrier": string,
    "incoterm": string,
    "invoice_id": string,
    "marks_numbers": string,
    "named_point": string,
    "order_date": string,
    "order_id": string,
    "refund_date": string,
    "refund_type": string,
    "origin_country_product_1": string,
    "origin_country_product_2": string,
    "origin_country_product_3": string,
    "origin_country_product_4": string,
    "origin_country_product_5": string,
    "origin_country_product_6": string,
    "other_seller_informations": string,
    "packages_quantity": number,
    "product_global_currency_1": string,
    "product_global_currency_2": string,
    "product_global_currency_3": string,
    "product_global_currency_4": string,
    "product_global_currency_5": string,
    "product_global_currency_6": string,
    "product_global_price_1": number,
    "product_global_price_2": number,
    "product_global_price_3": number,
    "product_global_price_4": number,
    "product_global_price_5": number,
    "product_global_price_6": number,
    "product_hscode_1": string,
    "product_hscode_2": string,
    "product_hscode_3": string,
    "product_hscode_4": string,
    "product_hscode_5": string,
    "product_hscode_6": string,
    "origin_country_1": string,
    "origin_country_2": string,
    "origin_country_3": string,
    "origin_country_4": string,
    "origin_country_5": string,
    "origin_country_6": string,
    "product_quantity_1": number,
    "product_quantity_2": number,
    "product_quantity_3": number,
    "product_quantity_4": number,
    "product_quantity_5": number,
    "product_quantity_6": number,
    "product_unit_currency_1": string,
    "product_unit_currency_2": string,
    "product_unit_currency_3": string,
    "product_unit_currency_4": string,
    "product_unit_currency_5": string,
    "product_unit_currency_6": string,
    "product_unit_price_1": number,
    "product_unit_price_2": number,
    "product_unit_price_3": number,
    "product_unit_price_4": number,
    "product_unit_price_5": number,
    "product_unit_price_6": number,
    "product_value_1": string,
    "product_value_2": string,
    "product_value_3": string,
    "product_value_4": string,
    "product_value_5": string,
    "product_value_6": string,
    "products_amount_ex_taxes": number,
    "products_amount_global": number,
    "products_amount_global_currency": string,
    "products_delivery_amount_global": number,
    "products_delivery_amount_global_currency": string,
    "products_duty_amount_global": number,
    "products_duty_amount_global_currency": string,
    "products_insurance_amount_currency": string,
    "products_insurance_amount_global": number,
    "products_packing_amount_currency": string,
    "products_packing_amount_global": number,
    "products_special_taxes_amount_global": number,
    "products_special_taxes_amount_global_currency": string,
    "products_vat_amount_global": number,
    "products_vat_amount_global_currency": string,
    "receiver_address": string,
    "receiver_city": string,
    "receiver_country": string,
    "receiver_name": string,
    "receiver_zipcode": string,
    "mkt_address": string,
    "mkt_city": string,
    "mkt_country": string,
    "mkt_name": string,
    "mkt_zipcode": string,
    "refund_amount": number,
    "reverse_logistic_terms": string,
    "seller_zipcode": string,
    "seller_city": string,
    "seller_country": string,
    "seller_address": string,
    "seller_address_1": string,
    "seller_brand": string,
    "seller_eori": string,
    "seller_logo": string, // URL of a picture (png, jpg, svg)
    "seller_name": string,
    "signature_url": string, // URL of a picture (png, jpg, svg)
    "terms_of_sale": string,
    "vat_id": string,
    "vat_rates": string,
    "weight_global_kg": string,
    "product_measure_1": number,
    "product_measure_2": number,
    "product_measure_3": number,
    "product_measure_4": number,
    "product_measure_5": number,
    "product_measure_6": number,
    "weight_unit_product_1": string,
    "weight_unit_product_2": string,
    "weight_unit_product_3": string,
    "weight_unit_product_4": string,
    "weight_unit_product_5": string,
    "weight_unit_product_6": string,
    "buyer_phone": string,
    "seller_phone": string,
    "buyer_vat_id": string,
    "buyer_eori": string
}

JSON Response Format

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

View of Credit Note (pdf)

Tax invoice

Tax invoice

Infos to generate a credit note

POST https://api.transiteo.io/v1/pdf/generate/taxInvoice/en

Headers

Name Type Description
Content-Type String application/json
Authorization Srting "id_token"

200: OK

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

JSON Request Format

{
    "company_id": string,
    "customer_service_info": string,
    "duty_total_amount": number,
    "localstaxes_total_amount": number,
    "specialtaxes_total_amount": number,
    "alltaxes_total_amount": number,
    "duty_payment_link": string, // URL, could be undefined
    "localtaxes_payment_link": string, // URL, could be undefined
    "specialtaxes_payment_link": string, // URL, could be undefined
    "alltaxes_payment_link": string, // URL, could be undefined
    "incoterm": string,
    "Date": string,
    "invoice_id": string,
    "order_id": string,
    "other_seller_informations": string,
    "product_hscode_1_tax_1": string,
    "product_hscode_1_tax_2": string,
    "product_hscode_1_tax_3": string,
    "product_hscode_1_tax_4": string,
    "product_hscode_2_tax_1": string,
    "product_hscode_2_tax_2": string,
    "product_hscode_2_tax_3": string,
    "product_hscode_2_tax_4": string,
    "product_hscode_3_tax_1": string,
    "product_hscode_3_tax_2": string,
    "product_hscode_3_tax_3": string,
    "product_hscode_3_tax_4": string,
    "product_hscode_4_tax_1": string,
    "product_hscode_4_tax_2": string,
    "product_hscode_4_tax_3": string,
    "product_hscode_4_tax_4": string,
    "product_hscode_5_tax_1": string,
    "product_hscode_5_tax_2": string,
    "product_hscode_5_tax_3": string,
    "product_hscode_5_tax_4": string,
    "product_hscode_6_tax_1": string,
    "product_hscode_6_tax_2": string,
    "product_hscode_6_tax_3": string,
    "product_hscode_6_tax_4": string,
    "product_value_1_tax_1": string,
    "product_value_1_tax_2": string,
    "product_value_1_tax_3": string,
    "product_value_1_tax_4": string,
    "product_value_2_tax_1": string,
    "product_value_2_tax_2": string,
    "product_value_2_tax_3": string,
    "product_value_2_tax_4": string,
    "product_value_3_tax_1": string,
    "product_value_3_tax_2": string,
    "product_value_3_tax_3": string,
    "product_value_3_tax_4": string,
    "product_value_4_tax_1": string,
    "product_value_4_tax_2": string,
    "product_value_4_tax_3": string,
    "product_value_4_tax_4": string,
    "product_value_5_tax_1": string,
    "product_value_5_tax_2": string,
    "product_value_5_tax_3": string,
    "product_value_5_tax_4": string,
    "product_value_6_tax_1": string,
    "product_value_6_tax_2": string,
    "product_value_6_tax_3": string,
    "product_value_6_tax_4": string,
    "duty_currency": string,
    "localstaxes_currency": string,
    "specialtaxes_currency": string,
    "alltaxes_currency": string,
    "tax_currency_1_product_1": string,
    "tax_currency_2_product_1": string,
    "tax_currency_3_product_1": string,
    "tax_currency_4_product_1": string,
    "tax_currency_1_product_2": string,
    "tax_currency_2_product_2": string,
    "tax_currency_3_product_2": string,
    "tax_currency_4_product_2": string,
    "tax_currency_1_product_3": string,
    "tax_currency_2_product_3": string,
    "tax_currency_3_product_3": string,
    "tax_currency_4_product_3": string,
    "tax_currency_1_product_4": string,
    "tax_currency_2_product_4": string,
    "tax_currency_3_product_4": string,
    "tax_currency_4_product_4": string,
    "tax_currency_1_product_5": string,
    "tax_currency_2_product_5": string,
    "tax_currency_3_product_5": string,
    "tax_currency_4_product_5": string,
    "tax_currency_1_product_6": string,
    "tax_currency_2_product_6": string,
    "tax_currency_3_product_6": string,
    "tax_currency_4_product_6": string,
    "receiver_address": string,
    "receiver_city": string,
    "receiver_country": string,
    "receiver_name": string,
    "receiver_zipcode": string,
    "buyer_address": string,
    "buyer_city": string,
    "buyer_country": string,
    "buyer_name": string,
    "buyer_zipcode": string,
    "reverse_logistic_terms": string,
    "seller_address": string,
    "seller_address_1": string,
    "seller_brand": string,
    "seller_city": string,
    "seller_country": string,
    "seller_eori": string,
    "seller_logo": string, // URL of a picture (png, jpg, svg)
    "seller_name": string,
    "seller_zipcode": string,
    "shipping_id": string,
    "tax_amount_1_product_1": number,
    "tax_amount_1_product_2": number,
    "tax_amount_1_product_3": number,
    "tax_amount_1_product_4": number,
    "tax_amount_1_product_5": number,
    "tax_amount_1_product_6": number,
    "tax_amount_2_product_1": number,
    "tax_amount_2_product_2": number,
    "tax_amount_2_product_3": number,
    "tax_amount_2_product_4": number,
    "tax_amount_2_product_5": number,
    "tax_amount_2_product_6": number,
    "tax_amount_3_product_1": number,
    "tax_amount_3_product_2": number,
    "tax_amount_3_product_3": number,
    "tax_amount_3_product_4": number,
    "tax_amount_3_product_5": number,
    "tax_amount_3_product_6": number,
    "tax_amount_4_product_1": number,
    "tax_amount_4_product_2": number,
    "tax_amount_4_product_3": number,
    "tax_amount_4_product_4": number,
    "tax_amount_4_product_5": number,
    "tax_amount_4_product_6": number,
    "tax_name_1_product_1": string,
    "tax_name_1_product_2": string,
    "tax_name_1_product_3": string,
    "tax_name_1_product_4": string,
    "tax_name_1_product_5": string,
    "tax_name_1_product_6": string,
    "tax_name_2_product_1": string,
    "tax_name_2_product_2": string,
    "tax_name_2_product_3": string,
    "tax_name_2_product_4": string,
    "tax_name_2_product_5": string,
    "tax_name_2_product_6": string,
    "tax_name_3_product_1": string,
    "tax_name_3_product_2": string,
    "tax_name_3_product_3": string,
    "tax_name_3_product_4": string,
    "tax_name_3_product_5": string,
    "tax_name_3_product_6": string,
    "tax_name_4_product_1": string,
    "tax_name_4_product_2": string,
    "tax_name_4_product_3": string,
    "tax_name_4_product_4": string,
    "tax_name_4_product_5": string,
    "tax_name_4_product_6": string,
    "tax_total_amount_1_product_1": number,
    "tax_total_amount_1_product_2": number,
    "tax_total_amount_1_product_3": number,
    "tax_total_amount_1_product_4": number,
    "tax_total_amount_1_product_5": number,
    "tax_total_amount_1_product_6": number,
    "tax_total_amount_2_product_1": number,
    "tax_total_amount_2_product_2": number,
    "tax_total_amount_2_product_3": number,
    "tax_total_amount_2_product_4": number,
    "tax_total_amount_2_product_5": number,
    "tax_total_amount_2_product_6": number,
    "tax_total_amount_3_product_1": number,
    "tax_total_amount_3_product_2": number,
    "tax_total_amount_3_product_3": number,
    "tax_total_amount_3_product_4": number,
    "tax_total_amount_3_product_5": number,
    "tax_total_amount_3_product_6": number,
    "tax_total_amount_4_product_1": number,
    "tax_total_amount_4_product_2": number,
    "tax_total_amount_4_product_3": number,
    "tax_total_amount_4_product_4": number,
    "tax_total_amount_4_product_5": number,
    "tax_total_amount_4_product_6": number,
    "tax_vat_amount_1_product_1": number,
    "tax_vat_amount_1_product_2": number,
    "tax_vat_amount_1_product_3": number,
    "tax_vat_amount_1_product_4": number,
    "tax_vat_amount_1_product_5": number,
    "tax_vat_amount_1_product_6": number,
    "tax_vat_amount_2_product_1": number,
    "tax_vat_amount_2_product_2": number,
    "tax_vat_amount_2_product_3": number,
    "tax_vat_amount_2_product_4": number,
    "tax_vat_amount_2_product_5": number,
    "tax_vat_amount_2_product_6": number,
    "tax_vat_amount_3_product_1": number,
    "tax_vat_amount_3_product_2": number,
    "tax_vat_amount_3_product_3": number,
    "tax_vat_amount_3_product_4": number,
    "tax_vat_amount_3_product_5": number,
    "tax_vat_amount_3_product_6": number,
    "tax_vat_amount_4_product_1": number,
    "tax_vat_amount_4_product_2": number,
    "tax_vat_amount_4_product_3": number,
    "tax_vat_amount_4_product_4": number,
    "tax_vat_amount_4_product_5": number,
    "tax_vat_amount_4_product_6": number,
    "vat_id": string,
    "buyer_phone": string,
    "buyer_vat_id": string,
    "buyer_eori": string
}

JSON Response Format

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

View of Credit Note (pdf)

Exports Marketplace invoice

Exports Marketplace invoice

Infos to generate an intermediate invoice (for Marketplace)

POST https://api.transiteo.io/v1/pdf/generate/agent_inv/en

This endpoint allows you to generate a cross border commercial intermediate invoice.

Headers

Name Type Description
Content-Type* string application/json
Authentication* string "id_token"

200

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

JSON Request Format

{
    "agent_address": "string",
    "agent_city": "string",
    "agent_country": "string",
    "agent_eori": "string",
    "agent_logo": "string",
    "agent_name": "string",
    "agent_zipcode": "string",

    "company_id": "string",
    "customer_service_info": "string",
    "Date": "string",
    "delivery_info": "string",

    "discount": number,
    "discount_currency": "string",

    "invoice_id": "string",

    "order_date": "string",
    "order_id": "string",
    "order_others_terms": "string",
    "order_payment_date": "string",
    "order_payment_type": "string",
    "other_seller_informations": "string",

    "product_delivery_unit_price_1": number,
    "product_delivery_unit_price_2": number,
    "product_delivery_unit_price_3": number,
    "product_delivery_unit_price_4": number,

    "product_duty_unit_price_1": number,
    "product_duty_unit_price_2": number,
    "product_duty_unit_price_3": number,
    "product_duty_unit_price_4": number,

    "product_quantity_1": number,
    "product_quantity_2": number,
    "product_quantity_3": number,
    "product_quantity_4": number,

    "product_special_taxes_1_price_1": number,
    "product_special_taxes_1_price_2": number,
    "product_special_taxes_1_price_3": number,
    "product_special_taxes_1_price_4": number,

    "product_special_taxes_number_price_1": number,
    "product_special_taxes_number_price_2": number,
    "product_special_taxes_number_price_3": number,
    "product_special_taxes_number_price_4": number,

    "product_unit_price_1": number,
    "product_unit_price_2": number,
    "product_unit_price_3": number,
    "product_unit_price_4": number,

    "product_unit_vat_1": number,
    "product_unit_vat_2": number,
    "product_unit_vat_3": number,
    "product_unit_vat_4": number,

    "product_value_1": "string",
    "product_value_2": "string",
    "product_value_3": "string",
    "product_value_4": "string",

    "products_amount_global": number,
    "products_amount_global_currency": "string",

    "products_delivery_amount_global": number,
    "products_delivery_amount_global_currency": "string",

    "products_duty_amount_global": number,
    "products_duty_amount_global_currency": "string",

    "products_special_taxes_1_amount_global": number,
    "products_special_taxes_1_amount_global_currency": "string",
    "products_special_taxes_2_amount_global": number,
    "products_special_taxes_2_amount_global_currency": "string",

    "products_vat_amount_global": number,
    "products_vat_amount_global_currency": "string",

    "refund_amount": number,
    "reverse_logistic_terms": "string",

    "seller_address": "string",
    "seller_address_1": "string",
    "seller_brand": "string",
    "seller_eori": "string",
    "seller_name": "string",

    "special_taxes_1_name": "string",
    "special_taxes_2_name": "string",

    "vat_id": "string",
    "vat_rates": number
}

JSON Response Format

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

View of Cross Border Commercial Invoice (pdf)

Cross Border Commercial Invoice

Postal customs declarations

Postal customs declarations

CN22

Infos to get CN22 document

POST https://api.transiteo.io/v1/pdf/generate/cn22/en

This endpoint allows you to get the CN22 document using by the posts.

Headers

Name Type Description
Content-Type* string application/json
Authorization* string id token

200 Example

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

JSON Request Format

{
    "product_weight_kg_1": number,
    "product_weight_kg_2": number,
    "product_weight_kg_3": number,
    "product_weight_kg_4": number,
    "product_price_total_1": number,
    "product_price_total_2": number,
    "product_price_total_3": number,
    "product_price_total_4": number,
    "product_hscode_1": string,
    "product_from_country_1": string,
    "product_value_1": string,
    "product_value_2": string,
    "product_value_3": string,
    "product_value_4": string,
    "date": string,
    "signature": string
}

JSON Response Format

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

View of CN22 in english (pdf)

CN23

Infos to get CN23 document

POST https://api.transiteo.io/v1/pdf/generate/cn23/en

The endpoint allows you to get the CN23 document using by the posts.

Headers

Name Type Description
Content-Type string application/json
Authorization string id token

200

{
    "id": "sub_X7jrrEj6qXLhgckHk5",
    "signed_url": "https://services.transiteo.io/templates/template-id/sub_X7jrrEj6qXLhgckHk5.pdf?Expires=1603906395&Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9zZXJ2aWNlcy5kZXYudHJhbnNpdGVvLmlvL3RlbXBsYXRlcy9yZWZ1bmQvc3ViX1g3anJyRWo2cVhMaGdja0hrNS5wZGYiLCJDb25kaXRpb24iOnsiRGF0ZUxlc3NUaGFuIjp7IkFXUzpFcG9jaFRpbWUiOjE2MDM5MDYzOTV9fX1dfQ__&Signature=l9FRSZm5UaEw3OA0QGtyOo4DqJnxj~7R0A-1o234ez-DiEENIye86R-RsE3ik5sF2B8BjlT~0HgHhN8CJ4MEjQt5XW-LgHDlpaXXoYTJhb7b9YUjhK-HPL9f-mPkTzKuYy6NyUwDBauSl-WDo9d12tAYHIbpu9rTBgimOWdn~y2q5wIEb7-NkQCRyct5oU6Mpx~OL4c35dmo-hl-umPIk-sC9T73kwGL92vzw4S9KfgTs8r9Jsa6B4WKEOxa6dudLPqaYa0xsqCmY42laDWgGU0TsWC7AlxC~~UspUd7C9ZcUvh2PDnbfQWWnVssSTAZs6I42YhUfaDNGug8ttaofg__&Key-Pair-Id=K1740UKS2KNTMI",
    "lang": "fr",
    "expireTime": 1603906395278,
    "date": 1603819995278
}

JSON Request Format

{
    "name_sender": string,
    "company_name_sender": string,
    "eori_id_sender": string,
    "adress_sender": string,
    "zipcode_sender": string,
    "city_sender": string,
    "country_sender": string,
    "name_receiver": string,
    "company_name_receiver": string,
    "adress_receiver": string,
    "phone_receiver": string,
    "email_receiver": string,
    "zipcode_receiver": string,
    "city_receiver": string,
    "country_receiver": string,
    "product_value_1": string,
    "product_quantity_1": number,
    "product_weight_kg_1": number,
    "product_price_total_1": number,
    "product_hscode_1": string,
    "product_from_country_1": string,
    "product_value_2": string,
    "product_quantity_2": number,
    "product_weight_kg_2": number,
    "product_price_total_2": number,
    "product_hscode_2": string,
    "product_from_country_2": string,
    "product_value_3": string,
    "product_quantity_3": number,
    "product_weight_kg_3": number,
    "product_price_total_3": number,
    "product_hscode_3": string,
    "product_from_country_3": string,
    "product_value_4": string,
    "product_quantity_4": number,
    "product_weight_kg_4": number,
    "product_price_total_4": number,
    "product_hscode_4": string,
    "product_from_country_4": string,
    "product_value_5": string,
    "product_quantity_5": number,
    "product_weight_kg_5": number,
    "product_price_total_5": number,
    "product_hscode_5": string,
    "product_from_country_5": string,
    "products_weight_total": number,
    "products_price_total": number,
    "transport_amount_total": number,
    "category_gift": boolean,
    "category_document": : boolean,
    "category_sample": : boolean,
    "category_reverse_sale": boolean,
    "category_other": : boolean,
    "not_returnable_mail_item": boolean,
    "category_detail": string,
    "observations": string,
    "total_packages": number,
    "vat_id_receiver": string,
    "vat_id": string,
    "seller_brand": string,
    "date": string,
    "signature_sender": string // URL of a picture (png, jpg, svg)
}

JSON Response Format

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

View of CN23 in english (pdf)

Lithium Battery

Lithium Battery

Infos to get Accompanying Lithium Battery Document

POST https://api.transiteo.io/v1/pdf/generate/lithium/en

This endpoint allows you to get the Accompanying Lithium Battery Document .

Headers

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

200

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

JSON Request Format

{
    "date": string,
    "receiver_firstname": string,
    "receiver_name": string,
    "receiver_adress": string,
    "receiver_city": string,
    "receiver_country": string,
    "receiver_zipcode": string,
    "seller_firstname": string,
    "seller_name": string,
    "seller_adress": string,
    "seller_city": string,
    "seller_country": string,
    "seller_zipcode": string,
    "alb_id": string,
    "company_phone": string,
    "installed": boolean,
    "ion_965_IB": boolean,
    "ion_965_II": boolean,
    "ion_966_II": boolean,
    "ion_967_II": boolean,
    "metal_968_IB": boolean,
    "metal_968_II": boolean,
    "metal_969_II": boolean,
    "metal_970_II": boolean,
    "signature": string // URL of a picture (png, jpg, svg)
}

JSON Response Format

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

View of Lithium Battery Document (pdf)

Taxes refund or discount

Taxes refund or discount

Infos to get the REP or REM document

POST https://api.transiteo.io/v1/pdf/generate/refund/fr

This endpoint allows you to get the REP or REMP document

Headers

Name Type Description
Content_type* string application/json
Authorization* string "your id_token"

200

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

JSON Request Format

{
    refund_tax: boolean,
    discount_tax: boolean,
    id_custom_documents: string,
    name_sender: string,
    job_sender: string,
    name_custom_office: string,
    company_name_sender: string,
    adress_sender: string,
    zipcode_sender: string,
    city_sender: string,
    country_sender: string,
    eori_id_sender: string,
    name_agent: string,
    company_name_agent: string,
    adress_agent: string,
    zipcode_agent: string,
    city_agent: string,
    country_agent: string,
    eori_id_agent: string,
    adress_custom_office: string,
    zipcode_custom_office: string,
    city_custom_office: string,
    release_true: boolean,
    release_false: boolean,
    attached_documents: string,
    request_fulfillment_true: boolean,
    request_fulfillment_false: boolean,
    product_hscode: string,
    product_quantity: string,
    product_price_total: string,
    product_value: string,
    amount_refund: string,
    duties_type: string,
    legal_basis_117_a: boolean,
    legal_basis_118_b: boolean,
    legal_basis_119_c: boolean,
    legal_basis_120_d: boolean,
    legal_basis_116_1_e: boolean,
    name_product_warehouse: string,
    adress_product_warehouse: string,
    zipcode_product_warehouse: string,
    city_product_warehouse: string,
    country_product_warehouse: string,
    refund_description: string,
    name_bank: string,
    adress_bank: string,
    zipcode_bank: string,
    city_bank: string,
    country_bank: string,
    country_custom_office: string,
    date: date,
    place: string,
    signature: url
    lang: string
}

JSON Response Format

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

View of Taxes refund or discount document (pdf)

Certificat of origin

Certificat of origin

Infos to get the product's certificat of origin

POST https://api.transiteo.io/v1/pdf/generate/certificate_of_origin/en

Headers

Name Type Description
Content_type* String application/json
Authorization* String "your id_token"

200: OK

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}
{
    "authority_signature_city": string,
    "authority_signature_date": string,
    "certification": string,
    "coo_id": string,
    "date": string,
    "invoice_id": string,
    "mean_of_transports": string,
    "officiel_use": string,
    "origin_country": string,
    "product_brand": string,
    "product_id": string,
    "product_origin": string,
    "product_package_id": string,
    "product_quantity": number,
    "product_title": string,
    "receiver_address": string,
    "receiver_city": string,
    "receiver_country": string,
    "receiver_name": string,
    "receiver_zipcode": string,
    "route": string,
    "seller_address": string,
    "seller_city": string,
    "seller_country": string,
    "seller_name": string,
    "seller_zipcode": string,
    "to_country": string,
    "signature": string, // URL of a picture (png, jpg, svg)
    "signature_authority": string // URL of a picture (png, jpg, svg)
}

JSON Response Format

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}

View of Certificat of origin

EORI Subscription

EORI Subscription

Infos to fill & generate the EORI subscription form

POST https://api.transiteo.io/v1/pdf/generate/eori/fr

Headers

Name Type Description
Content_type* String application/json
Authorization* String "your id_token"

200: OK

{
    "id": string,
    "signed_url": url,
    "lang": string,
    "expireTime": timestamp,
    "date": timestamp
}
{
    "association_name": string,
    "association_type": boolean,
    "company_activity": string,
    "company_adress_street": string,
    "company_adresse_number": number,
    "company_adresse_street_1": string,
    "company_city": string,
    "company_country": string,
    "company_date": string,
    "company_email": string,
    "company_name": string,
    "company_owner_name": string,
    "company_owner_phone": string,
    "company_phone": string,
    "company_siret": string,
    "company_statut": string,
    "company_type": boolean,
    "company_vat_id": string,
    "company_zipcode": string,
    "data_communication": boolean,
    "date": string,
    "firstname_lastname": string,
    "no_duty_office": boolean,
    "no_eori": boolean,
    "personal_type": boolean,
    "signature": {
        "url": url
    }
}

View of EORI subscription form

World Shipping Pricing

World Shipping Pricing

Get the cheaper price of your shipping in 198 countries.

POST https://api.transiteo.io/v1/aishippingpricing

JSON Request Format

{
    “quote”: {
        “shipper”: {
          “country”: string,
          “postal_code”: string,
          “city”: string
        },
        “recipient”: {
          “is_a_company”: boolean,
          “country”: string,
          “postal_code”: string,
          “city”: string
        },
        “parcels”: [
          {
            “weight”: number,
            “length”: number,
            “width”: number,
            “height”: number
          }
        ]
    }
}

Request fields

"quote" / "shipper" / "country"

Fill this value with the shipper country\ &#xNAN;Examples : FR \ &#xNAN;Type : string\ &#xNAN;Required : yes

"quote" / "shipper" / "postal_code"

Fill this value with the shipper postal code\ &#xNAN;Examples : 67000 \ &#xNAN;Type : string\ &#xNAN;Required : yes

"quote" / "shipper" / "city"

Fill this value with the shipper city\ &#xNAN;Examples : Strasbourg \ &#xNAN;Type : string\ &#xNAN;Required : yes

"quote" / "recipient" / "is_a_company"

Fill this value with true if the recipient is a company/pro.\ &#xNAN;Examples : true or false \ &#xNAN;Type : boolean\ &#xNAN;Required : yes

"quote" / "recipient" / "country"

Fill this value with the recipient country\ &#xNAN;Examples : FR \ &#xNAN;Type : string\ &#xNAN;Required : yes

"quote" / "recipient" / "postal_code"

Fill this value with the recipient postal code\ &#xNAN;Examples : 67000 \ &#xNAN;Type : string\ &#xNAN;Required : yes

"quote" / "recipient" / "city"

Fill this value with the recipient city\ &#xNAN;Examples : Strasbourg \ &#xNAN;Type : string\ &#xNAN;Required : yes

"quote" / "parcels" / "weight"

Fill this value with the parcel weight (in kg)\ &#xNAN;Examples : 4.7 \ &#xNAN;Type : number\ &#xNAN;Required : yes

"quote" / "parcels" / "length"

Fill this value with the parcel length\ &#xNAN;Examples : 20 \ &#xNAN;Type : number\ &#xNAN;Required : yes

"quote" / "parcels" / "width"

Fill this value with the parcel width\ &#xNAN;Examples : 30 \ &#xNAN;Type : number\ &#xNAN;Required : yes

"quote" / "parcels" / "height"

Fill this value with the parcel height\ &#xNAN;Examples : 15 \ &#xNAN;Type : number\ &#xNAN;Required : yes

JSON Response Format

{
    “amount”: number,
    “currency”: string,
    “carrier_code”: string,
    “code”: string,
    “name”: string,
    “delay”: string,
    “timestamp”: number
}

Response fields & values

"amount"

This value is the shipping price amount of your parcel (with locals taxes) \ &#xNAN;Example : 39.65\ &#xNAN;Type : number

"currency"

This value is the shipping price currency of your parcel\ &#xNAN;Example : EUR\ &#xNAN;Type : string

"carrier_code"

This value is the carrier code of your shipment \ &#xNAN;Example : dhl\ &#xNAN;Type : string

"code"

This value is the code of your shipment \ &#xNAN;Example : HU83\ &#xNAN;Type : string

"name"

This value is the carrier name of your shipment \ &#xNAN;Example : DHL\ &#xNAN;Type : string

"delay"

This value is the delay of your shipment \ &#xNAN;Example : 24-48\ &#xNAN;Type : string

"timestamp"

We provide the result timestamp. \ &#xNAN;Example : "1638440602271"\ &#xNAN;Type : string

Carbon Footprint

Carbon Footprint

Get the carbon footprint of shipped product.

POST https://api.transiteo.io/v1/greensrv/shipping

JSON Request Format

{
  “product”: {
    “identification”: {
        “type”: string,
        “value”: string
    },
    “weight”: number,
    “weight_unit”: string
  },
  “from_country”: string,
  “to_country”: string
}



Request fields

"products" / "identification" / "value"

You need to fill this field with a product's title, description, sku or barcode. We manage 5 languages (English, French, Spanish, Italian & Deutsch)\ &#xNAN;Examples : \ &#xNAN;TEXT : "Ballon de football" or "0711719407577" or SKU : "JHYU8_^ù/76YH" \ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "type"

You need to fill with "TEXT", "BARCODE" or "SKU"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"weight"

You need to fill this field with the product weight.\ &#xNAN;Examples : 3.40\ &#xNAN;Type : number\ &#xNAN;Required : yes

"weight_unit"

You need to fill this field with the product weight unit.\ &#xNAN;Examples : kg\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\ Download the list of countries.\ &#xNAN;Examples : "CHE"\ &#xNAN;Type : string\ &#xNAN;Required : yes

JSON Response Format

{
    “product”: {
        “identification”: {
            “type”: string,
            “value”: string
        },
        “weight”: number,
        “weight_unit”: string
    },
    “from_country”: string,
    “to_country”: string,
    “co2_shipping”: number,
    “timestamp”: 1646676552001
}

Response fields & values

"products" / "identification" / "value"

Same info than the request body\ &#xNAN;Type : string

"products" / "identification" / "type"

Same info than the request body\ &#xNAN;Type : string

"weight"

Same info than the request body\ &#xNAN;Examples : 3.40\ &#xNAN;Type : number

"weight_unit"

Same info than the request body\ &#xNAN;Examples : kg\ &#xNAN;Type : string

"to_country"

Same info than the request body.\ &#xNAN;Examples : "CHE"\ &#xNAN;Type : string

"co2_shipping"

We provide the CO2 in kg for product shipping by plane.\ &#xNAN;Examples : "3.54"\ &#xNAN;Type : string

"timestamp"

We provide the result timestamp. \ &#xNAN;Example : "1638440602271"\ &#xNAN;Type : string

E-COMMERCE MANAGEMENT

Customers (CRM)

Customers (CRM)

Add a product in its transiteo catalog

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

This endpoint allows you to add a product in your catalog. And thanks to product SKU you could calculate duties and taxes from & to every countries in the world.

Headers

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

Json Request Format

{
    "customerMail": string,
    "website": string,
    "firstname": string,
    "lastname": string,
    "gender": string,
    "age": number,
    "phoneNumber": string,
    "zipCode": string,
    "address": string,
    "city": string,
    "state": string,
    "country": string,
    "companyName": string,
    "companyId": string,
    "companyTaxId": string,
    "pro": boolean,
    "paidOrders": [
        {
            "orderId": string,
            "orderDutyAmount": number,
            "orderVatAmount": number,
            "orderSpecialTaxesAmount": number,
            "orderTotalAmount": number,
            "orderCurrency": string
        }
    ],
    "awaitingOrders": [
        {
            "orderId": string,
            "orderDutyAmount": number,
            "orderVatAmount": number,
            "orderSpecialTaxesAmount": number,
            "orderTotalAmount": number,
            "orderCurrency": string
        }
    ],
    "canceledOrders": [
        {
            "orderId": string,
            "orderDutyAmount": number,
            "orderVatAmount": number,
            "orderSpecialTaxesAmount": number,
            "orderTotalAmount": number,
            "orderCurrency": string
        }
    ],
    "buyedProducts": [
        {
            "productId": string,
            "productQuantity": number,
            "productPrice": number,
            "productCurrency": string
        }
    ]
}

Request fields & values

"customerMail"

Fill this value with the customer mail\ Exemple : john.do@gmail.com\ &#xNAN;Type : string\ &#xNAN;Required : yes

"website"

Fill this value with the website attached to the customer\ Exemple : https://www.transiteo.com\ &#xNAN;Type : string\ &#xNAN;Required : yes

"firstname"

Fill this value with the customer firstname\ Exemple : John\ &#xNAN;Type : string\ &#xNAN;Required : yes

"lastname"

Fill this value with the customer lastname\ Exemple : Do\ &#xNAN;Type : string\ &#xNAN;Required : yes

"gender"

Fill this value with the customer lastname\ Exemple : Male or Female\ &#xNAN;Type : string\ &#xNAN;Required : no

"age"

Fill this value with the customer age\ Exemple : 45\ &#xNAN;Type : number\ &#xNAN;Required : yes

"phoneNumber"

Fill this value with the customer phone number\ Exemple : +33678987654\ &#xNAN;Type : string\ &#xNAN;Required : no

"zipCode"

Fill this value with the customer postal code\ Exemple : FR67000\ &#xNAN;Type : string\ &#xNAN;Required : yes

"address"

Fill this value with the customer adress\ Exemple : 4 rue des moulins\ &#xNAN;Type : string\ &#xNAN;Required : yes

"city"

Fill this value with the customer city\ Exemple : Strasbourg\ &#xNAN;Type : string\ &#xNAN;Required : yes

"state"

Fill this value with the customer state\ Exemple : Alsace\ &#xNAN;Type : string\ &#xNAN;Required : yes

"country"

Fill this value with the customer country\ Exemple : France\ &#xNAN;Type : string\ &#xNAN;Required : yes

"companyName"

Fill this value with the customer company name\ Exemple : Transiteo\ &#xNAN;Type : string\ &#xNAN;Required : yes

"companyId"

Fill this value with the customer company id\ Exemple : 465 789 346\ &#xNAN;Type : string\ &#xNAN;Required : yes

"companyTaxId"

Fill this value with the customer company tax id\ Exemple : FR465789346\ &#xNAN;Type : string\ &#xNAN;Required : yes

"pro"

Fill this value with true or false if the customer is or is not a company \ Exemple : true\ &#xNAN;Type : boolean\ &#xNAN;Required : yes

"paidOrders" / "orderId"

Fill this value with the customer paid order id\ Exemple : OR004\ &#xNAN;Type : string\ &#xNAN;Required : yes

"paidOrders" / "orderDutyAmount"

Fill this value with the customer paid order duty amount\ Exemple : 67.45\ &#xNAN;Type : number\ &#xNAN;Required : yes

"paidOrders" / "orderVatAmount"

Fill this value with the customer paid order locals taxes amount\ Exemple : 34.88\ &#xNAN;Type : number\ &#xNAN;Required : yes

"paidOrders" / "orderSpecialTaxesAmount"

Fill this value with the customer paid order special taxes amount\ Exemple : 9.32\ &#xNAN;Type : number\ &#xNAN;Required : yes

"paidOrders" / "orderTotalAmount"

Fill this value with the customer paid order total amount\ Exemple : 98.64\ &#xNAN;Type : number\ &#xNAN;Required : yes

"paidOrders" / "orderCurrency"

Fill this value with the customer paid order currency\ Exemple : EUR\ &#xNAN;Type : string\ &#xNAN;Required : yes

"awaitingOrders" / "orderId"

Fill this value with the customer awaiting order id\ Exemple : OR004\ &#xNAN;Type : string\ &#xNAN;Required : yes

"awaitingOrders" / "orderDutyAmount"

Fill this value with the customer awaiting order duty amount\ Exemple : 67.45\ &#xNAN;Type : number\ &#xNAN;Required : yes

"awaitingOrders" / "orderVatAmount"

Fill this value with the customer awaiting order locals taxes amount\ Exemple : 34.88\ &#xNAN;Type : number\ &#xNAN;Required : yes

"awaitingOrders" / "orderSpecialTaxesAmount"

Fill this value with the customer awaiting order special taxes amount\ Exemple : 9.32\ &#xNAN;Type : number\ &#xNAN;Required : yes

"awaitingOrders" / "orderTotalAmount"

Fill this value with the customer awaiting order total amount\ Exemple : 98.64\ &#xNAN;Type : number\ &#xNAN;Required : yes

"awaitingOrders" / "orderCurrency"

Fill this value with the customer awaiting order currency\ Exemple : EUR\ &#xNAN;Type : string\ &#xNAN;Required : yes

"canceledOrders" / "orderId"

Fill this value with the customer canceled order id\ Exemple : OR004\ &#xNAN;Type : string\ &#xNAN;Required : yes

"canceledOrders" / "orderDutyAmount"

Fill this value with the customer canceled order duty amount\ Exemple : 67.45\ &#xNAN;Type : number\ &#xNAN;Required : yes

"canceledOrders" / "orderVatAmount"

Fill this value with the customer canceled order locals taxes amount\ Exemple : 34.88\ &#xNAN;Type : number\ &#xNAN;Required : yes

"canceledOrders" / "orderSpecialTaxesAmount"

Fill this value with the customer canceled order special taxes amount\ Exemple : 9.32\ &#xNAN;Type : number\ &#xNAN;Required : yes

"canceledOrders" / "orderTotalAmount"

Fill this value with the customer canceled order total amount\ Exemple : 98.64\ &#xNAN;Type : number\ &#xNAN;Required : yes

"canceledOrders" / "orderCurrency"

Fill this value with the customer canceled order currency\ Exemple : EUR\ &#xNAN;Type : string\ &#xNAN;Required : yes

"buyedProducts" / "productId"

Fill this value with the id of the buyed product\ Exemple : H76TYUJH3\ &#xNAN;Type : string\ &#xNAN;Required : yes

"buyedProducts" / "productQuantity"

Fill this value with the quantity of the buyed product\ Exemple : 3\ &#xNAN;Type : number\ &#xNAN;Required : yes

"buyedProducts" / "productPrice"

Fill this value with the unit price of the buyed product\ Exemple : 4.87\ &#xNAN;Type : number\ &#xNAN;Required : yes

"buyedProducts" / "productCurrency"

Fill this value with the currency of the unit price.\ Exemple : EUR\ &#xNAN;Type : string\ &#xNAN;Required : yes

JSON Examples - Request & Response

{
    “mail”: string,
    "customerMail": string,
    "website": string,
    "firstname": string,
    "lastname": string,
    "gender": string,
    "age": number,
    "phoneNumber": string,
    "zipCode": string,
    "address": string,
    "city": string,
    "state": string,
    "country": string,
    "companyName": string,
    "companyId": string,
    "companyTaxId": string,
    "pro": boolean,
    "paidOrders": [
        {
            "orderId": string,
            "orderDutyAmount": number,
            "orderVatAmount": number,
            "orderSpecialTaxesAmount": number,
            "orderTotalAmount": number,
            "orderCurrency": string
        }
    ],
    "awaitingOrders": [
        {
            "orderId": string,
            "orderDutyAmount": number,
            "orderVatAmount": number,
            "orderSpecialTaxesAmount": number,
            "orderTotalAmount": number,
            "orderCurrency": string
        }
    ],
    "canceledOrders": [
        {
            "orderId": string,
            "orderDutyAmount": number,
            "orderVatAmount": number,
            "orderSpecialTaxesAmount": number,
            "orderTotalAmount": number,
            "orderCurrency": string
        }
    ],
    "buyedProducts": [
        {
            "productId": string,
            "productQuantity": number,
            "productPrice": number,
            "productCurrency": string
        }
    ]
}

Video explainer

in progress...

Update a customer

PUT https://api.transiteo.io/v1/customer/customers?website={url}

This endpoint allows you tu update a product in its catalog

Headers

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

200

Get customer informations

GET https://api.transiteo.io/v1/customer/customers?website={url}

This endpoint allows you to get informations of specific product

Headers

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

200

Get all products in its catalog

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

This endpoint allows you to get a list of all product in its catalog

Headers

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

200

Delete a product in its catalog

DELETE https://api.transiteo.io/v1/customer/products/{sku}

This endpoint allows to delete a specific product inn its catalog

Headers

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

200

Products (PIM)

Products (PIM)

Add a product in its transiteo catalog

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

This endpoint allows you to add a product in your catalog. And thanks to product SKU you could calculate duties and taxes from & to every countries in the world.

Headers

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

Json Request Format

{
    "type": string,
    "sku": string,
    "value": string,
    "weight": number,
    "weight_unit": string,
    "unit_price": number,
    "currency_unit_price": string,
    "ecoTax_code_pro": string,
    "ecoTax_subCode_pro": string,
    "ecoTax_code_personal": string,
    "ecoTax_price_pro": number,
    "ecoTax_price_personal": number,
    "ecoTax_price_default_pro": number,
    "ecoTax_price_default_personal": number,
    "ecoTax_default": string,
    "co2_product_kg": number,
    "un_code": [string],
    "origin_country": string,
    "to_district": string,
    "to_country": string,
    "hscodefinder_hs_code": string,
    "quantity": number,
    "sale_unit_price": number,
    "sale_currency_unit_price": string,
    "purchase_unit_price": number,
    "purchase_currency_unit_price": string
}

Request fields & values

"type"

You need to fill with "SKU"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"sku"

You need to fill this field with the sku (Stock Keeping Unit) of your product.\ &#xNAN;Examples : "9754628", "dress" or "ARZ2-987H" \ &#xNAN;Type : string\ &#xNAN;Required : yes

"value"

You need to fill this field with the title of your product.\ &#xNAN;Examples : "Playstation 5", "Thon blanc germon au naturel 200g" or "Louis Vitton bagpack" \ &#xNAN;Type : string\ &#xNAN;Required : yes

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

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

"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 with them name and code.\ &#xNAN;Examples : "EUR" or "CAD"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"origin_country"

You need to fill this field with the iso Alpha 2 or 3 of the product origin country. Download the list of countries.\ &#xNAN;Examples : CHN\ &#xNAN;Type : string\ &#xNAN;Required : No

"to_district"

You need to fill thsi field with the iso code of the district of the product's arrival district. Download the list of districts.\ &#xNAN;Examples : FR-IDF\ &#xNAN;Type : string\ &#xNAN;Required : No

"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.\ &#xNAN;Examples : "Brazil" or "GLP" \ &#xNAN;Type : string\ &#xNAN;Required : yes if hscodefinder_hs_code is filled.

"hscodefinder_hs_code"

You need to fill this field with a HS Code. Between 8 to 13 digits numbers.\ &#xNAN;Examples : 9503006100\ &#xNAN;Type : string\ &#xNAN;Required : No

"quantity"

You need to fill this field with the quantity of this product in your stock.\ &#xNAN;Examples : 10 or 28\ &#xNAN;Type : string\ &#xNAN;Required : No

"sale_unit_price"

You need to fill this field with your sale price\ &#xNAN;Examples : 23.76 or 11\ &#xNAN;Type : string\ &#xNAN;Required : No

"sale_currency_unit_price"

You need to fill this field with the currency of your sale price.\ &#xNAN;Examples : USD\ &#xNAN;Type : string\ &#xNAN;Required : No

"purchase_unit_price"

You need to fill this field with your purchase price.\ &#xNAN;Examples : 23.76 or 11\ &#xNAN;Type : string\ &#xNAN;Required : No

"purchase_currency_unit_price"

You need to fill this field with the currency of your purchase price.\ &#xNAN;Examples : USD\ &#xNAN;Type : string\ &#xNAN;Required : No

JSON Examples - Request & Response

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

Video explainer

in progress...

Update a product in its catalog

PUT https://api.transiteo.io/v1/customer/products/{sku}

This endpoint allows you tu update a product in its catalog

Headers

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

200

Get product informations

GET https://api.transiteo.io/v1/customer/products/{sku}

This endpoint allows you to get informations of specific product

Headers

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

200

Get all products in its catalog

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

This endpoint allows you to get a list of all product in its catalog

Headers

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

200

Delete a product in its catalog

DELETE https://api.transiteo.io/v1/customer/products/{sku}

This endpoint allows to delete a specific product inn its catalog

Headers

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

200

Sellers (SIM)

Sellers (SIM)

Method to add customer sellers

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

This endpoint allows you to add customer sellers, up to 100 per request

Headers

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

Json Request Format

[
    {
        "mail": "a@a.com",
        "id": "001",
        "name": "Seller 001",
        "manager_name": "Jean Bretthon",
        "phone": "+33601020304",
        "vat_number": "1234",
        "eori_number": "5678",
        "country": "FR",
        "street": "3 Place de l'église",
        "city": "PARIS",
        "postal_code": "12345",
        "annual_revenue": {},
        "syderep": {
            "AAA": "CheckOK",
            "BBB": "CheckOK"
        },
        "ids": {
            "products": [],
            "categories": [],
            "orders": [],
            "invoices": [],
        }
    },
    {
        "mail": "a@a.com",
        "id": "002",
        "name": "Seller 002",
        "manager_name": "Juliette Caranet",
        "phone": "+33601020304",
        "vat_number": "1234",
        "eori_number": "5678",
        "country": "FR",
        "street": "3 Place de l'église",
        "city": "PARIS",
        "postal_code": "12345",
        "annual_revenue": {},
        "syderep": {
            "AAA": "CheckOK",
            "BBB": "CheckOK"
        },
        "ids": {
            "products": [],
            "categories": [],
            "orders": [],
            "invoices": [],
        }
    }
]

Method to update a customer seller

PUT https://api.transiteo.io/v1/customer/sellers/:sellerId

This endpoint allows you to update customer seller

Headers

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

200

{
    "mail": "a@a.com",
    "id": "001",
    "name": "Seller 001",
    "manager_name": "Jean Bretthon",
    "phone": "+33601020304",
    "vat_number": "12340000",
    "eori_number": "56780000",
    "country": "FR",
    "street": "7 Place de l'église",
    "city": "PARIS",
    "postal_code": "12345",
    "annual_revenue": {},
    "syderep": {
        "AAA": "CheckOK",
        "NEW_SYDEREP": "NEW_OK!",
        "BBB": "CheckOK"
    },
    "ids": {
        "orders": [],
        "categories": [],
        "invoices": [],
        "products": []
    }
}

Method to retrieve seller informations

GET https://api.transiteo.io/v1/customer/sellers/:sellerId}

This endpoint allows you to get customer seller informations.

Headers

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

200

{
    "mail": "a@a.com",
    "id": "001",
    "name": "Seller 001",
    "manager_name": "Jean Bretthon",
    "phone": "+33601020304",
    "vat_number": "1234",
    "eori_number": "5678",
    "country": "FR",
    "street": "3 Place de l'église",
    "city": "PARIS",
    "postal_code": "12345",
    "annual_revenue": {
        "2025": {
          "FR": { "amount": 12390.98, "currency": "EUR" },
          "US": { "amount": 78098.57, "currency": "USD" }
        }
    },
    "syderep": {
        "AAA": "CheckOK",
        "BBB": "CheckOK"
    },
    "ids": {
        "products": ["SKU_A"],
        "categories": ["CAT_1", "CAT_2"],
        "orders": ["ORDER_00002"],
        "invoices": ["INV0000001"],
    }
}

Method to retrieve all customer sellers

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

This endpoint allows you to get all customer sellers, paginated, pages of 500 items

Headers

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

200

{
    "data": [
        {
            "mail": "a@a.com",
            "id": "001",
            "name": "Seller 001",
            "manager_name": "Jean Bretthon",
            "phone": "+33601020304",
            "vat_number": "1234",
            "eori_number": "5678",
            "country": "FR",
            "street": "3 Place de l'église",
            "city": "PARIS",
            "postal_code": "12345",
            "annual_revenue": {
                "2025": {
                  "FR": { "amount": 12390.98, "currency": "EUR" },
                  "US": { "amount": 78098.57, "currency": "USD" }
                }
            },
            "syderep": {
                "AAA": "CheckOK",
                "BBB": "CheckOK"
            },
            "ids": {
                "products": ["SKU_A"],
                "categories": ["CAT_1", "CAT_2"],
                "orders": ["ORDER_00002"],
                "invoices": ["INV0000001"],
            }
        },
        {
            "mail": "a@a.com",
            "id": "002",
            "name": "Seller 002",
            "manager_name": "Juliette Caranet",
            "phone": "+33601020304",
            "vat_number": "1234",
            "eori_number": "5678",
            "country": "FR",
            "street": "3 Place de l'église",
            "city": "PARIS",
            "postal_code": "12345",
            "annual_revenue": {
                "2025": {
                  "FR": { "amount": 12390.98, "currency": "EUR" },
                  "US": { "amount": 78098.57, "currency": "USD" }
                }
            },
            "syderep": {
                "AAA": "CheckOK",
                "BBB": "CheckOK"
            },
            "ids": {
                "products": [],
                "categories": [],
                "orders": [],
                "invoices": [],
            }
        },
        ...
    ],
    "nextIndex": "500"
}

Method to delete a customer seller

DELETE https://api.transiteo.io/v1/customer/sellers/:sellerIdu}

This endpoint allows you to delete a customer seller

Headers

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

200


{
    "mail": "a@a.com",
    "id": "001",
    "name": "Seller 001",
    "manager_name": "Jean Bretthon",
    "phone": "+33601020304",
    "vat_number": "12340000",
    "eori_number": "56780000",
    "country": "FR",
    "street": "7 Place de l'église",
    "city": "PARIS",
    "postal_code": "12345",
    "annual_revenue": {},
    "syderep": {
        "AAA": "CheckOK",
        "NEW_SYDEREP": "NEW_OK!",
        "BBB": "CheckOK"
    },
    "ids": {
        "orders": [],
        "categories": [],
        "invoices": [],
        "products": []
    }
}

Orders (OMS)

Orders (OMS)

Add an order

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

This endpoint allows you to create an order

Headers

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

Request body

{
  "order_id": string,
  "invoice_id": string,
  "url": url,
  "order_date_hour": number,
  "customer_firstname": string,
  "customer_lastname": string,
  "customer_address": string,
  "customer_zipcode": string,
  "customer_city": string,
  "customer_country": string,
  "customer_email": string,
  "buyer_firstname": string,
  "buyer_lastname": string,
  "buyer_address": string",
  "buyer_zipcode": string,
  "buyer_city": string,
  "buyer_country": string,
  "agent_firstname": string,
  "agent_lastname": string,
  "agent_address": string,
  "agent_zipcode": string,
  "agent_city": string,
  "agent_country": string,
  "order_payment_type": string,
  "order_payment_date": number,
  "exporting_carrier": string,
  "departure_country": string,
  "arrival_country": string,
  "products": [
    {"sku": string, "quantity": number, "unit_price": number, "unit_price_currency": string, seller_id : string}
  ],
  "shipping_carrier": string,
  "category_of_item": string,
  "payment_type": string,
  "amount_products": number,
  "amount_shipping": number,
  "amount_duty": number,
  "amount_vat": number,
  "amount_specialtaxes": number,
  "incoterm": string,
  "currency": string,
  "order_statut": string,
  "duty_calculation_timestamp": number
}

Json Request Format

"order_id"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"invoice_id"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"url"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"order_date_hour"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"customer_firstname"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"customer_lastname"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"customer_address"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"customer_zipcode"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"customer_city"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"customer_country"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"buyer_firstname"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"buyer_lastname"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"buyer_address"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"buyer_zipcode"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"buyer_city"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"buyer_country"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"agent_firstname"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"agent_lastname"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"agent_adress"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"agent_zipcode"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"agent_city"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"agent_country"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"order_payment_type"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"order_payment_date"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"exporting_carrier"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"departure_country"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"arrival_country"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "sku"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "quantity"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "unit_price"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "unit_price_currency"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"shipping_carrier"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"category_of_item"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"payment_type"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"amount_products"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"amount_shipping"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"amount_duty"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"amount_vat"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"amount_specialtaxes"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"incoterm"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"currency"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

"order_statut"

You need to fill the field with ...\ &#xNAN;Examples : \ &#xNAN;Type : string\ &#xNAN;Required : yes

JSON Examples - Request & Response

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

Video explainer

in progress...

Update an order

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

This endpoint allows you to update an order

Headers

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

200

Get order informations

GET https://api.transiteo.io/v1/customer/orders/{order_id}

This endpoint allows you to get informations of a specific order

Headers

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

200

{
    "mail": "com-ave@yopmail.com",
    "order_id": "001",
    "invoice_id": "001-I",
    "url": "https://www.comave.com",
    "order_date_hour": 1753175951270,
    "customer_firstname": "Gauthier",
    "customer_lastname": "Legrix",
    "customer_address": "4 Rue des Moulins",
    "customer_zipcode": "67000",
    "customer_city": "Strasbourg",
    "customer_country": "FRA",
    "customer_email": "gauthier@transiteo.com",
    "buyer_firstname": "Gauthier",
    "buyer_lastname": "Legrix",
    "buyer_address": "4 Rue des Moulins",
    "buyer_zipcode": "67000",
    "buyer_city": "Strasbourg",
    "buyer_country": "FRA",
    "agent_firstname": "Comave",
    "agent_lastname": "France",
    "agent_address": "12 rue principal",
    "agent_zipcode": "L-56789",
    "agent_city": "Luxembourg",
    "agent_country": "LUX",
    "order_payment_type": "Stripe",
    "order_payment_date": 1753175951270,
    "exporting_carrier": "DHL",
    "departure_country": "FRA",
    "arrival_country": "FRA",
    "products": [
        {
            "amount_duty": 0,
            "quantity": 1,
            "amount_specialtaxes": 0,
            "amount_vat": 0,
            "unit_price_currency": "EUR",
            "sku": "SKU01",
            "unit_price": 100,
            "seller_id": 001
        }
    ],
    "shipping_carrier": "DHL",
    "category_of_item": "Commercial Goods",
    "payment_type": "Card",
    "amount_products": 100,
    "amount_shipping": 10,
    "amount_shipping_duty": 0,
    "amount_shipping_vat": 0,
    "amount_shipping_specialtaxes": 0,
    "amount_duty": 0,
    "amount_vat": 0,
    "amount_specialtaxes": 0,
    "amount_discount": 0,
    "global_products_discount": null,
    "global_shipping_discount": null,
    "currency": "EUR",
    "order_statut": "Expédié",
    "order_update_statut": 1753176084489,
    "incoterm": "CIF",
    "incoterm_delivery": "DDP",
    "customer_documents": null,
    "landed_cost_timestamp": 1753176347840,
    "canceled": null,
    "export_invoice_url": [
        "https://services.transiteo.io/templates/exportInvoice/sub_HFIAFDGHBDFHBKRoxU2sbh6B8M2Fmc.pdf"
    ],
    "sellers_export_invoice_url": {
      "00001" : https://services.transiteo.io/templates/exportInvoice/sub_HFIAFDGHBDFHBKRoxU2sbh6B8M2Fmc.pdf
      "00002" : https://services.transiteo.io/templates/exportInvoice/sub_HFIAFDGHBDFHBKRoxU2sbh6B8M2Fmc.pdf
    }
}    

Get orders list

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

This endpoint allows you to get informations of all orders created.

Headers

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

200

Delete an order

DELETE https://api.transiteo.io/v1/customer/orders/{order_id}

This endpoint allows you to delete a specific order

Headers

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

200

Tax Account

Tax Account

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.\ &#xNAN;Examples : "GLP" \ &#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.\ &#xNAN;Examples : "CHE" \ &#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" / "percentage"

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" / "currency"

You need to fill this field with the currency's amount.\ &#xNAN;Type : string\ &#xNAN;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.\ &#xNAN;Type : boolean\ &#xNAN;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\ &#xNAN;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.\ &#xNAN;Type : boolean\ &#xNAN;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

FREE API CONSUMPTION

Duty & Taxes Free Calculation

Duty & Taxes Free Calculation

Requirement : To use this API for free, you have to create an account on the transiteo web app, subscribe to a plan and configure your data settings. The consumption is free.

Duty & Taxes calculation

GET https://api.transiteo.io/v1/taxsrv/freedutyCalculation

This endpoint allows you to calculate duty & taxes for your default product in all countries.

Headers

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

200

{
    "DutyAmount": number,
    "VatAmount": number,
    "SpecialTaxesAmount": number,
    "global": {
        "amount": number
},
"timestamp": number
}

Request body

{
  "products": [
      {
        "quantity": number,
        "weight": number,
        "weight_unit": "string",
        "unit_price": number,
        "currency_unit_price": "string",
      }
  ],
  "to_country": "string",
}

Request fields

"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" / "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 if "unit_ship_price" and "currency_unit_ship_price"are not mentionned. Or if you request Switzerland in "from_country".

"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 if "unit_ship_price" and "currency_unit_ship_price"are not mentionned. Or if you request Switzerland in "from_country".

products" / "unit_price"

You need to fill the "unit_price" field with a number representing the price of one product.\ &#xNAN;Examples : 39 or 99.90\ &#xNAN;Type : string\ &#xNAN;Required : yes\ \ &#xNAN;"products" / "currency_unit_price"

You need to fill the "currency" field of the product with a currency iso Alpha 3.\ Download the list of currencies with them name and code.\ &#xNAN;Examples : "EUR"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"to_country"

You need to fill this field with the ISO Alpha 2 or 3 Code of the country.\ Download the list of countries.\ &#xNAN;Type : string\ &#xNAN;Required : yes

Response json Format

{
    "duty_amount": number,
    "vat_amount": number,
    "special_taxes_amount": number,
    "global": {
        "amount": number
    },
    "timestamp": number
}

Response fields

"duty_amount"

The value is the amount price of customs duties\ &#xNAN;Examples : 10 or 3.5\ &#xNAN;File type : number

"vat_amount"

The value is the amount price of locales taxes (VAT, GST, ...)\ &#xNAN;Examples : 10 or 3.5\ &#xNAN;File type : number

"special_taxes_amount"

The value is the amount price of specials taxes (OM, OMR, ...)\ &#xNAN;Examples : 10 or 3.5\ &#xNAN;File type : number

"global" / "amount"

The value is the amount prices of customs duties + locales taxes + specials taxes\ &#xNAN;Examples : 10 or 3.5\ &#xNAN;File type : number

JSON Examples - Request & Response

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

Video explainer

in progress...

Questions & Answers

Questions & Answers

Do you have a web application or a web platform ?

Yes, we do have a web application available here : https://app.transiteo.io

Can you create a custom API route for me ?

Yes, we can offer made-to-measure services to our clients. We know that the need is different for everyone. Contact the IT support at support@transiteo.com to discuss your needs with him.

How much do API requests cost ?

It depends on your consumption : the more you use our API, the cheaper the requests are. To take a look at our prices, you can visit https://www.app.transiteo.io/#/plans.

How to create a customer account ?

If you are reading this documentation, it means that you already have a customer account. If you need to activate it, please contact IT Support at support@transiteo.com.

Can I request more than one product on HSCode Finder ?

No, for the moment it’s limited to one product at a time.

Yes, we gathered data from different web sources and reprocessed it ourselves. The data are legal and exploitable.

From and to which country can I make requests ?

You can request from and to 178 countries, all the WTO members.

How many requests can I make per second ?

You can make up to 10,000 requests per second. If you have a bigger need, please contact our Account Manager - massinissa@transiteo.com - to express your need.

Where can I download your Postman collection ?

You can find our downloadable Postman collection here : POSTMAN API Collection.

Go to the Web App

Go to the Website

Web Application Guide

Introduction

Introduction

Bienvenue sur le guide de l'application web transiteo. Découvrez comment fonctionne chacun de nos services grâce à ce guide explicatif et illustré.

ACCOUNT

Créer un compte

Créer un compte

  • Vous allez ensuite recevoir un email, il faudra cliquer sur le bouton Valider mon compte :

  • Lors de votre première connexion, vous allez ensuite être redirigé.e vers un tutoriel de paramétrage de votre compte. Cliquez sur le bouton Démarrer :

PARAMÈTRES DE COMPTE

RAISON SOCIALE

Indiquez le nom de votre entreprise

Exemple : Ma Société

URL DE VOTRE BOUTIQUE

Indiquez l'adresse url de votre boutique en ligne

Exemple : http://www.monsite.com ou https://www.monsite.com

VOTRE MÉTHODE D'INTÉGRATION

Choisissez dans la liste déroulante

Choix : Plateforme SAAS / API / CMS - Prestashop 1.7.X / CMS Magento 2.3.X / CMS Woocommerce / CMS Shopify / CMS BigCommerce

PARAMÈTRES D'EXPÉDITION

PAYS

Choisissez dans la liste déroulante

Choix : Cliquez ici pour voir les pays disponibles

ADRESSE DE DÉPART

Indiquez l'adresse postale du point de départ de vos envois

Exemple : 34 Rue principale

CODE POSTAL

Saisissez le code postal de la ville de départ de vos expéditions

Exemple : 75001

VILLE

Indiquez le nom de la ville de départ

Exemple : Paris

ÉTAT / RÉGION

Choisissez dans la liste déroulante

Choix : Les états, régions, districts changent en fonction du pays.

PARAMÈTRES DE DESTINATION

Sélectionnez les pays ou continents entiers dans lesquels vous expédiez.

PARAMÈTRES TAX MANAGER

NUMÉRO D'IDENTIFICATION FISCALE

Choisissez dans la liste déroulante

Choix : Cliquez pour voir le continent, pays ou région dans la liste

CLASSIFICATION DOUANIÈRE

CATÉGORIE DE PRODUITS PAR DÉFAUT

Choisissez la catégorie de produits par défaut de votre boutique

Choix : Choisissez la catégorie de produits

CODE SH PAR DÉFAUT

Indiquez le code SH (code douanier) par défaut

Exemple : 8508190000

DESCRIPTIONS DE PRODUITS PAR DÉFAUTS

Indiquez le titre ou la description du produit le plus vendu

Exemple : aspirateur

PAYS D'ORIGINE DES PRODUITS PAR DÉFAUT

Choisissez le pays d'origine des produits par défaut

Choix : Choisissez le pays d'origine

PARAMÈTRES TRANSPORTEURS

RÉCAPITULATIF

Réinitialiser son mot de passe

Réinitialiser son mot de passe

Si vous avez oublié ou perdu votre mot de passe, vous pouvez cliquer sur Mot de passe oublié ? sur la page d'identification de l'application (https://www.app.transiteo.io/#/login) :

Vous allez être redirigé.e sur cette page pour réinitialiser votre mot de passe grâce à votre ADRESSE E-MAIL (https://www.app.transiteo.io/#/reset) :

Une fois votre adresse e-mail renseignée et avoir après cliqué sur le bouton Réinitialiser votre mot de passe, vous allez être redirigé.e vers cette page (https://www.app.transiteo.io/#/resetConfirm?email=...) :

Il faudra aller voir dans votre boite email, vous allez recevoir un email de ce type :

Copiez/Collez le CODE qui vous a été donné, votre ADRESSE E-MAIL et le NOUVEAU MOT DE PASSE sur cette page (https://www.app.transiteo.io/#/resetConfirm?email=...) :

Vous allez être redirigé.e ensuite vers la page d'identification de l'application (https://www.app.transiteo.io/#/login) pour vous connecter avec votre nouveau mot de passe :

Choisir une formule

Choisir une formule

Formule E-COMMERCE

Pour qui ?

Si vous êtes un e-commerçant utilisant un de ces CMS : Shopify, Magento, Prestashop, BigCommerce ou Wordpress.

Qu'est ce que ça comprend ?

Vous avez accès avec cet abonnement aux outils et services en illimité. Vous obtiendrez vos clefs d'activation pour les modules transiteo Welcome et transiteo Landed Cost.

Abonnement mensuel à 49€/mois

Chaque mois, à la date anniversaire de la contraction de votre formule vous serez débité.e de 49€.

+ Commission de 2% sur les droits et taxes

Les commissions sont prélevées uniquement sur le total des droits de douane et taxes des commandes abouties (commandes validées, payées, expédiées, réceptionnées et donc non retournées)

Exemple : Un client reçoit sa commande de 130€. 100€ H.T + 30€ de droits de douane et taxes. Nous allons prélever 0,60€, soit 30€ x 2%.

Consommation : Product > HSCode

Pour calculer les droits de douane et taxes sur vos commandes, il faut que préalablement vos produits soient attachés à un HSCode (code douanier). Si vous les connaissez vous n'aurez pas besoin de prendre une consommation, si vous ne les connaissez pas, il faudra prendre une quantité de crédits en fonction du nombre de produits que vous avez dans votre catalogue.

Formule API

Pour qui ?

Toutes les entreprises voulant connecter leurs services et/ou systèmes aux nôtres par API.

Qu'est ce que ça comprend ?

Vous avez accès à toute la bibliothèque de services de transiteo. Voir la documentation API.

Abonnement mensuel à 49€/mois

Chaque mois, à la date anniversaire de la contraction de votre formule vous serez débité.e de 49€.

+ Consommation

Vous devez pré-acheter des crédits pour utiliser les services de transiteo.

Consommation :

Pour connaitre les différents services par API, consulter la documentation API.

Formule APPLICATION WEB

Pour qui ?

Toutes les entreprises voulant connecter leurs services et/ou systèmes aux nôtres par API.

Qu'est ce que ça comprend ?

Vous avez accès à toute la bibliothèque de services de transiteo. Voir la documentation API.

Abonnement mensuel à 49€/mois

Chaque mois, à la date anniversaire de la contraction de votre formule vous serez débité.e de 49€.

+ Consommation

Vous devez pré acheter des crédits pour utiliser les services de transiteo.

Consommation : ...

Pour connaitre les différents services par API, consultez la documentation API.

Video Explainer

https://youtu.be/Sn41Av4CYkg

MENU - MANAGER

Accueil

Accueil

Essai gratuit

Depuis votre tableau de bord, accédez et pilotez l’ensemble de vos ventes à l’international (https://www.app.transiteo.io/#/dashboard) :

  • En haut à droite, LANGUES pour choisir la langue :

  • En haut à droite, MON PROFIL pour remplir et modifier toutes vos informations personnelles :

  • L'accès aux différents services pour gérer vos ventes, votre catalogue produit et vos données clients :

  • L'accès aux différents services pour gérer vos ventes à l'international :

  • Le bloc Choisissez votre formule Premium, pour choisir une formule payante et passer à un compte Premium :

  • L'accès au live chat pour demander une assistance à notre équipe :

  • Se déconnecter de votre compte :

Utilisation par API

Depuis votre tableau de bord, accédez et pilotez l’ensemble de vos services à l’international (https://www.app.transiteo.io/#/dashboard) :

  • En haut à droite, LANGUES pour choisir la langue :

  • En haut à droite, MON PROFIL pour remplir et modifier toutes vos informations personnelles :

  • En haut à droite, l'ensemble de vos statistiques, avec votre consommation de requêtes depuis la création de votre compte, ainsi que votre consommation de la journée

  • Les services utilisés et le nombre de requêtes consommées sur le nombre de requêtes achetées :

  • L'accès aux différents services pour gérer vos ventes, votre catalogue produit et vos données clients :

  • L'accès aux différents services pour gérer vos ventes à l'international :

  • L'accès aux paramètres :

  • L'accès à la documentation API :

  • L'accès au live chat pour demander une assistance à notre équipe :

  • Se déconnecter de votre compte :

Utilisation pour E-commerce

Depuis votre tableau de bord, accédez et pilotez l’ensemble de vos ventes à l’international (https://www.app.transiteo.io/#/dashboard) :

  • En haut à droite, LANGUES pour choisir la langue :

  • En haut à droite, MON PROFIL pour remplir et modifier toutes vos informations personnelles :

  • En haut à droite, votre chiffre d'affaire réalisé et les commandes réalisées du mois en cours :

  • Les top destinations, c'est-à-dire les pays où vous réalisez le plus de chiffre d'affaire :

  • L'accès aux différents services pour gérer vos ventes, votre catalogue produit et vos données clients :

  • L'accès aux différents services pour gérer vos ventes à l'international :

  • L'accès à la documentation :

  • L'accès aux paramètres :

  • L'accès au live chat pour demander une assistance à notre équipe :

  • Se déconnecter de votre compte :

Changer de langue

Changer de langue

Cliquez sur le bouton LANGUES dans le header de l'application :

L'application est disponible en 7 langues :

  • Français
  • Anglais
  • Chinois
  • Russe
  • Espagnol
  • Hindie
  • Portugais

Mon compte

Mon compte

Essai gratuit

Cliquez sur MON COMPTE dans le header de l'application :

Un menu déroulant apparait avec comme sous menu :

Utilisation par API

Cliquez sur MON COMPTE dans le header de l'application :

Un menu déroulant apparait avec comme sous menu :

Utilisation pour E-Commerce

Cliquez sur MON COMPTE dans le header de l'application :

Un menu déroulant apparait avec comme sous menu :

Menu

Menu

Essai gratuit

Accédez aux services transiteo directement depuis votre tableau de bord en cliquant sur Accéder selon le service que vous souhaitez utiliser :

  • transiteo AI CLASSIFY \ Classifier vos produits en code douanier (HSCode) grâce à l'intelligence artificielle
  • transiteo CUSTOMS DOCS\ Générer la documentation de vos envois à l'export
  • transiteo QUOTER \ Calculer en temps réel les droits de douane et taxes de vos ventes
  • transiteo TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Ou accédez à l'ensemble des outils transiteo, situés dans le menu à gauche de votre tableau de bord :

  • ACCUEIL\ Accéder à votre tableau de bord
  • MES VENTES \ Gérer l'ensemble de vos ventes à l'international
  • MON CATALOGUE\ Gérer l'ensemble de votre catalogue produit et ajouter y des codes douaniers (HSCode)
  • MES CLIENTS \ Gérer vos clients étrangers
  • AI CLASSIFY \ Classifier un ou plusieurs produit en code douanier (HSCode)
  • CUSTOMS DOCS

    Créer des documents douaniers et exports * QUOTER

    Calculer les droits de douane et taxes locales d'une commande ou d'un envoi en temps réel * TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Utilisation par API

Accédez aux services transiteo directement depuis votre tableau de bord en cliquant sur Accéder selon le service que vous souhaitez utiliser :

  • transiteo AI CLASSIFY \ Classifier vos produits en code douanier (HSCode) grâce à l'intelligence artificielle
  • transiteo CUSTOMS DOCS\ Générer la documentation de vos envois à l'export
  • transiteo QUOTER \ Calculer en temps réel les droits de douane et taxes de vos ventes
  • transiteo TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Ou accédez à l'ensemble des outils transiteo, situés dans le menu à gauche de votre tableau de bord :

  • ACCUEIL\ Accéder à votre tableau de bord
  • MES VENTES \ Gérer l'ensemble de vos ventes à l'international
  • MON CATALOGUE\ Gérer l'ensemble de votre catalogue produit et ajouter y des codes douaniers (HSCode)
  • MES CLIENTS \ Gérer vos clients étrangers
  • AI CLASSIFY \ Classifier un ou plusieurs produit en code douanier (HSCode)
  • CUSTOMS DOCS

    Créer des documents douaniers et exports * QUOTER

    Calculer les droits de douane et taxes locales d'une commande ou d'un envoi en temps réel * TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Utilisation pour E-commerce

Accédez aux services transiteo directement depuis votre tableau de bord en cliquant sur Accéder selon le service que vous souhaitez utiliser :

  • transiteo AI CLASSIFY \ Classifier vos produits en code douanier (HSCode) grâce à l'intelligence artificielle
  • transiteo CUSTOMS DOCS\ Générer la documentation de vos envois à l'export
  • transiteo QUOTER \ Calculer en temps réel les droits de douane et taxes de vos ventes
  • transiteo TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Ou accédez à l'ensemble des outils transiteo, situés dans le menu à gauche de votre tableau de bord :

  • ACCUEIL\ Accéder à votre tableau de bord
  • MES VENTES \ Gérer l'ensemble de vos ventes à l'international
  • MON CATALOGUE\ Gérer l'ensemble de votre catalogue produit et ajouter y des codes douaniers (HSCode)
  • MES CLIENTS \ Gérer vos clients étrangers
  • AI CLASSIFY \ Classifier un ou plusieurs produit en code douanier (HSCode)
  • CUSTOMS DOCS

    Créer des documents douaniers et exports * QUOTER

    Calculer les droits de douane et taxes locales d'une commande ou d'un envoi en temps réel * TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Statistiques

Statistiques

Essai gratuit

En version Freemium, vous ne pouvez pas visualiser vos statistiques :

Utilisation par API

Gardez le contrôle sur votre Consommation de requêtes des services utilisés depuis la création de votre compte, ainsi que votre Consommation du jour :

Contrôlez en détail vos SERVICES UTILISÉS et visualisez vos consommations restantes :

Liste des services :

Liste des services Explications
Duty Rate Pour calculer le taux de taxes de vos produits
SalesTax Rates Pour calculer le taux de SalesTax de vos produits (États-Unis)
Special Taxes Rates Pour calculer le taux de Special Taxes de vos produits
Local Taxes Rates Pour calculer le taux de Local Taxes de vos produits
Docs Generation Pour générer vos documents export
Duties & Taxes Calculation Pour calculer les droits de douane et taxes de vos produits
A.I Classify Pour classifier vos produits en HSCode (code douanier)
Local Taxes Calculation Pour calculer les Local Taxes de vos produits

Utilisation pour E-Commerce

Contrôlez votre chiffre d'affaire réalisé depuis la création de votre compte, ainsi que les commandes réalisées du jour :

Contrôlez dans TOP DESTINATION les pays phares de vos commandes à l'international :

Vous avez besoin de plus de requêtes ? Recharger votre compte

Support

Support

Contactez à tout moment l'équipe transiteo grâce au live chat, situé en bas à droite de votre tableau de bord :

Cliquez sur l'icône, cela vous ouvrira une fenêtre pour écrire à notre équipe :

Écrivez votre message sur le live chat. Vous serez mis en relation avec notre équipe :

Mes ventes

Mes ventes

Pour gérer vos ventes, cliquez sur MES VENTES à gauche de votre menu (https://www.app.transiteo.io/#/orderManager) :

Vous avez ici une vision sur l’ensemble de vos commandes : numéro de commande, nom et prénom du client, date de la commande, pays de l’acheteur, statut de la commande, etc. Importez directement vos fichiers de vente ou ajoutez vos commandes manuellement :

Détail du tableau

Détail du tableau

Colonnes dans le tableau des ventes :

Nom des colonnesExemple
NUMÉRO DE COMMANDE1573675
NUMÉRO DE FACTURE1573675
TOTAL PRODUITS H.T.223
TOTAL TRANSPORT H.T.20
TOTAL DROITS DE DOUANE12.56
TOTAL TAXE LOCALE6.23
TOTAL TAXES SPECIALES3.46
DEVISEEUR
URL DE LA BOUTIQUEhttps://transiteo.com/
DATE DE COMMANDE2022-01-31 12:20:34
PRÉNOM DU CLIENT Mélodie
NOM DU CLIENTDuraiz
ADRESSE DU CLIENT44 avenue des lucioles
CODE POSTAL DU CLIENT75020
VILLE DU CLIENTParis
PAYS DU CLIENTFrance
PRÉNOM DE L'ACHETEURJérome
NOM DE L'ACHETEURVan Delen
ADRESSE DE L'ACHETEUR1 rue de l'impasse
CODE POSTAL DE L'ACHETEUR1005
VILLE DE L'ACHETEURBruxelles
PAYS DE L'ACHETEURBelgique
PRÉNOM DU COMMISSIONNAIREArnaud
NOM DU COMMISSIONNAIRESigal
ADRESSE DU COMMISSIONNAIRE123 rue du bouclier
CODE POSTAL DU COMMISSIONNAIRE92130
VILLE DU COMMISSIONNAIREIssy-les-Moulineaux
PAYS DU COMMISSIONNAIREFrance
TYPE DE PAIEMENTVirement bancaire
DATE DE PAIEMENT2022-01-31 12:19:23
PAYS DE DÉPARTFrance
PAYS DE DESTINATIONBelgique
TRANSPORTEUR D'EXPORTATIONUPS
TRANSPORTEURUPS
CATÉGORIE DE L'ÉLÉMENTCommercial Goods
MOYEN DE PAIEMENTVirement bancaire
STATUT DE COMMANDEAWAITING
DATE DE MISE À JOUR2022-01-31 12:21:01

Sous-colonnes dans le tableau d'une vente :

Noms des sous colonnesExemple
SKU009-1-3
Quantité2
Prix Unitaire150
Devise du produitEUR

Importer une commande

Importer une commande

Télécharger le modèle de fichier CSV

Vue du CSV sous forme de tableau avec noms et correspondances des champs :

product_1_skuproduct_1_quantityproduct_1_unit_priceproduct_1_unit_price_currencyproduct_2_skuproduct_2_quantityproduct_2_unit_priceproduct_2_unit_price_currencyorder_idinvoice_idurlorder_date_hourcustomer_firstnamecustomer_lastnamecustomer_addresscustomer_zipcodecustomer_citycustomer_countrybuyer_firstnamebuyer_lastnamebuyer_addressbuyer_zipcodebuyer_citybuyer_countryagent_firstnameagent_lastnameagent_addressagent_zipcodeagent_cityagent_countryorder_payment_typeorder_payment_datedeparture_countryarrival_countryexporting_carriershipping_carriercategory_of_itempayment_typeamount_productsamount_shippingamount_dutyamount_vatamount_specialtaxesincotermcurrencyorder_statut
SKUQuantitéPrix unitaireDevise du prix unitaire SKUQuantitéPrix unitaireDevise du prix unitaire Numéro de commandeNuméro de factureURLDate de commandePrénom du clientNom du clientAdresse du clientCode postal du clientVille du clientPays du clientPrénom de l'acheteurNom de l'acheteur Adresse de l'acheteurCode postal de l'acheteurVille de l'acheteurPays de l'acheteurPrénom du commissionnaireNom du commissionnaireAdresse du commissionnaireCode postal du commissionnaireVille du commissionnairePays du commissionnaireType de paiementDate de paiementPays de départPays de destinationTransporteur d'exportation TransporteurCatégorie de l'élémentMoyen de paiementTotal produits H.TTotal transport H.TTotal droits de douaneTotal taxe localeTotal taxes spécialesIncotermDeviseStatut de commande
C'est la référence de votre produitC'est la quantité du produitC'est le prix à l'unité du produitC'est la devise du prix unitaire du produitC'est la référence de votre produitC'est la quantité du produitC'est le prix à l'unité du produitC'est la devise du prix unitaire du produitC'est le numéro de commandeC'est le numéro de factureC'est l'URL de la boutique C'est la date et l'heure de commandeC'est le prénom du clientC'est le nom du clientC'est l'adresse du client C'est le code postal du clientC'est la ville du clientC'est le pays du clientC'est le prénom de l'acheteurC'est le nom de l'acheteur C'est l'adresse de l'acheteurC'est le code postal de l'acheteurC'est la ville de l'acheteurC'est le pays de l'acheteurC'est le prénom du commissionnaireC'est le nom du commissionnaireC'est l'adresse du commissionnaireC'est le code postal du commissionnaireC'est la ville du commissionnaireC'est le pays du commissionnaire C'est le type de paiement de la commandeC'est la date de paiement de la commandeC'est le pays de départ de la commandeC'est le pays de destination de la commandeC'est le transporteur d'exportationC'est le transporteur C'est le type d'envoi C'est le moyen de paiement de la commandeC'est le montant total des produits H.T. de la commandeC'est le montant total du transport H.T. de la commandeC'est le montant total des droits de douane de la commandeC'est le montant total de la taxe locale de la commandeC'est le montant total des taxes spéciales de la commandeC'est l'incoterm de la commandeC'est la devise de la commandeC'est le statut de la commande

Vous devez obligatoirement remplir les champs suivants :

  • product_1_sku
  • product_1_quantity
  • product_1_unit_price
  • product_1_unit_price_currency
  • order_id
  • order_date_hour
  • departure_country
  • amount_products
  • order_statut

Si vous n'avez qu'un type de produit dans votre commande, veillez à supprimer les colonnes suivantes du fichier CSV :

  • product_2_sku
  • product_2_quantity
  • product_2_unit_price
  • product_2_unit_price_currency

Dans le cas de plusieurs produits dans une même commande :

Si vous avez plusieurs type de produits par commande, vous devez ajoutez les colonnes suivantes selon le nombre de produits. Si vous avez 2 types de produit par exemple, ajoutez ces colonnes après la colonne product_1_unit_price_currency :

  • product_2_sku
  • product_2_quantity
  • product_2_unit_price
  • product_2_unit_price_currency

Si vous avez 3 types de produits par exemple, ajoutez ces colonnes après la colonne product_2_unit_price_currency. Créez des colonnes et nommez-les ainsi :

  • product_3_sku
  • product_3_quantity
  • product_3_unit_price
  • product_3_unit_price_currency

etc...

FORMAT DES DONNÉES ET MESSAGES D'ERREURS

ChampsFormatExempleMessage d'erreur
product_1_skuChaine de caractère libre23FDDGR542Line XXXXXX : product_1_sku doit contenir au moins un caractère
product_1_quantity Chaine de caractère libre1, 5, 100Line XXXXXX : product_1_quantity doit être un nombre
product_1_unit_priceNombre décimal12.5, 234, 567.54Line XXXXXX : Line 2 : product_1_unit_price doit être un nombre
product_1_unit_price_currencyCode ISO Alpha 3EUR, USD, CADLine XXXXXX : product_1_unit_price_currency doit être une devise au format ISO 4217
order_idChaine de caractère libre24534542Line XXXXXX : order_id doit contenir au moins un caractère
departure_countryCode ISO Alpha 2 ou 3FRA, CAN, USALine XXXXXX : departure_country doit être un pays au format ISO3
arrival_countryCode ISO Alpha 2 ou 3FRA, CAN, USALine XXXXXX : arrival_country doit être un pays au format ISO3
amount_productsNombre décimal43.78, 55, 797.43Line XXXXXX : amount_products doit être un nombre
currencyCode ISO Alpha 3EUR, USD, CADLine XXXXXX : currency doit être une devise au format ISO 4217
order_statut Chaine de caractère libreValidée, RembourséeLine XXXXXX : order_statut doit contenir au moins un caractère
INCORRECT_JSON Chaine de caractèreMon Jan 31 2021 12:22:42INCORRECT_JSON : Incorrect Json Request. Details : order_date_hour : order_date_hour must be a number order_date_hour should not be empty

Line 2 : product_1_sku doit contenir au moins un caractère

Si vous recevez ce message, c'est que vous n'avez pas renseigné de SKU.

Solution :

Vous devez remplir un SKU.

Exemple : 976-43-2

------------------------------

Line 2 : product_1_quantity doit être un nombre

Si vous recevez ce message, c'est que vous n'avez pas renseigné une quantité de produit.

Solution :

Exemple 1, 23, 100, etc.

------------------------------

Line 2 : product_1_unit_price doit être un nombre

Si vous recevez ce message, c'est que vous n'avez pas renseigné un prix pour le produit ou que le format du prix n'est pas correct.

Les prix à décimales doivent être indiqués sous le format suivant : 23.99

Solution :

Exemple : 23, 67, 123, 1200, etc.

------------------------------

Line 2 : product_1_unit_price_currency doit être une devise au format ISO 4217

Si vous recevez ce message, c'est que vous n'avez pas renseigné la devise du prix de votre produit ou que le format ne respecte pas le format ISO 4217.

Liste des devises au format ISO 4217

Solution :

Exemple : EUR, USD, CHF, CNY, etc.

------------------------------

Line 2 : order_id doit contenir au moins un caractère

Si vous recevez ce message, c'est que vous n'avez pas renseigné de numéro de commande pour votre ou vos produits.

Solution :

Exemple : 768, 12467, 35763, etc.

------------------------------

Line 2 : departure_country doit être un pays au format ISO3

Si vous recevez ce message, c'est que vous n'avez pas renseigné de pays de départ ou que le format ne respecte pas le format ISO3.

Solution :

Exemple : FRA, BRA, NGA, etc.

------------------------------

Line 2 : arrival_country doit être un pays au format ISO3

Si vous recevez ce message, c'est que vous n'avez pas renseigné de pays de destination ou que le format ne respecte pas le format ISO3.

Solution :

Exemple : CHN, IND, JPN, etc.

------------------------------

Line 2 : amount_products doit être un nombre

Si vous recevez ce message, c'est que vous n'avez pas renseigné un montant pour l'ensemble des produits de votre commande.

Solution :

Exemple : 1243, 534, 542, etc.

------------------------------

Line 2 : currency doit être une devise au format ISO 4217

Si vous recevez ce message, c'est que vous n'avez pas renseigné de devise pour le total de votre commande ou que le format ne respecte pas le format ISO 4217.

Solution :

Exemple : EUR, AUD, GBP, etc.

------------------------------

Line 2 : order_statut doit contenir au moins un caractère

Si vous recevez ce message, c'est que vous n'avez pas renseigné le statut de votre commande.

Solution :

Exemple : AWAITING, PAID, etc.

------------------------------

INCORRECT_JSON : Incorrect Json Request. Details : order_date_hour : order_date_hour must be a number order_date_hour should not be empty

Si vous recevez ce message, c'est que vous n'avez pas renseigné la date et l'heure de commande.

Solution :

Exemple : Mon Jan 31 2021 12:22

Ajouter une commande

Ajouter une commande

Pour ajouter une commande, cliquez sur le bouton Ajouter une commande :

Noms des champs Exemple
NUMÉRO DE COMMANDE 1573675
DATE DE COMMANDE 2022-01-31 12:20:34
SKU 998-4-6
QUANTITÉ 1
PRIX UNITAIRE 25
DEVISE DU PRODUIT EUR
PAYS DE DESTINATION CHN
TOTAL PRODUITS H.T 25
DEVISE EUR
STATUT DE LA COMMANDE AWAITING

Champs obligatoires à remplir :

  • NUMÉRO DE COMMANDE
  • DATE DE COMMANDE
  • SKU
  • QUANTITÉ
  • PRIX UNITAIRE
  • DEVISE DU PRODUIT
  • PAYS DE DESTINATION
  • TOTAL PRODUITS H.T
  • DEVISE
  • STATUT DE LA COMMANDE

Champs non-obligatoires :

  • NUMÉRO DE FACTURE
  • URL DE LA BOUTIQUE
  • PRÉNOM DU CLIENT
  • NOM DU CLIENT
  • ADRESSE DU CLIENT
  • CODE POSTAL DU CLIENT
  • VILLE DU CLIENT
  • PRÉNOM DE L'ACHETEUR
  • NOM DE L'ACHETEUR
  • ADRESSE DE L'ACHETEUR
  • CODE POSTAL DE L'ACHETEUR
  • VILLE DE L'ACHETEUR
  • PAYS DE L'ACHETEUR
  • PRÉNOM DU COMMISSIONNAIRE
  • NOM DU COMMISSIONNAIRE
  • ADRESSE DU COMMISSIONNAIRE
  • CODE POSTAL DU COMMISSIONNAIRE
  • VILLE DU COMMISSIONNAIRE
  • PAYS DU COMMISSIONNAIRE
  • PAYS DE DÉPART
  • TRANSPORTEUR D'EXPORTATION
  • TRANSPORTEUR
  • TOTAL TRANSPORT H.T
  • TOTAL DROITS DE DOUANE
  • TOTAL TAXE LOCALE
  • TOTAL TAXES SPECIALES
  • TYPE DE PAIEMENT
  • DATE DE PAIEMENT
  • CATÉGORIE DE L'ÉLÉMENT
  • MOYEN DE PAIEMENT

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquez sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Veillez à remplir tous les champs signalés par un astérisque rouge.

Modifier une commande

Modifier une commande

Pour ajouter, supprimer ou changer les informations relatives à une commande, rendez-vous sur la ligne de la commande concernée et allez tout à droite. Ensuite, cliquez sur l'icône pour modifier la ligne :

Vous aurez accès à l'ensemble des informations concernant votre commande et pourrez modifier les différents champs :

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquer sur le bouton Valider, c'est que vous n'avez pas remplis tous les champs obligatoires.

Solution :

Veillez à remplir tous les champs signalés par un astérisque rouge.

------------------------------

Solution :

------------------------------

Génerer des docs export

Génerer des docs export

Pour générer des documents export relatifs à une commande, rendez-vous sur la ligne de la commande concernée et aller tout à droite. Ensuite, cliquez sur l'icône en forme de document au bout de la ligne :

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Figer une colonne

Figer une colonne

Vous pouvez figer des volets pour verrouiller des colonnes spécifiques dans votre tableau. Il suffit d'appuyer sur l'icône de punaise puis choisir la colonne que vous souhaitez épingler avant de cliquer sur "valider"

Dans ce cas, vous pourrez parcourir le tableau tout en gardant, visible à l'écran, la colonne portant les noms des produits :

Synchronisation

Synchronisation

Si vous avez installé une des extensions à votre CMS, la synchronisation de vos commandes sera automatique.

Liste des CMS :

  • Wordpress
  • Shopify
  • Magento
  • Prestashop
  • BigCommerce

Mon Catalogue

Mon Catalogue

  • Vous pouvez ajouter, supprimer ou modifier à votre guise les données relatives à vos produits. Vous pouvez importer directement votre catalogue produit en fichier CSV, et/ou exporter le catalogue produit que vous avez créé sur l’outil Mon catalogue :

Détail du tableau

Détail du tableau

Colonnes dans le tableau du catalogue produit :

Noms des colonnesExemple
TYPE SKU
SKU DU PRODUIT987-43-8
NOM DU PRODUITTable en bois
POIDS13
UNITÉ DE POIDSkg
QUANTITÉ1
PRIX UNITAIRE H.T240
DEVISEEUR
HS CODE9403609000
VERSION DU HS CODEHS17
DÉSIGNATION DU CODEchapter_designation : Furniture; bedding, mattresses, mattress supports, cushions and similar stuffed furnishings; lamps and lighting fittings, not elsewhere specified or included; illuminated signs, illuminated name- plates and the like; prefabricated buildings -- heading_designation : Other furniture and parts thereof. -- subheading_designation : Wooden furniture (excl. for offices, kitchens and bedrooms, and seats) -- national_designation : Wooden furniture (excl. for offices or shops, kitchens, dining rooms, living rooms and bedrooms, and seats)
STATUT DU PRODUITProhibé à l'importation dans ce pays

Pour modifier les colonnes, cliquez sur Modifier les colonnes en bas de votre catalogue produit :

Un encadré vous signalant les colonnes affichées et les colonnes non affichées s'ouvre. Vous pouvez déplacer le colonnes dans les lignes colonnes affichées et colonnes non affichées selon vos préférences, puis cliquez sue le bouton Valider pour enregistrer vos modifications :

Importer des produits

Importer des produits

Téléchargez le modèle de fichier CSV

Vue du CSV sous forme de tableau avec noms et correspondances des champs :

skuproductIDweightweight_unitquantityunit_priceunit_ship_pricecurrency_unit_pricesale_unit_pricesale_currency_unit_pricepurchase_unit_pricepurchase_currency_unit_pricefrom_countryto_countryto_districtrevenue_country_annualcurrency_revenue_country_annualhscodefinder_hs_code
skuID du produitPoidsUnité de poidsQuantitéPrix unitaire H.TPrix du transportDevisePrix de venteDevise du prix de ventePrix unitaire d'achatDevise du prix unitaire d'achatPays de départPays de destinationDistrict Chiffre d'affaire de l'expéditeur dan le pays de destinationDeviseHSCode
C'est la référence de votre produitC'est une référence secondaire du produit (titre, description, etc)C'est le poids du produit C'est l'unité de masse du produitC'est la quantité du produitC'est le prix H.T. à l'unité du produitC'est le prix du transportC'est la devise du prixC'est le prix de vente C'est la devise du prix de vente C'est le prix unitaire d'achatC'est la devise du prix unitaire d'achatC'est le pays de départ du produitC'est le pays de destination du produitC'est le district du pays de destination (obligatoire pour USA et CAN uniquement) C'est le chiffre d'affaire de l'expéditeur dans le pays de destinationC'est la devise du chiffre d'affaire de l'expéditeur dans le pays de destination C'est le code douanier (HSCode) du produit

Vous devez renseigner obligatoirement les champs suivants pour pouvoir importer un fichier CSV dans votre catalogue produit :

  • sku
  • productID
  • weight
  • weight_unit

Prise en compte des modèles de catalogue des CMS suivants :

  • Wordpress
  • Shopify
  • Prestashop
  • Magento
  • BigCommerce

FORMAT DES DONNÉES ET MESSAGES D'ERREURS

ChampsFormatExempleMessage d'erreur
skuChaine de caractère libreHidj7"èç':;,?ù:Line XXXXXX : sku doit contenir au moins un caractère
productIDChaine de caractère librejdIE83!'ç(à=+Line XXXXXX : productID doit contenir au moins un caractère
weightNombre décimal12, 4.78, 19.9, ...Line XXXXXX : weight doit contenir au moins un caractère
weight_unitChaine de caractèrekg, lbsLine XXXXXX : weight_unit est invalide

Line 2 : sku doit contenir au moins un caractère

Si vous recevez ce message, c'est que vous n'avez pas renseigné un SKU pour le produit.

Solution :

Vous devez remplir un SKU pour le produit.

Exemple : 0678-9-3

-----------

Line 2 : productID doit contenir au moins un caractère

Si vous recevez ce message, c'est que vous n'avez pas renseigné un nom de produit.

Solution :

Vous devez remplir un nom de produit.

Exemple : Vase en verre

------------------------------

Line 2 : weight doit être un nombre

Si vous recevez ce message, c'est que vous n'avez pas renseigné le poids de votre produit.

Solution :

Il faut renseigner le poids de votre produit.

Exemple correct : 1.4

----------------

Line 2 : weight_unit est invalide

Si vous recevez ce message, c'est que vous n'avez pas renseigné l'unité de poids de votre produit correctement.

Exemple faux : Kg

Solution :

Il faut renseigner les unités de mesures en minuscules.

Exemple correct : kg

Ajouter un produit

Ajouter un produit

Pour ajouter un produit à votre catalogue, cliquer sur le bouton Ajouter un produit, en haut à droite :

Pour ajouter un produit à votre catalogue, vous devez remplir obligatoirement les champs suivants :

  • NOM DU PRODUIT
  • POIDS
  • UNITÉ DE POIDS

En cliquant sur Ajouter une colonne, vous ajoutez les champs obligatoires suivants :

  • LABEL
  • VALEUR

Noms du champSignification du champExemple / Valeur
TYPEC'est le type SKUSKU
SKU DU PRODUITC'est le SKU rattaché au produit 5676-325-763
NOM DU PRODUITC'est le nom du produit Aspirateur, t-shirt en coton, table en bois
POIDSC'est le poids du produit3, 6.7, 45
UNITÉ DE POIDSC'est l'unité de poids du produit g, Kg, lb, t, oz
LABEL - QuantitéC'est la quantité3, 10, 200
LABEL - Prix unitaire HTC'est le prix unitaire HT45, 70.34, 100
LABEL - Frais de livraison HTCe sont les frais de livraison HT6.90, 10, 50
LABEL - Devise C'est la devise Euros (EUR), Livre Sterling (GBP), Roupie Indienne (INR)
LABEL - Prix de vente HTC'est le prix de vente HT45, 90.78, 230
LABEL - Devise du prix de venteC'est la devise du prix de vente Yen (JPY), Peso Mexicain (MXN), Dollar néo (NZD)
LABEL - Prix d'achat HT C'est le prix d'achat HT4, 45.8, 100.02
LABEL - Devise du prix d'achat C'est la devise du prix d'achat Franc congolais (CDF), Peso argentin (ARS)
LABEL - Pays d'origineC'est le pays d'origine Algérie, Bénin, Chine
LABEL - Pays d'expédition C'est le pays d'expéditionMaroc, Martinique, Canada
LABEL - Pays de destination C'est le pays de destination Chine, Etats-Unis d'Amérique, Hongrie
LABEL - District de destination C'est le district de destination Irlande, Namibie, Samoa
LABEL - Chiffre d'affaire annuel à destination réalisé C'est le chiffre d'affaire annuel à destination réalisé457900, 1000000, 5678000
LABEL - Devise du chiffre d'affaireC'est la devise du chiffre d'affaireLari géorgien (GEL), Quetzal (GTQ), Shekel Israélien (ILS)
LABEL - HS codeC'est le HS Code 8508190000, 6109100010, 95066200
ValeurC'est la valeur du label que vous avez sélectionnez Tous les exemples des labels

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquez sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Veillez à remplir tous les champs signalés par un astérisque rouge.

------------------------------

Solution :

------------------------------

Modifier un produit

Modifier un produit

Pour ajouter, supprimer ou changer les informations relatives à un produit, rendez-vous sur la ligne du produit concerné et allez tout à droite. Ensuite, cliquez sur l'icône de modification :

Une fenêtre vous permettant d'accéder à votre fiche produit s'ouvre :

Pensez à bien valider vos modifications.

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquez sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Veillez à remplir tous les champs signalés par un astérisque rouge.

------------------------------

Solution :

------------------------------

Supprimer des produits

Supprimer des produits

Pour supprimer un ou des produits de votre catalogue, cliquez sur la case tout à gauche de la ligne du ou des produits concernés :

Puis, cliquez sur Supprimer les produits sélectionnés, en bas à droite de votre catalogue pour les retirer :

Un encadré vous demandant si vous êtes sûr.e de vouloir supprimer le/les produits apparaît. Cliquez sur le bouton Oui :

Classifier des produits

Classifier des produits

Pour classifier un ou des produits de votre catalogue en code douanier (HSCode), sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

Cliquez sur le bouton Sélectionner une action en bas de votre catalogue produit. Ensuite, cliquez sur Rechercher les HS Code :

Cliquez ensuite sur le symbole de validation pour lancer votre classification :

Vos produits sont automatiquement classés en HSCode :

MESSAGES D'ERREURS

Lorsque vous souhaitez classifier un produit en HSCode, un encadré vous signalant que certains champs sont requis apparaît.

Solution :

Remplissez ces champs pour pouvoir obtenir votre HSCode.

------------------------------

Solution :

------------------------------

Récupérer les droits de douane

Récupérer les droits de douane

Pour récupérer les droits de douane d'un ou des produits de votre catalogue, sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

La première étape pour récupérer vos droits de douanes est de classifier tous vos produits en HSCode. Pour ce faire, appuyez sur "choisir une action" et choisissez la fonctionnalité "Rechercher les HSCodes" puis cliquez sur la coche "✓" tout à droite :

Vous ne pouvez pas récupérer les droits de douane d'un produit avant de classifier en HSCode ce même produit.

Vous devez ensuite saisir le pays de destination de chacun des produits dans le menu affiché sur votre écran puis cliquer sur "Valider"

Vos produits seront automatiquement classés en HSCodes :

Ensuite, appuyez une deuxième fois sur "Sélectionner une action" et choisissez l'action "Récupérer les droits de douane" puis cliquez sur la barre tout à droite pour valider votre choix

Vous devez par la suite renseigner le pays d'expédition des produits sélectionnés avant d'appuyer sur "valider", puis cliquez encore une fois sur la coche "✓"

Vous pouvez désormais récupérer vos droits de douane ! Faites défiler l'écran vers la droite pour voir tous les champs

Les résultats s'affichent en décimal. Multipliez le nombre décimal par 100 pour les transformer en pourcentage (e.g : 0.05 =5%)

Récupérer les taux de taxes locales

Récupérer les taux de taxes locales

Pour récupérer les taux de taxes locales d'un ou des produits de votre catalogue, sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

La première étape pour récupérer vos droits de douanes est de classifier tous vos produits en HSCode. Pour ce faire, appuyez sur "choisir une action" et choisissez la fonctionnalité "Rechercher les HSCodes" puis cliquez sur la coche "✓" tout à droite

Vous ne pouvez pas récupérer les taux de taxes locales d'un produit avant de classifier en HSCode ce même produit.

Vous devez ensuite saisir le pays de destination de chacun des produits dans le menu affiché sur votre écran puis cliquer sur "Valider"

Vos produits seront automatiquement classés en HSCodes

Ensuite, appuyez une deuxième fois sur "Sélectionner une action" et choisissez l'action "Récupérer les taux de taxes locales" puis cliquez sur la barre tout à droite pour valider votre choix

Les taux de taxes locales de vos produits seront affichés dans la partie droite de votre écran

Récupérer les taux de taxes spéciales

Récupérer les taux de taxes spéciales

Pour récupérer les taux de taxes spéciales d'un ou des produits de votre catalogue, sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

La première étape pour récupérer les taux de vos taxes spéciales est de classifier tous vos produits en HSCode. Pour ce faire, appuyez sur "choisir une action" et choisissez la fonctionnalité "Rechercher les HSCodes" puis cliquez sur la coche "✓" tout à droite

Vous ne pouvez pas récupérer les taux de taxes spéciales d'un produit avant de classifier en HSCode ce même produit.

Vous devez ensuite saisir le pays de destination de chacun des produits dans le menu affiché sur votre écran puis cliquer sur "Valider"

Vos produits seront automatiquement classés en HSCodes

Ensuite, appuyez une deuxième fois sur "Sélectionner une action" et choisissez l'action "Récupérer les taux de taxes spéciales" puis cliquez sur la barre tout à droite pour valider votre choix

Vous pouvez désormais récupérer les taux des taxes spéciales ! Faites défiler l'écran vers la droite pour voir tous les champs

Récupérer les eco taxes

Récupérer les eco taxes

Pour récupérer les eco taxes d'un ou des produits de votre catalogue, sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

La première étape pour récupérer les eco taxes est de classifier tous vos produits en HSCode. Pour ce faire, appuyez sur "choisir une action" et choisissez la fonctionnalité "Rechercher les HSCodes" puis cliquez sur la coche "✓" tout à droite

Vous ne pouvez pas récupérer les eco de taxes d'un produit avant de classifier en HSCode ce même produit.

Vous devez ensuite saisir le pays de destination de chacun des produits dans le menu affiché sur votre écran puis cliquer sur "Valider"

Vos produits seront automatiquement classés en HSCodes

Ensuite, appuyez une deuxième fois sur "Sélectionner une action" et choisissez l'action "Récupérer les eco taxes" puis cliquez sur la barre tout à droite pour valider votre choix

Les eco taxes de vos produits seront affichés dans la partie droite de votre écran :

Calculer les marges

Calculer les marges

Vous ne pouvez pas calculer les marges d'un produit avant de passer par les étapes ci-dessous :

  1. Classifier le produit en HSCode (Voir p.6 > Mon catalogue)
  2. Récupérer les droits de douanes (Voir p.7 > Mon catalogue)
  3. Récupérer les taux de taxes locales (Voir p.8 > Mon catalogue)
  4. Récupérer les taux de taxes spéciales (Voir p.9 > Mon catalogue)

Pour calculer les marges d'un ou des produits de votre catalogue, sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

La première étape pour récupérer les eco taxes est de classifier tous vos produits en HSCode. Pour ce faire, appuyez sur "choisir une action" et choisissez la fonctionnalité "Rechercher les HSCodes" puis cliquez sur la coche "✓" tout à droite

Vous devez ensuite saisir le pays de destination de chacun des produits dans le menu affiché sur votre écran puis cliquer sur "Valider"

Vos produits seront automatiquement classés en HSCodes

Ensuite, appuyez une deuxième fois sur "Sélectionner une action" et choisissez l'action "Calculer les marges" puis cliquez sur la barre tout à droite pour valider votre choix

Vous devez ensuite remplir les champs requis pour chacun des produits sélectionnés puis cliquer sur "Valider"

Vous pouvez désormais récupérer vos marges ! Faites défiler l'écran vers la droite pour voir tous les champs

Figer une colonne

Figer une colonne

Vous pouvez figer des volets pour verrouiller des colonnes spécifiques dans votre tableau. Il suffit d'appuyer sur l'icône de punaise puis choisir la colonne que vous souhaitez épingler avant de cliquer sur "valider"

Dans ce cas, vous pourrez parcourir le tableau tout en gardant, visible à l'écran, la colonne portant les noms des produits :

Synchronisation

Synchronisation

Si vous avez installé une des extensions à votre CMS, la synchronisation de vos commandes sera automatique.

Liste des CMS :

  • Wordpress
  • Shopify
  • Magento
  • Prestashop
  • BigCommerce

Mes Clients

Mes Clients

Pour utiliser l'outil Mes Clients, cliquez sur MES CLIENTS à gauche de votre menu (https://www.app.transiteo.io/#/customerManager) :

Vous pouvez visualiser l'ensemble de vos fiches clients et les informations associées :

Détails du tableau

Détails du tableau

Les champs du tableau :

  • Adresse mail du client
  • Site web du client
  • Prénom
  • Nom
  • Civilité
  • Age
  • N° de téléphone
  • Code postal
  • Adresse
  • Ville
  • État/Région
  • Pays
  • Nom de société du client
  • ID de société
  • N° de TVA
  • Professionnel
  • Commandes payées
  • Commande en attente
  • Commandes annulées
  • Produits achetés

Ajouter un client

Ajouter un client

Pour ajouter un client, cliquez sur le bouton Ajouter un client :

Plusieurs informations obligatoires concernant votre client sont demandées :

  • Adresse mail du client
  • Site web du client
  • Prénom
  • Nom
  • Civilité
  • Age
  • N° de téléphone
  • Pays
  • État/Région
  • Code postal
  • Adresse
  • Ville
  • Professionnel

Les informations non-obligatoire demandées :

  • Nom de société du client
  • ID de société
  • N° de TVA

Pour associer un ou plusieurs produits achetés à votre client, cliquez sur Ajouter un produit. Vous devez obligatoirement renseigner les informations suivantes :

  • SKU du produit
  • Quantité
  • Prix unitaire
  • Devise

Pour associer une ou des commandes payées à votre client, cliquez sur Ajouter une commande. Vous devez obligatoirement renseigner les informations suivantes :

  • ID de commande
  • Devise
  • Total droits de douane
  • Total taxes locales
  • Total taxes spéciales
  • Montant total

Pour associer une ou des commandes en attente à votre client, cliquez sur Ajouter une commande. Vous devez obligatoirement renseigner les informations suivantes :

  • ID de commande
  • Devise
  • Total droits de douane
  • Total taxes locales
  • Total taxes spéciales
  • Montant total

Pour associer une ou des commandes annulées à votre client, cliquez sur Ajouter une commande. Vous devez obligatoirement renseigner les informations suivantes :

  • ID de commande
  • Devise
  • Total droits de douane
  • Total taxes locales
  • Total taxes spéciales
  • Montant total

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquer sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Remplissez les champs signalés par un astérisque rouge.

Modifier les infos d'un client

Modifier les infos d'un client

Pour modifier les informations d'un client, rendez-vous tout à droit de la ligne et cliquez sur l'icône de modification :

Les informations de votre client s'ouvrent dans une fenêtre, vous pouvez les modifier. N'oubliez pas de cliquer sur le bouton Valider pour enregistrer vos modifications :

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquer sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Remplissez les champs signalés par un astérisque rouge.

Supprimer un client

Supprimer un client

Pour supprimer un client, rendez-vous tout à droite de la ligne et cliquez sur l'icône de suppression :

MENU - SERVICES

AI Classify

AI Classify

  • Pour utiliser notre outil AI CLASSIFY pour classifier des codes douaniers (HS Code), cliquez sur AI CLASSIFY à gauche de votre tableau de bord, ou sur Accéder, au milieu de votre tableau de bord (https://www.app.transiteo.io/#/hsCodeFinder/import) :

  • Vous pouvez effectuer votre recherche par deux types : manuel ou CSV :

Video Explainer

https://youtu.be/x6lUsj7KBg4

Par titre ou description

Par titre ou description

Prenons l'exemple d'une recherche à partir d’une description produit pour un code douanier (HS Code) allemand. Entrez aspirateur dans le champ PRODUIT. Ensuite, sélectionnez le PAYS DE DESTINATION : Allemagne. Il suffit de cliquer sur le bouton Rechercher pour classifier votre produit :

Vous obtenez ensuite le résultat de votre produit classifié en code douanier (HS Code) : 7322190000 pour l'Allemagne. Vous avez également les informations complémentaires suivantes : le status à l'importation, la version du code et la désignation du code

Vous pouvez calculer les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

Si le HSCode trouvé n'est pas le bon, cliquez sur Le HS Code n'est pas bon?

Une fenêtre s'ouvre et vous pouvez renseigner le HSCode que vous auriez mis à la place :

Classifier un produit HSCode (import) - BtoC

Classifier un produit HSCode (import) - BtoC

Si vous souhaitez obtenir le HSCode d'un produit BtoC, il suffit simplement d'entrer le nom de produit dans le champ PRODUIT, sélectionner le PAYS DE DESTINATION puis cliquer sur le bouton "RECHERCHER" pour classifier votre produit

Prenons l'exemple d'un Aspirateur à destination l'Allemagne

Vous obtenez ensuite le résultat de votre produit classifié en code douanier (HS Code) : 8508600000 pour l'Allemagne. Vous avez également les informations complémentaires suivantes : le status à l'importation, la version du code et la désignation du code

Vous avez la possibilité de copier le HSCode et/ou l'exporter en format .CSV

Vous pouvez calculer directement les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

Si le HSCode trouvé n'est pas le bon, c'est simple ! Cliquez sur Le HS Code n'est pas bon? :

Une nouvelle fenêtre apparaîtra et vous pouvez renseigner le HSCode que vous auriez mis à la place :

Classifier un produit HSCode (import) - BtoB

Classifier un produit HSCode (import) - BtoB

Si vous souhaitez obtenir le HSCode d'un produit BtoB, il suffit simplement d'entrer le nom de produit dans le champ PRODUIT, sélectionner le PAYS DE DESTINATION puis cliquer sur le bouton "RECHERCHER" pour classifier votre produit

Prenons l'exemple d'un Réfrigérateur à destination de la Belgique :

Vous obtenez ensuite le résultat de votre produit classifié en code douanier (HS Code) : 8418999099 pour la Belgique. Vous avez également les informations complémentaires suivantes : le status à l'importation, la version du code et la désignation du code

Vous avez la possibilité de copier le HSCode et/ou l'exporter en format .CSV

Vous pouvez calculer directement les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

Si le HSCode trouvé n'est pas le bon, c'est simple ! Cliquez sur Le HS Code n'est pas bon? :

Une nouvelle fenêtre apparaîtra et vous pouvez renseigner le HSCode que vous auriez mis à la place :

Transformer un HSCode en HSCode d'un autre pays

Transformer un HSCode en HSCode d'un autre pays

Si vous souhaitez transformer un code douanier en HSCode d'un autre pays, entrez simplement le HSCode et le pays d'origines, saisissez le pays de destination et appuyez sur Rechercher pour obtenir votre résultat

Vous obtenez ensuite le résultat de votre produit classifié en code douanier du pays de destination (HS Code) : 84189900 pour Hong Kong. Vous avez également les informations complémentaires suivantes : le status à l'importation, la version du code et la désignation du code

Vous avez la possibilité de copier le HSCode et/ou l'exporter en format .CSV

Vous pouvez calculer directement les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

Par code à barres

Par code à barres

Pour classifier un produit en HSCode à partir d'un code à barres, remplissez le champ PRODUIT avec un code à barres.

Prenons l'exemple suivant :

PRODUIT : BASKT-XYZ-BLN-41

PAYS DE DESTINATION : FRANCE

Cliquez ensuite sur le bouton Rechercher :

Obtenez votre HSCode pour la France : 640411000. Vous avez également les informations complémentaires suivantes : statut à l'importation, version du code, désignation du code et taux de CO2 :

Si le HSCode trouvé n'est pas le bon, cliquez sur Le HS Code n'est pas bon? :

Une fenêtre s'ouvre et vous pouvez renseigner le HSCode que vous auriez mis à la place :

Vous pouvez copier et/ou exporter le résultat en fichier CSV :

Vous pouvez calculer les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Par SKU

Par SKU

Pour classifier un produit en HSCode à partir d'un SKU, il faut au préalable associer un SKU à chacun de vos produits dans MON CATALOGUE :

Prenons l'exemple de ce rouge à lèvres. Le SKU de ce produit est 009-3-1 :

Dans AI CLASSIFY, dans le champ PRODUIT, entrez 009-3-1. Ensuite, choisissez un PAYS DE DESTINATION. Prenons ici la Chine comme destination :

Ensuite, cliquez sur le bouton Rechercher :

Vous obtenez le HSCode suivant : 3304100093 pour la Chine. Vous avez également les informations complémentaires suivantes : le status à l'importation, la version du code, la désignation du code, et le taux de CO2 :

Vous pouvez copier le HSCode et/ou l'exporter en format CSV :

Vous pouvez calculer les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

.MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Transformer un HSCode en HSCode d'un autre pays

Transformer un HSCode en HSCode d'un autre pays

Pour classifier un produit en HSCode à partir HSCode, remplissez le HSCODE D'ORIGINE, le PAYS D'ORIGINE et le PAYS DE DESTINATION :

Prenons comme exemple le HSCode d'origine suivant : 61091000. Il s'agit d'un t-shirt en coton.

Pays d'origine : Suisse

Pays de destination : France

Ensuite, cliquez sur le bouton Rechercher :

Vous obtenez votre HSCode : 6109100010 pour la France, ainsi que les informations complémentaire suivantes : statut à l'importation de votre produit, version de code, désignation du code, taux de CO2 :

Vous pouvez copier le HSCode et/ou l'exporter en format CSV :

Vous pouvez calculer les droits de douane et taxes liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

Exemple du CSV sous format d'un tableau :

codenamelangcountryhs_versionhs_codedesignationstatut
610910001061091000frFRAHS176109100010chapter_designation : Articles of apparel and clothing accessories, knitted or crocheted -- heading_designation : T-shirts, singlets and other vests, knitted or crocheted. -- subheading_designation : T-shirts, singlets and other vests of cotton, knitted or crocheted -- national_designation : T-shirts, singlets and other vests of cotton, knitted or crocheted : t-shirtsAutorisé à l'importation dans ce pays

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Classifier en masse vos produits grâce au fichier CSV

Classifier en masse vos produits grâce au fichier CSV

Pour la recherche par importation CSV, vous pouvez télécharger le modèle de fichier CSV en bas à gauche, puis le remplir :

Un exemple de comment remplir le fichier CSV vous ai donné pour une recherche d'HSCode à partir d'HSCode :

Si vous souhaitez faire une recherche à partir d'un titre ou d'une description produit, votre fichier CSV doit respecter le format suivant :

Déposez votre fichier CSV ou cliquez dans l'encadré gris pour ouvrir vos fichiers dans la zone dédiée. Notez que vous pouvez classifier un maximum de 100 produits par 100 produits :

Cliquez ensuite sur le bouton Rechercher :

Un fichier CSV contenant vos HSCode se télécharge automatiquement :

Vous recevrez vos HSCode sous ce format de réponse :

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Exporter le résultat d'une classification

Exporter le résultat d'une classification

Pour exporter le résultat de votre classification en HSCode, cliquez sur Exportez en .csv :

Un fichier contenant le résultat de votre recherche se télécharge automatiquement :

Exemple du résultat de cette classification en HSCode une fois exportée en fichier CSV :

Classifier un produit en code ONU

Classifier un produit en code ONU

Pour reconnaître les codes ONU des différentes marchandises, saisissez le type du produit et le pays de destination puis appuyer sur rechercher pour obtenir les résultats en une fraction de seconde

Vous obtenez ensuite le code ONU du produit en question : 1263 pour "peinture"

Vous avez la possibilité de copier le code ONU et/ou l'exporter en format .CSV

Calculer l'empreinte carbone d'un produit

Calculer l'empreinte carbone d'un produit

Avant de commencer votre calcul d'empreinte carbone, choisissez le type de recherche que vous souhaitez. Vous pouvez faire une recherche à partir d'un titre ou description, à partir d'un HSCode, d'un SKU ou alors à partir d'une catégorie.

Pour mesurer l'empreinte carbone d'un produit, précisez le type de produit, son pays de destination, son poids et unité puis appuyez sur “Rechercher” et apprenez plus sur vos émissions CO2

Vous obtenez ensuite le taux de rejet de CO2 pour votre produit : 720Kg pour "Télévision" à destination de "Danemark"

Vous avez la possibilité de copier le code ONU et/ou l'exporter en format .CSV

Customs Docs - en cours

Customs Docs - en cours

Quoter

Quoter

Avant de calculer les droits de douane et taxe de votre produit, notez qu’il est essentiel de connaître le code douanier (HS Code) de votre produit ou alors avoir rattaché votre produit à un SKU dans votre catalogue. Si vous ne connaissez pas le HS Code de votre produit, rendez-vous sur notre outil AI CLASSIFY afin de classifier votre produit en code douanier (https://www.app.transiteo.io/#/hsCodeFinder/import).

Pour calculer les droits de douanes et taxes de votre produit, cliquez sur QUOTER :

Video Explainer

https://youtu.be/EIK_4uF_0Ss

Calculer les droits et taxes d'une commande, d'un produit ou d'un colis

Calculer les droits et taxes d'une commande, d'un produit ou d'un colis

Pour effectuer votre calcul, commencez par choisir un PAYS D'EXPÉDITION et un PAYS DE DESTINATION :

Prenons l'exemples suivant :

PAYS D'EXPÉDITION : France

PAYS DE DESTINATION : l'Australie

Ensuite, pour votre recherche, vous avez deux possibilités.

1) Par type SKU : il faut remplir dans PRODUIT un SKU rattaché à un produit de votre catalogue :

2) Par HSCode : il faut remplir dans PRODUIT le HSCode de votre produit :

Remplissez ensuite le reste des informations qui vous sont demandées :

Notez que vous pouvez ajouter un ou des produits :

Vous arrivez ensuite sur la page concernant le transporteur :

1) Si vous ne connaissez pas votre transporteur, cliquez sur le bouton Transporteur connu pour retirer ce champ, et remplissez les informations demandées :

Notez qu'il faut choisir sur quoi s'applique les frais de transport : sur tout, sur le prix du produit, sur le prix d'envoi du produit :

2) Si vous connaissez votre transporteur, remplissez les champs demandés :

Ensuite, vous avez le choix en 4 types de transactions : CtoC, CtoB, BtoB et BtoC. Sélectionnez le type de transaction de votre choix et remplissez les informations demandées :

  • CtoC : ici, aucune information n'est à remplir :

  • CtoB : ici, il faut sélectionner l'activité professionnelle du destinataire :

  • BtoB : ici, il faut remplir le chiffre d'affaire de l'expéditeur dans le pays de destination et la devise, et sélectionner l'activité professionnelle du destinataire :

  • BtoC : ici, il faut renseigner le chiffre d'affaire de l'expéditeur dans le pays de destination et la devise :

Vous obtenez ainsi votre calcul de droits de douane et taxes. Vous avez le détail du calcul : une partie concernant le calcul pour les droits de douane et une partie pour le calcul des taxes (TVA, VAT, GST, IVA, etc). Vous avez également une information concernant le status du produit, c'est-à-dire s'il est autorisé, restreint ou interdit dans le pays de destination ainsi que le traité qui est appliqué entre le pays d'expedition et le pays de destination :

Vous pouvez exporter le résultat en cliquant sur le bouton EXPORTER EN .CSV :

Vous pouvez lancer une nouvelle recherche en cliquant sur le bouton NOUVELLE RECHERCHE :

BtoC

BtoC

Pour une rechercher BtoC, vous pouvez classifier un produit en HSCode à partir d'un HSCode ou d'un SKU.

Par HSCode

Par HSCode

Pour faire un calcul de droits de douane et de taxe à partir d'un HSCode pour une vente en BtoC, commencez par remplir le PAYS DE D'EXPORTATION et le PAYS DE DESTINATION, puis cliquez sur bouton Suivant :

Remplissez dans PRODUIT le HSCode de votre produit, le PRIX UNITAIRE HT, la DEVISE, la QUANTITÉ et le PAYS D'ORIGINE, puis cliquez sur le bouton Suivant :

Si vous ne connaissez pas votre transporteur, cliquez sur le bouton Transporteur connu. Si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article.

Ici, les frais de livraison sont différents par article et le transporteur est inconnu.

Ensuite, remplissez le TARIF D'EXPÉDITION, la DEVISE, le TYPE DE FRAIS, les FRAIS DE DOSSIER, la DEVISE, et sélectionnez sur quoi les frais de livraison s'appliquent : sur tout, sur le prix du produit, ou sur le prix d'envoi du produit, puis cliquez sur le bouton Suivant :

Si vous connaissez votre transporteur et si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article.

Ici, les frais de transports sont différents par article et le transporteur est connu.

Remplissez le TARIF D'EXPÉDITION, la DEVISE et le TRANSPORTEUR, puis cliquez sur le bouton Suivant :

Pour une vente en BtoC, renseignez le CHIFFRE D'AFFAIRE DE L'EXPÉDITEUR DANS LE PAYS DE DESTINATION, la DEVISE, puis cliquez sur le bouton Suivant :

Vous obtenez ainsi votre calcul de droits de douane et taxes. Vous avez le détail du calcul : une partie concernant le calcul pour les droits de douane et une partie pour le calcul des taxes (TVA, VAT, GST, IVA, etc). Vous avez également une information concernant le status du produit, c'est-à-dire s'il est autorisé, restreint ou interdit dans le pays de destination ainsi que le traité qui est appliqué entre le pays d'expedition et le pays de destination :

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Par SKU

Par SKU

Avant de pouvoir faire votre calcul de droits de douane et de taxe, assurez-vous que votre produit est rattaché à un SKU dans MON CATALOGUE :

Pour faire un calcul de droits de douane et de taxes à partir d'un SKU pour une vente en BtoC, commencez par remplir le PAYS DE D'EXPORTATION et le PAYS DE DESTINATION, puis cliquez sur bouton Suivant :

Remplissez dans PRODUIT le SKU rattaché à votre produit dans votre catalogue, puis le PRIX UNITAIRE HT, la DEVISE, la QUANTITÉ et le PAYS D'ORIGINE de votre produit, puis cliquez sur le bouton Suivant :

Si vous ne connaissez pas votre transporteur, cliquez sur le bouton Transporteur connu. Si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article. Ensuite, remplissez le TARIF D'EXPÉDITION, la DEVISE, le TYPE DE FRAIS, les FRAIS DE DOSSIER, la DEVISE, et sélectionnez sur quoi les frais de livraison s'appliquent : sur tout, sur le prix du produit, ou sur le prix d'envoi du produit, puis cliquez sur le bouton Suivant :

Si vous connaissez votre transporteur et si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article. Remplissez le TARIF D'EXPÉDITION, la DEVISE et le TRANSPORTEUR, puis cliquez sur le bouton Suivant :

Pour une vente en BtoC, renseignez le CHIFFRE D'AFFAIRE DE L'EXPÉDITEUR DANS LE PAYS DE DESTINATION, la DEVISE, puis cliquez sur le bouton Suivant :

Vous obtenez ainsi votre calcul de droits de douane et taxes. Vous avez le détail du calcul : une partie concernant le calcul pour les droits de douane et une partie pour le calcul des taxes (TVA, VAT, GST, IVA, etc). Vous avez également une information concernant le status du produit, c'est-à-dire s'il est autorisé, restreint ou interdit dans le pays de destination ainsi que le traité qui est appliqué entre le pays d'expedition et le pays de destination :

MESSAGES D'ERREURS

Sorry, we did not find the data you are trying to retrieve

Si vous recevez ce message, c'est que le SKU renseigné ne correspond à aucun produit de votre catalogue.

Solution :

Renseignez un SKU rattaché à un produit de votre catalogue.

Dans notre catalogue, le SKU rattaché à la télévision est le suivant : 1001-43-34

Il faut donc renseigner le même SKU si l'on souhaite faire un calcul de droits de douane et de taxe pour une télévision :

------------------------------

Solution :

------------------------------

BtoB

BtoB

Pour une rechercher BtoB, vous pouvez classifier un produit en HSCode à partir d'un HSCode ou d'un SKU.

Par HSCode

Par HSCode

Pour faire un calcul de droits de douane et de taxes à partir d'un HSCode pour une vente en BtoB, commencez par remplir le PAYS DE D'EXPORTATION et le PAYS DE DESTINATION, puis cliquez sur bouton Suivant :

Remplissez dans PRODUIT le HSCode de votre produit, le PRIX UNITAIRE HT, la DEVISE, la QUANTITÉ et le PAYS D'ORIGINE, puis cliquez sur le bouton Suivant :

Si vous ne connaissez pas votre transporteur, cliquez sur le bouton Transporteur connu. Si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article.

Si vous connaissez votre transporteur et si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article. Remplissez le TARIF D'EXPÉDITION, la DEVISE et le TRANSPORTEUR, puis cliquez sur le bouton Suivant :

Pour une vente en BtoB, renseignez le CHIFFRE D'AFFAIRE DE L'EXPÉDITEUR DANS LE PAYS DE DESTINATION, la DEVISE, l'ACTIVITÉ PROFESSIONNELLE DU DESTINATAIRE, puis cliquez sur le bouton Suivant :

Vous obtenez ainsi votre calcul de droits de douane et de taxes. Vous avez le détail du calcul : une partie concernant le calcul pour les droits de douane et une partie pour le calcul des taxes (TVA, VAT, GST, IVA, etc). Vous avez également une information concernant le status du produit, c'est-à-dire s'il est autorisé, restreint ou interdit dans le pays de destination ainsi que le traité qui est appliqué entre le pays d'expedition et le pays de destination :

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Par SKU

Par SKU

Avant de pouvoir faire votre calcul de droits de douane et de taxes, assurez-vous que votre produit soit rattaché à un SKU dans MON CATALOGUE :

Pour faire un calcul de droits de douane et de taxes à partir d'un SKU pour une vente en BtoB, commencez par remplir le PAYS DE D'EXPORTATION et le PAYS DE DESTINATION, puis cliquez sur bouton Suivant :

Remplissez dans PRODUIT le SKU rattaché à votre produit dans votre catalogue, puis le PRIX UNITAIRE HT, la DEVISE, la QUANTITÉ et le PAYS D'ORIGINE, puis cliquez sur le bouton Suivant :

Si vous ne connaissez pas votre transporteur, cliquez sur le bouton Transporteur connu. Si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article. Remplissez le TARIF D'EXPÉDITION, la DEVISE, le TYPE DE FRAIS, les FRAIS DE DOSSIER, la DEVISE, et sélectionnez sur quoi les frais de livraison s'appliquent : sur tout, sur le prix du produit, ou sur le prix d'envoi du produit, puis cliquez sur le bouton Suivant :

Si vous connaissez votre transporteur et si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article. Remplissez le TARIF D'EXPÉDITION, la DEVISE et le TRANSPORTEUR, puis cliquez sur le bouton Suivant :

Pour une vente en BtoB, renseignez le CHIFFRE D'AFFAIRE DE L'EXPÉDITEUR DANS LE PAYS DE DESTINATION, la DEVISE, l'ACTIVITÉ PROFESSIONNELLE DU DESTINATAIRE, puis cliquez sur le bouton Suivant :

Vous obtenez ainsi votre calcul de droits de douane et taxes. Vous avez le détail du calcul : une partie concernant le calcul pour les droits de douane et une partie pour le calcul des taxes (TVA, VAT, GST, IVA, etc). Vous avez également une information concernant le status du produit, c'est-à-dire s'il est autorisé, restreint ou interdit dans le pays de destination ainsi que le traité qui est appliqué entre le pays d'expedition et le pays de destination :

MESSAGES D'ERREURS

Sorry, we did not find the data you are trying to retrieve

Si vous recevez ce message, c'est que le SKU renseigné ne correspond à aucun produit de votre catalogue.

Solution :

Renseignez un SKU rattaché à un produit de votre catalogue.

Dans notre catalogue, le SKU rattaché à la télévision est le suivant : 1001-43-34

Il faut donc renseigner le même SKU si l'on souhaite faire un calcul de droits de douane et de taxe pour une télévision :

------------------------------

Solution :

------------------------------

Exporter le résultat

Exporter le résultat

Vous pouvez exporter le résultat en cliquant sur le bouton EXPORTER EN .CSV :

Le fichier CSV se télécharge automatiquement :

Exemple du résultat de ce calcul de droit de douane et de taxes une fois exporté en fichier CSV :

langfrom_countryfrom_districtto_countryto_districtproducts_duty_labelproducts_duty_percentageproducts_duty_product_taxes_amountproducts_duty_shipping_taxes_amountproducts_vat_labelproducts_vat_percentageproducts_vat_product_taxes_amountproducts_vat_shipping_taxes_amountproducts_special_taxes_labelproducts_special_taxes_percentageproducts_special_taxes_product_taxes_amountproducts_special_taxes_shipping_taxes_amountproducts_duty_fees_amountshipment_typeglobal_ship_pricecurrency_global_ship_pricesender_prosender_revenue_country_annualsender_currency_revenue_country_annualreceiver_proreceiver_activity_idtransport_typetransport_idproducts_valueproducts_transport_typeproducts_transport_idproducts_weightproducts_weight_unitproducts_quantityproducts_unit_priceproducts_currency_unit_priceproducts_unit_ship_priceproducts_currency_unit_ship_priceproducts_unitproducts_unit_typesproducts_origin_countryshipping_global_duty_labelshipping_global_duty_amountshipping_global_vat_labelshipping_global_vat_amountshipping_global_special_taxes_labelshipping_global_special_taxes_amountduty_fees_global_amountglobal_amount
frFRAAUSduty5458.2GST109016.40000ARTICLEtrue890000EURfalse852872001kg1900EUR164EUR
C'est la langue dans laquelle vous avez effectué votre calcul de droits de douane et de taxesC'est le pays d'expédition C'est le district d'expédition (obligatoire pour USA et CAN)C'est le pays de destinationC'est le district de destination (obligatoire pour USA et CAN)Pourcentage de droits de douaneMontant de droits de douane pour le/les produits

Tax Manager

Tax Manager

Détail du tableau

Détail du tableau

Champs du tableau et ses explications :

PAYSSTATUTCHIFFRE D'AFFAIRE 2020CHIFFRE D'AFFAIRE 2021CHIFFRE D'AFFAIRE 2022DEVISE C.AN°FISCAL - TAXESN°EORIPAYS D'ENREGISTREMENTRÈGLE UK
Vous trouvez ici le nom du pays dans votre langue ainsi que le code iso 3C'est le statut du paysC'est votre chiffe d'affaire de l'année 2022C'est votre chiffe d'affaire de l'année 2022C'est votre chiffe d'affaire de l'année 2022C'est la devise en format ISO Alpha 3C'est votre numéro fiscal de référence, composé de 13 chiffresC'est votre numéro EORI avec lequel vous êtes enregistré C'est le pays dans lequel votre société est enregistrée S'il y a une règle spécifique au Royaume-Uni
Argentine (ARG), Inde (IND), etc. Actif, InactifXXXXXXXXXXXXXXXXXXXXXEUR, USD, CADXX XX XXX XXX XXXFR + SIRETFRA, GBR, CHNOui, Non


Ajouter un pays

Ajouter un pays

Pour ajouter un pays, cliquez sur Ajouter un pays, en haut de votre liste de pays :

Les pays ne faisant pas partie de votre liste de pays vous seront proposés. Cliquez sur les pays que vous souhaitez ajouter, ils seront automatiquement ajouter à votre liste de pays :

Importer des infos pays

Importer des infos pays

Téléchargez le modèle de fichier CSV

Vue du CSV sous forme de tableau avec noms et correspondances des champs :

iso3_countrystatutcurrencytax_idannual_revenue_2020annual_revenue_2021annual_revenue_2022eoriuk_ruleorigin_tax
PaysStatutDeviseNuméro fiscal de référence Chiffre d'affaire en 2020Chiffre d'affaire en 2021Chiffre d'affaire en 2022Numéro EORIRègle UKPays d'enregistrement
C'est le code ISO 2 ou 3 du paysC'est le statut du pays C'est la devise du pays C'est votre numéro d'identification fiscal C'est votre chiffre d'affaire en 2020C'est votre chiffre d'affaire en 2021C'est votre chiffre d'affaire en 2022C'est votre numéro EORIS'il y a une règle spécifique au Royaume-UniC'est le pays d'enregistrement de votre société
BEL, CHN, FRAtrue, falseEUR, CAD, JPYXX XX XXX XXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXFR + SIRETtrue, falseFRA, BEL, ARE, etc

Les colonnes obligatoires à remplir :

  • iso3_country
  • statut
  • currency
  • annual_revenue_2020
  • annual_revenue_2021
  • annual_revenue_2022
  • origin_tax

Les colonnes non obligatoires à remplir :

  • tax_id
  • eori
  • uk_rule

FORMAT DES DONNÉES ET MESSAGES D'ERREURS

ChampsFormatExempleMessage d'erreur
iso3_countryCode ISO Alpha 3FRA, CAN, USALine XXXXXX : iso3_country doit être un pays au format ISO3
statutChaine de caractère libretrue, falseLine XXXXXX : statut doit être true ou false
currencyCode ISO Alpha 3EUR, CAD, USDLine XXXXXX : currency doit être une devise au format ISO 4217
annual_revenue_2020Nombre décimal150200, 378875.68, 1230089Line XXXXXX : annual_revenue_2020 doit être un nombre
annual_revenue_2021Nombre décimal150200, 378875.68, 1230089Line XXXXXX : annual_revenue_2021 doit être un nombre
annual_revenue_2022Nombre décimal150200, 378875.68, 1230089Line XXXXXX : annual_revenue_2022 doit être un nombre
origin_taxCode ISO Alpha 3FRA, CAN, USAINCORRECT_JSON : Incorrect Json Request. Details : origin_tax : origin_tax should be ISO3

Modifier les infos d'un pays

Modifier les infos d'un pays

Pour modifier les informations d'un pays, cliquez sur l'icône de modification à l'extrémité droite de la ligne du pays concerné :

Une fenêtre s'ouvre avec l'ensemble des informations, que vous pouvez modifier. Les champs signalés d'un astérisque rouge sont obligatoires, sinon vous ne pourrez pas valider vos informations :

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquer sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Remplissez les champs signalés par un astérisque rouge.

------------------------------

Solution :

------------------------------

Exporter ses infos pays

Exporter ses infos pays

Pour exporter ses informations pays, sélectionnez parmi votre liste de pays les pays de votre choix :

Cliquez sur bouton Exporter (CSV) :

Veillez à ce que votre fichier CSV se soit bien téléchargé :

Format du fichier CSV d'export :

iso3_countrystatutcurrencytax_iduk_ruleseoriorigin_taxannual_revenue_2020annual_revenue_2021annual_revenue_2022
C'est le format ISO 3 du paysC'est le statut du pays (actif ou non)C'est la deviseC'est votre numéro fiscal de référence S'il y a une règle spécifique du C'est votre numéro EORIC'est le pays d'enregistrement de votre société C'est votre chiffre d'affaire en 2020C'est votre chiffre d'affaire en 2021C'est votre chiffre d'affaire en 2022
CHE, FRA, USA, ...true, false EUR, CAN, USDXX XX XXX XXX XXXfalse, trueFR + SIRETCHE, FRA, USA, ...XXXXXXXXXXXXXXXXX

Figer une colonne

Figer une colonne

Vous pouvez figer des volets pour verrouiller des colonnes spécifiques dans votre tableau. Il suffit d'appuyer sur l'icône de punaise puis choisir la colonne que vous souhaitez épingler avant de cliquer sur "valider"

Dans ce cas, vous pourrez parcourir le tableau tout en gardant, visible à l'écran, la colonne portant les noms des produits :

Welcome

Welcome

  • Vous pouvez ici enregistrer le type de produit par défaut de votre catalogue produit.

La liste des différentes catégories : Animalerie, Auto & Moto, Bagages, Beauté et Parfum, Bijoux, Bricolage, Bébé & Puériculture, CD & Vinyles, Chaussures & Sacs, Commerce, Industrie & Science, Cuisine & Maison, DVD & Blu-ray, Fournitures de bureau, Gros électroménager, High-Tech, Hygiène & Santé, Informatique, Instruments de musique & Sono, Jardin, Jeux & Jouets, Jeux vidéos, Livres, Luminaires & Eclairage, Montres, Produits Handmade, Sports & Loisir, Vêtements, Bio, Viandes & Poissons, Fruits & Légumes frais, Pains & Pâtisseries, Produits Frais, Surgelés, Epicerie salée, Epicerie sucrée, Boissons, Alimentation bébé

Modifier ses infos produit par défaut

Modifier ses infos produit par défaut

Pour modifier vos informations produits par défaut, cliquez sur WELCOME (https://www.app.transiteo.io/#/settings-welcome) :

Vous pouvez renseigner vos informations par défaut, puis cliquez sur le bouton Enregistrer pour sauvegarder les paramètres que vous avez renseignées :

Les différents champs sont les suivants :

  • CATÉGORIES

La liste des différentes catégories : Animalerie, Auto & Moto, Bagages, Beauté et Parfum, Bijoux, Bricolage, Bébé & Puériculture, CD & Vinyles, Chaussures & Sacs, Commerce, Industrie & Science, Cuisine & Maison, DVD & Blu-ray, Fournitures de bureau, Gros électroménager, High-Tech, Hygiène & Santé, Informatique, Instruments de musique & Sono, Jardin, Jeux & Jouets, Jeux vidéos, Livres, Luminaires & Eclairage, Montres, Produits Handmade, Sports & Loisir, Vêtements, Bio, Viandes & Poissons, Fruits & Légumes frais, Pains & Pâtisseries, Produits Frais, Surgelés, Epicerie salée, Epicerie sucrée, Boissons, Alimentation bébé

  • DESCRIPTION

C'est la description de votre produit.

  • HSCODE PAR DÉFAUT

Si vous ne connaissez pas le HSCode de votre produit, rendez-vous sur AI CLASSIFY pour classifier votre produit en en HSCode.

  • PAYS D'ORIGINE

C'est le pays où vos produits sont fabriqués / transformés en dernier.

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquer sur le bouton Enregistrer, c'est que vous n'avez pas renseigner l'ensemble des informations demandées.

Solution :

Veillez à avoir sélectionner et renseigner l'ensemble des informations.

------------------------------

Solution :

------------------------------

Récupérer sa clef API Widget

Récupérer sa clef API Widget

Pour récupérer votre clef API Widget, rendez-vous dans la partie Sécurité, en bas de vos Paramètres Transiteo Welcome :

Cliquez sur Copier pour copier votre clef :

MENU - PARAMETERS

Paramètres

Paramètres

  • Une fois arrivé.e sur la page des paramètres, vous retrouvez l’ensemble des informations vous concernant et vous pouvez modifier ces informations. Pour enregistrer, descendez en bas de page et cliquez sur le bouton Enregistrer pour être sûr que toutes les modifications que vous avez effectuées soient bien enregistrées :

Plan

Plan

Utilisation par API

Pour avoir accès aux informations relatives au plan que vous avez, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous pouvez voir les diverses informations concernant le plan dont vous bénéficiez :

  • Type de plan
  • Type de paiement
  • Professionel
  • Méthode d'intégration

Utilisation pour E-Commerce

Pour avoir accès aux informations relatives au plan que vous avez, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous pouvez voir les diverses informations concernant le plan dont vous bénéficiez :

  • Type de plan
  • Type de paiement
  • Professionel
  • Méthode d'intégration

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Information utilisateur

Information utilisateur

Utilisation par API

Pour accéder à vos informations utilisateur, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouvez ici l'ensemble de vos informations utilisateurs :

  • Civilité
  • Prénom
  • Nom
  • Signature
  • Mail
  • Téléphone

Utilisation pour E-Commerce

Pour accéder à vos informations utilisateur, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouvez ici l'ensemble de vos informations utilisateurs :

  • Civilité
  • Prénom
  • Nom
  • Signature
  • Mail
  • Téléphone

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Boutique (CMS)

Boutique (CMS)

Pour accéder à vos informations boutique, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouverez ici l'ensemble de vos informations sur votre boutique en ligne :

  • URL
  • Nom de la marque
  • Logo du vendeur
  • Info service client
  • Termes de vente
  • Autre infos vendeur

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Expéditions (CMS)

Expéditions (CMS)

Pour accéder à vos informations d'expédition, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouverez ici l'ensemble de vos informations sur vos expéditions :

  • Raison sociale
  • SIRET
  • Adresse
  • Code postal
  • Ville
  • État / Région
  • Pays de départ
  • Aéroport de chargement
  • Incoterm
  • Conditions de retour

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Business (API/WEB APP)

Business (API/WEB APP)

Vous trouverez ici l'ensemble des informations de votre entreprise :

  • Raison sociale
  • SIRET
  • URL
  • Nom de la marque
  • Logo du vendeur
  • Adresse
  • Code postal
  • Ville
  • État / Région
  • Pays de départ
  • Info service client
  • Termes de vente
  • Autre infos vendeur
  • Aéroport de chargement
  • Incoterm
  • Conditions de retour

Produits

Produits

Pour accéder à vos informations produits, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouverez ici l'ensemble de vos informations sur vos produits :

  • Catégories : C'est la catégorie de vos produits
  • Description : C'est la description de votre produits
  • HSCode par défaut : C'est le code douanier par défaut qui sera appliqué pour tous vos produits
  • Pays d'origine : C'est le pays où vos produits sont fabriqués / transformés à la dernière étape

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Transporteurs (CMS)

Transporteurs (CMS)

Pour accéder à vos informations transporteurs, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouverez ici l'ensemble de vos informations sur vos transporteurs (FedEx, DHL, UPS, etc) :

Factures

Factures

Cliquez ici pour être redirigé.e vers les explications concernant la page Mes Factures.

Crédits

Crédits

Essai gratuit

Pour pouvoir recharger ses crédits, il faut d'abord passer sur un compte premium en adhérant à l'un des plans. Vous pouvez consulter nos formules payantes en cliquant sur Devenir Premium dans le bloc en bas à gauche de votre menu :

Vous serez redirigé.e vers nos différentes formules. Si vous voulez en savoir plus sur chacune de nos formules, cliquez ici.

Si vous souhaitez par exemple choisir la formule API, veillez à la sélectionner en cliquant sur le bouton Choisir pour valider votre demande. Ensuite, dans le bloc Consommation, sélectionnez le nombre de crédit dont vous avez besoin par services et cliquez sur le bouton Choisir pour valider votre demande :

Vous pouvez convertir les prix dans plusieurs devises :

Cochez la case sous les différents blocs des formules pour accepter nos conditions générales de vente :

Ensuite, cliquez sur le bouton Payer :

Vous êtes redirigé.e vers notre portail de paiement sécurisé, avec le détail des crédits que vous souhaitez acheter :

Utilisation par API

Pour recharger vos crédit, cliquez sur bouton Recharger mes crédits :

Vous serez redirigé.e vers la page de nos différentes formules. Dans le bloc Consommation, à l'extrémité droite, vous pouvez ajuster le curseur sur le nombre de requêtes dont vous avez besoin puis cliquez sur le bouton Choisir :

Les services disponibles sont les suivants :

  • Duty & Taxes Calculation API
  • Rates Date API - Sales Taxes
  • Local Taxes Calculation API
  • Rates Data API - Local Taxes
  • Rates Data API - Duties
  • Rates Data API - Special Taxes
  • HSCode finder API

Pour changer de devise, cliquez sur le champ pour pouvoir modifier la devise :

Cochez la case sous les différents blocs des formules pour accepter nos conditions générales de vente :

Ensuite, cliquez sur le bouton Payer :

Vous êtes redirigé.e vers notre portail de paiement sécurisé, avec le détail des crédits que vous souhaitez acheter :

Utilisation pour E-Commerce

Pour recharger vos crédit, cliquez sur bouton Recharger mes crédits :

Vous serez redirigé.e vers la page de nos différentes formules. Dans le bloc Consommation, à l'extrémité droite, vous pouvez ajuster le curseur sur le nombre de requêtes dont vous avez besoin puis cliquez sur le bouton Choisir :

Le service disponible est le suivant :

Product > HSCode

Pour changer de devise, cliquez sur le champ pour pouvoir modifier la devise :

Cochez la case sous les différents blocs des formules pour accepter nos conditions générales de vente :

Ensuite, cliquez sur le bouton Payer :

Vous êtes redirigé.e vers notre portail de paiement sécurisé, avec le détail des crédits que vous souhaitez acheter :

Surcharge de calcul

Surcharge de calcul

Sécurité

Sécurité

Essai gratuit

En version freemium, vous n'avez pas accès aux identifiants pour se connecter aux modules CMS ou pour utiliser les webs services par APIs. Vous devez choisir une formule payante pour avoir accès à ces informations. Cliquez sur Devenir Premium dans le bloc Choisissez votre formule Premium :

Utilisation par API

Pour accéder à vos identifiants pour utiliser les web services par APIs, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Rendez-vous en bas des paramètres pour accéder aux paramètres de Sécurité :

Les identifiants dont vous disposez sont les suivants :

  • client_id
  • refresh_token
  • id_token

Utilisation pour E-Commerce

Pour accéder à vos identifiants pour connecter vos modules CMS, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Rendez-vous en bas des paramètres pour accéder aux paramètres de Sécurité :

Les identifiants dont vous disposez sont les suivants :

  • client_id
  • refresh_token
  • id_token
  • Widget API Key

Mon Profil

Mon Profil

Lorsque vous vous rendez sur Mon profil, vous êtes automatiquement redirigé.e vers Paramètres.

Mon Historique

Mon Historique

Pour consulter votre historique, cliquer sur Mon compte > Mon historique (https://www.app.transiteo.io/#/history) :

Vous pouvez voir l'ensemble de vos consommations de la journée :

Détail du tableau

Détail du tableau

Pour voir en détail les requêtes que vous avez effectuées, cliquez sur le guillemet à l'extrémité gauche de votre requête :

La requête en détail s'ouvre et vous pouvez visualisez la recherche et la réponse en entier :

Vous avez le détail suivant :

Request BodyResponse Body
{
"product": {
"identification": {
"type": "TEXT",
"value": "Kit blancheur avec dentifrice"
}
},
"to_country": "FRA",
"lang": "fr"
}
{
"result": {
"hs_code": "33069000",
"hs_version": "HS17",
"un_code": [],
"co2_product_kg": 0.85, "designation":
"designation : Essential oils and resinoids; perfumery, cosmetic or toilet preparations -- heading_designation : Preparations for oral or dental hygiene, including denture fixative pastes and powders; yarn used to clean between the teeth (dental floss), in individual retail packages. -- subheading_designation : Preparations for oral or dental hygiene, incl. denture fixative pastes and powders (excl. dentifrices and yarn used to clean between the teeth dental floss")" -- national_designation : Preparations for oral or dental hygiene, incl. denture fixative pastes and powders (excl. dentifrices and yarn used to clean between the teeth "dental floss")",
"splitted_designation": {
"chapter_designation": "Essential oils and resinoids; perfumery, cosmetic or toilet
preparations",
"heading_designation": "Preparations for oral or dental hygiene, including denture fixative pastes and powders; yarn used to clean between the teeth (dental floss), in individual retail packages.",
"subheading_designation": "Preparations for oral or dental hygiene, incl. denture fixative pastes and powders (excl. dentifrices and yarn used to clean between the teeth dental floss")"",
"national_designation": "Preparations for oral or dental hygiene, incl. denture fixative pastes and powders (excl. dentifrices and yarn used to clean between the teeth "dental floss")"
}
}, "timestamp": 1645006708619
}

Exporter votre historique

Exporter votre historique

Pour exporter votre historique de recherche, cliquez sur le bouton Exporter en .csv :

Un fichier se télécharge automatiquement avec l'ensemble de votre historique de requêtes de la journée :

Format du fichier CSV d'historique de recherche :

requestEndpointtimestamprequest_productrequest_to_countryrequest_hsCodeFinderSearchrequest_langnb_productsresponse_resultresponse_timestamprequest_from_countryrequest_to_districtrequest_productsrequest_shipment_typerequest_senderrequest_receiverresponse_productsresponse_shipping_globalresponse_packaging_globalresponse_insurance_globalresponse_duty_fees_globalresponse_incotermresponse_global
/v1/taxsrv/hscodefinder1644922812176{"identification":{"type":"TEXT","value":"table en bois"}}USAfr0{"hs_code":"94036080","hs_version":"HS17","un_code":[],"co2_product_kg":8,"designation":"chapter_designation : Furniture; bedding, mattresses, mattress supports, cushions and similar stuffed furnishings; lamps and lighting fittings, not elsewhere specified or included; illuminated signs, illuminated name- plates and the like; prefabricated buildings -- heading_designation : Other furniture and parts thereof. -- subheading_designation : Wooden furniture (excl. for offices, kitchens and bedrooms, and seats) -- national_designation : Furniture (o/than seats & o/than of 9402) of wooden (o/than bentwood) nesoi","product_statut":"Restreint à l'importation dans ce pays","splitted_designation":{"chapter_designation":"Furniture; bedding, mattresses, mattress supports, cushions and similar stuffed furnishings; lamps and lighting fittings, not elsewhere specified or included; illuminated signs, illuminated name- plates and the like; prefabricated buildings","heading_designation":"Other furniture and parts thereof.","subheading_designation":"Wooden furniture (excl. for offices, kitchens and bedrooms, and seats)","national_designation":"Furniture (o/than seats & o/than of 9402) of wooden (o/than bentwood) nesoi"}}1644922812176
/v1/taxsrv/hscodefinder1644920974715{"identification":{"value":"t-shirt en coton","type":"TEXT"}}GBRTEXTUELfr0{"hs_code":"6109100000","hs_version":"HS17","un_code":[],"co2_product_kg":75,"designation":"chapter_designation : Articles of apparel and clothing accessories, knitted or crocheted -- heading_designation : T-shirts, singlets and other vests, knitted or crocheted. -- subheading_designation : T-shirts, singlets and other vests of cotton, knitted or crocheted -- national_designation : T-shirts, singlets and other vests of cotton, knitted or crocheted","product_statut":"Restreint à l'importation dans ce pays","splitted_designation":{"chapter_designation":"Articles of apparel and clothing accessories, knitted or crocheted","heading_designation":"T-shirts, singlets and other vests, knitted or crocheted.","subheading_designation":"T-shirts, singlets and other vests of cotton, knitted or crocheted","national_designation":"T-shirts, singlets and other vests of cotton, knitted or crocheted"}}1644920974715
/v1/taxsrv/hscodefinder1644919917453{"identification":{"value":"aspirateur","type":"TEXT"}}CHNTEXTUELfr0{"hs_code":"8508190000","hs_version":"HS17","un_code":[],"co2_product_kg":6,"designation":"chapter_designation : Electrical machinery and equipment and parts thereof; sound recorders and reproducers, television image and sound recorders and reproducers, and parts and accessories of such articles -- heading_designation : Vacuum cleaners. -- subheading_designation : Vacuum cleaners, incl. dry cleaners and wet vacuum cleaners, with self-contained electric motor ( excl. of a power <= 1?500?w and having a dust bag or other receptacle capacity <= 20?l) -- national_designation : Vacuum cleaners: with self-contained electric-motor: other vacuum cleaners with self-contained electric motor","product_statut":"Prohibé à l'importation dans ce pays","splitted_designation":{"chapter_designation":"Electrical machinery and equipment and parts thereof; sound recorders and reproducers, television image and sound recorders and reproducers, and parts and accessories of such articles","heading_designation":"Vacuum cleaners.","subheading_designation":"Vacuum cleaners, incl. dry cleaners and wet vacuum cleaners, with self-contained electric motor ( excl. of a power <= 1?500?w and having a dust bag or other receptacle capacity <= 20?l)","national_designation":"Vacuum cleaners: with self-contained electric-motor: other vacuum cleaners with self-contained electric motor"}}1644919917453
/v1/taxsrv/dutyCalculation1644844382422BELfr11644844382422CHN[{"identification":{"type":"HSCODE","value":"8471705000"},"weight":1,"weight_unit":"kg","quantity":10,"unit_price":200,"currency_unit_price":"EUR","unit_ship_price":100,"currency_unit_ship_price":"EUR","transport":{"type":"CARRIER","id":"71"},"unit":null,"origin_country":"CHN"}]ARTICLE{"pro":true,"revenue_country_annual":50000000,"currency_revenue_country_annual":"EUR"}{"pro":true,"activity_id":"4741Z"}[{"identification":{"type":"HSCODE","value":"8471705000"},"product_statut":"Prohibé à l'importation dans ce pays","amount_exclusive":3000,"amount_inclusive_vat":3630,"amount_duty_and_tax":630.5,"amount_ecoTax":0.5,"amount_total":3630.5,"co2":4480.7,"percentage_duty_and_tax":21.02,"duty":{"label":"duty","percentage":0,"product_taxes_amount":0,"shipping_taxes_amount":0,"packaging_taxes_amount":0,"insurance_taxes_amount":0,"message":null,"vat_product_taxes_amount":0,"vat_shipping_taxes_amount":0,"vat_packaging_taxes_amount":0,"vat_insurance_taxes_amount":0,"vat_taxes_amount":0,"agreement":"MFN duties (Applied)"},"duty_fees":null,"special_taxes":[],"vat":[{"label":"VAT","percentage":21,"product_taxes_amount":420,"shipping_taxes_amount":210,"packaging_taxes_amount":0,"insurance_taxes_amount":0,"message":null}]}]{"vat":null,"duty":null,"special_taxes":null}{"vat":null,"duty":null,"special_taxes":null}{"vat":null,"duty":null,"special_taxes":null}CIF{"amount":630.5,"amount_exclusive":3000,"amount_inclusive_vat":3630,"amount_total":3630.5,"amount_duty_and_tax":630.5,"percentage_duty_and_tax":21.02,"amount_ecoTax":0.5,"co2":4480.7}
/v1/taxsrv/dutyCalculation1644841167347AUSfr11644841167347FRA[{"identification":{"type":"HSCODE","value":"85287200"},"weight":1,"weight_unit":"kg","quantity":1,"unit_price":900,"currency_unit_price":"EUR","unit_ship_price":164,"currency_unit_ship_price":"EUR","transport":{"type":"CARRIER","id":"72"},"unit":null,"origin_country":"FRA"}]ARTICLE{"pro":true,"revenue_country_annual":890000,"currency_revenue_country_annual":"EUR"}{"pro":true,"activity_id":"4742Z"}[{"identification":{"type":"HSCODE","value":"85287200"},"product_statut":"Restreint à l'importation dans ce pays","amount_exclusive":1064,"amount_inclusive_vat":1175.72,"amount_duty_and_tax":164.93,"amount_ecoTax":0,"amount_total":1228.92,"percentage_duty_and_tax":15.51,"duty":{"label":"duty","percentage":5,"product_taxes_amount":45,"shipping_taxes_amount":8.2,"packaging_taxes_amount":0,"insurance_taxes_amount":0,"message":null,"vat_product_taxes_amount":4.5,"vat_shipping_taxes_amount":0.82,"vat_packaging_taxes_amount":0,"vat_insurance_taxes_amount":0,"vat_taxes_amount":4.5,"agreement":"MFN duties (Applied)"},"duty_fees":null,"special_taxes":[],"vat":[{"label":"GST","percentage":10,"product_taxes_amount":90,"shipping_taxes_amount":16.4,"packaging_taxes_amount":0,"insurance_taxes_amount":0,"message":null}]}]{"vat":null,"duty":null,"special_taxes":null}{"vat":null,"duty":null,"special_taxes":null}{"vat":null,"duty":null,"special_taxes":null}CIF{"amount":164.92,"amount_exclusive":1064,"amount_inclusive_vat":1175.72,"amount_total":1228.92,"amount_duty_and_tax":164.93,"percentage_duty_and_tax":15.51,"amount_ecoTax":0}

Support

Support

Pour obtenir de l'aide, vous avez deux possibilités :

1) Cliquez sur la bulle en bas à droite de votre écran, pour ouvrir le chat en direct et être mis en relation avec notre équipe :

2) Cliquez sur Continuer dans le bloc Besoin d’aide ? en bas à droite de votre tableau de bord :

Vous serez redirigé.e vers notre guide d'utilisation de l'application :

Documentation

Documentation

Utilisation par API

Pour accéder à la documentation API, vous avez deux possibilités.

1) Cliquez sur API DOCUMENTATION en bas à gauche de votre menu (https://transiteo.gitbook.io/transiteo/) :

Vous êtes redirigé.e vers notre documentation API (https://transiteo.gitbook.io/transiteo/) :

2) Cliquez sur le menu Mon compte > Documentation :

Vous êtes redirigé.e vers notre documentation API (https://transiteo.gitbook.io/transiteo/) :

Formule E-Commerce

Pour accéder à la documentation vous deux options.

1) Cliquez sur PLUGIN à gauche de votre menu :

2) Cliquez sur Mon Compte > Documentation :

Se déconnecter

Se déconnecter

Pour vous déconnecter de l’application transiteo, vous avez deux possibilités.

1) Cliquez en bas à gauche de votre menu, sur Se déconnecter :

2) Cliquez sur Mon compte > Se déconnecter :

Factures

Factures

Essai gratuit

Pour consulter vos factures, cliquez sur Mon compte > Facturation (https://www.app.transiteo.io/#/subscription) :

Vous disposez des informations suivantes :

Utilisation par API

Pour consulter vos factures, cliquez sur Mon compte > Facturation (https://www.app.transiteo.io/#/subscription) :

Vous disposez des informations suivantes :

Utilisation pour E-Commerce

Pour consulter vos factures, cliquez sur Mon compte > Facturation (https://www.app.transiteo.io/#/subscription) :

Vous disposez des informations suivantes :

Formule actuelle

Formule actuelle

Essai gratuit

La formule dont vous bénéficiez est inscrite en violet, à la suite de Votre formule actuelle est :

Utilisation par API

La formule dont vous bénéficiez est inscrite en violet, à la suite de Votre formule actuelle est :

Utilisation pour E-Commerce

La formule dont vous bénéficiez est inscrite en violet, à la suite de Votre formule actuelle est :

Factures

Factures

Essai gratuit

Vous avez ici un visuel de vos factures : leur statut et la possibilité de les télécharger en format PDF :

Utilisation par API

Vous avez ici un visuel de vos factures : leur statut et la possibilité de les télécharger en format PDF :

Utilisation pour E-Commerce

Vous avez ici un visuel de vos factures : leur statut et la possibilité de les télécharger en format PDF :

Changer de formule

Changer de formule

Essai gratuit

Pour changer de formule, cliquez sur le bouton Changer de formule :

Vous êtes redirigé.e vers la page Ma Formule :

Vous avez 3 types de formules :

  • Formule E-commerce
  • Formule API
  • Formule Application Web

Vous avez également le bloc Consommation pour acheter des crédits pour les services que vous souhaitez.

Pour en savoir plus sur nos formules, cliquez ici.

Utilisation par API

Pour changer de formule, cliquez sur le bouton Changer de formule :

Vous êtes redirigé.e vers la page Ma Formule :

Vous avez 3 types de formules :

  • Formule E-commerce
  • Formule API
  • Formule Application Web

Vous avez également le bloc Consommation pour acheter des crédits pour les services que vous souhaitez.

Pour en savoir plus sur nos formules, cliquez ici.

Utilisation pour E-Commerce

Pour changer de formule, cliquez sur le bouton Changer de formule :

Vous êtes redirigé.e vers la page Ma Formule :

Vous avez 3 types de formules :

  • Formule E-commerce
  • Formule API
  • Formule Application Web

Vous avez également le bloc Consommation pour acheter des crédits pour les services que vous souhaitez.

Pour en savoir plus sur nos formules, cliquez ici.

Web Application Guide (EN)

Introduction

Introduction

Welcome sur le guide de l'application web transiteo. Découvrez comment fonctionne chacun de nos services grâce à ce guide explicatif et illustré.

ACCOUNT

Create an account

Create an account

  • Vous allez ensuite recevoir un email, il faudra cliquer sur le bouton Valider mon compte :

  • Lors de votre première connexion, vous allez ensuite être redirigé.e vers un tutoriel de paramétrage de votre compte. Cliquez sur le bouton Démarrer :

PARAMÈTRES DE COMPTE

RAISON SOCIALE

Indiquez le nom de votre entreprise

Exemple : Ma Société

URL DE VOTRE BOUTIQUE

Indiquez l'adresse url de votre boutique en ligne

Exemple : http://www.monsite.com ou https://www.monsite.com

VOTRE MÉTHODE D'INTÉGRATION

Choisissez dans la liste déroulante

Choix : Plateforme SAAS / API / CMS - Prestashop 1.7.X / CMS Magento 2.3.X / CMS Woocommerce / CMS Shopify / CMS BigCommerce

PARAMÈTRES D'EXPÉDITION

PAYS

Choisissez dans la liste déroulante

Choix : Cliquez ici pour voir les pays disponibles

ADRESSE DE DÉPART

Indiquez l'adresse postale du point de départ de vos envois

Exemple : 34 Rue principale

CODE POSTAL

Saisissez le code postal de la ville de départ de vos expéditions

Exemple : 75001

VILLE

Indiquez le nom de la ville de départ

Exemple : Paris

ÉTAT / RÉGION

Choisissez dans la liste déroulante

Choix : Les états, régions, districts changent en fonction du pays.

PARAMÈTRES DE DESTINATION

Sélectionnez les pays ou continents entiers dans lesquels vous expédiez.

PARAMÈTRES TAX MANAGER

NUMÉRO D'IDENTIFICATION FISCALE

Choisissez dans la liste déroulante

Choix : Cliquez pour voir le continent, pays ou région dans la liste

CLASSIFICATION DOUANIÈRE

CATÉGORIE DE PRODUITS PAR DÉFAUT

Choisissez la catégorie de produits par défaut de votre boutique

Choix : Choisissez la catégorie de produits

CODE SH PAR DÉFAUT

Indiquez le code SH (code douanier) par défaut

Exemple : 8508190000

DESCRIPTIONS DE PRODUITS PAR DÉFAUTS

Indiquez le titre ou la description du produit le plus vendu

Exemple : aspirateur

PAYS D'ORIGINE DES PRODUITS PAR DÉFAUT

Choisissez le pays d'origine des produits par défaut

Choix : Choisissez le pays d'origine

PARAMÈTRES TRANSPORTEURS

RÉCAPITULATIF

Réinitialiser son mot de passe

Réinitialiser son mot de passe

Si vous avez oublié ou perdu votre mot de passe, vous pouvez cliquer sur Mot de passe oublié ? sur la page d'identification de l'application (https://www.app.transiteo.io/#/login) :

Vous allez être redirigé.e sur cette page pour réinitialiser votre mot de passe grâce à votre ADRESSE E-MAIL (https://www.app.transiteo.io/#/reset) :

Une fois votre adresse e-mail renseignée et avoir après cliqué sur le bouton Réinitialiser votre mot de passe, vous allez être redirigé.e vers cette page (https://www.app.transiteo.io/#/resetConfirm?email=...) :

Il faudra aller voir dans votre boite email, vous allez recevoir un email de ce type :

Copiez/Collez le CODE qui vous a été donné, votre ADRESSE E-MAIL et le NOUVEAU MOT DE PASSE sur cette page (https://www.app.transiteo.io/#/resetConfirm?email=...) :

Vous allez être redirigé.e ensuite vers la page d'identification de l'application (https://www.app.transiteo.io/#/login) pour vous connecter avec votre nouveau mot de passe :

Choisir une formule

Choisir une formule

Formule E-COMMERCE

Pour qui ?

Si vous êtes un e-commerçant utilisant un de ces CMS : Shopify, Magento, Prestashop, BigCommerce ou Wordpress.

Qu'est ce que ça comprend ?

Vous avez accès avec cet abonnement aux outils et services en illimité. Vous obtiendrez vos clefs d'activation pour les modules transiteo Welcome et transiteo Landed Cost.

Abonnement mensuel à 49€/mois

Chaque mois, à la date anniversaire de la contraction de votre formule vous serez débité.e de 49€.

+ Commission de 2% sur les droits et taxes

Les commissions sont prélevées uniquement sur le total des droits de douane et taxes des commandes abouties (commandes validées, payées, expédiées, réceptionnées et donc non retournées)

Exemple : Un client reçoit sa commande de 130€. 100€ H.T + 30€ de droits de douane et taxes. Nous allons prélever 0,60€, soit 30€ x 2%.

Consommation : Product > HSCode

Pour calculer les droits de douane et taxes sur vos commandes, il faut que préalablement vos produits soient attachés à un HSCode (code douanier). Si vous les connaissez vous n'aurez pas besoin de prendre une consommation, si vous ne les connaissez pas, il faudra prendre une quantité de crédits en fonction du nombre de produits que vous avez dans votre catalogue.

Formule API

Pour qui ?

Toutes les entreprises voulant connecter leurs services et/ou systèmes aux nôtres par API.

Qu'est ce que ça comprend ?

Vous avez accès à toute la bibliothèque de services de transiteo. Voir la documentation API.

Abonnement mensuel à 49€/mois

Chaque mois, à la date anniversaire de la contraction de votre formule vous serez débité.e de 49€.

+ Consommation

Vous devez pré-acheter des crédits pour utiliser les services de transiteo.

Consommation :

Pour connaitre les différents services par API, consulter la documentation API.

Formule APPLICATION WEB

Pour qui ?

Toutes les entreprises voulant connecter leurs services et/ou systèmes aux nôtres par API.

Qu'est ce que ça comprend ?

Vous avez accès à toute la bibliothèque de services de transiteo. Voir la documentation API.

Abonnement mensuel à 49€/mois

Chaque mois, à la date anniversaire de la contraction de votre formule vous serez débité.e de 49€.

+ Consommation

Vous devez pré acheter des crédits pour utiliser les services de transiteo.

Consommation : ...

Pour connaitre les différents services par API, consultez la documentation API.

Video Explainer

https://youtu.be/Sn41Av4CYkg

MENU - MANAGER

Accueil

Accueil

Essai gratuit

Depuis votre tableau de bord, accédez et pilotez l’ensemble de vos ventes à l’international (https://www.app.transiteo.io/#/dashboard) :

  • En haut à droite, LANGUES pour choisir la langue :

  • En haut à droite, MON PROFIL pour remplir et modifier toutes vos informations personnelles :

  • L'accès aux différents services pour gérer vos ventes, votre catalogue produit et vos données clients :

  • L'accès aux différents services pour gérer vos ventes à l'international :

  • Le bloc Choisissez votre formule Premium, pour choisir une formule payante et passer à un compte Premium :

  • L'accès au live chat pour demander une assistance à notre équipe :

  • Se déconnecter de votre compte :

Utilisation par API

Depuis votre tableau de bord, accédez et pilotez l’ensemble de vos services à l’international (https://www.app.transiteo.io/#/dashboard) :

  • En haut à droite, LANGUES pour choisir la langue :

  • En haut à droite, MON PROFIL pour remplir et modifier toutes vos informations personnelles :

  • En haut à droite, l'ensemble de vos statistiques, avec votre consommation de requêtes depuis la création de votre compte, ainsi que votre consommation de la journée

  • Les services utilisés et le nombre de requêtes consommées sur le nombre de requêtes achetées :

  • L'accès aux différents services pour gérer vos ventes, votre catalogue produit et vos données clients :

  • L'accès aux différents services pour gérer vos ventes à l'international :

  • L'accès aux paramètres :

  • L'accès à la documentation API :

  • L'accès au live chat pour demander une assistance à notre équipe :

  • Se déconnecter de votre compte :

Utilisation pour E-commerce

Depuis votre tableau de bord, accédez et pilotez l’ensemble de vos ventes à l’international (https://www.app.transiteo.io/#/dashboard) :

  • En haut à droite, LANGUES pour choisir la langue :

  • En haut à droite, MON PROFIL pour remplir et modifier toutes vos informations personnelles :

  • En haut à droite, votre chiffre d'affaire réalisé et les commandes réalisées du mois en cours :

  • Les top destinations, c'est-à-dire les pays où vous réalisez le plus de chiffre d'affaire :

  • L'accès aux différents services pour gérer vos ventes, votre catalogue produit et vos données clients :

  • L'accès aux différents services pour gérer vos ventes à l'international :

  • L'accès à la documentation :

  • L'accès aux paramètres :

  • L'accès au live chat pour demander une assistance à notre équipe :

  • Se déconnecter de votre compte :

Changer de langue

Changer de langue

Cliquez sur le bouton LANGUES dans le header de l'application :

L'application est disponible en 7 langues :

  • Français
  • Anglais
  • Chinois
  • Russe
  • Espagnol
  • Hindie
  • Portugais

Mon compte

Mon compte

Essai gratuit

Cliquez sur MON COMPTE dans le header de l'application :

Un menu déroulant apparait avec comme sous menu :

Utilisation par API

Cliquez sur MON COMPTE dans le header de l'application :

Un menu déroulant apparait avec comme sous menu :

Utilisation pour E-Commerce

Cliquez sur MON COMPTE dans le header de l'application :

Un menu déroulant apparait avec comme sous menu :

Menu

Menu

Essai gratuit

Accédez aux services transiteo directement depuis votre tableau de bord en cliquant sur Accéder selon le service que vous souhaitez utiliser :

  • transiteo AI CLASSIFY \ Classifier vos produits en code douanier (HSCode) grâce à l'intelligence artificielle
  • transiteo CUSTOMS DOCS\ Générer la documentation de vos envois à l'export
  • transiteo QUOTER \ Calculer en temps réel les droits de douane et taxes de vos ventes
  • transiteo TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Ou accédez à l'ensemble des outils transiteo, situés dans le menu à gauche de votre tableau de bord :

  • ACCUEIL\ Accéder à votre tableau de bord
  • MES VENTES \ Gérer l'ensemble de vos ventes à l'international
  • MON CATALOGUE\ Gérer l'ensemble de votre catalogue produit et ajouter y des codes douaniers (HSCode)
  • MES CLIENTS \ Gérer vos clients étrangers
  • AI CLASSIFY \ Classifier un ou plusieurs produit en code douanier (HSCode)
  • CUSTOMS DOCS

    Créer des documents douaniers et exports * QUOTER

    Calculer les droits de douane et taxes locales d'une commande ou d'un envoi en temps réel * TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Utilisation par API

Accédez aux services transiteo directement depuis votre tableau de bord en cliquant sur Accéder selon le service que vous souhaitez utiliser :

  • transiteo AI CLASSIFY \ Classifier vos produits en code douanier (HSCode) grâce à l'intelligence artificielle
  • transiteo CUSTOMS DOCS\ Générer la documentation de vos envois à l'export
  • transiteo QUOTER \ Calculer en temps réel les droits de douane et taxes de vos ventes
  • transiteo TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Ou accédez à l'ensemble des outils transiteo, situés dans le menu à gauche de votre tableau de bord :

  • ACCUEIL\ Accéder à votre tableau de bord
  • MES VENTES \ Gérer l'ensemble de vos ventes à l'international
  • MON CATALOGUE\ Gérer l'ensemble de votre catalogue produit et ajouter y des codes douaniers (HSCode)
  • MES CLIENTS \ Gérer vos clients étrangers
  • AI CLASSIFY \ Classifier un ou plusieurs produit en code douanier (HSCode)
  • CUSTOMS DOCS

    Créer des documents douaniers et exports * QUOTER

    Calculer les droits de douane et taxes locales d'une commande ou d'un envoi en temps réel * TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Utilisation pour E-commerce

Accédez aux services transiteo directement depuis votre tableau de bord en cliquant sur Accéder selon le service que vous souhaitez utiliser :

  • transiteo AI CLASSIFY \ Classifier vos produits en code douanier (HSCode) grâce à l'intelligence artificielle
  • transiteo CUSTOMS DOCS\ Générer la documentation de vos envois à l'export
  • transiteo QUOTER \ Calculer en temps réel les droits de douane et taxes de vos ventes
  • transiteo TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Ou accédez à l'ensemble des outils transiteo, situés dans le menu à gauche de votre tableau de bord :

  • ACCUEIL\ Accéder à votre tableau de bord
  • MES VENTES \ Gérer l'ensemble de vos ventes à l'international
  • MON CATALOGUE\ Gérer l'ensemble de votre catalogue produit et ajouter y des codes douaniers (HSCode)
  • MES CLIENTS \ Gérer vos clients étrangers
  • AI CLASSIFY \ Classifier un ou plusieurs produit en code douanier (HSCode)
  • CUSTOMS DOCS

    Créer des documents douaniers et exports * QUOTER

    Calculer les droits de douane et taxes locales d'une commande ou d'un envoi en temps réel * TAX MANAGER \ Gérer les informations de taxes et de ventes par pays de destination

Statistiques

Statistiques

Essai gratuit

En version Freemium, vous ne pouvez pas visualiser vos statistiques :

Utilisation par API

Gardez le contrôle sur votre Consommation de requêtes des services utilisés depuis la création de votre compte, ainsi que votre Consommation du jour :

Contrôlez en détail vos SERVICES UTILISÉS et visualisez vos consommations restantes :

Liste des services :

Liste des services Explications
Duty Rate Pour calculer le taux de taxes de vos produits
SalesTax Rates Pour calculer le taux de SalesTax de vos produits (États-Unis)
Special Taxes Rates Pour calculer le taux de Special Taxes de vos produits
Local Taxes Rates Pour calculer le taux de Local Taxes de vos produits
Docs Generation Pour générer vos documents export
Duties & Taxes Calculation Pour calculer les droits de douane et taxes de vos produits
A.I Classify Pour classifier vos produits en HSCode (code douanier)
Local Taxes Calculation Pour calculer les Local Taxes de vos produits

Utilisation pour E-Commerce

Contrôlez votre chiffre d'affaire réalisé depuis la création de votre compte, ainsi que les commandes réalisées du jour :

Contrôlez dans TOP DESTINATION les pays phares de vos commandes à l'international :

Vous avez besoin de plus de requêtes ? Recharger votre compte

Support

Support

Contactez à tout moment l'équipe transiteo grâce au live chat, situé en bas à droite de votre tableau de bord :

Cliquez sur l'icône, cela vous ouvrira une fenêtre pour écrire à notre équipe :

Écrivez votre message sur le live chat. Vous serez mis en relation avec notre équipe :

Mes ventes

Mes ventes

Pour gérer vos ventes, cliquez sur MES VENTES à gauche de votre menu (https://www.app.transiteo.io/#/orderManager) :

Vous avez ici une vision sur l’ensemble de vos commandes : numéro de commande, nom et prénom du client, date de la commande, pays de l’acheteur, statut de la commande, etc. Importez directement vos fichiers de vente ou ajoutez vos commandes manuellement :

Détail du tableau

Détail du tableau

Colonnes dans le tableau des ventes :

Nom des colonnesExemple
NUMÉRO DE COMMANDE1573675
NUMÉRO DE FACTURE1573675
TOTAL PRODUITS H.T.223
TOTAL TRANSPORT H.T.20
TOTAL DROITS DE DOUANE12.56
TOTAL TAXE LOCALE6.23
TOTAL TAXES SPECIALES3.46
DEVISEEUR
URL DE LA BOUTIQUEhttps://transiteo.com/
DATE DE COMMANDE2022-01-31 12:20:34
PRÉNOM DU CLIENT Mélodie
NOM DU CLIENTDuraiz
ADRESSE DU CLIENT44 avenue des lucioles
CODE POSTAL DU CLIENT75020
VILLE DU CLIENTParis
PAYS DU CLIENTFrance
PRÉNOM DE L'ACHETEURJérome
NOM DE L'ACHETEURVan Delen
ADRESSE DE L'ACHETEUR1 rue de l'impasse
CODE POSTAL DE L'ACHETEUR1005
VILLE DE L'ACHETEURBruxelles
PAYS DE L'ACHETEURBelgique
PRÉNOM DU COMMISSIONNAIREArnaud
NOM DU COMMISSIONNAIRESigal
ADRESSE DU COMMISSIONNAIRE123 rue du bouclier
CODE POSTAL DU COMMISSIONNAIRE92130
VILLE DU COMMISSIONNAIREIssy-les-Moulineaux
PAYS DU COMMISSIONNAIREFrance
TYPE DE PAIEMENTVirement bancaire
DATE DE PAIEMENT2022-01-31 12:19:23
PAYS DE DÉPARTFrance
PAYS DE DESTINATIONBelgique
TRANSPORTEUR D'EXPORTATIONUPS
TRANSPORTEURUPS
CATÉGORIE DE L'ÉLÉMENTCommercial Goods
MOYEN DE PAIEMENTVirement bancaire
STATUT DE COMMANDEAWAITING
DATE DE MISE À JOUR2022-01-31 12:21:01

Sous-colonnes dans le tableau d'une vente :

Noms des sous colonnesExemple
SKU009-1-3
Quantité2
Prix Unitaire150
Devise du produitEUR

Importer une commande

Importer une commande

Télécharger le modèle de fichier CSV

Vue du CSV sous forme de tableau avec noms et correspondances des champs :

product_1_skuproduct_1_quantityproduct_1_unit_priceproduct_1_unit_price_currencyproduct_2_skuproduct_2_quantityproduct_2_unit_priceproduct_2_unit_price_currencyorder_idinvoice_idurlorder_date_hourcustomer_firstnamecustomer_lastnamecustomer_addresscustomer_zipcodecustomer_citycustomer_countrybuyer_firstnamebuyer_lastnamebuyer_addressbuyer_zipcodebuyer_citybuyer_countryagent_firstnameagent_lastnameagent_addressagent_zipcodeagent_cityagent_countryorder_payment_typeorder_payment_datedeparture_countryarrival_countryexporting_carriershipping_carriercategory_of_itempayment_typeamount_productsamount_shippingamount_dutyamount_vatamount_specialtaxesincotermcurrencyorder_statut
SKUQuantitéPrix unitaireDevise du prix unitaire SKUQuantitéPrix unitaireDevise du prix unitaire Numéro de commandeNuméro de factureURLDate de commandePrénom du clientNom du clientAdresse du clientCode postal du clientVille du clientPays du clientPrénom de l'acheteurNom de l'acheteur Adresse de l'acheteurCode postal de l'acheteurVille de l'acheteurPays de l'acheteurPrénom du commissionnaireNom du commissionnaireAdresse du commissionnaireCode postal du commissionnaireVille du commissionnairePays du commissionnaireType de paiementDate de paiementPays de départPays de destinationTransporteur d'exportation TransporteurCatégorie de l'élémentMoyen de paiementTotal produits H.TTotal transport H.TTotal droits de douaneTotal taxe localeTotal taxes spécialesIncotermDeviseStatut de commande
C'est la référence de votre produitC'est la quantité du produitC'est le prix à l'unité du produitC'est la devise du prix unitaire du produitC'est la référence de votre produitC'est la quantité du produitC'est le prix à l'unité du produitC'est la devise du prix unitaire du produitC'est le numéro de commandeC'est le numéro de factureC'est l'URL de la boutique C'est la date et l'heure de commandeC'est le prénom du clientC'est le nom du clientC'est l'adresse du client C'est le code postal du clientC'est la ville du clientC'est le pays du clientC'est le prénom de l'acheteurC'est le nom de l'acheteur C'est l'adresse de l'acheteurC'est le code postal de l'acheteurC'est la ville de l'acheteurC'est le pays de l'acheteurC'est le prénom du commissionnaireC'est le nom du commissionnaireC'est l'adresse du commissionnaireC'est le code postal du commissionnaireC'est la ville du commissionnaireC'est le pays du commissionnaire C'est le type de paiement de la commandeC'est la date de paiement de la commandeC'est le pays de départ de la commandeC'est le pays de destination de la commandeC'est le transporteur d'exportationC'est le transporteur C'est le type d'envoi C'est le moyen de paiement de la commandeC'est le montant total des produits H.T. de la commandeC'est le montant total du transport H.T. de la commandeC'est le montant total des droits de douane de la commandeC'est le montant total de la taxe locale de la commandeC'est le montant total des taxes spéciales de la commandeC'est l'incoterm de la commandeC'est la devise de la commandeC'est le statut de la commande

Vous devez obligatoirement remplir les champs suivants :

  • product_1_sku
  • product_1_quantity
  • product_1_unit_price
  • product_1_unit_price_currency
  • order_id
  • order_date_hour
  • departure_country
  • amount_products
  • order_statut

Si vous n'avez qu'un type de produit dans votre commande, veillez à supprimer les colonnes suivantes du fichier CSV :

  • product_2_sku
  • product_2_quantity
  • product_2_unit_price
  • product_2_unit_price_currency

Dans le cas de plusieurs produits dans une même commande :

Si vous avez plusieurs type de produits par commande, vous devez ajoutez les colonnes suivantes selon le nombre de produits. Si vous avez 2 types de produit par exemple, ajoutez ces colonnes après la colonne product_1_unit_price_currency :

  • product_2_sku
  • product_2_quantity
  • product_2_unit_price
  • product_2_unit_price_currency

Si vous avez 3 types de produits par exemple, ajoutez ces colonnes après la colonne product_2_unit_price_currency. Créez des colonnes et nommez-les ainsi :

  • product_3_sku
  • product_3_quantity
  • product_3_unit_price
  • product_3_unit_price_currency

etc...

FORMAT DES DONNÉES ET MESSAGES D'ERREURS

ChampsFormatExempleMessage d'erreur
product_1_skuChaine de caractère libre23FDDGR542Line XXXXXX : product_1_sku doit contenir au moins un caractère
product_1_quantity Chaine de caractère libre1, 5, 100Line XXXXXX : product_1_quantity doit être un nombre
product_1_unit_priceNombre décimal12.5, 234, 567.54Line XXXXXX : Line 2 : product_1_unit_price doit être un nombre
product_1_unit_price_currencyCode ISO Alpha 3EUR, USD, CADLine XXXXXX : product_1_unit_price_currency doit être une devise au format ISO 4217
order_idChaine de caractère libre24534542Line XXXXXX : order_id doit contenir au moins un caractère
departure_countryCode ISO Alpha 2 ou 3FRA, CAN, USALine XXXXXX : departure_country doit être un pays au format ISO3
arrival_countryCode ISO Alpha 2 ou 3FRA, CAN, USALine XXXXXX : arrival_country doit être un pays au format ISO3
amount_productsNombre décimal43.78, 55, 797.43Line XXXXXX : amount_products doit être un nombre
currencyCode ISO Alpha 3EUR, USD, CADLine XXXXXX : currency doit être une devise au format ISO 4217
order_statut Chaine de caractère libreValidée, RembourséeLine XXXXXX : order_statut doit contenir au moins un caractère
INCORRECT_JSON Chaine de caractèreMon Jan 31 2021 12:22:42INCORRECT_JSON : Incorrect Json Request. Details : order_date_hour : order_date_hour must be a number order_date_hour should not be empty

Line 2 : product_1_sku doit contenir au moins un caractère

Si vous recevez ce message, c'est que vous n'avez pas renseigné de SKU.

Solution :

Vous devez remplir un SKU.

Exemple : 976-43-2

------------------------------

Line 2 : product_1_quantity doit être un nombre

Si vous recevez ce message, c'est que vous n'avez pas renseigné une quantité de produit.

Solution :

Exemple 1, 23, 100, etc.

------------------------------

Line 2 : product_1_unit_price doit être un nombre

Si vous recevez ce message, c'est que vous n'avez pas renseigné un prix pour le produit ou que le format du prix n'est pas correct.

Les prix à décimales doivent être indiqués sous le format suivant : 23.99

Solution :

Exemple : 23, 67, 123, 1200, etc.

------------------------------

Line 2 : product_1_unit_price_currency doit être une devise au format ISO 4217

Si vous recevez ce message, c'est que vous n'avez pas renseigné la devise du prix de votre produit ou que le format ne respecte pas le format ISO 4217.

Liste des devises au format ISO 4217

Solution :

Exemple : EUR, USD, CHF, CNY, etc.

------------------------------

Line 2 : order_id doit contenir au moins un caractère

Si vous recevez ce message, c'est que vous n'avez pas renseigné de numéro de commande pour votre ou vos produits.

Solution :

Exemple : 768, 12467, 35763, etc.

------------------------------

Line 2 : departure_country doit être un pays au format ISO3

Si vous recevez ce message, c'est que vous n'avez pas renseigné de pays de départ ou que le format ne respecte pas le format ISO3.

Solution :

Exemple : FRA, BRA, NGA, etc.

------------------------------

Line 2 : arrival_country doit être un pays au format ISO3

Si vous recevez ce message, c'est que vous n'avez pas renseigné de pays de destination ou que le format ne respecte pas le format ISO3.

Solution :

Exemple : CHN, IND, JPN, etc.

------------------------------

Line 2 : amount_products doit être un nombre

Si vous recevez ce message, c'est que vous n'avez pas renseigné un montant pour l'ensemble des produits de votre commande.

Solution :

Exemple : 1243, 534, 542, etc.

------------------------------

Line 2 : currency doit être une devise au format ISO 4217

Si vous recevez ce message, c'est que vous n'avez pas renseigné de devise pour le total de votre commande ou que le format ne respecte pas le format ISO 4217.

Solution :

Exemple : EUR, AUD, GBP, etc.

------------------------------

Line 2 : order_statut doit contenir au moins un caractère

Si vous recevez ce message, c'est que vous n'avez pas renseigné le statut de votre commande.

Solution :

Exemple : AWAITING, PAID, etc.

------------------------------

INCORRECT_JSON : Incorrect Json Request. Details : order_date_hour : order_date_hour must be a number order_date_hour should not be empty

Si vous recevez ce message, c'est que vous n'avez pas renseigné la date et l'heure de commande.

Solution :

Exemple : Mon Jan 31 2021 12:22

Ajouter une commande

Ajouter une commande

Pour ajouter une commande, cliquez sur le bouton Ajouter une commande :

Noms des champs Exemple
NUMÉRO DE COMMANDE 1573675
DATE DE COMMANDE 2022-01-31 12:20:34
SKU 998-4-6
QUANTITÉ 1
PRIX UNITAIRE 25
DEVISE DU PRODUIT EUR
PAYS DE DESTINATION CHN
TOTAL PRODUITS H.T 25
DEVISE EUR
STATUT DE LA COMMANDE AWAITING

Champs obligatoires à remplir :

  • NUMÉRO DE COMMANDE
  • DATE DE COMMANDE
  • SKU
  • QUANTITÉ
  • PRIX UNITAIRE
  • DEVISE DU PRODUIT
  • PAYS DE DESTINATION
  • TOTAL PRODUITS H.T
  • DEVISE
  • STATUT DE LA COMMANDE

Champs non-obligatoires :

  • NUMÉRO DE FACTURE
  • URL DE LA BOUTIQUE
  • PRÉNOM DU CLIENT
  • NOM DU CLIENT
  • ADRESSE DU CLIENT
  • CODE POSTAL DU CLIENT
  • VILLE DU CLIENT
  • PRÉNOM DE L'ACHETEUR
  • NOM DE L'ACHETEUR
  • ADRESSE DE L'ACHETEUR
  • CODE POSTAL DE L'ACHETEUR
  • VILLE DE L'ACHETEUR
  • PAYS DE L'ACHETEUR
  • PRÉNOM DU COMMISSIONNAIRE
  • NOM DU COMMISSIONNAIRE
  • ADRESSE DU COMMISSIONNAIRE
  • CODE POSTAL DU COMMISSIONNAIRE
  • VILLE DU COMMISSIONNAIRE
  • PAYS DU COMMISSIONNAIRE
  • PAYS DE DÉPART
  • TRANSPORTEUR D'EXPORTATION
  • TRANSPORTEUR
  • TOTAL TRANSPORT H.T
  • TOTAL DROITS DE DOUANE
  • TOTAL TAXE LOCALE
  • TOTAL TAXES SPECIALES
  • TYPE DE PAIEMENT
  • DATE DE PAIEMENT
  • CATÉGORIE DE L'ÉLÉMENT
  • MOYEN DE PAIEMENT

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquez sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Veillez à remplir tous les champs signalés par un astérisque rouge.

Modifier une commande

Modifier une commande

Pour ajouter, supprimer ou changer les informations relatives à une commande, rendez-vous sur la ligne de la commande concernée et allez tout à droite. Ensuite, cliquez sur l'icône pour modifier la ligne :

Vous aurez accès à l'ensemble des informations concernant votre commande et pourrez modifier les différents champs :

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquer sur le bouton Valider, c'est que vous n'avez pas remplis tous les champs obligatoires.

Solution :

Veillez à remplir tous les champs signalés par un astérisque rouge.

------------------------------

Solution :

------------------------------

Génerer des docs export

Génerer des docs export

Pour générer des documents export relatifs à une commande, rendez-vous sur la ligne de la commande concernée et aller tout à droite. Ensuite, cliquez sur l'icône en forme de document au bout de la ligne :

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Figer une colonne

Figer une colonne

Vous pouvez figer des volets pour verrouiller des colonnes spécifiques dans votre tableau. Il suffit d'appuyer sur l'icône de punaise puis choisir la colonne que vous souhaitez épingler avant de cliquer sur "valider"

Dans ce cas, vous pourrez parcourir le tableau tout en gardant, visible à l'écran, la colonne portant les noms des produits :

Synchronisation

Synchronisation

Si vous avez installé une des extensions à votre CMS, la synchronisation de vos commandes sera automatique.

Liste des CMS :

  • Wordpress
  • Shopify
  • Magento
  • Prestashop
  • BigCommerce

Mon Catalogue

Mon Catalogue

  • Vous pouvez ajouter, supprimer ou modifier à votre guise les données relatives à vos produits. Vous pouvez importer directement votre catalogue produit en fichier CSV, et/ou exporter le catalogue produit que vous avez créé sur l’outil Mon catalogue :

Détail du tableau

Détail du tableau

Colonnes dans le tableau du catalogue produit :

Noms des colonnesExemple
TYPE SKU
SKU DU PRODUIT987-43-8
NOM DU PRODUITTable en bois
POIDS13
UNITÉ DE POIDSkg
QUANTITÉ1
PRIX UNITAIRE H.T240
DEVISEEUR
HS CODE9403609000
VERSION DU HS CODEHS17
DÉSIGNATION DU CODEchapter_designation : Furniture; bedding, mattresses, mattress supports, cushions and similar stuffed furnishings; lamps and lighting fittings, not elsewhere specified or included; illuminated signs, illuminated name- plates and the like; prefabricated buildings -- heading_designation : Other furniture and parts thereof. -- subheading_designation : Wooden furniture (excl. for offices, kitchens and bedrooms, and seats) -- national_designation : Wooden furniture (excl. for offices or shops, kitchens, dining rooms, living rooms and bedrooms, and seats)
STATUT DU PRODUITProhibé à l'importation dans ce pays

Pour modifier les colonnes, cliquez sur Modifier les colonnes en bas de votre catalogue produit :

Un encadré vous signalant les colonnes affichées et les colonnes non affichées s'ouvre. Vous pouvez déplacer le colonnes dans les lignes colonnes affichées et colonnes non affichées selon vos préférences, puis cliquez sue le bouton Valider pour enregistrer vos modifications :

Importer des produits

Importer des produits

Téléchargez le modèle de fichier CSV

Vue du CSV sous forme de tableau avec noms et correspondances des champs :

skuproductIDweightweight_unitquantityunit_priceunit_ship_pricecurrency_unit_pricesale_unit_pricesale_currency_unit_pricepurchase_unit_pricepurchase_currency_unit_pricefrom_countryto_countryto_districtrevenue_country_annualcurrency_revenue_country_annualhscodefinder_hs_code
skuID du produitPoidsUnité de poidsQuantitéPrix unitaire H.TPrix du transportDevisePrix de venteDevise du prix de ventePrix unitaire d'achatDevise du prix unitaire d'achatPays de départPays de destinationDistrict Chiffre d'affaire de l'expéditeur dan le pays de destinationDeviseHSCode
C'est la référence de votre produitC'est une référence secondaire du produit (titre, description, etc)C'est le poids du produit C'est l'unité de masse du produitC'est la quantité du produitC'est le prix H.T. à l'unité du produitC'est le prix du transportC'est la devise du prixC'est le prix de vente C'est la devise du prix de vente C'est le prix unitaire d'achatC'est la devise du prix unitaire d'achatC'est le pays de départ du produitC'est le pays de destination du produitC'est le district du pays de destination (obligatoire pour USA et CAN uniquement) C'est le chiffre d'affaire de l'expéditeur dans le pays de destinationC'est la devise du chiffre d'affaire de l'expéditeur dans le pays de destination C'est le code douanier (HSCode) du produit

Vous devez renseigner obligatoirement les champs suivants pour pouvoir importer un fichier CSV dans votre catalogue produit :

  • sku
  • productID
  • weight
  • weight_unit

Prise en compte des modèles de catalogue des CMS suivants :

  • Wordpress
  • Shopify
  • Prestashop
  • Magento
  • BigCommerce

FORMAT DES DONNÉES ET MESSAGES D'ERREURS

ChampsFormatExempleMessage d'erreur
skuChaine de caractère libreHidj7"èç':;,?ù:Line XXXXXX : sku doit contenir au moins un caractère
productIDChaine de caractère librejdIE83!'ç(à=+Line XXXXXX : productID doit contenir au moins un caractère
weightNombre décimal12, 4.78, 19.9, ...Line XXXXXX : weight doit contenir au moins un caractère
weight_unitChaine de caractèrekg, lbsLine XXXXXX : weight_unit est invalide

Line 2 : sku doit contenir au moins un caractère

Si vous recevez ce message, c'est que vous n'avez pas renseigné un SKU pour le produit.

Solution :

Vous devez remplir un SKU pour le produit.

Exemple : 0678-9-3

-----------

Line 2 : productID doit contenir au moins un caractère

Si vous recevez ce message, c'est que vous n'avez pas renseigné un nom de produit.

Solution :

Vous devez remplir un nom de produit.

Exemple : Vase en verre

------------------------------

Line 2 : weight doit être un nombre

Si vous recevez ce message, c'est que vous n'avez pas renseigné le poids de votre produit.

Solution :

Il faut renseigner le poids de votre produit.

Exemple correct : 1.4

----------------

Line 2 : weight_unit est invalide

Si vous recevez ce message, c'est que vous n'avez pas renseigné l'unité de poids de votre produit correctement.

Exemple faux : Kg

Solution :

Il faut renseigner les unités de mesures en minuscules.

Exemple correct : kg

Ajouter un produit

Ajouter un produit

Pour ajouter un produit à votre catalogue, cliquer sur le bouton Ajouter un produit, en haut à droite :

Pour ajouter un produit à votre catalogue, vous devez remplir obligatoirement les champs suivants :

  • NOM DU PRODUIT
  • POIDS
  • UNITÉ DE POIDS

En cliquant sur Ajouter une colonne, vous ajoutez les champs obligatoires suivants :

  • LABEL
  • VALEUR

Noms du champSignification du champExemple / Valeur
TYPEC'est le type SKUSKU
SKU DU PRODUITC'est le SKU rattaché au produit 5676-325-763
NOM DU PRODUITC'est le nom du produit Aspirateur, t-shirt en coton, table en bois
POIDSC'est le poids du produit3, 6.7, 45
UNITÉ DE POIDSC'est l'unité de poids du produit g, Kg, lb, t, oz
LABEL - QuantitéC'est la quantité3, 10, 200
LABEL - Prix unitaire HTC'est le prix unitaire HT45, 70.34, 100
LABEL - Frais de livraison HTCe sont les frais de livraison HT6.90, 10, 50
LABEL - Devise C'est la devise Euros (EUR), Livre Sterling (GBP), Roupie Indienne (INR)
LABEL - Prix de vente HTC'est le prix de vente HT45, 90.78, 230
LABEL - Devise du prix de venteC'est la devise du prix de vente Yen (JPY), Peso Mexicain (MXN), Dollar néo (NZD)
LABEL - Prix d'achat HT C'est le prix d'achat HT4, 45.8, 100.02
LABEL - Devise du prix d'achat C'est la devise du prix d'achat Franc congolais (CDF), Peso argentin (ARS)
LABEL - Pays d'origineC'est le pays d'origine Algérie, Bénin, Chine
LABEL - Pays d'expédition C'est le pays d'expéditionMaroc, Martinique, Canada
LABEL - Pays de destination C'est le pays de destination Chine, Etats-Unis d'Amérique, Hongrie
LABEL - District de destination C'est le district de destination Irlande, Namibie, Samoa
LABEL - Chiffre d'affaire annuel à destination réalisé C'est le chiffre d'affaire annuel à destination réalisé457900, 1000000, 5678000
LABEL - Devise du chiffre d'affaireC'est la devise du chiffre d'affaireLari géorgien (GEL), Quetzal (GTQ), Shekel Israélien (ILS)
LABEL - HS codeC'est le HS Code 8508190000, 6109100010, 95066200
ValeurC'est la valeur du label que vous avez sélectionnez Tous les exemples des labels

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquez sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Veillez à remplir tous les champs signalés par un astérisque rouge.

------------------------------

Solution :

------------------------------

Modifier un produit

Modifier un produit

Pour ajouter, supprimer ou changer les informations relatives à un produit, rendez-vous sur la ligne du produit concerné et allez tout à droite. Ensuite, cliquez sur l'icône de modification :

Une fenêtre vous permettant d'accéder à votre fiche produit s'ouvre :

Pensez à bien valider vos modifications.

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquez sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Veillez à remplir tous les champs signalés par un astérisque rouge.

------------------------------

Solution :

------------------------------

Supprimer des produits

Supprimer des produits

Pour supprimer un ou des produits de votre catalogue, cliquez sur la case tout à gauche de la ligne du ou des produits concernés :

Puis, cliquez sur Supprimer les produits sélectionnés, en bas à droite de votre catalogue pour les retirer :

Un encadré vous demandant si vous êtes sûr.e de vouloir supprimer le/les produits apparaît. Cliquez sur le bouton Oui :

Classifier des produits

Classifier des produits

Pour classifier un ou des produits de votre catalogue en code douanier (HSCode), sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

Cliquez sur le bouton Sélectionner une action en bas de votre catalogue produit. Ensuite, cliquez sur Rechercher les HS Code :

Cliquez ensuite sur le symbole de validation pour lancer votre classification :

Vos produits sont automatiquement classés en HSCode :

MESSAGES D'ERREURS

Lorsque vous souhaitez classifier un produit en HSCode, un encadré vous signalant que certains champs sont requis apparaît.

Solution :

Remplissez ces champs pour pouvoir obtenir votre HSCode.

------------------------------

Solution :

------------------------------

Récupérer les droits de douane

Récupérer les droits de douane

Pour récupérer les droits de douane d'un ou des produits de votre catalogue, sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

La première étape pour récupérer vos droits de douanes est de classifier tous vos produits en HSCode. Pour ce faire, appuyez sur "choisir une action" et choisissez la fonctionnalité "Rechercher les HSCodes" puis cliquez sur la coche "✓" tout à droite :

Vous ne pouvez pas récupérer les droits de douane d'un produit avant de classifier en HSCode ce même produit.

Vous devez ensuite saisir le pays de destination de chacun des produits dans le menu affiché sur votre écran puis cliquer sur "Valider"

Vos produits seront automatiquement classés en HSCodes :

Ensuite, appuyez une deuxième fois sur "Sélectionner une action" et choisissez l'action "Récupérer les droits de douane" puis cliquez sur la barre tout à droite pour valider votre choix

Vous devez par la suite renseigner le pays d'expédition des produits sélectionnés avant d'appuyer sur "valider", puis cliquez encore une fois sur la coche "✓"

Vous pouvez désormais récupérer vos droits de douane ! Faites défiler l'écran vers la droite pour voir tous les champs

Les résultats s'affichent en décimal. Multipliez le nombre décimal par 100 pour les transformer en pourcentage (e.g : 0.05 =5%)

Récupérer les taux de taxes locales

Récupérer les taux de taxes locales

Pour récupérer les taux de taxes locales d'un ou des produits de votre catalogue, sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

La première étape pour récupérer vos droits de douanes est de classifier tous vos produits en HSCode. Pour ce faire, appuyez sur "choisir une action" et choisissez la fonctionnalité "Rechercher les HSCodes" puis cliquez sur la coche "✓" tout à droite

Vous ne pouvez pas récupérer les taux de taxes locales d'un produit avant de classifier en HSCode ce même produit.

Vous devez ensuite saisir le pays de destination de chacun des produits dans le menu affiché sur votre écran puis cliquer sur "Valider"

Vos produits seront automatiquement classés en HSCodes

Ensuite, appuyez une deuxième fois sur "Sélectionner une action" et choisissez l'action "Récupérer les taux de taxes locales" puis cliquez sur la barre tout à droite pour valider votre choix

Les taux de taxes locales de vos produits seront affichés dans la partie droite de votre écran

Récupérer les taux de taxes spéciales

Récupérer les taux de taxes spéciales

Pour récupérer les taux de taxes spéciales d'un ou des produits de votre catalogue, sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

La première étape pour récupérer les taux de vos taxes spéciales est de classifier tous vos produits en HSCode. Pour ce faire, appuyez sur "choisir une action" et choisissez la fonctionnalité "Rechercher les HSCodes" puis cliquez sur la coche "✓" tout à droite

Vous ne pouvez pas récupérer les taux de taxes spéciales d'un produit avant de classifier en HSCode ce même produit.

Vous devez ensuite saisir le pays de destination de chacun des produits dans le menu affiché sur votre écran puis cliquer sur "Valider"

Vos produits seront automatiquement classés en HSCodes

Ensuite, appuyez une deuxième fois sur "Sélectionner une action" et choisissez l'action "Récupérer les taux de taxes spéciales" puis cliquez sur la barre tout à droite pour valider votre choix

Vous pouvez désormais récupérer les taux des taxes spéciales ! Faites défiler l'écran vers la droite pour voir tous les champs

Récupérer les eco taxes

Récupérer les eco taxes

Pour récupérer les eco taxes d'un ou des produits de votre catalogue, sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

La première étape pour récupérer les eco taxes est de classifier tous vos produits en HSCode. Pour ce faire, appuyez sur "choisir une action" et choisissez la fonctionnalité "Rechercher les HSCodes" puis cliquez sur la coche "✓" tout à droite

Vous ne pouvez pas récupérer les eco de taxes d'un produit avant de classifier en HSCode ce même produit.

Vous devez ensuite saisir le pays de destination de chacun des produits dans le menu affiché sur votre écran puis cliquer sur "Valider"

Vos produits seront automatiquement classés en HSCodes

Ensuite, appuyez une deuxième fois sur "Sélectionner une action" et choisissez l'action "Récupérer les eco taxes" puis cliquez sur la barre tout à droite pour valider votre choix

Les eco taxes de vos produits seront affichés dans la partie droite de votre écran :

Calculer les marges

Calculer les marges

Vous ne pouvez pas calculer les marges d'un produit avant de passer par les étapes ci-dessous :

  1. Classifier le produit en HSCode (Voir p.6 > Mon catalogue)
  2. Récupérer les droits de douanes (Voir p.7 > Mon catalogue)
  3. Récupérer les taux de taxes locales (Voir p.8 > Mon catalogue)
  4. Récupérer les taux de taxes spéciales (Voir p.9 > Mon catalogue)

Pour calculer les marges d'un ou des produits de votre catalogue, sélectionnez les produits en cliquant sur les cases des produits situées tout à gauche :

La première étape pour récupérer les eco taxes est de classifier tous vos produits en HSCode. Pour ce faire, appuyez sur "choisir une action" et choisissez la fonctionnalité "Rechercher les HSCodes" puis cliquez sur la coche "✓" tout à droite

Vous devez ensuite saisir le pays de destination de chacun des produits dans le menu affiché sur votre écran puis cliquer sur "Valider"

Vos produits seront automatiquement classés en HSCodes

Ensuite, appuyez une deuxième fois sur "Sélectionner une action" et choisissez l'action "Calculer les marges" puis cliquez sur la barre tout à droite pour valider votre choix

Vous devez ensuite remplir les champs requis pour chacun des produits sélectionnés puis cliquer sur "Valider"

Vous pouvez désormais récupérer vos marges ! Faites défiler l'écran vers la droite pour voir tous les champs

Figer une colonne

Figer une colonne

Vous pouvez figer des volets pour verrouiller des colonnes spécifiques dans votre tableau. Il suffit d'appuyer sur l'icône de punaise puis choisir la colonne que vous souhaitez épingler avant de cliquer sur "valider"

Dans ce cas, vous pourrez parcourir le tableau tout en gardant, visible à l'écran, la colonne portant les noms des produits :

Synchronisation

Synchronisation

Si vous avez installé une des extensions à votre CMS, la synchronisation de vos commandes sera automatique.

Liste des CMS :

  • Wordpress
  • Shopify
  • Magento
  • Prestashop
  • BigCommerce

Mes Clients

Mes Clients

Pour utiliser l'outil Mes Clients, cliquez sur MES CLIENTS à gauche de votre menu (https://www.app.transiteo.io/#/customerManager) :

Vous pouvez visualiser l'ensemble de vos fiches clients et les informations associées :

Détails du tableau

Détails du tableau

Les champs du tableau :

  • Adresse mail du client
  • Site web du client
  • Prénom
  • Nom
  • Civilité
  • Age
  • N° de téléphone
  • Code postal
  • Adresse
  • Ville
  • État/Région
  • Pays
  • Nom de société du client
  • ID de société
  • N° de TVA
  • Professionnel
  • Commandes payées
  • Commande en attente
  • Commandes annulées
  • Produits achetés

Ajouter un client

Ajouter un client

Pour ajouter un client, cliquez sur le bouton Ajouter un client :

Plusieurs informations obligatoires concernant votre client sont demandées :

  • Adresse mail du client
  • Site web du client
  • Prénom
  • Nom
  • Civilité
  • Age
  • N° de téléphone
  • Pays
  • État/Région
  • Code postal
  • Adresse
  • Ville
  • Professionnel

Les informations non-obligatoire demandées :

  • Nom de société du client
  • ID de société
  • N° de TVA

Pour associer un ou plusieurs produits achetés à votre client, cliquez sur Ajouter un produit. Vous devez obligatoirement renseigner les informations suivantes :

  • SKU du produit
  • Quantité
  • Prix unitaire
  • Devise

Pour associer une ou des commandes payées à votre client, cliquez sur Ajouter une commande. Vous devez obligatoirement renseigner les informations suivantes :

  • ID de commande
  • Devise
  • Total droits de douane
  • Total taxes locales
  • Total taxes spéciales
  • Montant total

Pour associer une ou des commandes en attente à votre client, cliquez sur Ajouter une commande. Vous devez obligatoirement renseigner les informations suivantes :

  • ID de commande
  • Devise
  • Total droits de douane
  • Total taxes locales
  • Total taxes spéciales
  • Montant total

Pour associer une ou des commandes annulées à votre client, cliquez sur Ajouter une commande. Vous devez obligatoirement renseigner les informations suivantes :

  • ID de commande
  • Devise
  • Total droits de douane
  • Total taxes locales
  • Total taxes spéciales
  • Montant total

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquer sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Remplissez les champs signalés par un astérisque rouge.

Modifier les infos d'un client

Modifier les infos d'un client

Pour modifier les informations d'un client, rendez-vous tout à droit de la ligne et cliquez sur l'icône de modification :

Les informations de votre client s'ouvrent dans une fenêtre, vous pouvez les modifier. N'oubliez pas de cliquer sur le bouton Valider pour enregistrer vos modifications :

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquer sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Remplissez les champs signalés par un astérisque rouge.

Supprimer un client

Supprimer un client

Pour supprimer un client, rendez-vous tout à droite de la ligne et cliquez sur l'icône de suppression :

MENU - SERVICES

AI Classify

AI Classify

  • Pour utiliser notre outil AI CLASSIFY pour classifier des codes douaniers (HS Code), cliquez sur AI CLASSIFY à gauche de votre tableau de bord, ou sur Accéder, au milieu de votre tableau de bord (https://www.app.transiteo.io/#/hsCodeFinder/import) :

  • Vous pouvez effectuer votre recherche par deux types : manuel ou CSV :

Video Explainer

https://youtu.be/x6lUsj7KBg4

Par titre ou description

Par titre ou description

Prenons l'exemple d'une recherche à partir d’une description produit pour un code douanier (HS Code) allemand. Entrez aspirateur dans le champ PRODUIT. Ensuite, sélectionnez le PAYS DE DESTINATION : Allemagne. Il suffit de cliquer sur le bouton Rechercher pour classifier votre produit :

Vous obtenez ensuite le résultat de votre produit classifié en code douanier (HS Code) : 7322190000 pour l'Allemagne. Vous avez également les informations complémentaires suivantes : le status à l'importation, la version du code et la désignation du code

Vous pouvez calculer les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

Si le HSCode trouvé n'est pas le bon, cliquez sur Le HS Code n'est pas bon?

Une fenêtre s'ouvre et vous pouvez renseigner le HSCode que vous auriez mis à la place :

Classifier un produit HSCode (import) - BtoC

Classifier un produit HSCode (import) - BtoC

Si vous souhaitez obtenir le HSCode d'un produit BtoC, il suffit simplement d'entrer le nom de produit dans le champ PRODUIT, sélectionner le PAYS DE DESTINATION puis cliquer sur le bouton "RECHERCHER" pour classifier votre produit

Prenons l'exemple d'un Aspirateur à destination l'Allemagne

Vous obtenez ensuite le résultat de votre produit classifié en code douanier (HS Code) : 8508600000 pour l'Allemagne. Vous avez également les informations complémentaires suivantes : le status à l'importation, la version du code et la désignation du code

Vous avez la possibilité de copier le HSCode et/ou l'exporter en format .CSV

Vous pouvez calculer directement les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

Si le HSCode trouvé n'est pas le bon, c'est simple ! Cliquez sur Le HS Code n'est pas bon? :

Une nouvelle fenêtre apparaîtra et vous pouvez renseigner le HSCode que vous auriez mis à la place :

Classifier un produit HSCode (import) - BtoB

Classifier un produit HSCode (import) - BtoB

Si vous souhaitez obtenir le HSCode d'un produit BtoB, il suffit simplement d'entrer le nom de produit dans le champ PRODUIT, sélectionner le PAYS DE DESTINATION puis cliquer sur le bouton "RECHERCHER" pour classifier votre produit

Prenons l'exemple d'un Réfrigérateur à destination de la Belgique :

Vous obtenez ensuite le résultat de votre produit classifié en code douanier (HS Code) : 8418999099 pour la Belgique. Vous avez également les informations complémentaires suivantes : le status à l'importation, la version du code et la désignation du code

Vous avez la possibilité de copier le HSCode et/ou l'exporter en format .CSV

Vous pouvez calculer directement les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

Si le HSCode trouvé n'est pas le bon, c'est simple ! Cliquez sur Le HS Code n'est pas bon? :

Une nouvelle fenêtre apparaîtra et vous pouvez renseigner le HSCode que vous auriez mis à la place :

Transformer un HSCode en HSCode d'un autre pays

Transformer un HSCode en HSCode d'un autre pays

Si vous souhaitez transformer un code douanier en HSCode d'un autre pays, entrez simplement le HSCode et le pays d'origines, saisissez le pays de destination et appuyez sur Rechercher pour obtenir votre résultat

Vous obtenez ensuite le résultat de votre produit classifié en code douanier du pays de destination (HS Code) : 84189900 pour Hong Kong. Vous avez également les informations complémentaires suivantes : le status à l'importation, la version du code et la désignation du code

Vous avez la possibilité de copier le HSCode et/ou l'exporter en format .CSV

Vous pouvez calculer directement les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

Par code à barres

Par code à barres

Pour classifier un produit en HSCode à partir d'un code à barres, remplissez le champ PRODUIT avec un code à barres.

Prenons l'exemple suivant :

PRODUIT : BASKT-XYZ-BLN-41

PAYS DE DESTINATION : FRANCE

Cliquez ensuite sur le bouton Rechercher :

Obtenez votre HSCode pour la France : 640411000. Vous avez également les informations complémentaires suivantes : statut à l'importation, version du code, désignation du code et taux de CO2 :

Si le HSCode trouvé n'est pas le bon, cliquez sur Le HS Code n'est pas bon? :

Une fenêtre s'ouvre et vous pouvez renseigner le HSCode que vous auriez mis à la place :

Vous pouvez copier et/ou exporter le résultat en fichier CSV :

Vous pouvez calculer les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Par SKU

Par SKU

Pour classifier un produit en HSCode à partir d'un SKU, il faut au préalable associer un SKU à chacun de vos produits dans MON CATALOGUE :

Prenons l'exemple de ce rouge à lèvres. Le SKU de ce produit est 009-3-1 :

Dans AI CLASSIFY, dans le champ PRODUIT, entrez 009-3-1. Ensuite, choisissez un PAYS DE DESTINATION. Prenons ici la Chine comme destination :

Ensuite, cliquez sur le bouton Rechercher :

Vous obtenez le HSCode suivant : 3304100093 pour la Chine. Vous avez également les informations complémentaires suivantes : le status à l'importation, la version du code, la désignation du code, et le taux de CO2 :

Vous pouvez copier le HSCode et/ou l'exporter en format CSV :

Vous pouvez calculer les droits de douane et taxe liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

.MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Transformer un HSCode en HSCode d'un autre pays

Transformer un HSCode en HSCode d'un autre pays

Pour classifier un produit en HSCode à partir HSCode, remplissez le HSCODE D'ORIGINE, le PAYS D'ORIGINE et le PAYS DE DESTINATION :

Prenons comme exemple le HSCode d'origine suivant : 61091000. Il s'agit d'un t-shirt en coton.

Pays d'origine : Suisse

Pays de destination : France

Ensuite, cliquez sur le bouton Rechercher :

Vous obtenez votre HSCode : 6109100010 pour la France, ainsi que les informations complémentaire suivantes : statut à l'importation de votre produit, version de code, désignation du code, taux de CO2 :

Vous pouvez copier le HSCode et/ou l'exporter en format CSV :

Vous pouvez calculer les droits de douane et taxes liés à l'importation de votre produit en cliquant sur le bouton Calculer les droits et taxes :

Exemple du CSV sous format d'un tableau :

codenamelangcountryhs_versionhs_codedesignationstatut
610910001061091000frFRAHS176109100010chapter_designation : Articles of apparel and clothing accessories, knitted or crocheted -- heading_designation : T-shirts, singlets and other vests, knitted or crocheted. -- subheading_designation : T-shirts, singlets and other vests of cotton, knitted or crocheted -- national_designation : T-shirts, singlets and other vests of cotton, knitted or crocheted : t-shirtsAutorisé à l'importation dans ce pays

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Classifier en masse vos produits grâce au fichier CSV

Classifier en masse vos produits grâce au fichier CSV

Pour la recherche par importation CSV, vous pouvez télécharger le modèle de fichier CSV en bas à gauche, puis le remplir :

Un exemple de comment remplir le fichier CSV vous ai donné pour une recherche d'HSCode à partir d'HSCode :

Si vous souhaitez faire une recherche à partir d'un titre ou d'une description produit, votre fichier CSV doit respecter le format suivant :

Déposez votre fichier CSV ou cliquez dans l'encadré gris pour ouvrir vos fichiers dans la zone dédiée. Notez que vous pouvez classifier un maximum de 100 produits par 100 produits :

Cliquez ensuite sur le bouton Rechercher :

Un fichier CSV contenant vos HSCode se télécharge automatiquement :

Vous recevrez vos HSCode sous ce format de réponse :

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Exporter le résultat d'une classification

Exporter le résultat d'une classification

Pour exporter le résultat de votre classification en HSCode, cliquez sur Exportez en .csv :

Un fichier contenant le résultat de votre recherche se télécharge automatiquement :

Exemple du résultat de cette classification en HSCode une fois exportée en fichier CSV :

Classifier un produit en code ONU

Classifier un produit en code ONU

Pour reconnaître les codes ONU des différentes marchandises, saisissez le type du produit et le pays de destination puis appuyer sur rechercher pour obtenir les résultats en une fraction de seconde

Vous obtenez ensuite le code ONU du produit en question : 1263 pour "peinture"

Vous avez la possibilité de copier le code ONU et/ou l'exporter en format .CSV

Calculer l'empreinte carbone d'un produit

Calculer l'empreinte carbone d'un produit

Avant de commencer votre calcul d'empreinte carbone, choisissez le type de recherche que vous souhaitez. Vous pouvez faire une recherche à partir d'un titre ou description, à partir d'un HSCode, d'un SKU ou alors à partir d'une catégorie.

Pour mesurer l'empreinte carbone d'un produit, précisez le type de produit, son pays de destination, son poids et unité puis appuyez sur “Rechercher” et apprenez plus sur vos émissions CO2

Vous obtenez ensuite le taux de rejet de CO2 pour votre produit : 720Kg pour "Télévision" à destination de "Danemark"

Vous avez la possibilité de copier le code ONU et/ou l'exporter en format .CSV

Customs Docs - en cours

Customs Docs - en cours

Quoter

Quoter

Avant de calculer les droits de douane et taxe de votre produit, notez qu’il est essentiel de connaître le code douanier (HS Code) de votre produit ou alors avoir rattaché votre produit à un SKU dans votre catalogue. Si vous ne connaissez pas le HS Code de votre produit, rendez-vous sur notre outil AI CLASSIFY afin de classifier votre produit en code douanier (https://www.app.transiteo.io/#/hsCodeFinder/import).

Pour calculer les droits de douanes et taxes de votre produit, cliquez sur QUOTER :

Video Explainer

https://youtu.be/EIK_4uF_0Ss

Calculer les droits et taxes d'une commande, d'un produit ou d'un colis

Calculer les droits et taxes d'une commande, d'un produit ou d'un colis

Pour effectuer votre calcul, commencez par choisir un PAYS D'EXPÉDITION et un PAYS DE DESTINATION :

Prenons l'exemples suivant :

PAYS D'EXPÉDITION : France

PAYS DE DESTINATION : l'Australie

Ensuite, pour votre recherche, vous avez deux possibilités.

1) Par type SKU : il faut remplir dans PRODUIT un SKU rattaché à un produit de votre catalogue :

2) Par HSCode : il faut remplir dans PRODUIT le HSCode de votre produit :

Remplissez ensuite le reste des informations qui vous sont demandées :

Notez que vous pouvez ajouter un ou des produits :

Vous arrivez ensuite sur la page concernant le transporteur :

1) Si vous ne connaissez pas votre transporteur, cliquez sur le bouton Transporteur connu pour retirer ce champ, et remplissez les informations demandées :

Notez qu'il faut choisir sur quoi s'applique les frais de transport : sur tout, sur le prix du produit, sur le prix d'envoi du produit :

2) Si vous connaissez votre transporteur, remplissez les champs demandés :

Ensuite, vous avez le choix en 4 types de transactions : CtoC, CtoB, BtoB et BtoC. Sélectionnez le type de transaction de votre choix et remplissez les informations demandées :

  • CtoC : ici, aucune information n'est à remplir :

  • CtoB : ici, il faut sélectionner l'activité professionnelle du destinataire :

  • BtoB : ici, il faut remplir le chiffre d'affaire de l'expéditeur dans le pays de destination et la devise, et sélectionner l'activité professionnelle du destinataire :

  • BtoC : ici, il faut renseigner le chiffre d'affaire de l'expéditeur dans le pays de destination et la devise :

Vous obtenez ainsi votre calcul de droits de douane et taxes. Vous avez le détail du calcul : une partie concernant le calcul pour les droits de douane et une partie pour le calcul des taxes (TVA, VAT, GST, IVA, etc). Vous avez également une information concernant le status du produit, c'est-à-dire s'il est autorisé, restreint ou interdit dans le pays de destination ainsi que le traité qui est appliqué entre le pays d'expedition et le pays de destination :

Vous pouvez exporter le résultat en cliquant sur le bouton EXPORTER EN .CSV :

Vous pouvez lancer une nouvelle recherche en cliquant sur le bouton NOUVELLE RECHERCHE :

BtoC

BtoC

Pour une rechercher BtoC, vous pouvez classifier un produit en HSCode à partir d'un HSCode ou d'un SKU.

Par HSCode

Par HSCode

Pour faire un calcul de droits de douane et de taxe à partir d'un HSCode pour une vente en BtoC, commencez par remplir le PAYS DE D'EXPORTATION et le PAYS DE DESTINATION, puis cliquez sur bouton Suivant :

Remplissez dans PRODUIT le HSCode de votre produit, le PRIX UNITAIRE HT, la DEVISE, la QUANTITÉ et le PAYS D'ORIGINE, puis cliquez sur le bouton Suivant :

Si vous ne connaissez pas votre transporteur, cliquez sur le bouton Transporteur connu. Si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article.

Ici, les frais de livraison sont différents par article et le transporteur est inconnu.

Ensuite, remplissez le TARIF D'EXPÉDITION, la DEVISE, le TYPE DE FRAIS, les FRAIS DE DOSSIER, la DEVISE, et sélectionnez sur quoi les frais de livraison s'appliquent : sur tout, sur le prix du produit, ou sur le prix d'envoi du produit, puis cliquez sur le bouton Suivant :

Si vous connaissez votre transporteur et si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article.

Ici, les frais de transports sont différents par article et le transporteur est connu.

Remplissez le TARIF D'EXPÉDITION, la DEVISE et le TRANSPORTEUR, puis cliquez sur le bouton Suivant :

Pour une vente en BtoC, renseignez le CHIFFRE D'AFFAIRE DE L'EXPÉDITEUR DANS LE PAYS DE DESTINATION, la DEVISE, puis cliquez sur le bouton Suivant :

Vous obtenez ainsi votre calcul de droits de douane et taxes. Vous avez le détail du calcul : une partie concernant le calcul pour les droits de douane et une partie pour le calcul des taxes (TVA, VAT, GST, IVA, etc). Vous avez également une information concernant le status du produit, c'est-à-dire s'il est autorisé, restreint ou interdit dans le pays de destination ainsi que le traité qui est appliqué entre le pays d'expedition et le pays de destination :

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Par SKU

Par SKU

Avant de pouvoir faire votre calcul de droits de douane et de taxe, assurez-vous que votre produit est rattaché à un SKU dans MON CATALOGUE :

Pour faire un calcul de droits de douane et de taxes à partir d'un SKU pour une vente en BtoC, commencez par remplir le PAYS DE D'EXPORTATION et le PAYS DE DESTINATION, puis cliquez sur bouton Suivant :

Remplissez dans PRODUIT le SKU rattaché à votre produit dans votre catalogue, puis le PRIX UNITAIRE HT, la DEVISE, la QUANTITÉ et le PAYS D'ORIGINE de votre produit, puis cliquez sur le bouton Suivant :

Si vous ne connaissez pas votre transporteur, cliquez sur le bouton Transporteur connu. Si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article. Ensuite, remplissez le TARIF D'EXPÉDITION, la DEVISE, le TYPE DE FRAIS, les FRAIS DE DOSSIER, la DEVISE, et sélectionnez sur quoi les frais de livraison s'appliquent : sur tout, sur le prix du produit, ou sur le prix d'envoi du produit, puis cliquez sur le bouton Suivant :

Si vous connaissez votre transporteur et si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article. Remplissez le TARIF D'EXPÉDITION, la DEVISE et le TRANSPORTEUR, puis cliquez sur le bouton Suivant :

Pour une vente en BtoC, renseignez le CHIFFRE D'AFFAIRE DE L'EXPÉDITEUR DANS LE PAYS DE DESTINATION, la DEVISE, puis cliquez sur le bouton Suivant :

Vous obtenez ainsi votre calcul de droits de douane et taxes. Vous avez le détail du calcul : une partie concernant le calcul pour les droits de douane et une partie pour le calcul des taxes (TVA, VAT, GST, IVA, etc). Vous avez également une information concernant le status du produit, c'est-à-dire s'il est autorisé, restreint ou interdit dans le pays de destination ainsi que le traité qui est appliqué entre le pays d'expedition et le pays de destination :

MESSAGES D'ERREURS

Sorry, we did not find the data you are trying to retrieve

Si vous recevez ce message, c'est que le SKU renseigné ne correspond à aucun produit de votre catalogue.

Solution :

Renseignez un SKU rattaché à un produit de votre catalogue.

Dans notre catalogue, le SKU rattaché à la télévision est le suivant : 1001-43-34

Il faut donc renseigner le même SKU si l'on souhaite faire un calcul de droits de douane et de taxe pour une télévision :

------------------------------

Solution :

------------------------------

BtoB

BtoB

Pour une rechercher BtoB, vous pouvez classifier un produit en HSCode à partir d'un HSCode ou d'un SKU.

Par HSCode

Par HSCode

Pour faire un calcul de droits de douane et de taxes à partir d'un HSCode pour une vente en BtoB, commencez par remplir le PAYS DE D'EXPORTATION et le PAYS DE DESTINATION, puis cliquez sur bouton Suivant :

Remplissez dans PRODUIT le HSCode de votre produit, le PRIX UNITAIRE HT, la DEVISE, la QUANTITÉ et le PAYS D'ORIGINE, puis cliquez sur le bouton Suivant :

Si vous ne connaissez pas votre transporteur, cliquez sur le bouton Transporteur connu. Si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article.

Si vous connaissez votre transporteur et si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article. Remplissez le TARIF D'EXPÉDITION, la DEVISE et le TRANSPORTEUR, puis cliquez sur le bouton Suivant :

Pour une vente en BtoB, renseignez le CHIFFRE D'AFFAIRE DE L'EXPÉDITEUR DANS LE PAYS DE DESTINATION, la DEVISE, l'ACTIVITÉ PROFESSIONNELLE DU DESTINATAIRE, puis cliquez sur le bouton Suivant :

Vous obtenez ainsi votre calcul de droits de douane et de taxes. Vous avez le détail du calcul : une partie concernant le calcul pour les droits de douane et une partie pour le calcul des taxes (TVA, VAT, GST, IVA, etc). Vous avez également une information concernant le status du produit, c'est-à-dire s'il est autorisé, restreint ou interdit dans le pays de destination ainsi que le traité qui est appliqué entre le pays d'expedition et le pays de destination :

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Par SKU

Par SKU

Avant de pouvoir faire votre calcul de droits de douane et de taxes, assurez-vous que votre produit soit rattaché à un SKU dans MON CATALOGUE :

Pour faire un calcul de droits de douane et de taxes à partir d'un SKU pour une vente en BtoB, commencez par remplir le PAYS DE D'EXPORTATION et le PAYS DE DESTINATION, puis cliquez sur bouton Suivant :

Remplissez dans PRODUIT le SKU rattaché à votre produit dans votre catalogue, puis le PRIX UNITAIRE HT, la DEVISE, la QUANTITÉ et le PAYS D'ORIGINE, puis cliquez sur le bouton Suivant :

Si vous ne connaissez pas votre transporteur, cliquez sur le bouton Transporteur connu. Si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article. Remplissez le TARIF D'EXPÉDITION, la DEVISE, le TYPE DE FRAIS, les FRAIS DE DOSSIER, la DEVISE, et sélectionnez sur quoi les frais de livraison s'appliquent : sur tout, sur le prix du produit, ou sur le prix d'envoi du produit, puis cliquez sur le bouton Suivant :

Si vous connaissez votre transporteur et si les frais de livraison ne sont pas différents par article, cliquez sur le bouton Frais de livraison différents / article. Remplissez le TARIF D'EXPÉDITION, la DEVISE et le TRANSPORTEUR, puis cliquez sur le bouton Suivant :

Pour une vente en BtoB, renseignez le CHIFFRE D'AFFAIRE DE L'EXPÉDITEUR DANS LE PAYS DE DESTINATION, la DEVISE, l'ACTIVITÉ PROFESSIONNELLE DU DESTINATAIRE, puis cliquez sur le bouton Suivant :

Vous obtenez ainsi votre calcul de droits de douane et taxes. Vous avez le détail du calcul : une partie concernant le calcul pour les droits de douane et une partie pour le calcul des taxes (TVA, VAT, GST, IVA, etc). Vous avez également une information concernant le status du produit, c'est-à-dire s'il est autorisé, restreint ou interdit dans le pays de destination ainsi que le traité qui est appliqué entre le pays d'expedition et le pays de destination :

MESSAGES D'ERREURS

Sorry, we did not find the data you are trying to retrieve

Si vous recevez ce message, c'est que le SKU renseigné ne correspond à aucun produit de votre catalogue.

Solution :

Renseignez un SKU rattaché à un produit de votre catalogue.

Dans notre catalogue, le SKU rattaché à la télévision est le suivant : 1001-43-34

Il faut donc renseigner le même SKU si l'on souhaite faire un calcul de droits de douane et de taxe pour une télévision :

------------------------------

Solution :

------------------------------

Exporter le résultat

Exporter le résultat

Vous pouvez exporter le résultat en cliquant sur le bouton EXPORTER EN .CSV :

Le fichier CSV se télécharge automatiquement :

Exemple du résultat de ce calcul de droit de douane et de taxes une fois exporté en fichier CSV :

langfrom_countryfrom_districtto_countryto_districtproducts_duty_labelproducts_duty_percentageproducts_duty_product_taxes_amountproducts_duty_shipping_taxes_amountproducts_vat_labelproducts_vat_percentageproducts_vat_product_taxes_amountproducts_vat_shipping_taxes_amountproducts_special_taxes_labelproducts_special_taxes_percentageproducts_special_taxes_product_taxes_amountproducts_special_taxes_shipping_taxes_amountproducts_duty_fees_amountshipment_typeglobal_ship_pricecurrency_global_ship_pricesender_prosender_revenue_country_annualsender_currency_revenue_country_annualreceiver_proreceiver_activity_idtransport_typetransport_idproducts_valueproducts_transport_typeproducts_transport_idproducts_weightproducts_weight_unitproducts_quantityproducts_unit_priceproducts_currency_unit_priceproducts_unit_ship_priceproducts_currency_unit_ship_priceproducts_unitproducts_unit_typesproducts_origin_countryshipping_global_duty_labelshipping_global_duty_amountshipping_global_vat_labelshipping_global_vat_amountshipping_global_special_taxes_labelshipping_global_special_taxes_amountduty_fees_global_amountglobal_amount
frFRAAUSduty5458.2GST109016.40000ARTICLEtrue890000EURfalse852872001kg1900EUR164EUR
C'est la langue dans laquelle vous avez effectué votre calcul de droits de douane et de taxesC'est le pays d'expédition C'est le district d'expédition (obligatoire pour USA et CAN)C'est le pays de destinationC'est le district de destination (obligatoire pour USA et CAN)Pourcentage de droits de douaneMontant de droits de douane pour le/les produits

Tax Manager

Tax Manager

Détail du tableau

Détail du tableau

Champs du tableau et ses explications :

PAYSSTATUTCHIFFRE D'AFFAIRE 2020CHIFFRE D'AFFAIRE 2021CHIFFRE D'AFFAIRE 2022DEVISE C.AN°FISCAL - TAXESN°EORIPAYS D'ENREGISTREMENTRÈGLE UK
Vous trouvez ici le nom du pays dans votre langue ainsi que le code iso 3C'est le statut du paysC'est votre chiffe d'affaire de l'année 2022C'est votre chiffe d'affaire de l'année 2022C'est votre chiffe d'affaire de l'année 2022C'est la devise en format ISO Alpha 3C'est votre numéro fiscal de référence, composé de 13 chiffresC'est votre numéro EORI avec lequel vous êtes enregistré C'est le pays dans lequel votre société est enregistrée S'il y a une règle spécifique au Royaume-Uni
Argentine (ARG), Inde (IND), etc. Actif, InactifXXXXXXXXXXXXXXXXXXXXXEUR, USD, CADXX XX XXX XXX XXXFR + SIRETFRA, GBR, CHNOui, Non


Ajouter un pays

Ajouter un pays

Pour ajouter un pays, cliquez sur Ajouter un pays, en haut de votre liste de pays :

Les pays ne faisant pas partie de votre liste de pays vous seront proposés. Cliquez sur les pays que vous souhaitez ajouter, ils seront automatiquement ajouter à votre liste de pays :

Importer des infos pays

Importer des infos pays

Téléchargez le modèle de fichier CSV

Vue du CSV sous forme de tableau avec noms et correspondances des champs :

iso3_countrystatutcurrencytax_idannual_revenue_2020annual_revenue_2021annual_revenue_2022eoriuk_ruleorigin_tax
PaysStatutDeviseNuméro fiscal de référence Chiffre d'affaire en 2020Chiffre d'affaire en 2021Chiffre d'affaire en 2022Numéro EORIRègle UKPays d'enregistrement
C'est le code ISO 2 ou 3 du paysC'est le statut du pays C'est la devise du pays C'est votre numéro d'identification fiscal C'est votre chiffre d'affaire en 2020C'est votre chiffre d'affaire en 2021C'est votre chiffre d'affaire en 2022C'est votre numéro EORIS'il y a une règle spécifique au Royaume-UniC'est le pays d'enregistrement de votre société
BEL, CHN, FRAtrue, falseEUR, CAD, JPYXX XX XXX XXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXFR + SIRETtrue, falseFRA, BEL, ARE, etc

Les colonnes obligatoires à remplir :

  • iso3_country
  • statut
  • currency
  • annual_revenue_2020
  • annual_revenue_2021
  • annual_revenue_2022
  • origin_tax

Les colonnes non obligatoires à remplir :

  • tax_id
  • eori
  • uk_rule

FORMAT DES DONNÉES ET MESSAGES D'ERREURS

ChampsFormatExempleMessage d'erreur
iso3_countryCode ISO Alpha 3FRA, CAN, USALine XXXXXX : iso3_country doit être un pays au format ISO3
statutChaine de caractère libretrue, falseLine XXXXXX : statut doit être true ou false
currencyCode ISO Alpha 3EUR, CAD, USDLine XXXXXX : currency doit être une devise au format ISO 4217
annual_revenue_2020Nombre décimal150200, 378875.68, 1230089Line XXXXXX : annual_revenue_2020 doit être un nombre
annual_revenue_2021Nombre décimal150200, 378875.68, 1230089Line XXXXXX : annual_revenue_2021 doit être un nombre
annual_revenue_2022Nombre décimal150200, 378875.68, 1230089Line XXXXXX : annual_revenue_2022 doit être un nombre
origin_taxCode ISO Alpha 3FRA, CAN, USAINCORRECT_JSON : Incorrect Json Request. Details : origin_tax : origin_tax should be ISO3

Modifier les infos d'un pays

Modifier les infos d'un pays

Pour modifier les informations d'un pays, cliquez sur l'icône de modification à l'extrémité droite de la ligne du pays concerné :

Une fenêtre s'ouvre avec l'ensemble des informations, que vous pouvez modifier. Les champs signalés d'un astérisque rouge sont obligatoires, sinon vous ne pourrez pas valider vos informations :

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquer sur le bouton Valider, c'est que vous n'avez pas rempli tous les champs obligatoires.

Solution :

Remplissez les champs signalés par un astérisque rouge.

------------------------------

Solution :

------------------------------

Exporter ses infos pays

Exporter ses infos pays

Pour exporter ses informations pays, sélectionnez parmi votre liste de pays les pays de votre choix :

Cliquez sur bouton Exporter (CSV) :

Veillez à ce que votre fichier CSV se soit bien téléchargé :

Format du fichier CSV d'export :

iso3_countrystatutcurrencytax_iduk_ruleseoriorigin_taxannual_revenue_2020annual_revenue_2021annual_revenue_2022
C'est le format ISO 3 du paysC'est le statut du pays (actif ou non)C'est la deviseC'est votre numéro fiscal de référence S'il y a une règle spécifique du C'est votre numéro EORIC'est le pays d'enregistrement de votre société C'est votre chiffre d'affaire en 2020C'est votre chiffre d'affaire en 2021C'est votre chiffre d'affaire en 2022
CHE, FRA, USA, ...true, false EUR, CAN, USDXX XX XXX XXX XXXfalse, trueFR + SIRETCHE, FRA, USA, ...XXXXXXXXXXXXXXXXX

Figer une colonne

Figer une colonne

Vous pouvez figer des volets pour verrouiller des colonnes spécifiques dans votre tableau. Il suffit d'appuyer sur l'icône de punaise puis choisir la colonne que vous souhaitez épingler avant de cliquer sur "valider"

Dans ce cas, vous pourrez parcourir le tableau tout en gardant, visible à l'écran, la colonne portant les noms des produits :

Welcome

Welcome

  • Vous pouvez ici enregistrer le type de produit par défaut de votre catalogue produit.

La liste des différentes catégories : Animalerie, Auto & Moto, Bagages, Beauté et Parfum, Bijoux, Bricolage, Bébé & Puériculture, CD & Vinyles, Chaussures & Sacs, Commerce, Industrie & Science, Cuisine & Maison, DVD & Blu-ray, Fournitures de bureau, Gros électroménager, High-Tech, Hygiène & Santé, Informatique, Instruments de musique & Sono, Jardin, Jeux & Jouets, Jeux vidéos, Livres, Luminaires & Eclairage, Montres, Produits Handmade, Sports & Loisir, Vêtements, Bio, Viandes & Poissons, Fruits & Légumes frais, Pains & Pâtisseries, Produits Frais, Surgelés, Epicerie salée, Epicerie sucrée, Boissons, Alimentation bébé

Modifier ses infos produit par défaut

Modifier ses infos produit par défaut

Pour modifier vos informations produits par défaut, cliquez sur WELCOME (https://www.app.transiteo.io/#/settings-welcome) :

Vous pouvez renseigner vos informations par défaut, puis cliquez sur le bouton Enregistrer pour sauvegarder les paramètres que vous avez renseignées :

Les différents champs sont les suivants :

  • CATÉGORIES

La liste des différentes catégories : Animalerie, Auto & Moto, Bagages, Beauté et Parfum, Bijoux, Bricolage, Bébé & Puériculture, CD & Vinyles, Chaussures & Sacs, Commerce, Industrie & Science, Cuisine & Maison, DVD & Blu-ray, Fournitures de bureau, Gros électroménager, High-Tech, Hygiène & Santé, Informatique, Instruments de musique & Sono, Jardin, Jeux & Jouets, Jeux vidéos, Livres, Luminaires & Eclairage, Montres, Produits Handmade, Sports & Loisir, Vêtements, Bio, Viandes & Poissons, Fruits & Légumes frais, Pains & Pâtisseries, Produits Frais, Surgelés, Epicerie salée, Epicerie sucrée, Boissons, Alimentation bébé

  • DESCRIPTION

C'est la description de votre produit.

  • HSCODE PAR DÉFAUT

Si vous ne connaissez pas le HSCode de votre produit, rendez-vous sur AI CLASSIFY pour classifier votre produit en en HSCode.

  • PAYS D'ORIGINE

C'est le pays où vos produits sont fabriqués / transformés en dernier.

MESSAGES D'ERREURS

Si vous n'arrivez pas à cliquer sur le bouton Enregistrer, c'est que vous n'avez pas renseigner l'ensemble des informations demandées.

Solution :

Veillez à avoir sélectionner et renseigner l'ensemble des informations.

------------------------------

Solution :

------------------------------

Récupérer sa clef API Widget

Récupérer sa clef API Widget

Pour récupérer votre clef API Widget, rendez-vous dans la partie Sécurité, en bas de vos Paramètres Transiteo Welcome :

Cliquez sur Copier pour copier votre clef :

MENU - PARAMETERS

Paramètres

Paramètres

  • Une fois arrivé.e sur la page des paramètres, vous retrouvez l’ensemble des informations vous concernant et vous pouvez modifier ces informations. Pour enregistrer, descendez en bas de page et cliquez sur le bouton Enregistrer pour être sûr que toutes les modifications que vous avez effectuées soient bien enregistrées :

Plan

Plan

Utilisation par API

Pour avoir accès aux informations relatives au plan que vous avez, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous pouvez voir les diverses informations concernant le plan dont vous bénéficiez :

  • Type de plan
  • Type de paiement
  • Professionel
  • Méthode d'intégration

Utilisation pour E-Commerce

Pour avoir accès aux informations relatives au plan que vous avez, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous pouvez voir les diverses informations concernant le plan dont vous bénéficiez :

  • Type de plan
  • Type de paiement
  • Professionel
  • Méthode d'intégration

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Information utilisateur

Information utilisateur

Utilisation par API

Pour accéder à vos informations utilisateur, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouvez ici l'ensemble de vos informations utilisateurs :

  • Civilité
  • Prénom
  • Nom
  • Signature
  • Mail
  • Téléphone

Utilisation pour E-Commerce

Pour accéder à vos informations utilisateur, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouvez ici l'ensemble de vos informations utilisateurs :

  • Civilité
  • Prénom
  • Nom
  • Signature
  • Mail
  • Téléphone

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Boutique (CMS)

Boutique (CMS)

Pour accéder à vos informations boutique, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouverez ici l'ensemble de vos informations sur votre boutique en ligne :

  • URL
  • Nom de la marque
  • Logo du vendeur
  • Info service client
  • Termes de vente
  • Autre infos vendeur

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Expéditions (CMS)

Expéditions (CMS)

Pour accéder à vos informations d'expédition, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouverez ici l'ensemble de vos informations sur vos expéditions :

  • Raison sociale
  • SIRET
  • Adresse
  • Code postal
  • Ville
  • État / Région
  • Pays de départ
  • Aéroport de chargement
  • Incoterm
  • Conditions de retour

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Business (API/WEB APP)

Business (API/WEB APP)

Vous trouverez ici l'ensemble des informations de votre entreprise :

  • Raison sociale
  • SIRET
  • URL
  • Nom de la marque
  • Logo du vendeur
  • Adresse
  • Code postal
  • Ville
  • État / Région
  • Pays de départ
  • Info service client
  • Termes de vente
  • Autre infos vendeur
  • Aéroport de chargement
  • Incoterm
  • Conditions de retour

Produits

Produits

Pour accéder à vos informations produits, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouverez ici l'ensemble de vos informations sur vos produits :

  • Catégories : C'est la catégorie de vos produits
  • Description : C'est la description de votre produits
  • HSCode par défaut : C'est le code douanier par défaut qui sera appliqué pour tous vos produits
  • Pays d'origine : C'est le pays où vos produits sont fabriqués / transformés à la dernière étape

MESSAGES D'ERREURS

Solution :

------------------------------

Solution :

------------------------------

Transporteurs (CMS)

Transporteurs (CMS)

Pour accéder à vos informations transporteurs, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Vous trouverez ici l'ensemble de vos informations sur vos transporteurs (FedEx, DHL, UPS, etc) :

Factures

Factures

Cliquez ici pour être redirigé.e vers les explications concernant la page Mes Factures.

Crédits

Crédits

Essai gratuit

Pour pouvoir recharger ses crédits, il faut d'abord passer sur un compte premium en adhérant à l'un des plans. Vous pouvez consulter nos formules payantes en cliquant sur Devenir Premium dans le bloc en bas à gauche de votre menu :

Vous serez redirigé.e vers nos différentes formules. Si vous voulez en savoir plus sur chacune de nos formules, cliquez ici.

Si vous souhaitez par exemple choisir la formule API, veillez à la sélectionner en cliquant sur le bouton Choisir pour valider votre demande. Ensuite, dans le bloc Consommation, sélectionnez le nombre de crédit dont vous avez besoin par services et cliquez sur le bouton Choisir pour valider votre demande :

Vous pouvez convertir les prix dans plusieurs devises :

Cochez la case sous les différents blocs des formules pour accepter nos conditions générales de vente :

Ensuite, cliquez sur le bouton Payer :

Vous êtes redirigé.e vers notre portail de paiement sécurisé, avec le détail des crédits que vous souhaitez acheter :

Utilisation par API

Pour recharger vos crédit, cliquez sur bouton Recharger mes crédits :

Vous serez redirigé.e vers la page de nos différentes formules. Dans le bloc Consommation, à l'extrémité droite, vous pouvez ajuster le curseur sur le nombre de requêtes dont vous avez besoin puis cliquez sur le bouton Choisir :

Les services disponibles sont les suivants :

  • Duty & Taxes Calculation API
  • Rates Date API - Sales Taxes
  • Local Taxes Calculation API
  • Rates Data API - Local Taxes
  • Rates Data API - Duties
  • Rates Data API - Special Taxes
  • HSCode finder API

Pour changer de devise, cliquez sur le champ pour pouvoir modifier la devise :

Cochez la case sous les différents blocs des formules pour accepter nos conditions générales de vente :

Ensuite, cliquez sur le bouton Payer :

Vous êtes redirigé.e vers notre portail de paiement sécurisé, avec le détail des crédits que vous souhaitez acheter :

Utilisation pour E-Commerce

Pour recharger vos crédit, cliquez sur bouton Recharger mes crédits :

Vous serez redirigé.e vers la page de nos différentes formules. Dans le bloc Consommation, à l'extrémité droite, vous pouvez ajuster le curseur sur le nombre de requêtes dont vous avez besoin puis cliquez sur le bouton Choisir :

Le service disponible est le suivant :

Product > HSCode

Pour changer de devise, cliquez sur le champ pour pouvoir modifier la devise :

Cochez la case sous les différents blocs des formules pour accepter nos conditions générales de vente :

Ensuite, cliquez sur le bouton Payer :

Vous êtes redirigé.e vers notre portail de paiement sécurisé, avec le détail des crédits que vous souhaitez acheter :

Surcharge de calcul

Surcharge de calcul

Sécurité

Sécurité

Essai gratuit

En version freemium, vous n'avez pas accès aux identifiants pour se connecter aux modules CMS ou pour utiliser les webs services par APIs. Vous devez choisir une formule payante pour avoir accès à ces informations. Cliquez sur Devenir Premium dans le bloc Choisissez votre formule Premium :

Utilisation par API

Pour accéder à vos identifiants pour utiliser les web services par APIs, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Rendez-vous en bas des paramètres pour accéder aux paramètres de Sécurité :

Les identifiants dont vous disposez sont les suivants :

  • client_id
  • refresh_token
  • id_token

Utilisation pour E-Commerce

Pour accéder à vos identifiants pour connecter vos modules CMS, rendez-vous dans Paramètres (https://www.app.transiteo.io/#/settings) :

Rendez-vous en bas des paramètres pour accéder aux paramètres de Sécurité :

Les identifiants dont vous disposez sont les suivants :

  • client_id
  • refresh_token
  • id_token
  • Widget API Key

Mon Profil

Mon Profil

Lorsque vous vous rendez sur Mon profil, vous êtes automatiquement redirigé.e vers Paramètres.

Mon Historique

Mon Historique

Pour consulter votre historique, cliquer sur Mon compte > Mon historique (https://www.app.transiteo.io/#/history) :

Vous pouvez voir l'ensemble de vos consommations de la journée :

Détail du tableau

Détail du tableau

Pour voir en détail les requêtes que vous avez effectuées, cliquez sur le guillemet à l'extrémité gauche de votre requête :

La requête en détail s'ouvre et vous pouvez visualisez la recherche et la réponse en entier :

Vous avez le détail suivant :

Request BodyResponse Body
{
"product": {
"identification": {
"type": "TEXT",
"value": "Kit blancheur avec dentifrice"
}
},
"to_country": "FRA",
"lang": "fr"
}
{
"result": {
"hs_code": "33069000",
"hs_version": "HS17",
"un_code": [],
"co2_product_kg": 0.85, "designation":
"designation : Essential oils and resinoids; perfumery, cosmetic or toilet preparations -- heading_designation : Preparations for oral or dental hygiene, including denture fixative pastes and powders; yarn used to clean between the teeth (dental floss), in individual retail packages. -- subheading_designation : Preparations for oral or dental hygiene, incl. denture fixative pastes and powders (excl. dentifrices and yarn used to clean between the teeth dental floss")" -- national_designation : Preparations for oral or dental hygiene, incl. denture fixative pastes and powders (excl. dentifrices and yarn used to clean between the teeth "dental floss")",
"splitted_designation": {
"chapter_designation": "Essential oils and resinoids; perfumery, cosmetic or toilet
preparations",
"heading_designation": "Preparations for oral or dental hygiene, including denture fixative pastes and powders; yarn used to clean between the teeth (dental floss), in individual retail packages.",
"subheading_designation": "Preparations for oral or dental hygiene, incl. denture fixative pastes and powders (excl. dentifrices and yarn used to clean between the teeth dental floss")"",
"national_designation": "Preparations for oral or dental hygiene, incl. denture fixative pastes and powders (excl. dentifrices and yarn used to clean between the teeth "dental floss")"
}
}, "timestamp": 1645006708619
}

Exporter votre historique

Exporter votre historique

Pour exporter votre historique de recherche, cliquez sur le bouton Exporter en .csv :

Un fichier se télécharge automatiquement avec l'ensemble de votre historique de requêtes de la journée :

Format du fichier CSV d'historique de recherche :

requestEndpointtimestamprequest_productrequest_to_countryrequest_hsCodeFinderSearchrequest_langnb_productsresponse_resultresponse_timestamprequest_from_countryrequest_to_districtrequest_productsrequest_shipment_typerequest_senderrequest_receiverresponse_productsresponse_shipping_globalresponse_packaging_globalresponse_insurance_globalresponse_duty_fees_globalresponse_incotermresponse_global
/v1/taxsrv/hscodefinder1644922812176{"identification":{"type":"TEXT","value":"table en bois"}}USAfr0{"hs_code":"94036080","hs_version":"HS17","un_code":[],"co2_product_kg":8,"designation":"chapter_designation : Furniture; bedding, mattresses, mattress supports, cushions and similar stuffed furnishings; lamps and lighting fittings, not elsewhere specified or included; illuminated signs, illuminated name- plates and the like; prefabricated buildings -- heading_designation : Other furniture and parts thereof. -- subheading_designation : Wooden furniture (excl. for offices, kitchens and bedrooms, and seats) -- national_designation : Furniture (o/than seats & o/than of 9402) of wooden (o/than bentwood) nesoi","product_statut":"Restreint à l'importation dans ce pays","splitted_designation":{"chapter_designation":"Furniture; bedding, mattresses, mattress supports, cushions and similar stuffed furnishings; lamps and lighting fittings, not elsewhere specified or included; illuminated signs, illuminated name- plates and the like; prefabricated buildings","heading_designation":"Other furniture and parts thereof.","subheading_designation":"Wooden furniture (excl. for offices, kitchens and bedrooms, and seats)","national_designation":"Furniture (o/than seats & o/than of 9402) of wooden (o/than bentwood) nesoi"}}1644922812176
/v1/taxsrv/hscodefinder1644920974715{"identification":{"value":"t-shirt en coton","type":"TEXT"}}GBRTEXTUELfr0{"hs_code":"6109100000","hs_version":"HS17","un_code":[],"co2_product_kg":75,"designation":"chapter_designation : Articles of apparel and clothing accessories, knitted or crocheted -- heading_designation : T-shirts, singlets and other vests, knitted or crocheted. -- subheading_designation : T-shirts, singlets and other vests of cotton, knitted or crocheted -- national_designation : T-shirts, singlets and other vests of cotton, knitted or crocheted","product_statut":"Restreint à l'importation dans ce pays","splitted_designation":{"chapter_designation":"Articles of apparel and clothing accessories, knitted or crocheted","heading_designation":"T-shirts, singlets and other vests, knitted or crocheted.","subheading_designation":"T-shirts, singlets and other vests of cotton, knitted or crocheted","national_designation":"T-shirts, singlets and other vests of cotton, knitted or crocheted"}}1644920974715
/v1/taxsrv/hscodefinder1644919917453{"identification":{"value":"aspirateur","type":"TEXT"}}CHNTEXTUELfr0{"hs_code":"8508190000","hs_version":"HS17","un_code":[],"co2_product_kg":6,"designation":"chapter_designation : Electrical machinery and equipment and parts thereof; sound recorders and reproducers, television image and sound recorders and reproducers, and parts and accessories of such articles -- heading_designation : Vacuum cleaners. -- subheading_designation : Vacuum cleaners, incl. dry cleaners and wet vacuum cleaners, with self-contained electric motor ( excl. of a power <= 1?500?w and having a dust bag or other receptacle capacity <= 20?l) -- national_designation : Vacuum cleaners: with self-contained electric-motor: other vacuum cleaners with self-contained electric motor","product_statut":"Prohibé à l'importation dans ce pays","splitted_designation":{"chapter_designation":"Electrical machinery and equipment and parts thereof; sound recorders and reproducers, television image and sound recorders and reproducers, and parts and accessories of such articles","heading_designation":"Vacuum cleaners.","subheading_designation":"Vacuum cleaners, incl. dry cleaners and wet vacuum cleaners, with self-contained electric motor ( excl. of a power <= 1?500?w and having a dust bag or other receptacle capacity <= 20?l)","national_designation":"Vacuum cleaners: with self-contained electric-motor: other vacuum cleaners with self-contained electric motor"}}1644919917453
/v1/taxsrv/dutyCalculation1644844382422BELfr11644844382422CHN[{"identification":{"type":"HSCODE","value":"8471705000"},"weight":1,"weight_unit":"kg","quantity":10,"unit_price":200,"currency_unit_price":"EUR","unit_ship_price":100,"currency_unit_ship_price":"EUR","transport":{"type":"CARRIER","id":"71"},"unit":null,"origin_country":"CHN"}]ARTICLE{"pro":true,"revenue_country_annual":50000000,"currency_revenue_country_annual":"EUR"}{"pro":true,"activity_id":"4741Z"}[{"identification":{"type":"HSCODE","value":"8471705000"},"product_statut":"Prohibé à l'importation dans ce pays","amount_exclusive":3000,"amount_inclusive_vat":3630,"amount_duty_and_tax":630.5,"amount_ecoTax":0.5,"amount_total":3630.5,"co2":4480.7,"percentage_duty_and_tax":21.02,"duty":{"label":"duty","percentage":0,"product_taxes_amount":0,"shipping_taxes_amount":0,"packaging_taxes_amount":0,"insurance_taxes_amount":0,"message":null,"vat_product_taxes_amount":0,"vat_shipping_taxes_amount":0,"vat_packaging_taxes_amount":0,"vat_insurance_taxes_amount":0,"vat_taxes_amount":0,"agreement":"MFN duties (Applied)"},"duty_fees":null,"special_taxes":[],"vat":[{"label":"VAT","percentage":21,"product_taxes_amount":420,"shipping_taxes_amount":210,"packaging_taxes_amount":0,"insurance_taxes_amount":0,"message":null}]}]{"vat":null,"duty":null,"special_taxes":null}{"vat":null,"duty":null,"special_taxes":null}{"vat":null,"duty":null,"special_taxes":null}CIF{"amount":630.5,"amount_exclusive":3000,"amount_inclusive_vat":3630,"amount_total":3630.5,"amount_duty_and_tax":630.5,"percentage_duty_and_tax":21.02,"amount_ecoTax":0.5,"co2":4480.7}
/v1/taxsrv/dutyCalculation1644841167347AUSfr11644841167347FRA[{"identification":{"type":"HSCODE","value":"85287200"},"weight":1,"weight_unit":"kg","quantity":1,"unit_price":900,"currency_unit_price":"EUR","unit_ship_price":164,"currency_unit_ship_price":"EUR","transport":{"type":"CARRIER","id":"72"},"unit":null,"origin_country":"FRA"}]ARTICLE{"pro":true,"revenue_country_annual":890000,"currency_revenue_country_annual":"EUR"}{"pro":true,"activity_id":"4742Z"}[{"identification":{"type":"HSCODE","value":"85287200"},"product_statut":"Restreint à l'importation dans ce pays","amount_exclusive":1064,"amount_inclusive_vat":1175.72,"amount_duty_and_tax":164.93,"amount_ecoTax":0,"amount_total":1228.92,"percentage_duty_and_tax":15.51,"duty":{"label":"duty","percentage":5,"product_taxes_amount":45,"shipping_taxes_amount":8.2,"packaging_taxes_amount":0,"insurance_taxes_amount":0,"message":null,"vat_product_taxes_amount":4.5,"vat_shipping_taxes_amount":0.82,"vat_packaging_taxes_amount":0,"vat_insurance_taxes_amount":0,"vat_taxes_amount":4.5,"agreement":"MFN duties (Applied)"},"duty_fees":null,"special_taxes":[],"vat":[{"label":"GST","percentage":10,"product_taxes_amount":90,"shipping_taxes_amount":16.4,"packaging_taxes_amount":0,"insurance_taxes_amount":0,"message":null}]}]{"vat":null,"duty":null,"special_taxes":null}{"vat":null,"duty":null,"special_taxes":null}{"vat":null,"duty":null,"special_taxes":null}CIF{"amount":164.92,"amount_exclusive":1064,"amount_inclusive_vat":1175.72,"amount_total":1228.92,"amount_duty_and_tax":164.93,"percentage_duty_and_tax":15.51,"amount_ecoTax":0}

Support

Support

Pour obtenir de l'aide, vous avez deux possibilités :

1) Cliquez sur la bulle en bas à droite de votre écran, pour ouvrir le chat en direct et être mis en relation avec notre équipe :

2) Cliquez sur Continuer dans le bloc Besoin d’aide ? en bas à droite de votre tableau de bord :

Vous serez redirigé.e vers notre guide d'utilisation de l'application :

Documentation

Documentation

Utilisation par API

Pour accéder à la documentation API, vous avez deux possibilités.

1) Cliquez sur API DOCUMENTATION en bas à gauche de votre menu (https://transiteo.gitbook.io/transiteo/) :

Vous êtes redirigé.e vers notre documentation API (https://transiteo.gitbook.io/transiteo/) :

2) Cliquez sur le menu Mon compte > Documentation :

Vous êtes redirigé.e vers notre documentation API (https://transiteo.gitbook.io/transiteo/) :

Formule E-Commerce

Pour accéder à la documentation vous deux options.

1) Cliquez sur PLUGIN à gauche de votre menu :

2) Cliquez sur Mon Compte > Documentation :

Se déconnecter

Se déconnecter

Pour vous déconnecter de l’application transiteo, vous avez deux possibilités.

1) Cliquez en bas à gauche de votre menu, sur Se déconnecter :

2) Cliquez sur Mon compte > Se déconnecter :

Factures

Factures

Essai gratuit

Pour consulter vos factures, cliquez sur Mon compte > Facturation (https://www.app.transiteo.io/#/subscription) :

Vous disposez des informations suivantes :

Utilisation par API

Pour consulter vos factures, cliquez sur Mon compte > Facturation (https://www.app.transiteo.io/#/subscription) :

Vous disposez des informations suivantes :

Utilisation pour E-Commerce

Pour consulter vos factures, cliquez sur Mon compte > Facturation (https://www.app.transiteo.io/#/subscription) :

Vous disposez des informations suivantes :

Formule actuelle

Formule actuelle

Essai gratuit

La formule dont vous bénéficiez est inscrite en violet, à la suite de Votre formule actuelle est :

Utilisation par API

La formule dont vous bénéficiez est inscrite en violet, à la suite de Votre formule actuelle est :

Utilisation pour E-Commerce

La formule dont vous bénéficiez est inscrite en violet, à la suite de Votre formule actuelle est :

Factures

Factures

Essai gratuit

Vous avez ici un visuel de vos factures : leur statut et la possibilité de les télécharger en format PDF :

Utilisation par API

Vous avez ici un visuel de vos factures : leur statut et la possibilité de les télécharger en format PDF :

Utilisation pour E-Commerce

Vous avez ici un visuel de vos factures : leur statut et la possibilité de les télécharger en format PDF :

Changer de formule

Changer de formule

Essai gratuit

Pour changer de formule, cliquez sur le bouton Changer de formule :

Vous êtes redirigé.e vers la page Ma Formule :

Vous avez 3 types de formules :

  • Formule E-commerce
  • Formule API
  • Formule Application Web

Vous avez également le bloc Consommation pour acheter des crédits pour les services que vous souhaitez.

Pour en savoir plus sur nos formules, cliquez ici.

Utilisation par API

Pour changer de formule, cliquez sur le bouton Changer de formule :

Vous êtes redirigé.e vers la page Ma Formule :

Vous avez 3 types de formules :

  • Formule E-commerce
  • Formule API
  • Formule Application Web

Vous avez également le bloc Consommation pour acheter des crédits pour les services que vous souhaitez.

Pour en savoir plus sur nos formules, cliquez ici.

Utilisation pour E-Commerce

Pour changer de formule, cliquez sur le bouton Changer de formule :

Vous êtes redirigé.e vers la page Ma Formule :

Vous avez 3 types de formules :

  • Formule E-commerce
  • Formule API
  • Formule Application Web

Vous avez également le bloc Consommation pour acheter des crédits pour les services que vous souhaitez.

Pour en savoir plus sur nos formules, cliquez ici.

CMS API Documentation

Transiteo - Landed Cost

Transiteo - Landed Cost

{% file src="https://921846278-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MePsCDZ9Wj5hoyowKc7%2F-Mk6leifFN5tZHG69ead%2F-Mk6mmDSwgYfIKldTuOs%2FTransiteo%20CMS.postman_collection.json?alt=media&token=46b6b265-754d-40af-a7e2-9cb7723bed37" %} Collection Postman

Authentication

Auth Token

Auth Token

Get Token

POST https://auth.transiteo.io/oauth2/token

This route returns an id_token needed to authenticate the user for all the "API SYNCHRONIZATION" and "DUTIES & TAXES" routes.

Headers

Name Type Description
Content-Type* string application/x-www-form-urlencoded

Request Body

Name Type Description
grant_type* string refresh_token
refresh_token* string \
client_id* string \

200 Token successfully created.

{
    “id_token”: string,
    “access_token”: string,
    “expires_in”: 3600 (int),
    “token_type”: Bearer (string)
}

API Synchronization

Products

Products

These are the routes you may use in order to synchronize the merchant's product catalog from the CMS to Transiteo's app : https://www.app.transiteo.io/#/productManager.\ The synchronisation is from the CMS to the Transiteo App only, not the other way. You must only pass the required elements in Transiteo App.

Get products

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

This route allows you to get all products related to the user.

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Successfully returned products

[
    {
    "id": "U0tVI1BST0RVQ1QtVEUxNjMyMjA3ODE1", (string)
    "type": "SKU", (string)
    "sku": "PRODUCT-TE1632207815", (string)
    "value": "Product-Test-2", (string)
    "weight": 10, (number)
    "weight_unit": "kg", (string)
    "creationDate": 1632207815420 (timestamp)
    },
    { … }
]

Get product

GET https://api.transiteo.io/v1/customer/products/{productId}

This route allows you to get all informations for a specific product.

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Successfully returned product

{
    "id": "U0tVI1BST0RVQ1QtVEUxNjMyMjA3ODE1", (string)
    "type": "SKU", (string)
    "sku": "PRODUCT-TE1632207815", (string)
    "value": "Product-Test-2", (string)
    "weight": 10, (number)
    "weight_unit": "kg", (string)
    "creationDate": 1632207815420 (timestamp)
}

Create product

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

This route allows you to create a product in Transiteo database.

Headers

Name Type Description
Content-Type* string application/json
Authorization* string \(see Auth Token)>

Request Body

Name Type Description
type* string "SKU"
sku* string \
value* string \
weight* number \
weight_unit* string \
unit_price number \

200 Product successfully created

{
    "id": "U0tVI1BST0RVQ1QtVEUxNjMyMjA3ODE1", (string)
    "type": "SKU", (string)
    "sku": "PRODUCT-TE1632207815", (string)
    "value": "Product-Test-2", (string)
    "weight": 10, (number)
    "weight_unit": "kg", (string)
    "creationDate": 1632207815420 (timestamp)
}

The "SKU" is not required, however if there is none, one will be automatically be created from the product's name.

Example Body

{
    "type": "SKU",
    "sku": "001-1-1",
    "value": "shoes",
    "weight": 2,
    "weight_unit": "kg",
    "unit_price": 140
}

Update product

PUT https://api.transiteo.io/v1/customer/products/{productId}

This route allows you to update a product's informations. Updating product's name or sku is impossible.

Headers

Name Type Description
Content-Type* string application/json
Authorization* string \(see Auth Token)>

Request Body

Name Type Description
type* string "SKU"
sku* string \
value* string \
weight* number \
weight_unit string \
unit_price number \

200 The product's informations successfully updated

{
    "id": "U0tVI1BST0RVQ1QtVEUxNjMyMjA3ODE1", (string)
    "type": "SKU", (string)
    "sku": "PRODUCT-TE1632207815", (string)
    "value": "Product-Test-2", (string)
    "weight": 10, (number)
    "weight_unit": "kg", (string)
    "creationDate": 1632207815420 (timestamp)
}

The "SKU" is not required, however if there is none, one will be automatically be created from the product's name and replace the old one.

Example body

{
    "type": "SKU",
    "sku": "001-1-1",
    "value": "shoes",
    "weight": 2,
    "weight_unit": "kg",
    "unit_price": 140
}

Delete product

DELETE https://api.transiteo.io/v1/customer/products/{productId}

This route allows you to delete a product in Transiteo database.

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Product successfully deleted

{
    "id": "U0tVI1BST0RVQ1QtVEUxNjMyMjA3ODE1", (string)
    "type": "SKU", (string)
    "sku": "PRODUCT-TE1632207815", (string)
    "value": "Product-Test-2", (string)
    "weight": 10, (number)
    "weight_unit": "kg", (string)
    "creationDate": 1632207815420 (timestamp)
}

Products CMS ID

Products CMS ID

These routes have been made to allow you to associate a transiteo product with a CMS product ID. The goal is that you can POST/PUT/DELETE a transiteo product with the id of the cms product's associated by using these routes.

POST : You should create the transiteo product first then create the cms id product with the right sku and id.

PUT/DELETE : first get the "old" sku of the product by using the "Get cms id product" request. Then you can PUT/DELETE the transiteo product by it's "old" sku, and finally (if needed) PUT/DELETE the associated cms id product.

Get cms id products

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

This route allows you to get all the CMS ID products associated to the user.

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Successfully returned CMS ID products

[
    {
        "mail": "clement@transiteo.com",
        "cms_id": "168",
        "cms_name": "BigCommerce",
        "sku": "PRODUCT-TE1632206965"
    },
    { ... }
]

Get cms id product

GET https://api.transiteo.io/v1/customer/productsCms?cmsId={cms_id}&cmsName={cms_name}

This route allows you to get a specific CMS ID product

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Successfully returned CMS ID product

{
    "mail": "clement@transiteo.com",
    "cms_id": "169",
    "cms_name": "BigCommerce",
    "sku": "PRODUCT-TE1632206487"
}

Create cms id product

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

This route allows you to create a CMS ID product

Headers

Name Type Description
Authorization* string \(see Auth Token)>
Content-Type* string application/json

Request Body

Name Type Description
cms_id* string \
cms_name* string \
sku* string \

200 Successfully created CMS ID product

{
    "mail": "clement@transiteo.com",
    "cms_id": "169",
    "cms_name": "BigCommerce",
    "sku": "PRODUCT-TE1632206487"
}

Update cms id product

PUT https://api.transiteo.io/v1/customer/productsCms?cmsId={cms_id}&cmsName={cms_name}

This route allows you to update a CMS ID product

Headers

Name Type Description
Authorization* string \(see Auth Token)>
Content-Type* string application/json

Request Body

Name Type Description
sku* string \

200 Successfully updated CMS ID product

{
    "mail": "clement@transiteo.com",
    "cms_id": "169",
    "cms_name": "BigCommerce",
    "sku": "PRODUCT-TE1632206487"
}

Delete cms id product

DELETE https://api.transiteo.io/v1/customer/productsCms?cmsId={cms_id}&cmsName={cms_name}

This route allows you to delete a CMS ID product

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Successfully deleted CMS ID product

{
    "mail": "clement@transiteo.com",
    "cms_id": "169",
    "cms_name": "BigCommerce",
    "sku": "PRODUCT-TE1632206487"
}

Destination countries

Destination countries

These are the routes you may use in order to synchronize the merchant's allowed import countries from the CMS to Transiteo's app : https://www.app.transiteo.io/#/countryManager. \ The synchronisation is from the CMS to the Transiteo App only, not the other way. You must only pass the required elements in Transiteo App.

Get countries

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

This route allows you to get all import countries related to the user.

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Successfully returned import countries

[
    {
        "mail": string (ex: "jean@transiteo.com"),
        "iso3Country": string (ex: "FRA"),
        "statut": Boolean (ex: true),
        "annual_revenue": {
            "2020": number (ex: 0),
            "2021": number (ex: 0)
        },
        "currency": "string (ex: "EUR"),
        "VAT_ID": null (string)
    },
    { … }
]

Get country

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

This route allows you to get all informations for a specific country.

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Country's informations successfully returned.

{
    "mail": string (ex: "jean@transiteo.com"),
    "iso3Country": string (ex: "FRA"),
    "statut": Boolean (ex: true),
    "annual_revenue": {
        "2020": number (ex: 0),
        "2021": number (ex: 0)
    },
    "currency": "string (ex: "EUR"),
    "VAT_ID": null (string)
}

Create country

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

This route allows you to create an import country in Transiteo database.

Headers

Name Type Description
Authorization* string \(see Auth Token)>
Content-Type* string application/json

Request Body

Name Type Description
iso3_country* string \
status* boolean \
annual_revenue* object

{
"2020": <2020 turnover> (int),
"2021": <2021 turnover> (int)
}

currency* string \
VAT_ID* string \ (required but can be empty)

200 Import country successfully created

{
    "mail": string (ex: "jean@transiteo.com"),
    "iso3Country": string (ex: "JPN"),
    "statut": boolean (ex: true),
    "annual_revenue": {
        "2020": number (ex: 123456),
        "2021": number (ex: 98765)
    },
    "currency": string (ex: "EUR"),
    "VAT_ID": string (ex: "JPN724378642")
}

Example Body

{
    "iso3_country": "JPN",
    "statut": true,
    "annual_revenue": {"2020": 123456, "2021": 98765},
    "currency": "EUR",
    "VAT_ID": "JPN724378642"
}

Update country

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

This route allows you to update a country's informations, like if it's active or not.

Headers

Name Type Description
Authorization* string \(see Auth Token)>
Content-Type* string application/json

Request Body

Name Type Description
iso3_country* string \
status* boolean \
annual_revenue* object

{
"2020": <2020 turnover> (int),
"2021": <2021 turnover> (int)
}

currency* string \
VAT_ID* string \ (required but can be empty)

200 Country's informations successfully updated.

{
    "mail": string (ex: "jean@transiteo.com"),
    "iso3Country": string (ex: "JPN"),
    "statut": boolean (ex: false),
    "annual_revenue": {
        "2020": number (ex: 123456),
        "2021": number (ex: 98765)
    },
    "currency": string (ex: "EUR"),
    "VAT_ID": string (ex: "JPN724378642")
}

Example Body

{
    "iso3_country": "JPN",
    "statut": false,
    "annual_revenue": {"2020": 123456, "2021": 100000},
    "currency": "EUR",
    "VAT_ID": "JPN724378642"
}

Orders

Orders

These are the routes you may use in order to synchronize the merchant's orders from the CMS to Transiteo's app : https://www.app.transiteo.io/#/orderManager.\ The synchronisation is from the CMS to the Transiteo App only, not the other way. You must only pass the required elements in Transiteo App.

Get orders

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

This route allows you to get all orders related to the user.

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Orders successfully returned

[
    {
        "mail": string (ex: "jean@transiteo.com"),
        "order_id": string (ex: "ztgbtgzerthzthzthzrth"),
        "url": string (ex: "http://"),
        "order_date_hour": timestamp (ex: 1625562730426),
        "customer_firstname": string (ex: "jean"),
        "customer_lastname": string (ex: "Capsar"),
        "departure_country": string (ex: "DZA"),
        "arrival_country": string (ex: "ZAF"),
        "products": [
            {
                "unit_price_currency": string (ex: "EUR"),
                "quantity": int (ex: 1),
                "sku": string (ex: "zthrhzthzrthztrhz"),
                "unit_price": number (ex: 10)
            },
            { ... }
        ],
        "shipping_carrier": string (ex: "Chronopost"),
        "amount_products": number (ex: 10),
        "amount_shipping": number (ex: 0),
        "amount_duty": number (ex: 0),
        "amount_vat": number (ex: 0),
        "amount_specialtaxes": number (ex: 0),
        "currency": string (ex: "EUR"),
        "order_statut": string (ex: "AWAITING"),
        "order_update_statut": timestamp (ex: 1626164314647)
    },
    { ... }
]

Get order

GET https://api.transiteo.io/v1/customer/orders/{orderId}

This route allows you to get all informations for a specific order.

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Order successfully returned.

{
    "mail": string (ex: "jean@transiteo.com"),
    "order_id": string (ex: "ztgbtgzerthzthzthzrth"),
    "url": string (ex: "http://"),
    "order_date_hour": timestamp (ex: 1625562730426),
    "customer_firstname": string (ex: "jean"),
    "customer_lastname": string (ex: "Capsar"),
    "departure_country": string (ex: "DZA"),
    "arrival_country": string (ex: "ZAF"),
    "products": [
        {
            "unit_price_currency": string (ex: "EUR"),
            "quantity": int (ex: 1),
            "sku": string (ex: "zthrhzthzrthztrhz"),
            "unit_price": number (ex: 10)
        }
    ],
    "shipping_carrier": string (ex: "Chronopost"),
    "amount_products": number (ex: 10),
    "amount_shipping": number (ex: 0),
    "amount_duty": number (ex: 0),
    "amount_vat": number (ex: 0),
    "amount_specialtaxes": number (ex: 0),
    "currency": string (ex: "EUR"),
    "order_statut": string (ex: "AWAITING"),
    "order_update_statut": timestamp (ex: 1626164314647)
}

Create order

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

This route allows you to create an order in Transiteo database

Headers

Name Type Description
Content-Type* string application/json
Authorization* string \(see Auth Token)>

Request Body

Name Type Description
order_id* string \
url string \
order_date_hour* string \
customer_firstname string
customer_lastname string
departure_country string \
arrival_country string \
products* array

[
{
"sku": <sku of the product> (string),
"quantity": <how many> (int),
"unit_price": <how much by unit> (int),
"currency": <product's currency> (string)
},
{ ... }
]

shipping_carrier string \
amount_products* number \
amount_shipping number
amount_duty string
amount_vat string
amount_specialtaxes string
currency* string
order_statut* string \

200 Order successfully created

{
    "mail": string (ex: "jean@transiteo.com"),
    "order_id": string (ex: "ztgbtgzerthzthzthzrth"),
    "url": string (ex: "http://"),
    "order_date_hour": timestamp (ex: 1625562730426),
    "customer_firstname": string (ex: "jean"),
    "customer_lastname": string (ex: "Capsar"),
    "departure_country": string (ex: "DZA"),
    "arrival_country": string (ex: "ZAF"),
    "products": [
        {
            "unit_price_currency": string (ex: "EUR"),
            "quantity": int (ex: 1),
            "sku": string (ex: "zthrhzthzrthztrhz"),
            "unit_price": number (ex: 10)
        }
    ],
    "shipping_carrier": string (ex: "Chronopost"),
    "amount_products": number (ex: 10),
    "amount_shipping": number (ex: 0),
    "amount_duty": number (ex: 0),
    "amount_vat": number (ex: 0),
    "amount_specialtaxes": number (ex: 0),
    "currency": string (ex: "EUR"),
    "order_statut": string (ex: "AWAITING"),
    "order_update_statut": timestamp (ex: 1626164314647)
}

Order_status must be one of the following values:

AWAITING = order hasn't been paid yet. \ PAID = order has been paid.\ CANCELLED = order cancelled or refunded.

Example Body

{
    "order_id": "12345",
    "url": "https://myorderurl.com/12345",
    "order_date_hour": 1618677827,
    "customer_firstname": "test",
    "customer_lastname": "test",
    "departure_country": "FRA",
    "arrival_country": "USA",
    "products": [{"sku": "HGTU76TYH", "quantity": 100, "unit_price": 19.9, "unit_price_currency": "EUR"}],
    "shipping_carrier": "UPS",
    "amount_products": 1990,
    "amount_shipping": 50,
    "amount_duty": 95,
    "amount_vat": 125,
    "amount_specialtaxes": 33,
    "currency": "EUR",
    "order_statut": "AWAITING"
}

Update order

PUT https://api.transiteo.io/v1/customer/orders/{orderId}

This route allows you to update an order's informations.

Headers

Name Type Description
Content-Type* string application/json
Authorization* string \(see Auth Token)>

Request Body

Name Type Description
url string \
order_date_hour* string \
customer_firstname string
customer_lastname string
departure_country string
arrival_country string
products* string

[
{
"sku": <sku of the product> (string),
"quantity": <how many> (int),
"unit_price": <how much by unit> (int),
"currency": <product's currency> (string)
}
]

shipping_carrier string \
amount_products number \
amount_shipping string
amount_duty string
amount_vat string
amount_specialtaxes string
currency* string
order_statut* string \

200 Order successfully updated.

{
    "mail": string (ex: "jean@transiteo.com"),
    "order_id": string (ex: "ztgbtgzerthzthzthzrth"),
    "url": string (ex: "http://"),
    "order_date_hour": timestamp (ex: 1625562730426),
    "customer_firstname": string (ex: "jean"),
    "customer_lastname": string (ex: "Capsar"),
    "departure_country": string (ex: "DZA"),
    "arrival_country": string (ex: "ZAF"),
    "products": [
        {
            "unit_price_currency": string (ex: "EUR"),
            "quantity": int (ex: 1),
            "sku": string (ex: "zthrhzthzrthztrhz"),
            "unit_price": number (ex: 10)
        }
    ],
    "shipping_carrier": string (ex: "Chronopost"),
    "amount_products": number (ex: 10),
    "amount_shipping": number (ex: 0),
    "amount_duty": number (ex: 0),
    "amount_vat": number (ex: 0),
    "amount_specialtaxes": number (ex: 0),
    "currency": string (ex: "EUR"),
    "order_statut": string (ex: "AWAITING"),
    "order_update_statut": timestamp (ex: 1626164314647)
}

Order_status must be one of the following values:

AWAITING = order hasn't been paid yet. \ PAID = order has been paid.\ CANCELLED = order cancelled or refunded.

Example Body

{
    "url": "https://myorderurl.com/12345",
    "order_date_hour": 1618677827,
    "customer_firstname": "test",
    "customer_lastname": "test",
    "departure_country": "FRA",
    "arrival_country": "USA",
    "products": [{"sku": "HGTU76TYH", "quantity": 100, "unit_price": 19.9, "unit_price_currency": "EUR"}],
    "shipping_carrier": "UPS",
    "amount_products": 1990,
    "amount_shipping": 50,
    "amount_duty": 95,
    "amount_vat": 125,
    "amount_specialtaxes": 33,
    "currency": "EUR",
    "order_statut": "AWAITING",
}

Delete order

DELETE https://api.transiteo.io/v1/customer/orders/{orderId}

This route allows you to delete an order in Transiteo database.

Headers

Name Type Description
Authorization* string \(see Auth Token)>

200 Order successfully deleted.

{
    "mail": string (ex: "jean@transiteo.com"),
    "order_id": string (ex: "ztgbtgzerthzthzthzrth"),
    "url": string (ex: "http://"),
    "order_date_hour": timestamp (ex: 1625562730426),
    "customer_firstname": string (ex: "jean"),
    "customer_lastname": string (ex: "Capsar"),
    "departure_country": string (ex: "DZA"),
    "arrival_country": string (ex: "ZAF"),
    "products": [
        {
            "unit_price_currency": string (ex: "EUR"),
            "quantity": int (ex: 1),
            "sku": string (ex: "zthrhzthzrthztrhz"),
            "unit_price": number (ex: 10)
        }
    ],
    "shipping_carrier": string (ex: "Chronopost"),
    "amount_products": number (ex: 10),
    "amount_shipping": number (ex: 0),
    "amount_duty": number (ex: 0),
    "amount_vat": number (ex: 0),
    "amount_specialtaxes": number (ex: 0),
    "currency": string (ex: "EUR"),
    "order_statut": string (ex: "AWAITING"),
    "order_update_statut": timestamp (ex: 1626164314647)
}

Duties & Taxes

Duty Calculation

Duty Calculation

DutyCalculation

POST https://api.transiteo.io/v1/taxsrv/dutyCalculation

This route allows you to calculate duties and taxes estimation for one or multiple products.

Headers

Name Type Description
Content-Type* string application/json
Authorization* string \(See Auth Token)>

Request Body

Name Type Description
transport string \(see below)>
products* array \(see below)>
duty_fees object \(see below)>
lang string
from_country* string \
from_district string \
to_country* string \
to_district string \
shipment_type* string <"GLOBAL" OR "ARTICLE">
global_ship_price number \
currency_global_ship_price string
global_packaging_price number
currency_global_packaging_price string
global_insurance_price number
currency_global_insurance_price string
included_tax boolean \
incoterm string
extra_fees number
sender* object \(see below)>
receiver* object \(see below)>

200

Example Body

{
    "products": [
        {
            "identification": {
                "type": "TEXT",
                "value": "Lave linge"
            },
            "weight": 125,
            "weight_unit": "g",
            "quantity": 1,
            "unit_price": 200,
            "currency_unit_price": "EUR",
            "unit_ship_price": 10,
            "unit_packaging_price": 2,
            "unit_insurance_price": 5,
            "origin_country": "FRA",
            "transport":{
                "type": "CARRIER",
                "id": "71"
            }
        }
    ],
    "duty_fees" : {
        "amount" : 10, 
        "currency" : "EUR",  
        "on_global": 1
    },
    "lang": "fr",
    "from_country": "FRA",
    "from_district": null,
    "to_country": "DZA",
    "to_district": null,
    "shipment_type": "GLOBAL",
    "global_ship_price": 10,
    "currency_global_ship_price": "EUR",
    "global_packaging_price": 2,
    "currency_global_packaging_price": "EUR",
    "global_insurance_price": 5,
    "currency_global_insurance_price": "EUR",
    "included_tax": true,
    "incoterm": "CIF",
    "extra_fees": 0.02,
    "sender": {
        "pro": true,
        "revenue_country_annual": 3450000,
        "currency_revenue_country_annual": "EUR"
    },
    "receiver": {
        "pro": true,
        "activity_id": "0144Z"
    }
    "transport": {
        "type": "CARRIER",
        "id": "125"
    }
}

Products Array

The products array, is an array of product object.

Product Object

{
    "identification": {
        "type": "SKU" (string), REQUIRED
        "value": "001-1-1" (string) REQUIRED
    },
    "weight": 125 (number), REQUIRED
    "weight_unit": "g" (string), REQUIRED
    "quantity": 1 (int), REQUIRED
    "unit_price": 200 (number), REQUIRED
    "currency_unit_price": "EUR" (string), REQUIRED
    "unit_ship_price": 10 (number), REQUIRED if "ARTICLE" shipment_type
    "unit_packaging_price": 2 (number), REQUIRED if "ARTICLE" shipment_type
    "unit_insurance_price": 5 (number), REQUIRED if "ARTICLE" shipment_type
    "origin_country": "FRA" (string),
    "transport":{
        "type": "CARRIER" (string),
        "id": "71" (string)
    }
}

Duty fees Object

"duty_fees" : {
    "percentage": 10 (number),
    "amount" : 0 (number), 
    "currency" : "EUR" (string),  
    "on_products_price": 0 (boolean), 
    "on_shipping_products_price": 0 (boolean), 
    "on_global": 1 (boolean)
}

You have to choose if you want to inquire the percentage or the amout, don't put both.\ If you choose to inquire the amount, you will have to add the currency.

Then you have to choose if the duty fees must apply on the product price, the shipping product price or the order.

Sender Object

"sender": {
    "pro": true (boolean),
    "revenue_country_annual": 3450000 (number),
    "currency_revenue_country_annual": "EUR" (string)
}

Receiver Object

"receiver": {
    "pro": true (boolean),
    "activity_id": "0144Z" (string)
}

Transport Object

"transport":{
    "type": "CARRIER" (string),
    "id": "71" (string)
}

Fields details

"products" / "identification" / "type"

Allways equals "SKU". \ &#xNAN;Examples : SKU\ &#xNAN;Type : string\ &#xNAN;Required : yes

"products" / "identification" / "value"

You need to fill this field with your product SKU in your catalog.\ &#xNAN;Examples : ARE-987UY\ &#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 if "unit_ship_price" and "currency_unit_ship_price" are not mentionned. Or if you request Switzerland in "from_country".\ &#xNAN;Default value : 1

"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 if "unit_ship_price" and "currency_unit_ship_price" are not mentionned. Or if you request Switzerland in "from_country".\ &#xNAN;Default value : "kg"

"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 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 "ARTICLE" shipment_type

"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 "ARTICLE" shipment_type

"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 "ARTICLE" shipment_type

"products" / "origin_country"

You need to fill the "origin_country" field with the Iso Alpha 3 code from where the product had build.\ Download the list of countries.\ &#xNAN;Examples : "FRA" or "VEN"\ &#xNAN;Type : string\ &#xNAN;Required : optional

"products" / "transport" / "type"

You need to fill the "transport" field of the shipping product(s) price.\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to know the duty fees by product)

"products" / "transport" / "id"

You need to fill the "transport" field of the shipping product(s) price with an id number.\ Download the list of carriers and freight forwarder.\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to know the duty fees by product)

"products" / "unit"

You need to fill the "unit" field with a entire number representing an other feature of product \ &#xNAN;Examples : 1 or 9\ &#xNAN;Type : number\ &#xNAN;Required : optional

"products" / "unit_type"

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 : optional and yes es if "unit" is mentioned.

"lang"

You need to fill this field with a web language code of your product name or description. 3 languages are available :\ fr = french\ en = english\ es = spanish\ &#xNAN;Examples : "fr"\ &#xNAN;Type : string\ &#xNAN;Required : optional

"from_country"

You need to fill the "from_country" field with the country english label or Iso Alpha 3 from where the product is sent.\ Download the list of countries.\ &#xNAN;Examples : "Bulgaria" or "ZHN"\ &#xNAN;Type : string\ &#xNAN;Required : yes

"from_district"

You need to fill the "from_district" field with the Iso codes of the district from where the product is sent.\ Download the list of districts.\ &#xNAN;Examples : "AL-11" or "FR-GES"\ &#xNAN;Type : string\ &#xNAN;Required : optional

"to_country"

You need to fill the "to_country" field with the country english label or Iso Alpha 3 from where the product arrives.\ Download the list of countries.\ &#xNAN;Examples : "Brazil" or "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.\ &#xNAN;Examples : "AL-11" or "FR-GES"\ &#xNAN;Type : string\ &#xNAN;Required : yes if "to_country" has different tax rates by districts

"shipment_type"\ GLOBAL : global shipping\ ARTICLE : One ship price per article\ Type : enum\ 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 shipment_type is GLOBAL\ &#xNAN;Default value : 0

"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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if shipment_type is 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 shipment_type is 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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if shipment_type is 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 shipment_type is 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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if shipment_type is 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 : optional

"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\ &#xNAN;Default value : true

"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 from_country & to_country are European countries. \ &#xNAN;Default value : 0

"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.\ &#xNAN;Examples : "USD" or "AUD"\ &#xNAN;Type : string\ &#xNAN;Required : yes if "sender" / pro" field is "pro" and from_country & to_country are European countries. \ &#xNAN;Default value : "EUR"

"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\ &#xNAN;Default value : false

"receiver" / "activity_id"

You need to fill the "activity_id" field with an activity code.\ Download the list of companies activities.\ &#xNAN;Examples : "0112Z" or "7161A"\ &#xNAN;Type : string\ &#xNAN;Required : yes if "receiver" / "pro" field is "true".

"transport" / "type"

You can fill the "type" field of the transport company with "CARRIER" or "FREIGHT_FORWARDER".\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to know the duty fees)

"transport" / "id"

You can fill the "id" field of the transport company with an entire number.\ Download the list of carriers and freight forwarders.\ &#xNAN;Examples : "01" or "28"\ &#xNAN;Type : string\ &#xNAN;Required : optional (required if you want to add automaticaly the duty fees)

"duty_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

"duty_fees" / "amount"

You can fill the "amount" field of your duty fees.\ &#xNAN;Examples : "10" or "29.99"\ &#xNAN;Type : number\ &#xNAN;Required : optional

"duty_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 you filled "duty_fees" / "amount" )

"duty_fees" / "on_products_price"

You have three choices : on_products_price / on_shipping_products_price / on_global\ If on_products_price = true, the duty_fees will be calculated only on the price of product(s).\ Examples : "true" or "false"\ Type : boolean\ Required : optional but required if you fill a value in duty_fees, percentage or amount/currency

"duty_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 duty_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 a value in duty_fees, percentage or amount/currency

"duty_fees" / "on_global"

You have three choices : on_products_price / on_shipping_products_price / on_global\ If on_global = true, the duty_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 a value in duty_fees, percentage or amount/currency

Widget

Integration

Integration

Setup

In order to use the widget, you will first have to add this line in the head of the html document:

<script defer="defer" src="https://transiteo-public-ressources.s3.eu-west-3.amazonaws.com/dc-widget/v1.1/transiteo-widget.min.js"></script>

Then you will need to add transiteo-widget tag in the <body></body> tag of the “catalog”/”home”, “product” and “cart” pages.

Here is an example of transiteo-widget tag:

<transiteo-widget
location="br" 
apikey="HIaEBHAFAICGByHyJlacI5MAoaIzmabm9NQLAPCR" 
displaypoweredby="true" 
autoopen="false”>
</transiteo-widget>

Usage

Now that you have setup transiteo-widget, you can use the bellow functions:

  • widget.isReady() -> returns promise \ true if widget is ready to display, false if not.
  • widget.displayWelcome() -> display widget in welcome mode. (only if ready / home page)
  • widget.displayAddedProductDuty(data) -> display estimation banner. (only if ready, only on product & cart page).
  • widget.displayDuty(data) -> display widget in duty mode. (only if ready, only on product & cart page)

For both modules, the duty estimation must be calculated with widget.displayDuty(products) function every time you go to a “product” or “cart” page, and every time you change: the quantity (on the “product” page), and the cart content (on the “cart” page).

Welcome Module

Only two of the transiteo-widget’s attributs should be configurable by the merchant : apiKey and autoopen. The others shouldn't change, location must be “br'' and displaypoweredby must be “true”.

Here is an example of a data variable for Welcome module:

const data = {
    currency: "EUR",
    guestCurrency: false,
    taxes_included: false,
    products: [
        {
            unit_price: 12.99,
            quantity: 3,
            weight: 3,
            weight_unit: "kg"
        },
        {
            unit_price: 50.00,
            quantity: 1000,
            weight: 450,
            weight_unit: "kg"
        }
    ]
};

data:
    currency: (string). Shop’s currency.
    guestCurrency: false (boolean). Always false with Welcome module.
    taxes_included: (boolean). true = taxes are included in prices.
    products: is a list, it contains information about the product(s).
        unit_price: (number)
    quantity: (int)
    weight: default value = 1 (int)
    weight_unit: default value = kg (string)

Landed Cost Module

All the transiteo-widget’s attributs should be configurable by the merchant.

Here is an example of a data variable for Landed Cost module:

const data = {
    currency: "EUR",
    guestCurrency: false,
    taxes_included: false,
    products: [
        {
            unit_price: 12.99,
            quantity: 3,
            sku: "AAAAA"
        },
        {
            unit_price: 50.00,
            quantity: 1000,
            sku: "BBBBB"
        }
    ]
};

data:
    currency: (string). Shop’s currency.
    guestCurrency: (boolean). false = use shop’s currency. true = use visitor currency
    taxes_included: (boolean). true = taxes are included in prices.
    products: is a list, it contains information about the product(s).
        unit_price: (number)
    quantity: (int)
    sku: (string)

Example of use

<!doctype html>
<html>    
    <head>        
        <meta charset="UTF-8">        
        <title>Transiteo Widget</title>        
        <script src="https://code.jquery.com/jquery-3.6.0.min.js" integrity="sha256-/xUj+3OJU5yExlq6GSYGSHk7tPXikynS7ogEvDej/m4=" crossorigin="anonymous"></script>
        <script defer="defer" src="https://transiteo-public-ressources.s3.eu-west-3.amazonaws.com/dc-widget/v1.1/transiteo-widget.min.js"></script>   
    </head>    
    <body>            
        <script>        
            // Create widget        
            const widget = document.createElement("transiteo-widget");        
            widget.setAttribute("location", "br");        
            widget.setAttribute("apikey", "{apiKey}");        
            widget.setAttribute("autoopen", "false");        
            widget.setAttribute("displaypoweredby", "true");  

            // Add on the body of the page        
            document.body.appendChild(widget);       

            // cart page data example (Welcome)        
            const dataFreemium = {            
                currency: "EUR",            
                guestCurrency: false,            
                taxes_included: false,            
                products: [                
                    {                    
                        weight: 1,                    
                        weight_unit: "kg",                    
                        unit_price: 290,                    
                        quantity: 1                
                    },                
                    {                  
                        weight: 1,                    
                        weight_unit: "kg",                    
                        unit_price: 90,                    
                        quantity: 1                
                    },                
                    {                    
                        weight: 1,                    
                        weight_unit: "kg",                    
                        unit_price: 150,                    
                        quantity: 5                
                    }            
                ]      
            };                

            // cart page data example (LandedCost)        
            const dataPremium = {            
                currency: "EUR",            
                guestCurrency: false,            
                taxes_included: false,            
                products: [                
                    {                    
                        sku: "009-1-1", // product must exists on your transiteo account and have a hscode                    
                        unit_price: 290,                    
                        quantity: 1                
                    },                
                    {                    
                        sku: "009-1-2", // product must exists on your transiteo account and have a hscode                    
                        unit_price: 90,                    
                        quantity: 1                
                    },                
                    {                    
                        sku: "009-1-3", // product must exists on your transiteo account and have a hscode                    
                        unit_price: 150,                    
                        quantity: 5                
                    }            
                ]        
            };        

            $(document).ready(function() {            
                widget.isReady().then(isDisplayed => {                
                    // the widget is displayed (the merchant has landed cost OR the user is in one of the available countries)                
                    if (isDisplayed) {                    
                        // Home page display                    
                        widget.displayWelcome();              

                        // Cart & Product page display                    
                        // widget.displayDuty(dataFreemium);                    
                        // widget.displayDuty(dataPremium);           

                        // Estimation banner                    
                        // widget.displayAddedProductDuty(dataFreemium);                    
                        // widget.displayAddedProductDuty(dataPremium);                
                    } else {                    
                        console.warn('WIDGET IS NOT DISPLAYED');                
                    }            
                });         
            });
        </script>    
    </body>
</html>

For this page to work, you should change {apiKey} (line 13) with the right value. Create an account on https://app.transiteo.io to get your apiKey.

If you want to try different cases, you can comment/uncomment functions between line 75 and 84.

Example bellow :

// Home page display                    
//widget.displayWelcome();              

// Cart & Product page display                    
widget.displayDuty(dataFreemium);                    
// widget.displayDuty(dataPremium);           

// Estimation banner                    
widget.displayAddedProductDuty(dataFreemium);                    
// widget.displayAddedProductDuty(dataPremium);

{% file src="https://921846278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MePsCDZ9Wj5hoyowKc7%2Fuploads%2FXA7U3m96cGpUdyhxhtAy%2Findex.html?alt=media&token=66774c5f-54ae-4481-919c-3213502b61b4" %}

Has Access

Has Access

Has access

POST https://api.transiteo.io/v1/widget/hasAccess

This route allows you to check if an apiKey is valid or not.

Request Body

Name Type Description
apiKey* string \

200 Successfull reponse

{
    "hasAccess": true
}
OR
{
    "hasAccess": false
}

CMS Plugins Guide

Guide d'utilisation - CMS

Guide d'utilisation - CMS

En savoir + sur les modules transiteo pour CMS :

https://transiteo.com/modules-cms

Avec les modules CMS transiteo vous allez pouvoir :

  • Être en conformité avec les règles et les lois fiscales de chaque pays
  • Vendre mieux ou pour la première fois dans plus de 198 pays
  • Réduire votre taux de retour colis si vous vendez déjà à l'international
  • Eviter la frustration d'un client devant payer des taxes à réception.
  • Être transparent avec vos clients sur les taxes à payer en amont de la commande.
  • Augmenter votre chiffre d’affaire et votre panier moyen à l'international
  • Réduire vos échanges mail et chat suite aux plaintes clients
  • Automatiser les règles de taxes à appliquer à chaque produit dans le back office
  • Ajouter ou afficher les taxes sur la pages produit, le panier et dans le checkout
  • Commencer à vendre et expédier en DDP
  • Réduire vos tarifs de transport
  • Générer automatiquement les documents pour exporter votre marchandise.
  • ...

Plugin pour WordPress / WooCommerce

Vous utilisez le CMS Wordpress pour votre boutique en ligne, nous avons le plugin qui vous correspond. Cliquez sur le lien ci dessous et laissez-vous guider :

wordpress

Site démo avec le plugin :

http://wordpress.dev.transiteo.io

Extension pour Magento 2.X

Vous utilisez le CMS Magento 2 pour votre boutique en ligne, nous avons l'extension qui vous correspond. Cliquez sur le lien ci dessous et laissez-vous guider :

magento-2.x

Application pour Shopify

Vous utilisez le CMS Shopify pour votre boutique en ligne, nous avons l'application qui vous correspond. Cliquez sur le lien ci dessous et laissez-vous guider :

shopify

Application pour BigCommerce

Vous utilisez le CMS BigCommerce pour votre boutique en ligne, nous avons l'application qui vous correspond. Cliquez sur le lien ci dessous et laissez-vous guider :

bigcommerce

Site démo avec l'application :

Addon pour Prestashop 1.7.X

Vous utilisez le CMS Prestashop 1.7 pour votre boutique en ligne, nous avons l'addon qui vous correspond. Cliquez sur le lien ci dessous et laissez-vous guider :

prestashop

Site démo avec l'addon :

http://15.188.240.79/fr

WORDPRESS

Installation & Mise à jour

Installation & Mise à jour

transiteo Welcome

Vous avez 2 manières d'installer le module : \ \ 1. Télécharger & Installer l'extension d'après ce fichier ZIP

zip-transiteo-welcome

2. Télécharger & Installer l'extension depuis le site Wordpress

https://fr.wordpress.org/plugins

  • [ ] Rechercher l'extension : transiteo ou Welcome ou transiteo Welcome

  • [ ] Obtenir l'extension en cliquant sur le bouton “Télécharger”

  • [ ] Le plugin a été installé. Vous pouvez le retrouver dans la page Plugins > Installed Plugins

transiteo Landed Cost

Vous avez 2 manières d'installer le module : \ \ 1. Télécharger & Installer l'extension d'après ce fichier ZIP

zip-transiteo-landed-cost

2. Télécharger & Installer l'extension depuis le site Prestashop

https://fr.wordpress.org/plugins

  • [ ] Rechercher l'extension : transiteo ou Landed Cost ou transiteo Landed Cost

  • [ ] Obtenir l'extension en cliquant sur le bouton “Télécharger”

  • [ ] Le plugin a été installé. Vous pouvez le retrouver dans la page Plugins > Installed Plugins

Activation

Activation

transiteo Welcome

Créer un compte sur https://app.transiteo.io/#/register

https://app.transiteo.io/#/register

  • [ ] Remplissez les champs requis pour vous inscrire

  • [ ] Cliquez sur “valider mon compte” dans l’email que vous avez reçu suite à l’enregistrement de votre compte.

    (il se peut que ce mail soit arrivé dans vos spams)

  • [ ] Vous allez être redirigé(e) sur la page de connexion du dashboard transiteo. Connectez-vous avec vos email et mot de passe renseigné lors de votre ouverture de compte.

    (Si vous ne vous souvenez plus de votre mot de passe, cliquez sur “Mot de passe oublié ?”)

  • [ ] A votre première connexion, vous allez être redirigé vers un tutoriel de paramétrage de votre boutique.

    Certaines parties sont obligatoires et d'autres peuvent être paramétrées par la suite.

  • [ ] Pour que l’extension fonctionne, vous n’avez pas besoin de choisir une formule payante. Le module fonctionne gratuitement.
  • [ ] Vous devez récupérer votre clef API pour activer votre extension sur votre back office Wordpress. Vous pouvez trouver cette clé dans les Paramètres (https://www.app.transiteo.io/#/settings)

https://www.app.transiteo.io/#/settings

  • [ ] Copier coller la clef dans l'extension transiteo Welcome

transiteo Landed Cost

Créer un compte sur https://app.transiteo.io/#/register

https://app.transiteo.io/#/register

  • [ ] Remplissez les champs requis pour vous inscrire

  • [ ] Cliquez sur “valider mon compte” dans l’email que vous avez reçu suite à l’enregistrement de votre compte.

    (il se peut que ce mail soit arrivé dans vos spams)

  • [ ] Vous allez être redirigé(e) sur la page de connexion du dashboard transiteo. Connectez-vous avec vos email et mot de passe renseigné lors de votre ouverture de compte.

    (Si vous ne vous souvenez plus de votre mot de passe, cliquez sur “Mot de passe oublié ?”)

  • [ ] A votre première connexion, vous allez être redirigé vers un tutoriel de paramétrage de votre boutique.

    Certaines parties sont obligatoires et d'autres peuvent être paramétrées par la suite.

https://www.app.transiteo.io/#/plans

  • [ ] Une fois votre formulPour que l’extension fonctionne, vous n’avez pas besoin de choisir une formule payante. Le module fonctionne gratuitement.Pour que l’extension fonctionne, vous n’avez pas besoin de choisir une formule payante. Le module fonctionne gratuitemente contractée, vous devez récupérer votre client_id et refresh_token pour activer votre plugin sur votre back office Wordpress. Vous pouvez trouver ces clés dans les Paramètres (https://www.app.transiteo.io/#/settings)

https://www.app.transiteo.io/#/settings

  • [ ] Copier coller le widget API Key, le client_id et le refresh_token dans le plugin transiteo Welcome

Configuration

Configuration

transiteo Welcome

La configuration du plugin “transiteo Welcome” est disponible via :

  • La page Plugins > Installed Plugins > transiteo Welcome > Settings

ou

  • Dans le menu de gauche Transiteo > Configuration

Configuration > API Key\ Ici se trouve votre widget API Key qu’il faut entrer pour que le widget puisse fonctionner.

Options > Activate\ Si la case est cochée, le module est activé.\ Si la case est décochée, le module est désactivé.

Options > Statut\ Ici se trouve le statut de votre compte.

Options > Let the widget open automatically\ Si la case est cochée, le widget s’ouvrira automatiquement quand un visiteur arrive sur la home page, la page produit et la page panier ou quand les droits et taxes sont recalculés.\ Si la case est décochée, le widget ne s’ouvrira pas automatiquement. Le visiteur devra cliquer sur le widget pour l’ouvrir.

transiteo Landed Cost

La configuration du plugin “transiteo Landed Cost” est disponible via :

  • La page Plugins > Installed Plugins > transiteo Landed Cost > Settings

ou

  • Dans le menu de gauche Transiteo > Options

Options > Activate\ Si le toggle est violet, le module est activé.\ Si le toggle est grisé, le module est désactivé.

Options > Statut\ Ici se trouve le statut de votre compte.

Options > Display Duties and taxes\ Si le toggle est violet, les droits et taxes s'affichent sur la page produit\ Si le toggle est grisé, les droits et taxes ne s'affichent pas sur la page produit

Options > Hide widget\ Si le toggle est violet, le widget est masqué.\ Si le toggle est grisé, le widget s'affiche.

Options > Widget position\ Si “bottom right”, le widget sera placé dans le coin gauche en bas.\ Si “bottom left”, le widget sera placé dans le coin gauche en bas.\ Si “Top right”, le widget sera placé dans le coin droite en haut.\ Si “Top left”, le widget sera placé dans le coin gauche en haut.

Options > Let the widget open automatically\ Si le toggle est violet, le widget s’ouvrira automatiquement quand un visiteur arrive sur la home page, la page produit et la page panier ou quand les droits et taxes sont recalculés.\ Si le toggle est grisé, le widget ne s’ouvrira pas automatiquement. Le visiteur devra cliquer sur le widget pour l’ouvrir.

Options > Hide the Powered by transiteo\ Si le toggle est violet, le widget affichera “Welcome is Powered by Transiteo” en bas de la fenêtre quand elle sera ouverte.\ Si le toggle est grisé, le widget n’affichera aucune mention.

Dès que vous avez installé et configuré votre plugin, cliquez sur le bouton “Launch” pour synchroniser votre boutique avec transiteo. Cette opération est à faire une seule fois.

Fonctionnement

Fonctionnement

transiteo Welcome

Fonctionnement du widget

L'extension transiteo Welcome fait un pont entre votre compte transiteo et votre Wordpress. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transite, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Si vous avez différents produits, il faut passer à la version Premium.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Vue sur la home page : (widget ouvert)

\ Vue sur une page produit : (bannière ouverte)

Vue sur une page produit : (widget ouvert)

\ Vue sur la page panier : (bannière ouverte)

Vue sur la page panier : (widget ouverte)

transiteo Landed Cost

Fonctionnement du widget

L'extension transiteo Welcome fait un pont entre votre compte transiteo et votre Wordpress. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transite, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Si vous avez différents produits, il faut passer à la version Premium.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Vue du fonctionnement du widget :

Vue sur la home page : (widget ouvert)

\ Vue sur une page produit : (bannière ouverte)

Vue sur une page produit : (widget ouvert)

\ Vue sur la page panier : (bannière ouverte)

Vue sur la page panier : (widget ouverte)

Vue du fonctionnement sans widget :

Vue sur la page produit :


Vue sur la page panier :

Vue sur la page checkout :

Fonctionnement du plugin

Imbrication des Droits et Taxes sur les pages :

  • Produit

    • DDP

    • DDU

  • Panier

    • DDP


    • DDU

  • Paiement

    • DDP

    • DDU

Synchronisation Boutique <> Transiteo

  • Produits

    • Première synchronisation

    Pour synchroniser vos produits, rendez-vous dans l'onglet "Synchronisation" et appuyer sur le bouton "Launch" : \ \ \ \ Vous verrez dans la plateforme transiteo dans la page MON CATALOGUE, vos produits : \ \ \ \ &#xNAN;ou

    Importer le CSV dans “Mon Catalogue” sur l’application Transiteo.

    \ \ \ Associer des codes douaniers à vos produits : \ \ Automatiquement :

    Si vous voulez associer des codes douaniers à vos produits de façon automatique \ \ ou

    Manuellement :

    \


    • Mise à jour

    Les mises à jour que vous faites sur vos produits dans vos back office WordPress seront synchronisé avec ceux de votre CATALOGUE transiteo. \ \
    * SKU / Product Id / Ref

Si vous modifiez le SKU, le product ID ou la Ref d'un de vos produits, cela créera un nouveau produit dans votre CATALOGUE transiteo.\ Evitez au maximum de mettre à jour ces données d'un produit.

  • Commandes

    • Première synchronisation

    Vos anciennes commandes ne sont pas synchronisées. Elles commenceront à se synchroniser à partir de l'activation du module transiteo Landed Cost.

    • Mise à jour Statut de commande \ \ Il existe 3 statuts de commande chez transiteo : PAID / AWAITING / CANCELED

    Order Statut WordpressOrder Statut Transiteo
    Pending payment
AWAITING
    Processing
AWAITING
    On hold
AWAITING
    Completed
PAID
    Cancelled
CANCELED
    Refunded
CANCELED
    FailedCANCELED


    • Génération des documents exports \ \
    • Prélèvement des Transactions Fees\ \ Il y a des commissions uniquement les droits et taxes d'une commande. Cette commission s'élève à 2%.\ \ Le débit se fait tous les 15 jours sur la carte que vous avez paramètré lors de la contraction de votre formule transiteo\ \ &#xNAN;Exemple : Une commande validée, payée, expédiée et non retournée de 100 EUR Hors Taxes + 30 EUR de Taxes (Douanes & VAT). \ 2% x 30 EUR = 0,60 EUR de commission prélevée
  • Pays

    • Première synchronisation

    Un bouton a été créé pour l’occasion. Vous pouvez trouver ce bouton dans l'onglet "Synchronization" dans les settings de transiteo Landed Cost sur Wordpress.

    • Mise à jour

    Si vous modifiez un pays depuis votre Wordpress, il sera mis à jour automatique dans l’application transiteo. Attention, si vous mettez à jour des pays dans l’application transiteo, il ne seront pas synchronisé avec votre Wordpress. La synchronisation marche uniquement dans le sens Wordpress > Transiteo

    • Numéro d’identification fiscal

    Au moment de la création de votre compte transiteo, nous vous demandons d’inscrire vos différents numéro fiscaux en fonction des pays. Si vous ne les avez pas rempli vous pouvez les remplir manuellement dans TaxManager.

    • Chiffre d’affaire additionné pays par pays

    Nous calculons, additionnons vos ventes pour chaque pays. Les autorités fiscales de chaque pays demandent de tenir une comptabilité mais surtout le calcul des droits et taxes.

-------------------------------

-------------------------------

Zip : transiteo Welcome

Zip : transiteo Welcome

{% file src="https://18706970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLr4ZIcum9zLHPikml6Kk%2Fuploads%2FZImI181ihG9K2JGaeNdI%2Ftransiteo-cms-addons-woocommerce-main.zip?alt=media&token=b6d2b57d-13b0-4416-ad14-bdb079167a14" %}

Zip : transiteo Landed Cost

Zip : transiteo Landed Cost

{% file src="https://18706970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLr4ZIcum9zLHPikml6Kk%2Fuploads%2FFFrKK3LdaBPVBOPuc1ZQ%2Ftransiteo-cms-landed-cost-woocommerce-main.zip?alt=media&token=c0b9f438-d4ab-46de-bf4b-e84be7ef40cd" %}

MAGENTO 2.X

Installation & Mise à jour

Installation & Mise à jour

transiteo Landed Cost est un module pour le CMS Magento 2.

  • [ ] Rendez-vous sur la marketplace des modules de Magento : https://marketplace.magento.com/

  • [ ] Rechercher l’application : transiteo ou Landed Cost ou transiteo Landed Cost

  • [ ] Obtenir l’application en cliquant sur le bouton “Ajouter l’application”

Activation

Activation

Configuration

Configuration

Fonctionnement

Fonctionnement

-------------------------------

-------------------------------

Zip : transiteo Landed Cost

Zip : transiteo Landed Cost

SHOPIFY

Installation & Mise à jour

Installation & Mise à jour

transiteo Landed Cost est une application pour le CMS Shopify.

  • [ ] Rechercher l’application : transiteo ou Landed Cost ou transiteo Landed Cost

  • [ ] Obtenir l’application en cliquant sur le bouton “Ajouter l’application”

Image

Activation

Activation

Créer un compte sur https://app.transiteo.io/#/register

  • [ ] Remplissez les champs requis pour vous inscrire

  • [ ] Cliquez sur “valider mon compte” dans l’email que vous avez reçu suite à l’enregistrement de votre compte.

    (il se peut que ce mail soit arrivé dans vos spams)

  • [ ] Vous allez être redirigé(e) sur la page de connexion du dashboard transiteo. Connectez-vous avec vos email et mot de passe renseigné lors de votre ouverture de compte.

    (Si vous ne vous souvenez plus de votre mot de passe, cliquez sur “Mot de passe oublié ?”)

  • [ ] A votre première connexion, vous allez être redirigé vers un tutoriel de paramétrage de votre boutique. Certaines parties sont obligatoires et d'autres peuvent être paramétrées par la suite.

Activation de l’application / Freemium

  • [ ] Pas besoin de contracter une formule pour utiliser le module en mode Freemium

Vous devez récupérer votre widget APKey pour activer votre module en mode Freemium sur votre back office Shopify. Vous pouvez trouver ce token dans les Paramètres (https://www.app.transiteo.io/#/settings)

  • [ ] Copier coller le client_id et le refresh_token dans le panneau d’authentification.

Activation de l’application / Premium

  • [ ] Une fois votre formule contractée, vous devez récupérer votre client_id et votre refresh_token pour activer votre application sur votre back office Shopify. Vous pouvez trouver ces tokens dans les Paramètres (https://www.app.transiteo.io/#/settings)
  • [ ] Copier coller le client_id et le refresh_token dans le panneau d’authentification.

Configuration

Configuration

Configuration de l’application / Freemium

La configuration de l’application “transiteo Landed Cost” en utilisant uniquement le widget en mode Freemium est disponible dans le menu Applications

  1. Compte transiteo

    Pour utiliser l'application il vous faudra d'abord un compte Transiteo 2. Renseignez vos identifiants

    Une fois votre compte créé, rendez-vous dans l'espace 'clé d'activation' pour trouver vos identifiants 3. API Carrier de Shopify\ Pour utiliser l'application il vous faudra souscrire à l'offre API Carrier de Shopify 4. Synchronisation\ Pour synchroniser vos produits avec transiteo vous devez effectuer une modification sur chacun de vos produits afin de lancer la configuration 5. Taxes\ Transiteo is taking care of everything related to taxes. So you'll want to disable every taxes setting for your store. 6. Countries Synchronisation\ Once your client_id and refresh_token set, you'll want to sync the countries your shop is shipping to with Transiteo.

Bouton : Synchronise countries

Configuration de Transiteo > apiKey\ Ici se trouve l’emplacement pour entrer votre widget API Key pour que le widget puisse fonctionner.

Configuration du widget > Activer le module Transiteo\ Si la case est cochée, le module est activé.\ Si la case est décochée, le module est désactivé.

Configuration du widget > Position du widget\ Si “En haut à gauche”, le widget sera placé dans le coin gauche en haut.\ Si “En haut à droite”, le widget sera placé dans le coin droit en haut.\ Si “En bas à gauche”, le widget sera placé dans le coin gauche en bas.\ Si “En bas à droite”, le widget sera placé dans le coin gauche en bas.

Configuration du widget > Ouverture automatique du widget\ Si la case est cochée, le widget s’ouvrira automatiquement quand un visiteur arrive sur la home page, la page produit et la page panier ou quand les droits et taxes sont recalculés\ Si la case est décochée, le widget ne s’ouvrira pas automatiquement. Le visiteur devra cliquer sur le widget pour l’ouvrir.

Configuration du widget > Masquer le widget\ Si la case est cochée, le widget ne s’affiche pas.\ Si la case est cochée, le widget s’affiche.

Configuration de l'application / Premium

La configuration de l’application “transiteo Landed Cost” en utilisant uniquement le widget en mode Freemium est disponible dans le menu Applications

  1. Compte transiteo

    Pour utiliser l'application il vous faudra d'abord un compte Transiteo 2. Renseignez vos identifiants

    Une fois votre compte créé, rendez-vous dans l'espace 'clé d'activation' pour trouver vos identifiants 3. API Carrier de Shopify\ Pour utiliser l'application il vous faudra souscrire à l'offre API Carrier de Shopify 4. Synchronisation\ Pour synchroniser vos produits avec transiteo vous devez effectuer une modification sur chacun de vos produits afin de lancer la configuration 5. Taxes\ Transiteo is taking care of everything related to taxes. So you'll want to disable every taxes setting for your store. 6. Countries Synchronisation\ Once your client_id and refresh_token set, you'll want to sync the countries your shop is shipping to with Transiteo.

Bouton : Synchronise countries

Configuration de Transiteo > apiKey\ Ici se trouve l’emplacement pour entrer votre widget API Key pour que le widget puisse fonctionner.

Configuration de Transiteo > client_id\ Ici se trouve l’emplacement pour entrer votre client_id pour que le widget puisse fonctionner.

Configuration de Transiteo > refresh_token\ Ici se trouve l’emplacement pour entrer votre refresh_token pour que le widget puisse fonctionner.

Configuration du widget > Activer le module Transiteo\ Si la case est cochée, le module est activé.\ Si la case est décochée, le module est désactivé.

Configuration du widget > Position du widget\ Si “En haut à gauche”, le widget sera placé dans le coin gauche en haut.\ Si “En haut à droite”, le widget sera placé dans le coin droit en haut.\ Si “En bas à gauche”, le widget sera placé dans le coin gauche en bas.\ Si “En bas à droite”, le widget sera placé dans le coin gauche en bas.

Configuration du widget > Ouverture automatique du widget\ Si la case est cochée, le widget s’ouvrira automatiquement quand un visiteur arrive sur la home page, la page produit et la page panier ou quand les droits et taxes sont recalculés\ Si la case est décochée, le widget ne s’ouvrira pas automatiquement. Le visiteur devra cliquer sur le widget pour l’ouvrir.

Configuration du widget > Masquer le widget\ Si la case est cochée, le widget ne s’affiche pas.\ Si la case est cochée, le widget s’affiche.

Configuration du widget > Afficher une bannière d’estimation le widget\ Si la case est cochée, le widget ouvrira automatiquement une bannière d’estimation de droits et taxes pendant 3 secondes quand le visiteur arrive sur une page produit et la page panier ou quand la quantité des produits changent.\ Si la case est décochée, le widget n’ouvrira pas automatiquement la bannière d’estimation.

Configuration du widget > Convertir les devises\ Si la case est cochée, le widget calculera les droits et taxes dans la devise du visiteur.\ Si la case est décochée, le widget calculera les droits et taxes dans la devise du site.

Configuration du widget > Masquer Powered by transiteo\ Si la case est cochée, le widget affichera “Welcome is Powered by Transiteo” en bas de la fenêtre quand elle sera ouverte.\ Si la case est décochée, le widget n’affichera aucune mention.

Fonctionnement

Fonctionnement

L’application transiteo Landed Cost fait un pont entre votre compte transiteo et votre BigCommerce. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transite, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Si vous avez différents produits, il faut passer à la version Premium.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Fonctionnement du widget / Freemium

Vue sur la home page : (widget ouvert)

Image

Vue sur une page produit : (bannière ouverte)

Image

\ Vue sur une page produit : (widget ouvert)

Image

Vue sur la page panier : (bannière ouverte)

Image

Vue sur la page panier : (widget ouvert)

Image

Fonctionnement du module / Premium

Vue sur la home page : (widget ouvert)

Image

Vue sur une page produit : (bannière ouverte)

Image

\ Vue sur une page produit : (widget ouvert)

Image

Vue sur la page panier : (bannière ouverte)

Image

Vue sur la page panier : (widget ouvert)

Image

Vue sur une page produit : (sans widget)

Image

Vue sur la page panier : (sans widget)

Image

\ Vue sur la page checkout :

Image

Fonctionnement du plugin

Imbrication des Droits et Taxes sur les pages :

  • Produit
  • DDP
  • DDU
  • Panier
  • DDP
  • DDU
  • Paiement
  • DDP
  • DDU

Synchronisation Boutique <> Transiteo

  • Produits
  • Première synchronisation
  • Mise à jour
  • SKU / Product Id / Ref

  • Commandes

  • Première synchronisation
  • Mise à jour Statut de commande
  • Génération des documents exports
  • Prélèvement des Transactions Fees

  • Pays

  • Première synchronisation
  • Mise à jour
  • Numéro d’identification fiscal
  • Chiffre d’affaire additionné pays par pays

BIGCOMMERCE

Installation & Mise à jour

Installation & Mise à jour

transiteo Welcome

  • [ ] Rechercher l’application : transiteo ou Welcome ou transiteo Welcome

  • [ ] Obtenir l’application en cliquant sur le bouton “Get This App”

  • [ ] Installer l’application dans son back office BigCommerce

transiteo Landed Cost

  • [ ] Rechercher l’application : transiteo ou Landed Cost ou transiteo Landed Cost

  • [ ] Obtenir l’application en cliquant sur le bouton “Get This App”

  • [ ] Installer l’application dans son back office BigCommerce

Activation

Activation

transiteo Welcome

Créer un compte sur https://app.transiteo.io/#/register

  • [ ] Remplissez les champs requis pour vous inscrire

  • [ ] Cliquez sur “valider mon compte” dans l’email que vous avez reçu suite à l’enregistrement de votre compte.

    (il se peut que ce mail soit arrivé dans vos spams)

  • [ ] Vous allez être redirigé(e) sur la page de connexion du dashboard transiteo. Connectez-vous avec vos email et mot de passe renseigné lors de votre ouverture de compte.

    (Si vous ne vous souvenez plus de votre mot de passe, cliquez sur “Mot de passe oublié ?”)

  • [ ] A votre première connexion, vous allez être redirigé vers un tutoriel de paramétrage de votre boutique.

    Certaines parties sont obligatoires et d'autres peuvent être paramétrées par la suite.

  • [ ] Pour que l’extension fonctionne, vous n’avez pas besoin de choisir une formule payante. Le module fonctionne gratuitement.

  • [ ] Vous devez récupérer votre clef API pour activer votre application sur votre back office BigCommerce. Vous pouvez trouver cette clé dans les Paramètres (https://www.app.transiteo.io/#/settings)

  • [ ] Copier coller la clef dans l’application transiteo Welcome

transiteo Landed Cost

Créer un compte sur https://app.transiteo.io/#/register

  • [ ] Remplissez les champs requis pour vous inscrire

  • [ ] Cliquez sur “valider mon compte” dans l’email que vous avez reçu suite à l’enregistrement de votre compte.

    (il se peut que ce mail soit arrivé dans vos spams)

  • [ ] Vous allez être redirigé(e) sur la page de connexion du dashboard transiteo. Connectez-vous avec vos email et mot de passe renseigné lors de votre ouverture de compte.

    (Si vous ne vous souvenez plus de votre mot de passe, cliquez sur “Mot de passe oublié ?”)

  • [ ] A votre première connexion, vous allez être redirigé vers un tutoriel de paramétrage de votre boutique. Certaines parties sont obligatoires et d'autres peuvent être paramétrées par la suite.

  • [ ] Une fois votre formule contractée, vous devez récupérer votre client_id, votre refresh_token et votre widget API Key pour activer votre application sur votre back office BigCommerce. Vous pouvez trouver ces tokens dans les Paramètres (https://www.app.transiteo.io/#/settings)
  • [ ] Copier coller le client_id et le refresh_token dans le panneau d’authentification.

  • [ ] Copier coller le widget API Key dans Widget > Api Key

Configuration

Configuration

transiteo Welcome

La configuration de l’application “transiteo Welcome” est disponible dans via le menu Apps > My Apps > transiteo Welcome

Widget > Auto open widget\ Si “enabled”, le widget s’ouvrira automatiquement quand un visiteur arrive sur la home page, la page produit et la page panier ou quand les droits et taxes sont recalculés\ Si “disabled”, le widget ne s’ouvrira pas automatiquement. Le visiteur devra cliquer sur le widget pour l’ouvrir.

Widget > Estimation banner\ Si “enabled”, le widget ouvrira automatiquement une bannière d’estimation de droits et taxes pendant 3 secondes quand le visiteur arrive sur une page produit et la page panier ou quand la quantité des produits changent.\ Si “disabled”, le widget n’ouvrira pas automatiquement la bannière d’estimation.

General > Module\ Si “enabled”, le module est activé.\ Si “disabled”, le module est désactivé.

General > Show Widget\ Si “enabled”, le widget s’affiche.\ Si “disabled”, le widget ne s’affiche pas.

transiteo Landed Cost

La configuration de l’application “transiteo Landed Cost” est disponible dans via le menu Apps > My Apps > transiteo Landed Cost

General > Module\ Si “enabled”, le module est activé.\ Si “disabled”, le module est désactivé.

General > Client ID\ Ici se trouve votre client_id que vous avez entré précédemment dans le panneau d’authentification.

General > Refresh Token\ Ici se trouve votre refresh_token que vous avez entré précédemment dans le panneau d’authentification.

General > Show widget\ Si “enabled”, le widget s’ouvrira automatiquement quand un visiteur arrive sur la home page, la page produit et la page panier ou quand les droits et taxes sont recalculés\ Si “disabled”, le widget ne s’ouvrira pas automatiquement. Le visiteur devra cliquer sur le widget pour l’ouvrir.

General > Display Duties & Taxes on product page\ Si “enabled”, une estimation des droits et taxes s’affichera en dessous du prix sur la page produit.\ Si “disabled”, aucune estimation de droits et taxes sera affichée sur la page produit. On vous conseille si vous choisissez cette option d’activer le Widget.

General > Incoterm\ Peu importe ce que vous choisirez, les droits et taxes s’afficheront sur la page de paiement.\ Si “DDP”, les droits et taxes seront ajoutés à la commande. Vos clients payeront ces droits et taxes.\ Si “DDU”, les droits et taxes s’afficheront mais ne seront pas ajoutés à la commande. Vos clients devront les payer à l’arrivée de leur commande.

Bouton “Submit”\ Ce bouton permet d’enregistrer les modifications.

Bouton “Synchronise countries”\ Ce bouton permet de synchroniser les pays de livraison que vous avez configuré dans votre back office BigCommerce.

Widget > Api Key\ Ici se trouve votre widget API Key qu’il faut entrer pour que le widget puisse fonctionner.

Widget > Auto open widget\ Si “enabled”, le widget s’ouvrira automatiquement quand un visiteur arrive sur la home page, la page produit et la page panier ou quand les droits et taxes sont recalculés\ Si “disabled”, le widget ne s’ouvrira pas automatiquement. Le visiteur devra cliquer sur le widget pour l’ouvrir.

Widget > Estimation banner\ Si “enabled”, le widget ouvrira automatiquement une bannière d’estimation de droits et taxes pendant 3 secondes quand le visiteur arrive sur une page produit et la page panier ou quand la quantité des produits changent.\ Si “disabled”, le widget n’ouvrira pas automatiquement la bannière d’estimation.

Widget > Currency conversion\ Si “enabled”, le widget calculera les droits et taxes dans la devise du visiteur.\ Si “disabled”, le widget calculera les droits et taxes dans la devise du site.

Widget > Widget Position\ Si “Top left corner”, le widget sera placé dans le coin gauche en haut.\ Si “Top right corner”, le widget sera placé dans le coin droite en haut.\ Si “bottom left corner”, le widget sera placé dans le coin gauche en bas.\ Si “bottom right corner”, le widget sera placé dans le coin gauche en bas.

Widget > Powered by\ Si “enabled”, le widget affichera “Welcome is Powered by Transiteo” en bas de la fenêtre quand elle sera ouverte.\ Si “disabled”, le widget n’affichera aucune mention.

Fonctionnement

Fonctionnement

transiteo Welcome

L’application transiteo Welcome fait un pont entre votre compte transiteo et votre BigCommerce. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transite, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Si vous avez différents produits, il faut passer à la version Premium.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Vue du widget ouvert sur la home page :

Vue du widget ouvert sur une page produit :

Vue du widget ouvert sur la page panier :

Vue de la bannière d’estimation sur une page produit :

Vue de la bannière d’estimation sur la page panier :

transiteo Landed Cost

Fonctionnement du widget

L’application transiteo Landed Cost fait un pont entre votre compte transiteo et votre BigCommerce. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transite, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Si vous avez différents produits, il faut passer à la version Premium.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Vue du widget ouvert sur la home page :

Vue du widget ouvert sur une page produit :

Vue du widget ouvert sur la page panier :

Vue de la bannière d’estimation sur une page produit :

Vue de la bannière d’estimation sur la page panier :

Fonctionnement de l'application

Calcul des droits et taxes imbriqué dans les pages

Page produit :

Page panier :

Pour obtenir le calcul imbriqué sur la page Panier, il faut ajouter les infos de transport

DDP :

DDU :

Page paiement :

DDP :

DDU :

Commandes :

Factures :

Synchronisation

Produits

Première synchronisation :

Importer le CSV dans “Mon Catalogue” sur l’application Transiteo.

Associer automatiquement des codes douaniers à tous vos produits.

ou

Associer manuellement des codes douaniers à tous vos produits.

Mise à jour

Dès que vous allez mettre à jour un produit sur BigCommerce, la mise à jour dans votre catalogue sur transiteo se mettra automatiquement à jour.

SKU / Product Id / Ref

Les SKU / Product ID / Ref ne peuventt pas être mis à jour.

Commandes

Première synchronisation

Pas besoin de synchroniser vos anciennes commandes.

Mise à jour

Dès que le statut d’une commande est mis à jour ou toutes autres données, la mise à jour dans vos vente sur transiteo se mettra automatiquement à jour.

Statut de commande

Il existe 3 statuts de commande chez transiteo : PAID / AWAITING / CANCELED

Génération des documents exports

Pour générer les documents exports, il faut vous rendre dans “Mes ventes” sur l’application transiteo et cliquer sur le bouton de génération de document sur la commande en question. Dès lors il vous sera envoyer des pdf.

Prélèvement des Transactions Fees

Nous prélevons des commissions sur les droits et taxes des commandes ayant le statut PAID uniquement.

Pays

Première synchronisation

Un bouton a été créé pour l’occasion. Vous pouvez trouver ce bouton dans l’application transiteo Landed Cost sur BigCommerce dans “Général”

Mise à jour

Si vous modifiez un pays depuis votre BigCommerce, il sera mis à jour automatique dans l’application transiteo. Attention, si vous mettez à jour des pays dans l’application transiteo, il ne seront pas synchronisé avec votre BigCommerce. La synchronisation marche uniquement dans le sens BigCommerce > Transiteo.

Numéro d’identification fiscal

Au moment de la création de votre compte transiteo, nous vous demandons d’inscrire vos différents numéro fiscaux en fonction des pays. Si vous ne les avez pas rempli vous pouvez les remplir manuellement dans TaxManager.

Chiffre d’affaire additionné pays par pays

Nous calculons, additionnons vos ventes pour chaque pays. Les autorités fiscales de chaque pays demandent de tenir une comptabilité mais surtout le calcul des droits et taxes.

PRESTASHOP

Installation & Mise à jour

Installation & Mise à jour

transiteo Welcome

Vous avez 2 manières d'installer le module : \ \ 1. Télécharger & Installer le module d'après ce fichier ZIP

zip-transiteo-welcome

2. Télécharger & Installer le module depuis le site Prestashop

  • [ ] Rechercher l’application : transiteo ou Welcome ou transiteo Welcome

  • [ ] Télécharger le module

  • [ ] Installer le module dans son back office Prestashop

transiteo Landed Cost

Vous avez 2 manières d'installer le module : \ \ 1. Télécharger & Installer le module d'après ce fichier ZIP

zip-transiteo-landed-cost

2. Télécharger & Installer le module depuis le site Prestashop

  • [ ] Rechercher l’application : transiteo ou Welcome ou transiteo Welcome

  • [ ] Télécharger le module


  • [ ] Installer le module dans son back office Prestashop

Activation

Activation

transiteo Welcome

Créer un compte sur https://app.transiteo.io/#/register

  • [ ] Remplissez les champs requis pour vous inscrire

  • [ ] Cliquez sur “valider mon compte” dans l’email que vous avez reçu suite à l’enregistrement de votre compte.

    (il se peut que ce mail soit arrivé dans vos spams)

  • [ ] Vous allez être redirigé(e) sur la page de connexion du dashboard transiteo. Connectez-vous avec vos email et mot de passe renseigné lors de votre ouverture de compte.

    (Si vous ne vous souvenez plus de votre mot de passe, cliquez sur “Mot de passe oublié ?”)

  • [ ] A votre première connexion, vous allez être redirigé vers un tutoriel de paramétrage de votre boutique. Certaines parties sont obligatoires et d'autres peuvent être paramétrées par la suite.

  • [ ] Une fois votre formule contractée, vous devez récupérer votre widget API Key pour activer votre application sur votre back office Prestashop. Vous pouvez trouver ce token dans les Paramètres (https://www.app.transiteo.io/#/settings)

  • [ ] Copier coller le widget API Key dans le champ : Api Key

transiteo Landed Cost

Créer un compte sur https://app.transiteo.io/#/register

  • [ ] Remplissez les champs requis pour vous inscrire

  • [ ] Cliquez sur “valider mon compte” dans l’email que vous avez reçu suite à l’enregistrement de votre compte.

    (il se peut que ce mail soit arrivé dans vos spams)

  • [ ] Vous allez être redirigé(e) sur la page de connexion du dashboard transiteo. Connectez-vous avec vos email et mot de passe renseigné lors de votre ouverture de compte.

    (Si vous ne vous souvenez plus de votre mot de passe, cliquez sur “Mot de passe oublié ?”)

  • [ ] A votre première connexion, vous allez être redirigé vers un tutoriel de paramétrage de votre boutique. Certaines parties sont obligatoires et d'autres peuvent être paramétrées par la suite.

  • [ ] Une fois votre formule contractée, vous devez récupérer votre client_id et votre refresh_token pour activer votre application sur votre back office Prestashop. Vous pouvez trouver ces tokens dans les Paramètres (https://www.app.transiteo.io/#/settings)

  • [ ] Copier coller le client_id et votre refresh_token dans les champs correspondants

Configuration

Configuration

transiteo Welcome

La configuration du module “transiteo Welcome” est disponible dans via le menu Module Manager > Configure

Statut Module\ Si vous n'avez installé et activé uniquement le module "transiteo Welcome", vous serez en mode Freemium. Si avez installé et activé en plus du module "transiteo Welcome", le module "transiteo Landed Cost", vous serez en mode Premium.

API Key\ Ici se trouve l'API Key que vous avez entré précédemment pour activer votre module.

Automatically show Powered by Transiteo\ Permet d'afficher ou pas le trademark "transiteo" dans le widget.\ &#xNAN;Attention : en statut "Freemium" vous ne pourrez pas retirer le trademark

Automatically show widget\ Permet d'afficher ou pas le widget.\ Si vous êtes en mode Freemium et que vous n'afficher pas le widget, cela revient à désactiver le module.

transiteo Landed Cost

La configuration du module “transiteo Landed Cost” est disponible dans via le menu Module Manager > Configure

Activate Module Landed Cost (OFF/ON)\ Activer ou pas les fonctions du module transiteo Landed Cost\ \ Statut Module\ Si vous n'avez installé et activé uniquement le module "transiteo Welcome", vous serez en mode Freemium. Si avez installé et activé en plus du module "transiteo Welcome", le module "transiteo Landed Cost", vous serez en mode Premium.

refresh_token\ Ici se trouve le refresh_token que vous avez entré précédemment pour activer votre module.

client_id\ Ici se trouve le client_id que vous avez entré précédemment pour activer votre module.

Position Widget\ Permet de choisir la position du widget sur votre site ecommerce : \ - Botton Right : En bas à droite\ - Top Right : En haut à droite\ - Botton Left : En bas à gauche\ - Top Left : En haut à gauche

Display Duty on product page (OFF/ON)\ Permet d'afficher ou pas le calcul et l'affichage directement sur la page produit.\ \ Display Widget (OFF/ON)\ Permet d'afficher ou pas l'affichage du widget.\ \ Incoterm (DDP/DDU)\ Choisissiez l'incoterm de vos ventes : \ - DDP : Les droits de douanes et taxes seront ajoutés à la commande\ - DDU : Les droits de douanes et taxes seront affichés de façon informative et ne seront pas ajoutés à la commande.\ \ Use currency visitor (OFF/ON)\ Choisissez d'utiliser ou non pour le calcul des droits de douanes et taxes la devise du visiteur.\ \ Edit CSS\ Si vous souhaitez personnalisé l'affichage, vous pouvez inclure du CSS.

Fonctionnement

Fonctionnement

transiteo Welcome

Le module transiteo Welcome fait un pont entre votre compte transiteo et votre site Prestashop. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transite, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Si vous avez différents produits, il faut passer à la version Premium.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Vue du widget ouvert sur la home page :

Vue sur une page produit : (Bannière ouverte)

Vue sur une page produit : (Widget ouvert)

\ Vue sur la page panier : (Bannière ouverte)

\ Vue sur la page panier : (Widget ouvert)\

transiteo Landed Cost

Le module transiteo Welcome fait un pont entre votre compte transiteo et votre site Prestashop. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transite, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Si vous avez différents produits, il faut passer à la version Premium.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Vue du widget ouvert sur la home page :

Vue sur une page produit : (Bannière ouverte)

Vue sur une page produit : (Widget ouvert)

\ Vue sur la page panier : (Bannière ouverte)

\ Vue sur la page panier : (Widget ouvert)\

-------------------------------

-------------------------------

Zip : transiteo Welcome

Zip : transiteo Welcome

{% file src="https://18706970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLr4ZIcum9zLHPikml6Kk%2Fuploads%2FID6A5cuCv9LoEYwT2AQL%2Ftransiteo_welcome.zip?alt=media&token=932ca4ae-8bca-4dd7-bdac-643ec9c98b8a" %}

Zip : transiteo Landed Cost

Zip : transiteo Landed Cost

{% file src="https://18706970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLr4ZIcum9zLHPikml6Kk%2Fuploads%2FjdnUtN2R2jLQRX1sC9TE%2Ftransiteo_landed_cost.zip?alt=media&token=75a0d4ef-b2a3-4cf4-86bb-eaade5660f66" %}

Shopify Guide

Page 1

Page 1

Woocommerce Guide

Installation & Mise à jour

Installation & Mise à jour

Welcome

Vous avez 2 manières d'installer le module : \ \ 1. Télécharger & Installer l'extension d'après ce fichier ZIP

---------------

2. Télécharger & Installer l'extension depuis le site Wordpress

https://fr.wordpress.org/plugins

  • [ ] Rechercher l'extension : transiteo ou Welcome ou transiteo Welcome

  • [ ] Obtenir l'extension en cliquant sur le bouton “Télécharger”
  • [ ] Le plugin a été installé. Vous pouvez le retrouver dans la page Plugins > Installed Plugins

Landed Cost

Vous avez 2 manières d'installer le module : \ \ 1. Télécharger & Installer l'extension d'après ce fichier ZIP

----------------------------------

2. Télécharger & Installer l'extension depuis le site Prestashop

https://fr.wordpress.org/plugins

  • [ ] Rechercher l'extension : transiteo ou Landed Cost ou transiteo Landed Cost

  • [ ] Obtenir l'extension en cliquant sur le bouton “Télécharger”
  • [ ] Le plugin a été installé. Vous pouvez le retrouver dans la page Plugins > Installed Plugins

Activation

Activation

Welcome

Créer un compte sur https://app.transiteo.io/#/register

https://app.transiteo.io/#/register

  • [ ] Remplissez les champs requis pour vous inscrire

  • [ ] Cliquez sur “valider mon compte” dans l’email que vous avez reçu suite à l’enregistrement de votre compte.

    (il se peut que ce mail soit arrivé dans vos spams)

  • [ ] Vous allez être redirigé(e) sur la page de connexion du dashboard transiteo. Connectez-vous avec vos email et mot de passe renseigné lors de votre ouverture de compte.

    (Si vous ne vous souvenez plus de votre mot de passe, cliquez sur “Mot de passe oublié ?”)

  • [ ] A votre première connexion, vous allez être redirigé vers un tutoriel de paramétrage de votre boutique.

    Certaines parties sont obligatoires et d'autres peuvent être paramétrées par la suite.

  • [ ] Pour que l’extension fonctionne, vous n’avez pas besoin de choisir une formule payante. Le module fonctionne gratuitement.
  • [ ] Vous devez récupérer votre clef API pour activer votre extension sur votre back office Wordpress. Vous pouvez trouver cette clé dans les Paramètres (https://www.app.transiteo.io/#/settings)

https://www.app.transiteo.io/#/settings

  • [ ] Copier coller la clef dans l'extension transiteo Welcome

Landed Cost

Créer un compte sur https://app.transiteo.io/#/register

https://app.transiteo.io/#/register

  • [ ] Remplissez les champs requis pour vous inscrire

  • [ ] Cliquez sur “valider mon compte” dans l’email que vous avez reçu suite à l’enregistrement de votre compte.

    (il se peut que ce mail soit arrivé dans vos spams)

  • [ ] Vous allez être redirigé(e) sur la page de connexion du dashboard transiteo. Connectez-vous avec vos email et mot de passe renseigné lors de votre ouverture de compte.

    (Si vous ne vous souvenez plus de votre mot de passe, cliquez sur “Mot de passe oublié ?”)

  • [ ] A votre première connexion, vous allez être redirigé vers un tutoriel de paramétrage de votre boutique.

    Certaines parties sont obligatoires et d'autres peuvent être paramétrées par la suite.

https://www.app.transiteo.io/#/plans

  • [ ] Une fois votre formulPour que l’extension fonctionne, vous n’avez pas besoin de choisir une formule payante. Le module fonctionne gratuitement.Pour que l’extension fonctionne, vous n’avez pas besoin de choisir une formule payante. Le module fonctionne gratuitemente contractée, vous devez récupérer votre client_id et refresh_token pour activer votre plugin sur votre back office Wordpress. Vous pouvez trouver ces clés dans les Paramètres (https://www.app.transiteo.io/#/settings)

https://www.app.transiteo.io/#/settings

  • [ ] Copier coller le widget API Key, le client_id et le refresh_token dans le plugin transiteo Welcome

Configuration

Configuration

Welcome

La configuration du plugin “transiteo Welcome” est disponible via :

  • La page Plugins > Installed Plugins > transiteo Welcome > Settings

ou

  • Dans le menu de gauche Transiteo > Configuration

Configuration > API Key\ Ici se trouve votre widget API Key qu’il faut entrer pour que le widget puisse fonctionner.

Options > Activate\ Si la case est cochée, le module est activé.\ Si la case est décochée, le module est désactivé.

Options > Statut\ Ici se trouve le statut de votre compte.

Options > Let the widget open automatically\ Si la case est cochée, le widget s’ouvrira automatiquement quand un visiteur arrive sur la home page, la page produit et la page panier ou quand les droits et taxes sont recalculés.\ Si la case est décochée, le widget ne s’ouvrira pas automatiquement. Le visiteur devra cliquer sur le widget pour l’ouvrir.

Landed Cost

La configuration du plugin “transiteo Landed Cost” est disponible via :

  • La page Plugins > Installed Plugins > transiteo Landed Cost > Settings

ou

  • Dans le menu de gauche Transiteo > Options

Options > Activate\ Si le toggle est violet, le module est activé.\ Si le toggle est grisé, le module est désactivé.

Options > Statut\ Ici se trouve le statut de votre compte.

Options > Display Duties and taxes\ Si le toggle est violet, les droits et taxes s'affichent sur la page produit\ Si le toggle est grisé, les droits et taxes ne s'affichent pas sur la page produit

Options > Hide widget\ Si le toggle est violet, le widget est masqué.\ Si le toggle est grisé, le widget s'affiche.

Options > Widget position\ Si “bottom right”, le widget sera placé dans le coin gauche en bas.\ Si “bottom left”, le widget sera placé dans le coin gauche en bas.\ Si “Top right”, le widget sera placé dans le coin droite en haut.\ Si “Top left”, le widget sera placé dans le coin gauche en haut.

Options > Let the widget open automatically\ Si le toggle est violet, le widget s’ouvrira automatiquement quand un visiteur arrive sur la home page, la page produit et la page panier ou quand les droits et taxes sont recalculés.\ Si le toggle est grisé, le widget ne s’ouvrira pas automatiquement. Le visiteur devra cliquer sur le widget pour l’ouvrir.

Options > Hide the Powered by transiteo\ Si le toggle est violet, le widget affichera “Welcome is Powered by Transiteo” en bas de la fenêtre quand elle sera ouverte.\ Si le toggle est grisé, le widget n’affichera aucune mention.

Dès que vous avez installé et configuré votre plugin, cliquez sur le bouton “Launch” pour synchroniser votre boutique avec transiteo. Cette opération est à faire une seule fois.

Fonctionnalités

Fonctionnalités

Welcome

Fonctionnement du widget

L'extension transiteo Welcome fait un pont entre votre compte transiteo et votre Wordpress. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transite, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Si vous avez différents produits, il faut passer à la version Premium.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Vue sur la home page : (widget ouvert)

\ Vue sur une page produit : (bannière ouverte)

Vue sur une page produit : (widget ouvert)

\ Vue sur la page panier : (bannière ouverte)

Vue sur la page panier : (widget ouverte)

Landed Cost

Fonctionnement du widget

L'extension transiteo Welcome fait un pont entre votre compte transiteo et votre Wordpress. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transite, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Si vous avez différents produits, il faut passer à la version Premium.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Vue du fonctionnement du widget :

Vue sur la home page : (widget ouvert)

\ Vue sur une page produit : (bannière ouverte)


Vue sur une page produit : (widget ouvert)

Vue sur la page panier : (bannière ouverte)

Vue sur la page panier : (widget ouverte)

Vue du fonctionnement sans widget :

Vue sur la page produit :


Vue sur la page panier :


Vue sur la page checkout :

Fonctionnement du plugin

Imbrication des Droits et Taxes sur les pages :

  • Produit

    • DDP

    • DDU

  • Panier

    • DDP


    • DDU

  • Paiement

    • DDP

    • DDU

Synchronisation Boutique <> Transiteo

  • Produits

    • Première synchronisation

    Pour synchroniser vos produits, rendez-vous dans l'onglet "Synchronisation" et appuyer sur le bouton "Launch" : \ \ \ \ Vous verrez dans la plateforme transiteo dans la page MON CATALOGUE, vos produits : \ \ \ \ &#xNAN;ou

    Importer le CSV dans “Mon Catalogue” sur l’application Transiteo.

    \ \ \ Associer des codes douaniers à vos produits : \ \ Automatiquement :

    Si vous voulez associer des codes douaniers à vos produits de façon automatique \ \ ou

    Manuellement :

    \


    • Mise à jour

    Les mises à jour que vous faites sur vos produits dans vos back office WordPress seront synchronisé avec ceux de votre CATALOGUE transiteo. \ \
    * SKU / Product Id / Ref

Si vous modifiez le SKU, le product ID ou la Ref d'un de vos produits, cela créera un nouveau produit dans votre CATALOGUE transiteo.\ Evitez au maximum de mettre à jour ces données d'un produit.

  • Commandes

    • Première synchronisation

    Vos anciennes commandes ne sont pas synchronisées. Elles commenceront à se synchroniser à partir de l'activation du module transiteo Landed Cost.

    • Mise à jour Statut de commande \ \ Il existe 3 statuts de commande chez transiteo : PAID / AWAITING / CANCELED

    Order Statut WordpressOrder Statut Transiteo
    Pending payment
AWAITING
    Processing
AWAITING
    On hold
AWAITING
    Completed
PAID
    Cancelled
CANCELED
    Refunded
CANCELED
    FailedCANCELED


    • Génération des documents exports \ \
    • Prélèvement des Transactions Fees\ \ Il y a des commissions uniquement les droits et taxes d'une commande. Cette commission s'élève à 2%.\ \ Le débit se fait tous les 15 jours sur la carte que vous avez paramètré lors de la contraction de votre formule transiteo\ \ &#xNAN;Exemple : Une commande validée, payée, expédiée et non retournée de 100 EUR Hors Taxes + 30 EUR de Taxes (Douanes & VAT). \ 2% x 30 EUR = 0,60 EUR de commission prélevée
  • Pays

    • Première synchronisation

    Un bouton a été créé pour l’occasion. Vous pouvez trouver ce bouton dans l'onglet "Synchronization" dans les settings de transiteo Landed Cost sur Wordpress.

    • Mise à jour

    Si vous modifiez un pays depuis votre Wordpress, il sera mis à jour automatique dans l’application transiteo. Attention, si vous mettez à jour des pays dans l’application transiteo, il ne seront pas synchronisé avec votre Wordpress. La synchronisation marche uniquement dans le sens Wordpress > Transiteo

    • Numéro d’identification fiscal

    Au moment de la création de votre compte transiteo, nous vous demandons d’inscrire vos différents numéro fiscaux en fonction des pays. Si vous ne les avez pas rempli vous pouvez les remplir manuellement dans TaxManager.

    • Chiffre d’affaire additionné pays par pays

    Nous calculons, additionnons vos ventes pour chaque pays. Les autorités fiscales de chaque pays demandent de tenir une comptabilité mais surtout le calcul des droits et taxes.

-------------------------------

-------------------------------

Download - Welcome

Download - Welcome

{% file src="https://1513986945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMS4m3rCsPrZK9THpKOYy%2Fuploads%2FtCK52oPRmdVBXRGuj8Pt%2Ftransiteo-cms-addons-woocommerce-main%20(2).zip?alt=media&token=62a11086-398c-48c6-9eaa-2f9fac5fe41b" %}

Download - Landed Cost

Download - Landed Cost

{% file src="https://1513986945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMS4m3rCsPrZK9THpKOYy%2Fuploads%2FqJo3SkV2bpS2ztVwflRX%2Ftransiteo-cms-landed-cost-woocommerce-main%20(2).zip?alt=media&token=a2995fad-d286-4283-a12a-36faeb1b010b" %}

Prestashop Guide

Comment ça marche ?

Comment ça marche ?

Grâce au module Prestashop Welcome et/ou Landed Cost développé par Transiteo, vous allez gérer vos ventes à l'international facilement et en toute transparence. \ \ \=> La clef de la réussite à l'export est de vendre et expédier en DDP (Delivery Duties Paid). \ Mais reste à bien le gérer ! \ \ Dans le cas d'une vente en DDP, les droits et taxes ne sont plus à payer à l'arrivée par le destinataire mais doit être payer par l'expéditeur auprès de son transporteur. Il faut donc que l'expéditeur puisse gérer les taxes à faire payer à son acheteur avec précision, générer les bons documents export avec toutes les infos, etc. \ \ C'est là que Transiteo intervient pour vous

Comment fonctionne le module ?

Côté admin\ \ 1. Le module va synchroniser vos produits à l'installation et les mises à jour de produits (création, suppression & modification). \ 2. Le module va remonter les infos de commandes (création, suppression & modification) uniquement de vos ventes à l'export dans l'application Transiteo\ 3. Le module permet l'affichage des taxes côté acheteur (en dynamique ou en statique),

Côté acheteur

1. Le module va géolocaliser le visiteur grâce à son IP afin d'en déduire dès le début son pays de destination.\ 2. Le module va calculer automatiquement les droits de douane et taxes locales sur la fiche produit, le panier et le checkout.

Comment fonctionne la plateforme ?

Voici le guide le plateforme

Quels sont les bénéfices ?

Pour vos acheteurs : Ils vont pouvoir payer les taxes au moment de la commande et n'auront plus la surprise de devoir payer ces taxes à l'arrivée sans qu'ils en soient informé.

Pour votre comptabilité / finance : Vous n'aurez qu'un seul interlocuteur pour reverser ces droits et taxes, ce sera votre transporteur. Qui lui se chargera de payer les divers organismes et institutions localement. Il fait office d'intermédiaire fiscal pour vous. Il vous enverra, en fin de mois généralement, une facture des expéditions qu'il a effectué pour vous mais aussi une facture des droits et taxes à lui reverser.

Pour vos équipes logistiques / conformités : Vous n'avez plus besoin de créer manuellement des documents pour votre transporteur, Transiteo les génère automatiquement pour vous (facture d'export, certificat d'origine, declaration lithium, ...).

Pour vos équipes e-merchandising : Vous n'avez plus besoin d'attacher une règle de taxe par produit et par pays. Transiteo le gère pour vous et de façon automatique.

Il faut demander à votre transporteur s'il gère le DDP dans vos pays où vous allez expédier votre marchandise.\ \ Notez que FedEx, DHL et UPS sont les transporteurs qui gèrent le DDP dans tous les -pays du monde. D'autres transporteurs le gèrent mais dans certains pays.

Comment fonctionne le calcul des droits et taxes ?

Pour calculer les droits et taxes, il faut :

  • Un pays de départ. Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur acheteur, peut choisir de changer de pays grâce à une liste déroulante dans le widget Welcome. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.\ Si vous n'activez pas le widget, la géolocalisation s'effectue tout de même pour pouvoir calculer les droits et taxes.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transiteo, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Ce sera donc une estimation du montant des droits et taxes sur tous vos produits. \ Si vous avez différents produits, il faudra passer à la version Premium qui prendra en compte le code douanier de chacun de vos produits afin de faire un calcul précis.
  • Le prix du ou des produit(s) ou de la commande avec les frais de livraison.

Pré requis

Pré requis

Pour créer un compte transiteo, suivez ces étapes :

  1. Allez sur : https://app.transiteo.io/#/register :

2. Remplissez les champs et sélectionnez votre méthode d'intégration : CMS - Prestashop 1.7.X

3. Cochez la case pour valider les Conditions générales de vente

4. Cliquez sur le bouton S'inscrire

\ 5. Vous allez recevoir un email de validation :

6. C'est l'heure de vous connecter à votre compte : https://app.transiteo.io

7. Lors de votre première connexion, vous allez ensuite être redirigé.e vers un tutoriel de paramétrage de votre compte :

a. PARAMETRES DE COMPTE :

RAISON SOCIALE

Indiquez le nom de votre entreprise

Exemple : Ma Société

URL DE VOTRE BOUTIQUE

Indiquez l'adresse url de votre boutique en ligne

Exemple : http://www.monsite.com ou https://www.monsite.com

VOTRE MÉTHODE D'INTÉGRATION

Choisissez dans la liste déroulante

Choix : CMS - Prestashop 1.7.X ou supérieur.

b. PARAMETRES D'EXPEDITION :

PAYS

Choisissez dans la liste déroulante

Choix : Cliquez ici pour voir les pays disponibles

ADRESSE DE DÉPART

Indiquez l'adresse postale du point de départ de vos envois

Exemple : 34 Rue principale

CODE POSTAL

Saisissez le code postal de la ville de départ de vos expéditions

Exemple : 75001

VILLE

Indiquez le nom de la ville de départ

Exemple : Paris

ÉTAT / RÉGION

Choisissez dans la liste déroulante

Choix : Les états, régions, districts changent en fonction du pays.

c. PAYS DE DESTINATION :

Sélectionnez les pays ou continents entiers dans lesquels vous expédiez ou vous souhaitez expédier.

d. PARAMETRES TAX MANAGER :

NUMÉRO D'IDENTIFICATION FISCALE

Choisissez dans la liste déroulante

Choix : Cliquez pour voir le continent, pays ou région dans la liste

e. CLASSIFICATION DOUANIERE :

CATÉGORIE DE PRODUITS PAR DÉFAUT

Choisissez la catégorie de produits par défaut de votre boutique

Choix : Choisissez la catégorie de produits

CODE SH PAR DÉFAUT

Indiquez le code SH (code douanier) par défaut

Exemple : 8508190000

DESCRIPTIONS DE PRODUITS PAR DÉFAUTS

Indiquez le titre ou la description du produit le plus vendu

Exemple : aspirateur

PAYS D'ORIGINE DES PRODUITS PAR DÉFAUT

Choisissez le pays d'origine des produits par défaut

Choix : Choisissez le pays d'origine

f. PARAMETRES TRANSPORTEURS :

g. RECAPITULATIF :

8. Votre compte a bien été paramétrer. Vous pouvez modifier vos informations si vous le souhaitez. Cliquez sur "Choisir ma formule"

9. Vous allez être redirigé vers la page des abonnements :

10. Sélectionnez et régler votre formule :

11. Régler votre formule

Les commissions sont prélevées tous les 15 jours et l'abonnement est prélevé à la date d'anniversaire.

-------------------------------

-------------------------------

Installation & Mise à jour

Installation & Mise à jour

Il y a 2 onglets par page : Welcome et Landed Cost

Welcome

Téléchargez & Installez le module "Welcome" d'après ce fichier ZIP :

{% file src="https://101331140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmDm3dpR5fSAVnFeI0QMo%2Fuploads%2F2SfofwGU49YuJOWWE5YA%2Ftransiteo-cms-addons-welcome-prestashop-main%20(1).zip?alt=media&token=01b7a15e-6144-4565-8f1b-1a93a6a5ca42" %}

Aller dans le module manager de votre back office : /index.php/improve/modules/manage

Cliquez sur "Upload a module" :

Sélectionnez et ouvrez le fichier ZIP téléchargé.\ \ Votre module a été installé et est prêt à être configuré :

Landed Cost

Téléchargez & Installez le module "Welcome" d'après ce fichier ZIP :

{% file src="https://101331140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmDm3dpR5fSAVnFeI0QMo%2Fuploads%2FIHGI4L1VVYN5L8gf0q9T%2Ftransiteo-cms-addons-landed-cost-prestashop-main%20(1).zip?alt=media&token=bc3e1482-0e5e-498e-b68b-389aa3596fec" %}

Aller dans le module manager de votre back office : /index.php/improve/modules/manage

Cliquez sur "Upload a module" :

Sélectionnez et ouvrez le fichier ZIP téléchargé.\ \ Votre module a été installé et est prêt à être configuré :

Activation

Activation

Welcome

Vous devez récupérer votre widget API Key pour activer le module Welcome sur votre back office Prestashop. Vous pouvez trouver ce token dans les Paramètres (https://www.app.transiteo.io/#/settings)

Copier la widget API Key :

Coller la widget API Key dans le champ API Key de la page configuration du module Welcome.


Landed Cost

Vous devez récupérer votre client_id & refresh_token pour activer le module Landed Cost sur votre back office Prestashop. Vous pouvez trouver ce token dans les Paramètres (https://www.app.transiteo.io/#/settings)

Copier le refresh_token et le client_id :

Coller le refresh_token et le client_id dans les champs correspondants de la page configuration du module Landed Cost.


Configuration

Configuration

Welcome

La configuration du module “transiteo Welcome” est disponible dans via le menu Module Manager > Configure

Statut Module\ Si vous n'avez installé et activé uniquement le module "transiteo Welcome", vous serez en mode Freemium. Si avez installé et activé en plus du module "transiteo Welcome", le module "transiteo Landed Cost", vous serez en mode Premium.

API Key\ Ici se trouve l'API Key que vous avez entré précédemment pour activer votre module.

Automatically show Powered by Transiteo\ Permet d'afficher ou pas le trademark "transiteo" dans le widget.\ &#xNAN;Attention : en statut "Freemium" vous ne pourrez pas retirer le trademark

Automatically show widget\ Permet d'afficher ou pas le widget.\ Si vous êtes en mode Freemium et que vous n'afficher pas le widget, cela revient à désactiver le module.

Landed Cost

Pré requis :

Transiteo va reprendre la main sur la gestion des taxes. Vous n'aurez plus à associer pour chaque produit et pour chaque pays une règle de taxes. Vous devez donc désactivé la gestion des taxes de Prestashop comme sur la capture : \ \ \/administration/index.php/improve/international/taxes/

La configuration du module “transiteo Landed Cost” est disponible dans via le menu Module Manager > Configure

Activate Module Landed Cost (OFF/ON)\ Activer ou pas les fonctions du module transiteo Landed Cost\ \ Statut Module\ Si vous n'avez installé et activé uniquement le module "transiteo Welcome", vous serez en mode Freemium. Si avez installé et activé en plus du module "transiteo Welcome", le module "transiteo Landed Cost", vous serez en mode Premium.

refresh_token\ Ici se trouve le refresh_token que vous avez entré précédemment pour activer votre module.

client_id\ Ici se trouve le client_id que vous avez entré précédemment pour activer votre module.

Position Widget\ Permet de choisir la position du widget sur votre site ecommerce : \ - Bottom Right : En bas à droite\ - Top Right : En haut à droite\ - Bottom Left : En bas à gauche\ - Top Left : En haut à gauche

Display Duty on product page (OFF/ON)\ Permet d'afficher ou pas le calcul et l'affichage directement sur la page produit.\ \ Display Widget (OFF/ON)\ Permet d'afficher ou pas l'affichage du widget.\ \ Incoterm (DDP/DDU)\ Choisissiez l'incoterm de vos ventes : \ - DDP : Les droits de douanes et taxes seront ajoutés à la commande\ - DDU : Les droits de douanes et taxes seront affichés de façon informative et ne seront pas ajoutés à la commande.\ \ Use currency visitor (OFF/ON)\ Choisissez d'utiliser ou non pour le calcul des droits de douanes et taxes la devise du visiteur.\ \ Edit CSS\ Si vous souhaitez personnalisé l'affichage, vous pouvez inclure du CSS.

Synchro Prestashop<>Transiteo

Synchro Prestashop<>Transiteo

Pays

Produits

Commandes

Fonctionnement - Front end

Fonctionnement - Front end

Welcome

Le module transiteo Welcome fait un pont entre votre compte transiteo et votre site Prestashop. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous avez configuré quand vous avez créé votre compte sur l’application transiteo, un HSCode par défaut pour tous vos produit (HSCode signifie Harmonized System Code, en bon français “un code douanier”). C’est avec ce code douanier (HSCode) par défaut que nous nous basons pour faire le calcul. Si vous avez différents produits, il faut passer à la version Premium.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Vue du widget ouvert sur la home page :

Vue sur une page produit : (Bannière ouverte)

Vue sur une page produit : (Widget ouvert)

\ Vue sur la page panier : (Bannière ouverte)

\ Vue sur la page panier : (Widget ouvert)

Landed Cost

Le module transiteo Welcome fait un pont entre votre compte transiteo et votre site Prestashop. Sans ce pont, le widget ne fonctionnerait pas et calculer les droits et taxes ne pourrait se faire.

Comment ça marche ?

Pour calculer des droits et taxes, il faut :

  • Un pays de départ Vous l’avez configuré pendant la création de votre compte sur l’application transiteo. C’est le pays d'où part la marchandise.
  • Un pays d’arrivée. C’est le pays dans lequel votre futur client se trouve. Grâce à une géolocalisation par ip, nous connaissons avec exactitude l’emplacement de votre futur client. Le visiteur, futur client, peut choisir de changer de pays grâce à une liste déroulante. Nous l’informons dès la page d’accueil que des taxes supplémentaires peuvent être ajoutées en fonction d’un montant d’achat. Une fois arrivée sur un page produit, le calcul va se faire.
  • Un ou plusieurs produit(s) et plus particulièrement son ou leur code douanier. Chaque produit a un code douanier différent et chaque pays a des codes douanier différents des autres. Vous devez préalablement classifier votre base de données produits en code douanier. Vous pouvez réaliser cette opération dans la partie Catalogue / Produits.
  • Le prix du produit ou de la commande. Quand vous créez des produits vous attachez un prix de vente, c’est sur ce prix que le widget se base pour faire le calcul.

Vue du calcul de droits et taxes sur une page produit :

Vue sur la popup "Ajout au panier" :

Vue sur la page panier : (en DDP)

Vue sur la page checkout :

\ Vue sur la page checkout : (en DDP - Transport gratuit)

\ Vue sur la page checkout : (en DDP - Transport gratuit)

Fonctionnement - Back office

Fonctionnement - Back office

Welcome

Le

Landed Cost

Utilisation transiteo Dashboard

Utilisation transiteo Dashboard

Mes ventes

Mon catalogue

Mes clients

Mes documents

Mes taxes

-------------------------------

-------------------------------

Pourquoi ?

Pourquoi ?

Bénéfices des modules Prestashop transiteo

  • Être en conformité avec les règles et les lois fiscales de chaque pays
  • Vendre mieux ou pour la première fois dans plus de 198 pays
  • Réduire votre taux de retour colis si vous vendez déjà à l'international
  • Eviter la frustration d'un client devant payer des taxes à réception.
  • Être transparent avec vos clients sur les taxes à payer en amont de la commande.
  • Augmenter votre chiffre d’affaire et votre panier moyen à l'international
  • Réduire vos échanges mail et chat suite aux plaintes clients
  • Automatiser les règles de taxes à appliquer à chaque produit dans le back office
  • Ajouter ou afficher les taxes sur la pages produit, le panier et dans le checkout
  • Commencer à vendre et expédier en DDP
  • Réduire vos tarifs de transport
  • Générer automatiquement les documents pour exporter votre marchandise.
  • ...

Combien ça coute ?

Combien ça coute ?

L'abonnement mensuel est à 49€/mois (sans engagement de durée)\ + une commission de 2%* sur le montant des droits et taxes des commandes effectuées.

Exemple : Commande de 130€ droits et taxes comprises. Détail : le produit 100€ H.T + 30€ de droits et taxes. 30€ x 2% = 0,6€ de commission à reverser à transiteo.

*La commission de 2% peut être ajouté dans le calcul des droits et taxes grâce à un paramètres dans votre compte. Dès lors ce seront vos acheteurs qui payeront la commission.

Exemple : Commande de 130,6€ droits et taxes comprises. Détail : le produit 100€ H.T + 30€ de droits et taxes + 0,6€ de commission (30€ x 2%).

Pour pouvoir faire du calcul de droits et taxes, nous nous basons sur les HS Codes de vos produits. Si vous les connaissez, il faudra les ajouter à votre base de données produits dans transiteo Dashboard. Sinon il faudra les classifier automatiquement grâce à notre moteur d'intelligence artificielle et c'est un service payant : \ \ 1 to 50 produits à classifier : 0,50€ / produits \ 51 to 250 produits à classifier : 0,35€ / produits \ 251 to 500 produits à classifier : 0,25€ / produits \ 501 to 1 200 produits à classifier : 0,16€ / produits \ 1 201 to 6 000 produits à classifier : 0,12€ / produits \ 6 001 to 35 000 produits à classifier : 0,08€ / produits \ 35 001 to 100 000 produits à classifier : 0,04€ / produits \ 100 001 to 1 000 000 produits à classifier : 0,03€ / produits

Intégration sur mesure

Intégration sur mesure

Nous vous proposons un accompagnement sur mesure depuis la création de votre compte transiteo jusqu'au Go Live. Ne vous souciez plus de rien. Contactez-nous par email à support@transiteo.com

Foire aux questions

Foire aux questions

Que faîtes-vous des données de ventes ? \ Vos données sont cryptés et il faut une clef pour les décrypter. Seul vous avez cette clef. Nous ne pouvons rien faire avec vos données si ce n'est que de faire un oeuvre d'art numérique avec :)

Existe-t-il des incompatibilités avec d'autres modules ? \ C'est possible qu'un de vos modules empêche celui de transiteo de fonctionner. Dans ce cas, il faut faire une recherche et vous créez un patch pour que ça puisse correctement fonctionner. Vous pouvez vous en occuper ou bien nos équipes peuvent le faire.

Les HS Codes de mes produits ne fonctionnent pas, quoi faire ?\ Quand vous associez un HSCode à un produit, nous vérifions si celui ci est juste, à jour sur la dernière version de la nomenclatures.

Prestashop Guide (English)

Pre-required

Pre-required

To create a transiteo account, follow these steps :

  1. Go to : https://app.transiteo.io/#/register :

2. Fill in the fields and select your integration method : CMS - Prestashop 1.7.X

3. Check the box to validate the Terms and Conditions

4. Click on the Register button

\ 5. You will receive a validation email :

6. It's time to log in to your account : https://app.transiteo.io

7. When you log in for the first time, you will be redirected to a tutorial for setting up your account :

a. ACCOUNT SETTINGS :

COMPANY NAME

Fill the name of your company

Example : My Company

URL OF YOUR STORE

Indicate the url address of your online store

Example : http://www.mystore.com ou https://www.mystore.com

YOUR INTEGRATION METHOD

Choose in the dropdown list

Choice to select : CMS - Prestashop 1.7.X ou supérieur.

b. SHIPPING PARAMETERS :

COUNTRY

Choose form the drop down list

Option : Click here to see the available countries

DEPARTURE ADDRESS

Indicate the postal address of the departure point of your shipments

Example : Main Street 34th

POSTAL CODE

Fill the postal code of the city from which your shipments will depart.

Example : 75001

CITY

Fill the name of the city of departure

Example : Paris

STATE / REGION

Choose form the drop-down list

Option : States, regions, districts change depending on the country.

c. DESTINATION COUNTRIES :

Select the countries or entire continents you are shipping to or want to ship to.

d. TAX MANAGER SETTINGS :

TAX IDENTIFICATION NUMBER

Select from the drop down list.

Option : Click to see the continent, country or region in the list.

e. CUSTOMS CLASSIFICATION :

DEFAULT PRODUCT CATEGORY

Choose the default product category for your store.

Option : Choose the product category

DEFAULT SH CODE

Indicate the default HS code (customs code).

Example : 8508190000

DEFAULT PRODUCT DESCRIPTIONS

Enter the title or description of the best selling product.

Example : vacuum cleaner

DEFAULT COUNTRY OF ORIGIN OF PRODUCTS

Choose the country of origin of the default products.

Option : Choose the country of origin.

f. CARRIER SETTINGS :

g. SUMMARY :

8. Your account has been set up. You can modify your information if you wish. Click on "Choose my formula".

9. You will be redirected to the subscriptions page.

10. Select and set your plan :

11. Pay for your plan

Commissions are deducted every 15 days and the subscription is deducted on the anniversary date.

-------------------------------

-------------------------------

Installation & Update

Installation & Update

There are 2 tabs per page: Welcome and Landed Cost

Welcome

Download & Install the "Welcome" module from this ZIP file :

{% file src="https://3447039759-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvIqLnjDgBeLuXYr7TuGe%2Fuploads%2FePconMLEtuvtjRp2I28N%2Ftransiteo_welcome.zip?alt=media&token=feda3f4f-3d32-4483-a744-4c4b5e65cddd" %}

Go to the module manager of your back office : /index.php/improve/modules/manage

Click on "Upload a module" :

Select and open the uploaded ZIP file.\ \ Your addon has been installed and is ready to be configured :

Landed Cost

Download & Install the "Welcome" module from this ZIP file :

{% file src="https://3447039759-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvIqLnjDgBeLuXYr7TuGe%2Fuploads%2FOtUPaWliESOKtl1Un3u0%2Ftransiteo_landed_cost.zip?alt=media&token=32742d7a-35c8-4bca-ae05-6ee9b3e3bcd5" %}

Go to the module manager of your back office : /index.php/improve/modules/manage

Click on "Upload a addon" :

Select and open the uploaded ZIP file.\ \ Your module has been installed and is ready to be configured :

Activation

Activation

Welcome

You need to get your API Key widget to activate the Welcome module on your Prestashop back office. You can find this token in the Settings (https://www.app.transiteo.io/#/settings)

Copy the API Key widget :

Paste the API Key widget into the API Key field on the Welcome module configuration page.


Landed Cost

You need to get your client_id & refresh_token to activate the Landed Cost module on your Prestashop back office. You can find this token in the Settings (https://www.app.transiteo.io/#/settings)

Copy the refresh_token and the client_id :

Paste the refresh_token and client_id in the corresponding fields of the Landed Cost module configuration page.


Configuration

Configuration

Pre-required :

Transiteo will take over the management of taxes. You will not have to associate for each product and for each country a tax rule. You must therefore deactivate the management of taxes in Prestashop as on the capture : \ \ \/administration/index.php/improve/international/taxes/

Welcome

The configuration of the "transiteo Welcome" module is available in the Module Manager.

then click on configure

Module status \ If you have installed and activated only the "transiteo Welcome" module, you will be in Freemium mode. If you have installed and activated the "transiteo Landed Cost" module in addition to the "transiteo Welcome" module, you will be in Premium mode.

API Key\ Here you will find the API Key that you entered earlier to activate your module.

activation

Automatically show Powered by Transiteo\ Allows you to display or not the trademark "transiteo" in the widget. Warning : in "Freemium" status you can't remove the trademark

operation-back-less-than-greater-than-front

Automatically show widget\ Allows to display or not the widget. If you are in Freemium mode and you don't show the widget, it is the same as disabling the module.

operation-back-less-than-greater-than-front

Landed Cost

The configuration of the "transiteo Landed Cost" module is available in the Module Manager.

then click on configure

SETTINGS

Activate Module Landed Cost (OFF/ON)\ Activate or not the functions of the transiteo Landed Cost module

operation-back-less-than-greater-than-front

\ Statut Module\ If you have installed and activated only the "transiteo Welcome" module, you will be in Freemium mode. If you have installed and activated the "transiteo Landed Cost" module in addition to the "transiteo Welcome" module, you will be in Premium mode.

refresh_token\ This is the refresh_token you entered earlier to activate your module.

activation

client_id\ This is the client_id you entered earlier to activate your module.

activation

Position Widget\ Allows you to choose the position of the widget on your ecommerce site : \ - Bottom Right\ - Top Right\ - Bottom Left\ - Top Left

operation-back-less-than-greater-than-front

Display Duty on product page (OFF/ON)\ Allows to display or not the calculation and display directly on the product page.

operation-back-less-than-greater-than-front

\ Display Widget (OFF/ON)\ Allows you to display or not the widget.

operation-back-less-than-greater-than-front

Calcul from France price (TTC/HT)

???

operation-back-less-than-greater-than-front

\ \ Incoterm (DDP/DDU)\ Choose the incoterm of your sales:

  • DDP: Customs duties and taxes will be added to the order
  • DDU: Customs duties and taxes will be displayed for information purposes and will not be added to the order

operation-back-less-than-greater-than-front

Taxes Display (External from price/Include in price)

Choose how to display the taxes :

  • External from price = 100€ + Duty & taxes : 21,8€
  • Include in price = 121,8€

operation-back-less-than-greater-than-front

.\ Use currency visitor (OFF/ON)\ Choose whether or not to use the currency of the visitor for the calculation of customs duties and taxes.

operation-back-less-than-greater-than-front

Load taxes async

Asynchrone allow to display the page before calculate the duty and taxes.

operation-back-less-than-greater-than-front

\ \ Edit CSS\ If you want to customize the display, you can include CSS.

operation-back-less-than-greater-than-front


\ GROUPS SETTINGS


ID of the group to exclude (No Taxes)

Exclude the duty and taxes calculation for user groups

operation-back-less-than-greater-than-front

ID of the professional group (BtoB)

Select the professional group here

operation-back-less-than-greater-than-front

Force Professional group with HT prices even\ Display the price exclude taxes

operation-back-less-than-greater-than-front

\

SYNCHRONISATION

Before start to configure the addon, synchronise your data with transiteo.

operation-back-less-than-greater-than-front

Prestashop <> Transiteo

Prestashop <> Transiteo

To work, there is a synchronisation between Prestashop data and Transiteo.

Before to start configuration, you have to synchronise data with Transiteo. Go to Configuration Setting and click on Synchronisation button. \ \ What data is synchronized ?

  • Countries
  • Products
  • Orders

Countries synchronisation

The duty and taxes calculation works from and to 200 countries. You can activate any country :

\/administration/index.php?controller=AdminCountries

On Transiteo Dashboard :

You will be able to see on the table your countries as well as your detailed turnover (price of the goods, price of the delivery, customs duties, local taxes, etc.)

https://www.app.transiteo.io/#/countryManager

Products synchronisation

\/administration/index.php/sell/catalog/products

On Transiteo Dashboard :

Xxx

https://www.app.transiteo.io/#/productManager

Orders synchronisation

Xxx

\/administration/index.php?controller=AdminOrders

On Transiteo Dashboard :

Xxx

https://www.app.transiteo.io/#/orderManager

Operation - Back <> Front

Operation - Back <> Front

Welcome

The widget is displayed on home, product and card pages.

SETTINGS

Statuts Module : \ You informed if your have a premium of freemium account.

Automatically Show "Powered by transiteo" :

Here is the "Powered by Transiteo" :

If you choose "Enabled" :


If you choose "Disabled" :

Automatically show widget :

Here is the "widget" :

If you choose "Enabled" :

If you choose "Disabled" :

Landed Cost

SETTINGS

Activate Module "Landed Cost" (OFF/ON) :

Active or not the "Landed Cost" module

Status Module :

Here, you are informed if you statut is Premium or Freemium.

Position Widget :

You can choose the widget position on pages.

Display Duty on product page (OFF/ON) :

The Duty and Taxes are displayed on product, card and checkout pages.

If it's "OFF" :

If it's "ON" :

Display Widget (OFF/ON) :

The widget is displayed on home, product and card pages.

If it's "OFF" :

If it's "ON" :

The widget is not displayed on checkout page

Calcul from France price (TTC/HT) :

Xxxxxxx

Incoterm (DDP/DAP) :

You can choose the incoterm.

If you choose "DDP" : (Duty & Taxes are included in the total)

If you choose "DAP" : (Duty & Taxes are not included in the total)

Display Duties & Taxes :

If you choose to display taxes "External from price" :

If you choose to display taxes "Include in price" :

Use currency visitor (OFF/ON) :

If it's "OFF" :

If it's "ON" :

Load taxes async :

Edit CSS :

GROUP SETTINGS

ID of the group to exclude (No taxes) :

ID of the professional group (BtoB) :

Force Professional group with HT prices even if you set prices :

Xxxxxxx

SYNCHRONISATION

-------------------------------

-------------------------------

Why ?

Why ?

Benefits of Prestashop transiteo addons

  • Be in compliance with the rules and tax laws of each country
  • Sell better or for the first time in over 198 countries
  • Reduce your return rate if you already sell internationally
  • Avoid the frustration of a customer having to pay taxes upon receipt
  • Be transparent with your customers about the taxes to be paid before the order is placed.
  • Increase your turnover and your average shopping cart internationally
  • Reduce your email and chat exchanges following customer complaints
  • Automate the tax rules to be applied to each product in the back office
  • Add or display taxes on the product page, the shopping cart and in the checkout
  • Start selling and shipping in DDP
  • Reduce your shipping rates
  • Automatically generate documents to export your goods.
  • ...

How much does it cost?

How much does it cost?

The monthly subscription is 49€/month (without commitment of duration) \ + 2%* fees on the amount of duties and taxes of the orders made. \ \ &#xNAN;Example: Order of 130€ including taxes and duties. \ Detail : the product 100€ before tax + 30€ of duties and taxes. 30€ x 2% = 0,6€ of commission to be paid to transiteo.

The 2% commission can be added in the calculation of duties and taxes through a parameter in your account. From then on, it will be your buyers who will pay the commission. \ \ &#xNAN;Example: Order of 130,6€ including taxes and duties. \ Detail: the product 100€ H.T + 30€ of rights and taxes + 0,6€ of commission (30€ x 2%)

In order to calculate the duties and taxes, we base ourselves on the HS Codes of your products. If you know them, you can add them to your product database in the transiteo Dashboard. If not, you will have to classify them automatically using our artificial intelligence engine. This is a paying service : \ \ 1 to 50 products to be classified: 0,50€ / product \ 51 to 250 products to classify : 0,35€ / product \ 251 to 500 products to classify : 0,25€ / product \ 501 to 1 200 products to classify : 0,16€ / product \ 1 201 to 6 000 products to classify : 0,12€ / product \ 6 001 to 35 000 products to classify : 0,08€ / product \ 35 001 to 100 000 products to classify : 0,04€ / product \ 100 001 to 1 000 000 products to classify : 0,03€ / product\ \ Where to classify products to HS Codes ? On the web app

Customized integration

Customized integration

We offer you a tailor-made support from the creation of your transiteo account to the Go Live. Don't worry about anything else. Contact us by email at support@transiteo.com

Frequently asked questions

Frequently asked questions

What do you do with the sales data ? \ Your data is encrypted and you need a key to decrypt it. Only you have this key. We can't do anything with your data except to make a digital artwork with it :) \ \ Are there any incompatibilities with other modules ? \ It is possible that one of your modules prevents the transiteo module from working. In this case, you have to search for a problem and create a patch so that it can work properly. You can do this yourself or our team can do it for you. \ \ The HS Codes of my products do not work, what should I do ? \ When you associate an HSCode to a product, we check if it is correct, up to date on the latest version of the customs nomenclature.

Magento 2 Guide

Page 1

Page 1

BigCommerce Guide

Page 1

Page 1

Odoo Apps Guide

Guide d'utilisation - ERP

Guide d'utilisation - ERP

En savoir + sur le module transiteo - HS Tariff Codes pour l'ERP Odoo :

Avec le module transiteo - HS Tariff Codes vous allez pouvoir :

  • Gérer les authentifications en utilisant le refreshtoken et le client_id.
  • Chercher le HSCode européen d'un produit.
  • Chercher le HSCode avec un pays de destination.
  • Garder les HSCodes avec leurs pays de destination dans un tableau.

Pré requis

Pré requis

  1. Créer un compte sur https://app.transiteo.io/#/register

https://app.transiteo.io/#/register

Remplissez les champs requis pour vous inscrire

  • [ ] Cliquez sur “valider mon compte” dans l’email que vous avez reçu suite à l’enregistrement de votre compte.

    (il se peut que ce mail soit arrivé dans vos spams)

  • [ ] Vous allez être redirigé(e) sur la page de connexion du dashboard transiteo. Connectez-vous avec vos email et mot de passe renseigné lors de votre ouverture de compte.

    (Si vous ne vous souvenez plus de votre mot de passe, cliquez sur “Mot de passe oublié ?”)

2. Pour que l’application fonctionne, vous devez contracter une formule API. \ \ Rendez-vous sur la page : https://www.app.transiteo.io/#/plans

https://www.app.transiteo.io/#/plans

Prendre rendez-vous avec l'équipe pour discuter de la formule d'abonnement API.

Activation

Activation

transiteo - HS Tariff Codes

Pour activer le module Odoo, il faut suivre les étapes suivantes :

1 - Télécharger le module dans Odoo store

https://apps.odoo.com/apps/modules/15.0/transiteo_module/

2 - Décompresser le module

Dans cette partie, il faut aller vers l'emplacement du module et le décompresser comme suite :

Puis, vous allez obtenir un dossier appelé "transiteo_module" :

3 - Copier/Coller le dossier "transiteo_module"

Dans cette partie, il faut copier le dossier "transiteo_module" et le coller dans le dossier il faut mettre les addons ajoutés.

4 - Installer le module HS Tariff Codes

Il faut premièrement faire Update Apps List.

Ensuite, chercher l'application avec son nom "HS Tariff Codes".

En fin, installer l'application, et voilà.

HTS Code classification

Fonctionnement

Fonctionnement

transiteo - HS Tariff Codes

Après l'étape de l'installation du module, il vient le moment où il faut suivre ces étapes pour bien utiliser le module:

1 - S'authentifier

Premièrement, on trouve une trouve une icône en haut à gauche qu'il faut la cliquer pour trouver "auth transiteo"

A l'aide du refreshtoken et du client_id existant dans les paramètres du compte, on peut se connecter.

Il faut cliquer sur Create

Il faut tout d'abord copier le refresh_token et le coller dans sa place et la même chose pour le client_id et d'insérer un nom pour l'authentification pour bien la trouver après (optionnel).

SI on retourne vers la page d'avant, on trouve la liste de tous les authentifications faites.

En suite, on est connecté, maintenant il nous faut switcher vers la page sale où se trouve products.

2 - Chercher les HSCodes

Encore une autre fois vers la page products.

Puis, il faut créer un produit en cliquant sur Create

et saisir un nom pour ce produit (obligatoirement) dans mon exemple je l'ai appelé 'Friteuse'.

En suite, switcher vers la page HTS Code

Il faut s'authentifier grâce au nom qui est donné avant, puis il faut cliquer sur Get European HSCode pour avoir le hscode européen (c'est obligatoire si on veut chercher le hscode avec un pays de destination)

Après l'éteinte de l'objectif qui est d'avoir le HSCode européen, si on veut chercher le HSCode avec pays de destination, il faut choisir le pays de destination qu'on souhaite chercher avec et en fin il s'afficher le boutton Get It qu'il faut le cliquer.

Il faut saisir les résultats qu'on a eu manuellement dans le tableau ci-dessous si on veut les garder.

Cliquer sur save pour sauvegarder la recherche.

En suite, en peut afficher la liste des produits avec leurs HSCodes européens.

Customs Duty Rate

Fonctionnement

Fonctionnement

transiteo - Customs Duty Rate

Après l'étape de l'installation du module, il vient le moment où il faut suivre ces étapes pour bien utiliser le module:

Chercher le taux de droit de douane et le régime

Encore une autre fois vers la page products.

Puis, il faut créer un produit en cliquant sur Create

et saisir un nom pour ce produit (obligatoirement) dans mon exemple je l'ai appelé 'Batterie de téléphone'.

En suite, switcher vers la page Customs Duty Rate, il faut cliquer sur Get It pour avoir le taux de droit de douane et le régime.

Après l'éteinte de l'objectif, il faut saisir les résultats qu'on a eu manuellement dans le tableau ci-dessous si on veut les garder.

Cliquer sur save pour sauvegarder la recherche.

En suite, en peut afficher la liste des produits avec leurs taux de droit de douane et leurs régimes.

UN Code Finder

Fonctionnement

Fonctionnement

transiteo - UN Code

Après l'étape de l'installation du module, il vient le moment où il faut suivre ces étapes pour bien utiliser le module:

Chercher le code ONU

Encore une autre fois vers la page products.

Puis, il faut créer un produit en cliquant sur Create

et saisir un nom pour ce produit (obligatoirement) dans mon exemple je l'ai appelé 'Batterie de téléphone'.

En suite, switcher vers la page UN Code, il faut cliquer sur Get It pour avoir code ONU.

Cliquer sur save pour sauvegarder la recherche.

En suite, en peut afficher la liste des produits avec leurs codes ONU.

-------------------------------

-------------------------------