Public API Doc
  • Introduction
  • Authentification
  • E-CUSTOMS SERVICES
    • Product Infos Generator (A.I)
      • Harmonized System Code
      • United Nations Code
      • Dimensions & Weight
      • Carbon footprint
      • Eco Codes and Taxes
      • World Product Pricing
    • HSCode services
      • Link (HSCode > HSCode)
      • Nomenclature
      • RTC / BTI
      • Check
      • A.I Customs Code Control
    • Documents import services
      • Landed Cost
      • Taxes Invoice
      • Export invoice
      • H7 Declaration (Akanea)
    • Duty & Taxes Calculator
      • Landed Cost Calculator
        • For E-Commerce
        • For Marketplace
        • For Shipping Comparator
        • For International Carrier
        • Using Product's HS Code
        • Using Product's SKU
        • Using Product's description
        • Using Product's barcode
      • Reverse Landed Cost Calculator
      • Locals taxes Calculator
        • Using Product's HSCode
        • Using Product's SKU
        • Using Product's description
        • Using Product's barcode
    • Rates Data Generator
      • Duties
      • Locals Taxes (VAT, GST, ...)
      • Specials Taxes (OM, OMR, ...)
      • SalesTaxes (USA)
    • Export Docs Generator
      • Exports invoice
      • Rectified Export invoice
      • Credit Note
      • Tax invoice
      • Exports Marketplace invoice
      • Postal customs declarations
      • Lithium Battery
      • Taxes refund or discount
      • Certificat of origin
      • EORI Subscription
    • Shipping Infos Generator
      • World Shipping Pricing
      • Carbon Footprint
  • E-COMMERCE MANAGEMENT
    • Customers (CRM)
    • Products (PIM)
    • Orders (OMS)
    • Tax Account
  • FREE API CONSUMPTION
    • Duty & Taxes Free Calculation
  • Questions & Answers
  • Go to the Web App
  • Go to the Website
Powered by GitBook
On this page
  • Infos to get Duties Rates
  • Json Request Format
  • Request fields & values
  • Json Response Format
  • Result fields & values
  • JSON Examples - Request & Response
  • Video Explainer
  1. E-CUSTOMS SERVICES
  2. Rates Data Generator

Duties

Using Product's HSCode

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

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


wrong token id or token has expired
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": []
}
{
    "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 Examples : HUYYUU37Y Type : string 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. Examples : 4202310000 Type : string Required : yes if you don't fill sku & product_text fields

"from_country"

"to_country"

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 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 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. Examples : Authorized for importation into this country 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. Examples : 100 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. Examples : 100 Type : string

"tariff"

It's the rate of duty to apply. Examples : 0.2 Type : string

"tariff_ave"

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

"tariff_regime"

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

JSON Examples - Request & Response

Video Explainer

PreviousRates Data GeneratorNextLocals Taxes (VAT, GST, ...)

Last updated 2 years ago

You need to fill the "from_country" field with the Iso Alpha 2 or 3 from where the product leaves. Download the . Examples : "FRA" Type : string Required : yes

You need to fill the "to_country" field with the Iso Alpha 2 or 3 from where the product arrives. Download the . Examples : "VEN" Type : string Required : yes

It exist many possibilities. Please with our support team.

list of countries
list of countries
book a call