Avalara Developer Network Developer communications

Chapter 2.1 - Required Fields

The CalcTaxes request has numerous fields, but only a handful of the fields are required by Communications REST v2.

CompanyData

These fields are required in the Company Data object (cmpn):

Key Name
bscl Business Class
svcl Service Class
fclt Facilities
reg Regulated


For more information, see Company Data.

Exclusion

The Exclusion object (excl) is not required. If you do use the Exclusion object, these fields are required:

Key Name
ctry Country
excl Exclusion On


For more information, see Exclusion.

Invoice

These fields are required in the Invoice object (inv):

Key Name
bill Bill To Location
cust Customer Type
date Invoice Date
doc Document Code
Required only if Commit (cmmt) is set to true
itms LineItem object


For more information, see Invoice.

Line Item

These fields are required in the LineItem object (itms):

Key Name
sale Sale
tran Transaction Type
serv Service Type


For more information, see Line Item.

Exemption

The Exemption object (exms) is not required. If you do use the Exemption object, these fields are required:

Key Name
loc Location
tpe or cat Tax Type or Tax Category (choose one)

If Tax Type, one of these is required:
Key Name
lvl Tax Level
dom Domain


For more information, see Exemption.

Tax Override

The TaxOverride object (ovr) is not required. If you do use the Tax Override object, these fields are required:

Key Name
loc Location
scp Scope
tid Tax Type ID
lvl Tax Level ID
brkt Tax Bracket object


For more information, see Tax Override.

Tax Bracket

These fields are required in the TaxBracket object (brkt):

Key Name
rate Rate
max Max Base


For more information, see Tax Bracket.

Safe Harbor Override

The SafeHarborOverride object (sovr) is not required. If you do use the Safe Harbor Override object, these fields are required:

Key Name
sh Safe Harbor Type
old Original Federal TAM
new New Federal TAM


For more information, see Safe Harbor Override.

Location

Location is used by the following objects:


Only one of these fields is required in a Location object:

Key Name
pcd PCode
fips FIPS
npa NPANXX
geo Geocoded Street Address

These fields are required when geo is true:
Key Name
addr Street Address
city City
st State
zip Postal Code


For more information, see Location.