Skip to main content
Avalara Help Center

What are some of the common error messages returned with GetTax and Validate Requests?

 

Overview

Common errors that developers may experience when making GetTax or Validate calls to the AvaTax web service.

Environment

API Integration

Resolution

Message Summary Documentation
CompanyNotFoundError Company not found. Verify the CompanyCode. An unknown company code was specified. All companies must be configured using the Admin Console.
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 couldn't be found.
RegionCodeError Invalid or missing state/province code. The two-digit state code wasn't specified or was invalid.
CountryError Unknown country name or code The country name or code wasn't recognized.
TaxAddressError Address is incomplete or invalid. An incomplete or invalid origin or destination address was given. RefersTo indicates which address type. 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 didn't match the saved document. This is just a warning. The document was posted.
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 wasn't 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 doesn't 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. Verify the element is unique.
Messages.MaxCountExceededError MaxCount limit exceeded. Please use filters to limit the result set. 1000 invoice lines is the current limit.

Address Validation Errors

Summary Severity Details
Error accessing address service data. Exception Contact Avalara Support.
The address data has expired. Exception Contact Avalara Support.
The address data is in Demo mode and can validate only Nevada addresses Exception Contact Avalara Support.
The VerifyAddress method was called before the Initialize method Exception Contact Avalara Support.
Incorrect configuration for validating Canada addresses Exception Contact Avalara Support.
Delivery Point Validation processing was terminated Exception Contact Avalara Support.
Unable to validate the address. Error  
Address service error Error {0}
Address validation exception Exception Contact Avalara 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 isn't 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 won't 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 isn't supported.
Service not enabled. Error Service is not enabled for this account, contact Avalara Support..
Geocoding not supported for country. Error Address geocoding for this country not supported.
The city could not be determined. Error The city couldn't be found or determined from postal code.
An exact street name match could not be found Error An exact street name match couldn't 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 wasn't between the low and high range of the post office database.
Invalid ZIP/Postal Code. Error The ZIP/Postal Code doesn't exist and couldn't 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 can't be geocoded.

Next steps

For more information, review our API Integration documentation