# ATE error messages

Source: https://developer.avalara.com/products/excise/integration-guides/excise/egs1135035441467/

Guide: AvaTax Excise

# ATE error messages

Understand ATE error messages, their causes, and how to address them.

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](https://en.wikipedia.org/wiki/List_of_HTTP_status_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}