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
Chapter 5.6.2 - Calculate Tax Errors
  • Previous
  • Next

CalcTaxes Request

Error Code Message Summary
-2000 CompanyData is null. The CompanyData object is missing
-2000 Invoice cannot be null or empty. The Invoice object is missing or incomplete

CompanyData

Error Code Message Summary
-2000 BusinessClass is required. Missing BusinessClass field in CompanyData
-2000 BusinessClass is invalid. Invalid BusinessClass value
-2000 ServiceClass is required. Missing ServiceClass field in CompanyData
-2000 ServiceClass is invalid. ServiceClass value is invalid
-2000 Facilities is required. Missing Facilities field in CompanyData
-2000 Franchise is required. Missing Franchise field in CompanyData
-2000 Regulated is required. Missing Regulated field in CompanyData

Exclusion

Error Code Message Summary
-2000 County, State, and ExclusionOn are required in Exclusions. Missing fields in Exclusion
-2000 Number of Exclusions cannot exceed 100 Too many exclusions in Exclusions list
-1000 Invalid Exclusion: {\"ctry\":\"XXX\",\"st\":\"YYY\",\"excl\":true} - EZTax failed to add the exclusion information.. Invalid data in Exclusion
-2000 Both Country and State cannot be blank in an exclusion. Neither Country or State provided

Invoice

Error Code Message Summary
-2000 DocumentCode is required in order to commit transactions. Missing DocumentCode field in Invoice when Commit is true
-2000 DocumentCode cannot exceed 150 characters. DocumentCode contains too many characters
-1008 BillTo is required. Missing BillTo location in Invoice
-2000 Invalid BillTo location: Insufficient information provided to determine taxing jurisdiction. Not enough information to determine a BillTo location
-2000 CustomerType is required. Missing CustomerType field in Invoice
-2000 CustomerType is invalid. CustomerType value is invalid
-2000 Date is required. Missing Invoice Date field in Invoice
-2000 Items list is empty. Missing Line Item list in Invoice
-2000 ReturnDetail and/or ReturnSummary must be set to true. Either ReturnDetail, ReturnSummary, or both must be true
-2000 Total Invoices 1001 cannot exceed 1000 Too many Invoices on a request
-2000 Billing period month must be between 1 and 12 Billing Period Month is invalid
-2000 Billing period year is invalid. Use YYYY format Billing Period Year is invalid
-2000 Currency code USA not supported. Currency Code is invalid

Exemption

Error Code Message Summary
-2000 Exemption Error - {\"frc\":true,\"tpe\":1,\"lvl\":1,\"cat\":0,\"dom\":0,\"scp\":0,\"exnb\":true} - Bad data in exemption: Location is required. Missing location in Exemption
-2000 Invalid TaxExemption: {\"loc\":{\"ctry\":\"USA\",\"st\":\"PA\",\"zip\":\"27701\"},\"tpe\":35,\"dom\":1,\"scp\":256} - Unable to determine jurisdiction for TaxExemption: County/State/Zip not found.. Invalid Exemption location
-2000 Exemption Error - {\"frc\":true,\"loc\":{},\"tpe\":1,\"lvl\":1,\"cat\":0,\"dom\":0,\"scp\":0,\"exnb\":true} - Insufficient information provided to determine taxing jurisdiction. Not enough information to determine an Exemption location
-2000 Exemption Error - {\"frc\":true,\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"}} - Bad data in exemption: Tax Type value and one of (Tax Level, Domain) or Category are required. Missing required fields in Exemption
-2000 Exemption Error - {\"frc\":true,\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"},\"tpe\":1,\"lvl\":200,\"cat\":200,\"dom\":0,\"scp\":0,\"exnb\":true} - Bad data in exemption: Category value must be in the range 0 to 13. Exemption Category value is invalid
-2000 Exemption Error - {\"frc\":true,\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"},\"tpe\":1,\"lvl\":1,\"cat\":0,\"dom\":10,\"scp\":0,\"exnb\":true} - Bad data in exemption: Domain value is not a valid numeric tax level. Exemption Domain value is invalid
-2000 Exemption Error - {\"frc\":true,\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"},\"tpe\":1,\"lvl\":1,\"cat\":0,\"dom\":0,\"scp\":10,\"exnb\":true} - Bad data in exemption: Scope value does not represent a supported numeric tax category scope combination. Exemption Scope value is invalid

LineItem

Error Code Message Summary
-2000 LineNumber cannot exceed 150 characters. LineItem Reference too long
-2000 Invalid From location: Insufficient information provided to determine taxing jurisdiction. Not enough information to determine a From/Origination location
-2000 Invalid To location: Insufficient information provided to determine taxing jurisdiction. Not enough information to determine a To/Termination location
-2000 Sale is required. Missing Sale field in LineItem
-2000 A valid TransactionType and/or ServiceType are required. Missing Transaction Type or Service Type field in LineItem
-28 Invalid transaction/service pair. Transaction Type or Service Type is invalid
-28 TransactionType does not support auto-determination of ServiceType. Transaction Type cannot determine an Interstate or Intrastate Service Type
-28 ServiceType does not support auto-determination of TransctionType. Service Type cannot determine an Interstate or Intrastate Transaction Type
-48 Can't determine call type for international calls. Interstate/Intrastate Determination no valid on cross-border transactions
-2000 AdjustmentMethod is invalid. Adjustment Method value is invalid
-2000 DiscountType is invalid. Discount Type value is invalid
-2000 Total LineItems 10001 cannot exceed 10000 Too many LineItems on a request
-1000 Exception: The IsPrivateLine parameter is not supported for CalculateTaxInclusiveTaxes. Private Line functionality not supported on a Tax Inclusive request
-36 Split for private line transaction must be greater than or equal to 0 and less than or equal to 1. Private Line Split value is invalid
-16 One or more LineItems failed. Errors in the request are causing one or more line items to fail
-76 Quantity 10001 exceeds maximum allowed value 10000 Quantity value exceeds the maximum value
-74 Quantity field not supported on Tax Inclusive calls Quantity functionality not supported on a Tax Inclusive request
-75 Quantity field not supported on pro-rated tax calls Quantity functionality not supported on a Prorated request
-1 Quantity -5 is invalid. The value cannot be negative. Quantity value can't be negative
-1 Pro-rate adjustment type 5 invalid Pro-rated Adjustment Type value is invalid
-2000 One or more LineItems are invalid. Errors in the request are causing one or more line items to be invalid
-1 The provided charge amount: 999999999.99 is invalid. Charge must be within -99999999.99 - 99999999.99. Charge amount must be between -99,999,999.99 and 99,999,999.99

Tax Override

Error Code Message Summary
-2000 Invalid TaxOverride: {\"scp\":0,\"tid\":162,\"lvl\":0,\"lvlExm\":true,\"brkt\":[{\"rate\":0.0,\"max\":2147483647.0}]} - Invalid location for override: Location is null. Missing location in Tax Override
-1011 Invalid Override: {\"loc\":{\"ctry\":\"USA\",\"st\":\"PA\",\"zip\":\"27701\"},\"scp\":0,\"tid\":162,\"lvl\":0,\"lvlExm\":true,\"brkt\":[{\"rate\":0.0,\"max\":2147483647.0}]} - County/State/Zip not found.. Invalid Tax Override location
-2000 Invalid TaxOverride: {\"loc\":{},\"scp\":0,\"tid\":162,\"lvl\":0,\"lvlExm\":true,\"brkt\":[{\"rate\":0.0,\"max\":2147483647.0}]} - Invalid location for override: Insufficient information provided to determine taxing jurisdiction. Not enough information to determine a Tax Override location
-2000 Invalid TaxOverride: {\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"},\"tid\":162,\"lvl\":0,\"lvlExm\":true,\"brkt\":[{\"rate\":0.0,\"max\":2147483647.0}]} - Scope is required. Missing Scope field in Tax Override
-2000 Invalid TaxOverride: {\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"},\"scp\":10,\"tid\":162,\"lvl\":0,\"lvlExm\":true,\"brkt\":[{\"rate\":0.0,\"max\":2147483647.0}]} - Scope is invalid. Tax Override Scope value is invalid
-2000 Invalid TaxOverride: {\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"},\"scp\":3,\"lvl\":0,\"lvlExm\":true,\"brkt\":[{\"rate\":0.0,\"max\":2147483647.0}]} - TaxType is required. Missing Tax Type field in Tax Override
-1011 Invalid TaxOverride: {\"loc\":{\"ctry\":\"USA\",\"pcd\":2757800,\"st\":\"NC\",\"zip\":\"27701\"},\"scp\":3,\"tid\":999,\"lvl\":0,\"lvlExm\":true,\"brkt\":[{\"rate\":0.0,\"max\":2147483647.0}]} - EZTax failed to insert the override.. Tax Override Tax Type value is invalid for the jurisdiction and tax level
-2000 Invalid TaxOverride: {\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"},\"scp\":3,\"tid\":162,\"lvlExm\":true,\"brkt\":[{\"rate\":0.0,\"max\":2147483647.0}]} - TaxLevel is required. Missing Tax Level field in Tax Override
-2000 Invalid TaxOverride: {\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"},\"scp\":3,\"tid\":162,\"lvl\":10,\"lvlExm\":true,\"brkt\":[{\"rate\":0.0,\"max\":2147483647.0}]} - TaxLevel is invalid. Tax Override Tax Level value is invalid
-2000 Invalid TaxOverride: {\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"},\"scp\":3,\"tid\":162,\"lvl\":0,\"lvlExm\":true} - BracketInfo is required. Missing Tax Bracket in Tax Override
-2000 Invalid TaxOverride: {\"loc\":{\"ctry\":\"USA\",\"st\":\"NC\",\"zip\":\"27701\"},\"scp\":3,\"tid\":162,\"lvl\":0,\"lvlExm\":true,\"brkt\":[{}]} - Rate and MaxBase are required in each BracketInfo. Missing Rate or Max Base in Tax Bracket
-2000 Number of TaxOverrides cannot exceed 100. Too many Tax Overrides on a CalcTaxes request

Safe Harbor Override

Error Code Message Summary
-2000 Invalid SafeHarborOverride: {\"old\":0.0,\"new\":0.0} - SafeHarborType is required. Missing Safe Harbor Type field in Safe Harbor Override
-2000 Invalid SafeHarborOverride: {\"sh\":0,\"new\":0.0} - OriginalFederalTam is required. Missing Original Federal TAM field in Safe Harbor Override
-2000 Invalid SafeHarborOverride: {\"sh\":0,\"old\":0.0} - NewFederalTam is required. Missing New Federal TAM field in Safe Harbor Override
-42 Invalid SafeHarborOverride: {\"sh\":5,\"old\":0.0,\"new\":0.0} - The Traffic Study Type is Invalid.. Safe Harbor Type value is invalid
-2000 Invalid SafeHarborOverride: {\"sh\":2,\"old\":64.9,\"new\":0.0} - OriginalFederalTam is invalid. Original Federal TAM value is invalid
-2000 Invalid SafeHarborOverride: {\"sh\":2,\"old\":0.649,\"new\":61.0} - NewFederalTam is invalid. New Federal TAM value is invalid
-2000 Cannot have multiple SafeHarborOverrides for the same safe harbor type. Only one Safe Harbor Override allowed for each Safe Harbor Type
-2000 Number of SafeHarborOverrides cannot exceed 100. Too many Safe Harbor Overrides on a CalcTaxes request

Location

Error Code Message Summary
-16 County/State/Zip not found. Invalid location information
-12 PCode not found. Invalid PCode on a location
-14 NPANXX not found. Invalid NPANXX on a location
-24 FIPS not found. Invalid FIPS code on a location

Optional Fields

Error Code Message Summary
-2000 Number of OptionalField elements in LineItem cannot exceed 10. Too many Optional Field elements included in the request
-2000 Key in OptionalFields must be unique - duplicate key [1]. Duplicate key used in multiple Optional Fields
-2000 Key in OptionalFields must have a numeric value between 1 and 10. Optional Field key must be a number between 1 and 10
-2000 OptionalField values cannot exceed 150 characters. Optional Field value contains too many characters

  • Previous
  • Next
PreviousNext
Knowledge CenterDeveloper Support
Avalara.com|Terms of Use|Privacy Policy
© 2026 Avalara, Inc.