AvalaraAvalaraDeveloperDeveloper
  • Productsdown arrow
      Calculations
      AvaTax
      AvaTax Brazil
      AvaTax for Communications
      AvaTax for Excise
      Avalara Tax Content
      E-invoicing
      Activation Service
      Avalara E-Invoicing and Live Reporting
      Brazil
      Brazil Customer Portal
      Tax Compliance (Brazil)
      Tax Central
      Data Staging
      Returns
      Avalara Managed Returns API
      MyLodgeTax
      Avalara Returns Excise
      VAT Reporting
      Shared service
      Shared Services
      1099 & W-9
      Avalara 1099 & W-9
      Tax registrations and business licenses
      Avalara License Guidance
      Sales Tax Registrations
      Payroll tax registrations
      Avalara license filings
      ECM
      Exemption Certificate Management
      Avalara Cross-Border
      Automated Tariff Code Classification
      Self-Serve Tariff Code Classification
      Managed and Premium Tariff Code Classification
      AvaTax Cross-Border (Estimator + Calculator)
      Avalara Trade Compliance
      Avalara Trade and Tariff Library
  • Learndown arrow
      Integrations guides
      Refactor guides
      Get certified
  • Get starteddown arrow
      AvaTax 90 days free trial
      Playground
      Become a partner
      Build with Avalara using AI
  • Developdown arrow
      APIs
      SDKs
      MCPs
      Agent to Agent (A2A)
      AI use cases
      API versioning
  • Resourcesdown arrow
      Avalara NEXT recordings
      Avalara University
      Knowledge Center
  • Support
MENU
Search Icon

No results found for

Profile
  • Sign In
Sign In
Search Icon

No results found for

  • Productsdown arrow
      Calculations
      AvaTax
      AvaTax Brazil
      AvaTax for Communications
      AvaTax for Excise
      Avalara Tax Content
      E-invoicing
      Activation Service
      Avalara E-Invoicing and Live Reporting
      Brazil
      Brazil Customer Portal
      Tax Compliance (Brazil)
      Tax Central
      Data Staging
      Returns
      Avalara Managed Returns API
      MyLodgeTax
      Avalara Returns Excise
      VAT Reporting
      Shared service
      Shared Services
      1099 & W-9
      Avalara 1099 & W-9
      Tax registrations and business licenses
      Avalara License Guidance
      Sales Tax Registrations
      Payroll tax registrations
      Avalara license filings
      ECM
      Exemption Certificate Management
      Avalara Cross-Border
      Automated Tariff Code Classification
      Self-Serve Tariff Code Classification
      Managed and Premium Tariff Code Classification
      AvaTax Cross-Border (Estimator + Calculator)
      Avalara Trade Compliance
      Avalara Trade and Tariff Library
  • Learndown arrow
      Integrations guides
      Refactor guides
      Get certified
  • Get starteddown arrow
      AvaTax 90 days free trial
      Playground
      Become a partner
      Build with Avalara using AI
  • Developdown arrow
      APIs
      SDKs
      MCPs
      Agent to Agent (A2A)
      AI use cases
      API versioning
  • Resourcesdown arrow
      Avalara NEXT recordings
      Avalara University
      Knowledge Center
  • Support
Profile
  • Sign In
Sign In
Sales (877) 282-5585
cardImage
Getting Started with AvaTax
  • Connecting to the API
  • Authentication
  • Troubleshooting
  • Configure Your Account
  • Chapter Summary
cardImage
Transactions
  • A Simple Transaction
  • Invoice Lines
  • Should I commit?
  • Document Types
  • Duty Calc
  • Chapter Summary
cardImage
Customizing Your Transactions
  • Using Address Types
  • Using Reference Fields
  • Using TaxIncluded
  • Chapter Summary
cardImage
Reconciliation
  • Committing a Transaction
  • Modifying a Transaction
  • Chapter Summary
cardImage
Product Taxability
  • Finding a Tax Code
  • TaxCodes and Exemptions
  • Mapping Items to TaxCodes
  • Chapter Summary
cardImage
Discounts and Overrides
  • Tax Overrides
  • Discounting a Transaction
  • Chapter Summary
cardImage
Shipping and Handling
  • Taxability of Shipping Charges
  • Taxability of Handling Charges
  • Chapter Summary
cardImage
Exemptions
  • Reasons Tax Can Be Zero
  • Exemption Certificate
  • Exemptions for Usage
  • Chapter Summary
cardImage
Locations
  • About Location Based Reporting
  • Using Locations
  • Chapter Summary
cardImage
Consumer Use Tax
  • Consumer and Sellers Use Tax
  • Putting It All Together
  • Chapter Summary
cardImage
Calculating Tax Offline
  • Detecting a Dropped Connection
  • Retry or Fallback
  • Tax Content API
  • Reconcile Transactions After Outage
  • Chapter Summary
cardImage
Use Cases
  • Document Workflow
  • Calculating Tax
  • Address Validation
  • Reportable Transactions
  • Product Returns
  • Exempt Transactions
  • Voiding Documents
  • Drop Shipping
  • Consumer Use Tax
  • Batch File Reference
  • Automated Provisioning
  • SOAP or REST
  • Filtering in REST
  • Authentication in REST
  • Client Profile Headers
  • Finding Your CompanyId
  • Proxy Server Settings
  • Errors and Outages
  • REST Error Codes
  • SOAP Error Codes
  • Service Availability
  • Going Live
  • Logins and Resources
  • About Client Strings
SOAP Error Codes

Also see REST Error Codes for errors in the REST v2 API.

Message Summary Documentation
CompanyNotFoundError Company not found. Verify the CompanyCode. An unknown CompanyCode was specified. All companies must be configured using the AvaTax Website.
DocStatusError DocStatus is invalid for this operation. GetTax expects the document to not exist or the DocStatus to be Saved. PostTax expects the DocStatus to be Saved. CommitTax expects the DocStatus to be Posted.
DocTypeError DocType is invalid An unsupported document type was specified. It must be SalesOrder, SalesInvoice, PurchaseOrder, PurchaseInvoice, ReturnOrder, ReturnInvoice
DocumentNotFoundError The tax document could not be found. The tax document specified could not be found.
NoNexus not supported for this transaction type. NoNexus not supported for this transaction type. Digital goods sales in the EU have specific nexus requirements. Please refer to the help center for further detail.
RegionCodeError Invalid or missing state/province code. The two-digit state code was not specified or was invalid.
CountryError Unknown country name or code The country name or code was not recognized.
TaxAddressError Address is incomplete or invalid. An incomplete or invalid origin or destination address was given. RefersTo indicates which. A taxable address must include a (line, city, and region (state)) or a (line and zip) or a (region (state) and postal code).
OutOfBalanceWarning Document was posted, but is out of balance. A document was posted in which the specified TotalAmount or TaxAmount did not match the saved document. This is just a warning. The document was posted.
InvalidZipForState Zip not valid for this state. The zip passed is not in this state. Please pass a zipcode that is in the state.
ZipNotValidError Tax calculation cannot be determined. Zip is not valid for the state. Tax calculation cannot be determined. Zip is not valid for the state.
JurisdictionNotFoundError Unable to determine the taxing jurisdictions. Unable to determine the taxing jurisdictions.
AddressRangeError The address number is out of range. The address was found but the street number in the input address was not between the low and high range of the post office database.
InactiveCompanyError Tax operations not allowed for an inactive company Company Code is set to inactive.
DuplicateLineNoError Duplicate line number One or more line numbers are duplicates. All line numbers must be unique within the document.
TaxRegionError The TaxRegionId was not found
TaxOverrideError Tax override cannot be applied.
AddressError Unable to validate the address.
InsufficientAddressError Insufficient address information You must specify at least Line/ZIP, or Line/City/State
PostalCodeError Invalid ZIP/Postal Code. The ZIP/Postal Code does not exist and could not be determined by the city/municipality and state/province.
UnsupportedCountryError Country not supported. Address Validation for this country not supported.
Messages.DateRangeError Start Date cannot be later than the End Date An invalid date range was specified. RefersTo indicates the property.
Messages.RequiredError Required element is missing A required property was not provided. RefersTo indicates which property. This value must be specified.
Messages.UniqueConstraintError This is a duplicate of an existing unique element and cannot be saved. Please verify the element is unique.
Messages.MaxCountExceededError MaxCount limit exceeded. Please use filters to limit the result set. The default limit is set at 1000. Tech Support will process requests to increase the limit up to the maximum allowed of 15000 invoice lines.

Address Validation Errors

Summary Severity Details
Error accessing address service data. Exception Please contact Avalara Technical Support.
The address data has expired. Exception Please contact Avalara Technical Support.
The address data is in Demo mode and can validate only Nevada addresses Exception Please contact Avalara Technical Support.
The VerifyAddress method was called before the Initialize method Exception Please contact Avalara Technical Support.
Incorrect configuration for validating Canada addresses Exception Please contact Avalara Technical Support.
Delivery Point Validation processing was terminated Exception Please contact Avalara Technical Support.
Unable to validate the address. Error
Address service error Error {0}
Address validation exception Exception Please contact Avalara Technical Support.
Insufficient address information Error You must specify at least Line/ZIP, or Line/City/State
The address was standardized but not validated Error Standardization means that some conversion was done on the address (for example, changing Post Office Box to PO Box or abbreviating street suffixes).
There were multiple matches for the address Error Multiple matches for the address are all in the same ZIP/Postal Code and carrier route. No +4 information is available.
There were multiple matches for the address Error There is not enough information available in the input address to break the tie between multiple matching records.
The street was not found Error The ZIP/Postal Code exists but no streets begin with the same letter in that ZIP/Postal Code.
Insufficient directional or suffix information Error Either the directionals or the suffix field did not match the post office database, and there was more than one choice for correcting the address.
The address is new. Error This is a new address that will not validate properly until the next database update.
The address is not deliverable. Error The physical location exists but there are no homes on this street. One reason might be railroad tracks or rivers running alongside this street, as they would prevent construction of homes in this location.
Country not supported. Error Address Validation for this country not supported.
Service not enabled. Error {0} service is not enabled for this account, please contact customer support.
Geocoding not supported for country. Error Address geocoding for this country not supported.
The city could not be determined. Error The city could not be found or determined from postal code.
An exact street name match could not be found Error An exact street name match could not be found and phonetically matching the street name resulted in either no matches or matches to more than one street name.
The address number is out of range Error The address was found but the street number in the input address was not between the low and high range of the post office database.
Invalid ZIP/Postal Code. Error The ZIP/Postal Code does not exist and could not be determined by the city/municipality and state/province.
No Tax Region intersected. Error No Tax Region returned from Tax Region intersect process.
Multiple tax regions were found for the address. Error
The tax region state did not match the validated address state. Fallback. Success {0}
Address not geocoded. Error Address cannot be geocoded.

CloudConnect Errors

If you're calling the service hosted on CloudConnect, you may encounter the following errors during your integration process:

Summary Severity Documentation
PostTax is not supported on CloudConnect. Error The CloudConnect only accepts GetTax, Ping, IsAuthorized, and Validate calls.
CommitTax is not supported on CloudConnect. Error The CloudConnect only accepts GetTax, Ping, IsAuthorized, and Validate calls.
CancelTax is not supported on CloudConnect. Error The CloudConnect only accepts GetTax, Ping, IsAuthorized, and Validate calls.
AdjustTax is not supported on CloudConnect. Error The CloudConnect only accepts GetTax, Ping, IsAuthorized, and Validate calls.
GetTaxHistory is not supported on CloudConnect. Error The CloudConnect only accepts GetTax, Ping, IsAuthorized, and Validate calls.
Document Type must be Sales Order, Purchase Order, Return Order, Inventory Transfer Order, or Reverse Charge Order on CloudConnect. Error The CloudConnect only calculates tax, and cannot be used to record transactions. As such, document types that trigger a document record creation are rejected.
PreviousNext
Knowledge CenterDeveloper Support
Avalara.com|Terms of Use|Privacy Policy
© 2026 Avalara, Inc.