DOCS

Classifying items

/

Classifying items

Examples of universal and country-specific classifications.

GraphQL

Below, you'll find examples of generating classifications for products at both the universal (6-digit) and country-specific (8+ digit) HS code levels. Understand the differences between universal and country-specific HS codes.

For those seeking more comprehensive technical details and extensive documentation, visit our Zonos GraphQL API reference developer site. This comprehensive resource offers detailed insights into API endpoints, GraphQL mutations, and extensive technical information.

Universal (6-digit) classifications

If you're looking to classify items to the universal (6-digit) WCO HS code, use the example below.

GraphQL
REST

The input takes a list so you can request many or a single classification at once.

MUTATION

GraphQL

1
2
3
4
5
6
7
8
9
10
11
mutation ClassificationsCalculate($inputs: [ClassificationCalculateInput!]!) {
  classificationsCalculate(input: $inputs) {
    id
    name
    categories
    imageUrl
    hsCode {
      code
    }
  }
}

VARIABLES

JSON

1
2
3
4
5
6
7
8
9
{
  "inputs": [
    {
      "categories": "women's clothing",
      "imageUrl": "https://zonos.com/images/cozygloves.png",
      "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
    }
  ]
}

RESPONSE

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "data": {
    "classificationsCalculate": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
        "categories": "women's clothing",
        "imageUrl": "https://zonos.com/images/cozygloves.png",
        "hsCode": {
          "code": "6116.10"
        }
      }
    ]
  }
}

Country specific (8+ digit) classifications

The benefits of classifying to a country-specific code include improved restricted item management, reduced tax rates, preferential duty rates, and smoother customs clearance.

To request classifications to specific countries, add the countries' ISO codes in the Classify request as seen in the example below.

GraphQL
REST

The input takes a list so you can request many or a single classification at once.

Mutation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
mutation ClassificationsCalculate($inputs: [ClassificationCalculateInput!]!) {
  classificationsCalculate(input: $inputs) {
    id
    name
    categories
    imageUrl
    configuration {
      shipToCountries
    }
    hsCode {
      code
      countryCode
    }
  }
}

Variables

1
2
3
4
5
6
7
8
9
10
11
12
{
  "inputs": [
    {
      "categories": "women's clothing",
      "imageUrl": "https://zonos.com/images/cozygloves.png",
      "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
      "configuration": {
        "shipToCountries": ["CA", "KR"]
      }
    }
  ]
}

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
  "data": {
    "classificationsCalculate": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
        "categories": "women's clothing",
        "imageUrl": "https://zonos.com/images/cozygloves.png",
        "configuration": {
          "shipToCountries": ["CA", "KR"]
        },
        "hsCode": {
          "code": "6116.10.0020",
          "countryCode": "CA"
        }
      },
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
        "categories": "women's clothing",
        "imageUrl": "https://zonos.com/images/cozygloves.png",
        "configuration": {
          "shipToCountries": ["CA", "KR"]
        },
        "hsCode": {
          "code": "6116.10.2030",
          "countryCode": "KR"
        }
      }
    ]
  }
}

Possible Classify API responses

GraphQL
REST
  1. When hsCode is returned with a 6 to 8+ digit HS code, depending on whether or not a ship-to country was included in the request, your classification request was successful.
  2. When {"errors": [ { "message": "No adequate response"}]} is returned, that means Classify could not find a classification due to insufficient input information.

Was this page helpful?


© 2023 Zonoszonos.com