ATE error messages

We designed the ATE error messages to help you determine what went wrong during an API call, what you can do about it, and how to proceed.

When an AvaTax API call produces an error, it responds using the standard HTTP error response codes.

Response codes between 500 and 599 refer to internal errors within AvaTax itself. Each internal error is automatically logged and reported to our development team for triage. The remaining response codes are client errors that indicate a mistake in an API call. The table below provides a list of client error messages in ATE.


Error code	Short name	Error text	Description
-700	ExternalWebServiceException	External Web Service Message. Name: {0}. Details: {1}. Summary: {2}. Source: {3}. Refers To: {4}. Help Link: {5}.	An error was returned while calling another web service during the calculation.
-859	IncompleteLocation	The {0} on line {1} is incomplete, but couldn’t be overlayed.	The location information was missing the country and/or jurisdiction.
-860	InvalidCounterJurisdiction	The value “{1}” isn’t a valid Counter Party Jurisdiction for the specified country “0”.	The transaction line specifies a jurisdiction that is not valid for the corresponding country code.
-861	InvalidCounterCountryCode	The value “{0}” isn’t a valid Counter Party Country Code.	An invalid country code was specified on the transaction line.
-862	InvalidSaleJurisdiction	The value “{1}” isn’t a valid Sale Jurisdiction for the specified country “0”.	The transaction line specifies a jurisdiction that is not valid for the corresponding country code.
-863	InvalidSaleCountryCode	The value “{0}” isn’t a valid Sale Country Code.	An invalid country code was specified on the transaction line.
-864	InvalidDestinationJurisdiction	The value “{1}” isn’t a valid Destination Jurisdiction for the specified country “0”.	The transaction line specifies a jurisdiction that is not valid for the corresponding country code.
-865	InvalidDestintionCountryCode	The value “{0}” isn’t a valid Destination Country Code.	An invalid country code was specified on the transaction line.
-866	InvalidOriginJurisdiction	The value “{1}” isn’t a valid Origin Jurisdiction for the specified country “0”.	The transaction line specifies a jurisdiction that is not valid for the corresponding country code.
-867	InvalidOriginCountryCode	The value “{0}” isn’t a valid Origin Country Code.	An invalid country code was specified on the transaction line.
-868	InvalidTitleTransferCode	The value "{0}" isn’t a valid Title Transfer Code.	An invalid title transfer code was specified on the transaction.
-869	InvalidTransactionType	The value "{0}" isn’t a valid Transaction Type.	An invalid transaction type was specified on the transaction.
-870	UnitOfMeasureMismatch	Couldn’t overlay unit quantity from the tobacco product. The line’s unit of measure of {0} wasn’t the same as the tobacco product’s unit of measure of {1}.	A mismatched unit of measure was specified on the transaction line.
-871	UnitOfMeasureNotFound	Unit of “{0}” not Found.	An invalid unit of measure was specified on the transaction line.
-872	InvalidExchangeRate	Exchange Rate From: {0}, To: {1}, On Date: {2}, with Conversion Factor: {3} is not valid. Exchange Rates must have different and valid From and To Currencies, on a valid date, with a non-zero conversion factor.	An invalid transaction exchange rate was included on the transaction.
-873	UnlicensedJurisdictionLocationUncached	Not licensed to calculate taxes for Country: "{0}" Jurisdiction: "{1}" as specified by the {2} on line {3} with unlicensed taxes not cached.	The transaction line specifies a jurisdiction that isn’t included in the license key for the current company, and the Company Setting 'Only Cache Licensed Scenario Taxes' is set to true.
-874	UnlicensedJurisdictionLocation	Not licensed to calculate taxes for Country: "{0}" Jurisdiction: "{1}" as specified by the {2} on line {3}.	The transaction line specifies a jurisdiction that isn’t included in the license key for the current company, and the Company Setting 'Only Cache Licensed Scenario Taxes' is set to false.
-875	InvalidJurisdiction	The value "{0}" isn’t a valid {1} Jurisdiction for the specified country.	The transaction line specifies a jurisdiction that isn't valid for the corresponding country code.
-876	InvalidCountryCode	The value "{0}" isn’t a valid {1} Country Code.	An invalid country code was specified on the transaction line.
-877	InvalidTitleTransferCode	The value "{0}" isn’t a valid Title Transfer Code.	An invalid title transfer code was specified on the transaction.
-878	InvalidTransactionType	The value "{0}" isn’t a valid Transaction Type.	An invalid transaction type was specified on the transaction.
-879	InvalidUserDefinedError	Couldn’t find a determination error with error code {0} as specified by profile {1}.	A profile was configured to cause a user-defined error, but the user define error couldn’t be found.
-880	MissingCity	No city was provided on the {0} for transaction line {1}.	Possible city taxes were found for the current transaction, but a city wasn’t specified on the transaction line.
-881	MissingCounty	No county was provided on the {0} for transaction line {1}.	Possible county taxes were found for the current transaction, but a county wasn’t specified on the transaction line.
-882	InvalidCityCountyPair	The city of {0} isn’t in {1} county. CountryCode: {2} Jurisdiction: {3} EffectiveDate: {4}	The city wasn’t located in the county as specified on the transaction line.
-883	MissingSpecialJurisdictions	Transaction Line specified {0} special jurisdictions should be used, but no special jurisdictions were found.	Possible special jurisdictions taxes were found for the current transaction, but no STJs were specified on the transaction line.
-884	InvalidSpecialJurisdiction	Scenario specifies special jurisdiction taxation, but the name provided doesn’t match any known special jurisdiction. CountryCode: {0}, Jurisdiction: {1}, LocalJurisdictionCode: {2}, LocalJurisdictionType: {3}, EffectiveDate: {4}, Name: {5} wasn’t found.	An invalid special tax jurisdiction was included on the transaction line.
-885	InvalidAlternateTransportationMode	Mode Code "{0}" Alternate Mode Code "{1}" not found.	An invalid alternate mode code was specified on the transaction.
-885	InvalidTransportationMode	Mode Code "{0}" not found.	An invalid mode code was specified on the transaction.
-886	UnlicensedJurisdiction	Not licensed to calculate taxes for Country: "{0}" Jurisdiction: "{1}	The engine attempted to calculate a tax, but the tax was in a jurisdiction that isn’t included in the license key of the current company.
-887	InvalidQuantity	Invalid Quantity. The {0} quantity is required.	The engine attempted to calculate a tax, but the tax quantity field specified by the scenario tax was 0 or null.
-888	UnitOfMeasureConversionNotFound	Unit of Measure Conversion Not Found. The tax quantity isn’t provided in the needed unit of measure and can't be converted to the needed unit of measure. From: {0}, To: {1}.	The engine attempted to convert a quantity from 1 unit of measure to another but couldn’t find a valid conversion.
-889	ExchangeRateNotFound	Exchange Rate Not Found. The tax can’t be calculated because a component of the subtotal couldn’t be converted to the proper currency. From: {0}, To: {1}, On Date: {2}, Of Date Type: {3}.	The engine attempted to convert an amount from 1 currency to another but couldn’t find a valid conversion.
-890	InvalidCity	{2} isn’t a valid city in {1}, {0}. Please update the {3} on transaction line {4}.	The city wasn't located in the state/region and country as specified on the transaction line.
-891	InvalidCounty	{2} isn’t a valid county in {1}, {0}. Please update the {3} on transaction line {4}.	The county wasn’t located in the state/region and country as specified on the transaction line.
-892	InvalidRate	Rate for CountryCode: {0} Jurisdiction: {1} LocalJurisdiction: {2} EffectiveDate: {3} TaxingLevel: {4} TaxType: {5} RateType: {6} RateSubtype: {7} ProductCategory: {8} wasn’t found.	A Scenario Tax is configured with a rate that doesn't exist.
-894	InvalidLocation	{2} "{0}" on line {3} doesn’t exist or isn’t active for {1}.	An invalid location was specified on the transaction line.
-895	OverrideOriginWithDestination	Populating Origin information using Destination information.	The origin wasn’t provided on the transaction line, so the all the destination fields were copied to the corresponding origin fields.
-896	OverrideDestinationWithOrigin	Populating Destination information using Origin information.	The destination wasn’t provided on the transaction line, so the all the origin fields were copied to the corresponding destination fields.
-897	BuyerNotFound	Buyer "{0}" doesn’t exist or isn’t active for {1}.	An invalid buyer was specified on the transaction.
-898	SellerNotFound	Seller "{0}" doesn’t exist or isn’t active for {1}.	An invalid seller was specified on the transaction.
-986	TransactionNotFound	Transaction "{0}" not found.	The transaction code field was populated, but no matching transaction was found in the system. AvaTax Sales & Use integrations only.
-987	MissingTransactionLine	Transaction Line Missing.	No transaction lines were included on the transaction or a null transaction line was included in the list.
-990	MissingRuleSetConfiguration	Company Settings entry for DET_RULESET not found.	The ruleset Company Setting couldn’t be found.
-991	RuleSetTypeNotFound	Invalid Configuration. Rule Definition for class "{0}" couldn’t be found.	The type specified in the ruleset Company Setting couldn’t be resolved.
-992	InvalidRuleSet	Invalid Configuration. Class "{0}" doesn’t isn’t derived from {1}	The type specified in the ruleset Company Setting didn’t inherit from the RuleSet base class.
-993	InvalidSpecialRule	Special Rule: "{0}" not found.	The scenario or scenario tax specified a special rule, but the rule couldn’t be resolved.
-995	InvalidAlternateProduct	Product "{0}" Alternate Product "{1}" doesn’t exist or isn’t active for {2}.	An invalid alternate product was specified on the transaction line.
-995	InvalidProduct	Product "{0}" doesn’t exist or isn’t active for {1}.	An invalid product was specified on the transaction line.
-996	InvalidCompany	Company "{0}" not found.	An invalid company was specified on the transaction.
-997	MissingTransaction	Transaction Missing.	No transactions were included on the call or a null transaction was included in the list.
-998	UnhandledTaxRule	An unhandled exception occurred while processing the tax rules.	An internal error occurred while processing the transaction.
-999	Other Exception	Varies
-1002	ScenarioTaxesNotFoundException	No ScenarioTax records found. TransactionType: {0} OriginJurisdiction: {1} OriginCountryCode: {2} DestinationJurisdiction: {3} DestinationCountryCode: {4} TitleTransferCode: {5} DeterminationProductCategory: {6} SellerId: {7} EffectiveDate: {8} PerspectiveBusinessType: {9} ChainLeg: {10}	No scenarios taxes were found in any of the scenarios that matched the transaction and transaction line.
-1003	ScenarioNotFound	No Scenario record found. TransactionType: {0} OriginJurisdiction: {1} OriginCountryCode: {2} DestinationJurisdiction: {3} DestinationCountryCode: {4} TitleTransferCode: {5} DeterminationProductCategory: {6} SellerId: {7} EffectiveDate: {8}	No scenarios matched the transaction and transaction line.
	UserError	User Error. Profile ID: {0}. {1}