Docs / Guides / Product Catalog
Product Catalog
A persistent, per-account store of every classified product with full change history.
What the catalog stores
Every time a product is classified — through the dashboard or via the API — it is automatically saved to your catalog. The catalog is keyed by SKU (if provided) or by a hash of the product name. This means re-classifying the same product updates the existing record rather than creating a duplicate.
Each catalog entry stores: the current HS code, confidence score, duty rates (EU/US/UK), status, extended classification metadata (chapter title, heading, GRI rule, market-specific codes), and the original product context (description, material, category, origin country) needed for re-classification.
Catalog keys
Each product is identified by a catalog key:
With SKU
The SKU is used as-is. Two products with the same SKU are treated as the same product.
Without SKU
A 16-character hex hash of the normalized product name (lowercase, trimmed) is used.sha256("cotton t-shirt").slice(0,16)
Tip: always include SKUs for products you sell across multiple channels. Hashed keys work but are harder to correlate with your own database.
Product status
Re-classify from catalog
Any product in your catalog can be re-classified without re-uploading the original file. Click the chevron on any row to expand it, then click Re-classify.
Re-classification uses the product context stored at the time of original classification (description, material, category, origin country). The result bypasses the cache so you always get a fresh AI response. The old HS code is recorded in the audit log before being replaced.
Use re-classify when: the AI initially received vague input and you have since added more context, or when a product's specification changed (e.g. switched from cotton to polyester).
Audit history
Every change to a product's HS code is recorded in the audit log. The log shows who made the change (AI or user), what changed, and the AI's reasoning if applicable.
| Action | Actor | When it happens |
|---|---|---|
| classify | AI | First time a product is classified in a job. |
| reclassify | AI / user | Product is submitted for a fresh AI classification (from catalog or job workspace). |
| approve | User | User clicks Approve in the results workspace. |
| edit | User | User manually enters a different HS code in the results workspace. |
The audit log is visible in the expanded row view in the Catalog dashboard. It is also available via GET /api/v1/catalog?audit=true.
Section 301 risk
When a product's HS code falls under a chapter covered by US Section 301 tariffs, a warning badge appears in the expanded catalog row. This is a risk indicator — it applies only to China-origin goods. The actual surcharge (7.5%–25%) depends on the specific list (1–4A) the HS chapter falls under. Use the Import Duty Calculator for a precise breakdown including Section 301, MPF, and HMF.