Managed and Premium Tariff Code Classification

OverviewAPI
Version v2
Classifications
CreateHSClassificationRequest
GetHSClassification
HSCodeValidationRequest
HSCodeVerificationRequest
NomenclatureChangeWebhook
WebhookCallback

WebhookCallbackRequest

The webhook callback payload that will be sent to the client's webhook endpoint when a classification is completed. Only clients who have specifically opted to receive webhook callbacks need to implement this endpoint. This is an optional feature for "Item Classification Without Storage" customers.

Authentication: The webhook callback supports two authentication methods:

  • Basic Authentication: Requires an API key configured in the Avalara system
  • OAuth: Requires an OAuth token endpoint to be configured in the Avalara system

Conditional Fields:

  • The hsCode field is included for HS classification activities such as hs6, hsFull, and export HS flows
  • The eccnCode and countryOfExport fields are included for ECCN classification activities when available
  • The countryOfOrigin field is included for COO classification activities when available
  • The possibleHsCodes field is only included when the broker parameter is set to "true" and there are alternative HS codes available

Retry Behavior: If the webhook call fails due to server connectivity issues, the system will automatically retry the call.

This model is used in the following APIs:

Parameters
hsClassificationIdRequired
string

The id of the HS classification request that was completed.

companyIdRequired
string

The ID of the company that owns this item.

itemCodeRequired
string

The unique item code (typically your SKU) that was classified.

countryOfDestinationRequired
string

The country code for which the classification was performed.

countryOfExportOptional
string

The export country code for ECCN classification results, when available.

countryOfOriginOptional
string

The country of origin for COO classification results, when available.

statusRequired
string

The status of the classification request.

Enum: CLASSIFIED, CANNOT_BE_CLASSIFIED
hsCodeOptional
string

The HS classification result for HS classification activities.

eccnCodeOptional
string

The export-control classification result for ECCN classification activities.

rationaleOptional
string

Explanation of the classification decision when available.

possibleHsCodesOptional
string

Alternative HS codes that could apply to this item, when available. This is provided as a stringified JSON array.

compliancesOptional
array

Trade compliance data for the classified item, when compliance enrichment was enabled. Each entry follows the same shape as the compliance payload returned on the classification response.