AvaTax

Version v2
APConfigSetting
Accounts
Addresses
AvaFileForms
Batches
CertExpressInvites
Certificates
Clerk
CommunicationCertificates
Companies
Compliance
Contacts
CostCenter
Customers
DataSources
Definitions
DistanceThresholds
DomainControlVerification
ECommerceToken
EcmEventNotifications
EcoNexusThreshold
FirmClientLinkages
FormTypeMapping
FundingRequests
GLAccount
Items
ItemsReverseSync
Jobs
JurisdictionOverrides
Locations
MultiDocument
Nexus
Notices
Notifications
Provisioning
Registrar
Reports
Settings
Subscriptions
TaxCodes
TaxContent
TaxRules
Transactions
Upcs
UserDefinedFields
Users
Utilities
VendorCertificates
Vendors

HsCodeModel

Describes an element in the harmonized tariff system.

According to the United States International Trade Commission, the harmonized tariff schedule is defined as follows:

The HTS is a U.S. nomenclature system used to classify traded goods based on their material composition, product name, and/or intended function. The HTS is designed so that each article falls into only one category. It is divided into chapters, each of which has a 2-digit number. Each product category within the various chapters is designated by 4, 6, 8, or 10 digits. The 4-digit categories are called "headings." The 6-, 8- and 10-digit classifications are called "subheadings."

Within AvaTax, the HsCodeModel object can refer to sections, chapters, headings, subheadings, or articles. Each object represents one classification. Many of these objects have child objects underneath them; these child objects are more specific than their parent objects.

Parameters
hsCodeOptional
string

The harmonized tariff system code for this section and chapter.

A full HS code contains more than six characters. Partial HS codes with two, four, or six characters may have child codes underneath them. A child code is one that contains greater specificity than a parent code. It is recommended that when you identify a product you use the most detailed code available to identify it.

Top level sections do not have HS Codes.

idRequired
integer

A unique identifier for this harmonized tariff system code.

To search for a list of child codes underneath a specific HS code, search for codes where the child's parentHsCodeId value matches the parent's id value.

parentHsCodeIdOptional
integer

The unique ID number of the parent HS code or HS code prefix.

To search for a list of child codes underneath a specific HS code, search for codes where the child's parentHsCodeId value matches the parent's id value.

descriptionRequired
string

A human readable description that identifies Code descriptive text for this Section, Chapter, Heading, or Subheading.

systemOptional
string

The system to which this HS code belongs.

destinationCountryOptional
string

The destination country identified with this HS Code. This value applies when certain products are classified in specific ways by bilateral trade agreements.

effDateOptional
string

For codes that have been expired or defined on specific dates, this value indicates the earliest date for which this code is considered valid.

If this value is null, this code can be used for any valid date earlier than its end date.

endDateOptional
string

For codes that have been expired or defined on specific dates, this value indicates the latest date for which this code is considered valid.

If this value is null, this code can be used for any valid date later than its effective date.