The AI HS Code & Customs Description Assistant turns product name, use, material, selling format, and destination market into a classification brief that can be reviewed by a customs broker or internal compliance owner. It does not issue a final HS code and does not calculate duties. Instead, it drafts an English customs description, candidate HS directions, classification reasoning, missing information, and human review questions. It is designed for cross-border sellers, DTC operators, sourcing teams, and listing teams preparing export documents before checking the official tariff system or asking a broker for the final classification.
Core inputs include product name, primary use, material or composition, target market, battery status, electronics status, set/bundle status, package contents, product form, user group, brand/model, unit weight, and risk flags. Product name, use, material, and destination market are the main classification signals. Risk flags such as battery, electronics, liquid or powder, food contact, children product, magnet, wireless communication, medical claim, and cosmetic contact help the model surface extra declaration or compliance questions. Output language can be Chinese or English, supporting both internal review and direct English broker communication.
The tool returns a structured JSON result and displays it as separate copyable sections. customsName is the English customs item name draft, invoiceDescription is the commercial invoice wording, and classificationBrief is the product classification note for a broker or freight forwarder. candidates provides up to 3 HS directions; each candidate includes a code prefix, confidence level, reason it may fit, reason it may not fit, and questions still needing confirmation. brokerQuestions lists questions to ask the supplier, broker, or compliance team. missingInformation highlights important fields absent from the current brief. riskLevel marks the overall review risk. disclaimer states that official tariff databases, BTI/CROSS-style rulings, or licensed broker advice must be used for final classification.
After the user submits the form, the frontend sends productName, productUse, material, targetMarket, battery, electronics, setSold, packageContents, productForm, userGroup, brandModel, unitWeight, riskFlags, outputLanguage, and interface language to /api/ai-hs-code-assistant via fetch POST. The server selects an official lookup hint for the chosen market, such as US HTS Search, EU TARIC, UK Trade Tariff, or Canada Customs Tariff, then inserts the product facts and risk flags into the system prompt. The model is constrained to return JSON only, avoid final-ruling language, avoid duty or tax calculations, and limit HS candidates to 3. The frontend parses the JSON and renders the customs description, candidate list, review questions, missing information, and official lookup link. If JSON parsing or the request fails, the page shows an error while keeping the form available for correction and retry.
Input example
Product name: Foldable silicone drinking cup
Primary use: Reusable cup for outdoor travel and daily drinking
Material: Food-grade silicone with plastic rim
Target market: US
Package contents: 1 cup with lid
Product form: Finished consumer product
Risk flags: Food contact itemOutput example
Customs description: Foldable food-grade silicone drinking cup with plastic rim and lid, reusable household/travel drinking container, packed as one finished consumer product.
Candidate 1: 3924 - tableware, kitchenware, other household articles of plastics. Confidence: medium. Reason: finished household drinking container made mainly from silicone/plastic material.
Questions for broker: Confirm material composition by weight; confirm whether silicone is treated as plastic under the target tariff schedule; confirm whether the lid changes the classification; confirm food-contact documentation requirements.No. It provides candidate directions, reasoning, missing questions, and customs wording. Confirm the final code with the official tariff system, your freight forwarder, or a customs broker.
Customs classification depends on material, function, product form, essential character, set composition, and regulated features. Those details can change the candidate heading.
Use it as a draft. Check that it matches the actual product, packaging, quantity, material, and destination-market requirements before putting it on shipping documents.
AI output is a classification aid, not a customs ruling. Verify candidate codes with official tariff tools or a customs broker before shipment.