Tariff Code Classification

Version v2
CreateHSClassificationRequest
GetHSClassification
HSCodeValidationRequest
HSCodeVerificationRequest
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 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.

statusRequired
string

The status of the classification request.

Enum: CLASSIFIED, CANNOT_BE_CLASSIFIED
hsCodeOptional
string

The HS classification result.

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.

complianceOptional
object

Compliance information if compliance_flagging was enabled.