Request a tariff classification for core requirements

This example uses the CreateHSClassificationRequest endpoint to classify an item. It then uses the retrieve a tariff code for the item being shipped to Germany. Getting a fully qualified tariff classification insures AvaTax will calculate the most accurate price prior to shipping DDP.

Note

Setting an itemGroup tells Avalara the item to be classified belongs to an item group. Avalara does a classification for the item group and all SKU's associated with the group get the same classification.

After requesting a tariff classification, use webhook to receive notification that the parcel can ship. Alternatively, you can run the GetHSClassification endpoint to get the HS code.

Example request

Create the request. Be sure to change the URL in the classification parameters to match the path to your item code.

{
  "id": "1234-SKU001-CA",
  "item": {
    "companyId": "DEFAULT",
    "itemCode": "SKU 1000.6",
    "description": "Cuban Links",
    "itemGroup": "Man > Jewelry ; Gold > Bracelet",
    "classificationParameters": [
      {
"name": "url",
"value": "http://merchant_host.com/path_to_product/SKU001",
"unit": ""
      },
      {
"name": "hs_code_test",
"value": "9504900090"
      },
      {
"name": "price",
"value": "950",
"unit": "USD"
      }
    ]
   },
  "countryOfDestination": "DE"
}