SalesTaxes (USA)

Using Product's HSCode

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

403

404

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

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

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. Examples : "FRA" Type : string 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. Examples : "VEN" Type : string 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. Examples : "AL-11" or "FR-GES" Type : string 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 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 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

"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. Examples : 800 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. Examples : USD Type : string

"locals_taxes" / "label"

It's the local tax name. Examples : SalesTaxes Type : string

"locals_taxes" / "percentage"

It's the local tax percentage to apply. Examples : 16 Type : string

JSON Examples - Request & Response

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

Video explainer

in progress...