HTS Code

Get Harmonized System Codes informations

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

Headers

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

200: OK DATA Found

{
    "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: Bad Request

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

{
    "code": "DATA_NOT_FOUND",
    "name": "BusinessError",
    "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 REQUEST EXEMPLE

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

Verify Harmonized System Codes

Check if the hscode is a right hscode for the origin_country

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

Headers

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

200: OK

{
    "isRightHscode": false
}

400: Bad Request

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

500: Internal Server Error

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

JSON REQUEST EXEMPLE

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