DOCS

Classifying items

/

Classifying items

Learn how to request a classification in Dashboard and via API.

Below you'll find examples illustrating how to request universal and country-specific classifications through Dashboard or via API. 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.

Input fields 

While only a description is required to generate a classification, the more product details you provide, the more accurate your classification will be. Below is a comprehensive explanation of each input field accepted by Classify. By understanding these input fields, you can maximize their usage and generate highly accurate classifications.

Input field descriptions

FieldDescription
Name (required)The name of the product
Description (optional)An in-depth, long-form description of the product
Image URL (optional)Link to an image of the product. Note: Make sure you use a link to the actual image URL and not the product page URL
Categories (optional)General sub product categories, e.g. Clothing & Accessories, Pet Supplies, Office Products or Baby Clothes, Pet Beds, Adhesives & Tape
Material (optional)What the product is made from, e.g. plastic, wood, steel
Country of Origin (optional)The two-letter abbreviation (ISO code) for the country of manufacture or production of the product
Provided HS Code (optional)Include an existing HS code in your classification request to guide your request. Depending on your preference and the origin of your provided HS code, Classify can validate the HS code and check its coherency against the item's description details. Learn more.
Destination country (optional)Identifies which country the product will be classified to. The destination country must be displayed with each country’s two-letter abbreviation (ISO code) and not the actual country name, e.g. AU, not Australia. Including this field will power Classify to return an 8+ digit country-specific HS code instead of the universal 6-digit code. Learn more about the differences between universal and country-specific HS codes.
Product ID (optional)Your product ID or any number that can be used to uniquely identify each product. If a product ID is not provided, Classify will assign product IDs starting with 1

Note: If you're uploading your bulk request CSV in Dashboard, the destination country will not be part of the template rather you will select your destination countries after you upload your bulk request CSV.

Request a classification 

To request a classification in Dashboard or via API, follow the steps and mutation below.

To request a universal (6-digit) code, leave the destination country empty. To request a country-specific (8+ digit code), provide a destination country.

  1. Go to Dashboard -> Products -> Classify.
  2. Describe your item.
  3. Optional—Add additional product detail fields, such as an image, category, material, provided HS code, and additional details.
  4. OptionalSelect your destination country.
  5. Click Classify.
  6. Review your classification response, including the HS code, tariff schedule description, and confidence score.

To request a bulk classification in Dashboard, follow these steps.

Was this page helpful?