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
  • Check if the hscode is a right hscode for a specific country
  • JSON REQUEST FORMAT
  1. E-CUSTOMS SERVICES
  2. HSCode services

Check

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

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

{
    "isRightHscode": false
}
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": []
}
{
    "code": "UNEXPECTED_ERROR",
    "httpCode": 500,
    "reason": "Please try again or contact our service",
}
PreviousRTC / BTINextA.I Customs Code Control

Last updated 11 months ago