Managed and Premium Tariff Code Classification

Version v2
Classifications
CreateHSClassificationRequest
GetHSClassification
HSCodeValidationRequest
HSCodeVerificationRequest
WebhookCallback

ClassificationRequest

This model is used in the following APIs:

Parameters
classificationTypeOptional
string
Enum: managed, autoPro, autoEssentials
classificationsOptional
array
classificationModifiersOptional
ClassificationModifiers
countryOfDestinationOptional
array

Capped at 10 per request (configurable via unify.max.countries.of.destination). Exceeding returns 413.

providedHsCodesOptional
object
hsCodeTestOptional
object

Sandbox / integration use only. Pre-supplied HS code per country of destination. When present, the server treats the listed code as the final classification for that COD and bypasses all classification logic (no Indix / HSAC call). Strictly capped to 20 characters per value.

Independent of classificationType, every COD listed in hsCodeTest is processed via the managed pipeline. When the caller asked for an auto type and supplied hsCodeTest for every entry in countryOfDestination, the entire request is re-routed to managed. Partial coverage splits the request: covered CODs run through managed, the rest through the requested auto path.

Covered CODs surface in the response as status: "classified", hsCode: "<test value>", confidence: "test". Uncovered CODs follow the regular auto response shape. The response's classificationType echoes the original caller value (re-routing is internal).

complianceDataOptional
ComplianceData
itemOptional
Item
itemsOptional
array

Bulk shape. Capped at 10 per request (configurable via unify.max.items.per.request). Exceeding returns 413.