AvaTax Troubleshooting and FAQs

Use this article to resolve common AvaTax connection and calculation issues, and to answer common questions about the integration.

Troubleshooting

The connection fails with "Invalid credentials"

If you receive this error with a recently generated license key, wait 5 minutes and try again. It can take up to 5 minutes for a new license key to become available for use in Avalara.

If the error persists, double-check your account ID and license key against Avalara's own account ID and license key FAQ.

Tax stopped calculating with no error shown

Advanced Billing doesn't show an on-screen error banner for an expired or unauthorized Avalara connection; it just quietly stops calculating and posting tax. Reconnect your account from Config > Taxes by clicking Edit and re-entering your credentials.

Taxes are not calculated for a subscriber

Confirm all of the following:

• The Plan or Product is marked This Plan is subject to taxes, with a Tax Type assigned.
• The customer has a complete shipping or billing address in the required ISO format.
• Your tax origin address is complete.

A partial address, or a missing Tax Type, results in no tax being calculated for that charge.

A tax amount looks wrong for one purchase

If you're using Avalara tax codes, tax is occasionally charged on only a percentage of the total taxable amount. Double check how much of the purchase actually qualifies for taxing before assuming the calculation is wrong.

A void or refund doesn't appear in Avalara

Confirm the original document was actually committed in Avalara. Advanced Billing doesn't void an uncommitted (Saved/draft) document, and if a void fails because the document is already filed, there's no automatic adjustment created in its place. On classic invoicing, a refund creates a separate return-type transaction rather than voiding the original.

Frequently asked questions

Can I use AvaTax alongside Managed Sales Tax, Anrok, TaxJar, Numeral, or Sphere?

No. Only one tax provider can be active per site at a time. Connecting a different provider replaces your AvaTax connection.

Is tax code assignment done in Maxio or in Avalara?

In Advanced Billing. Assign a Tax Type (Digital Service or Physical Good) directly on the Plan or Product; unlike some other tax providers, AvaTax doesn't require you to categorize your catalog inside its own interface.

Does previewing a cost or invoice post anything to Avalara?

No. Previews and real invoice generation both use the same non-committing tax calculation. A document is only posted and committed to Avalara if Post documents to Avalara is enabled, and only on specific billing events.

Can I disable AvaTax and switch to a different tax method?

There's no separate disconnect step in the AvaTax connection flow itself. Enabling a different tax provider, or Custom Taxes, from your Taxes settings replaces the AvaTax connection, since a site can only have one active tax provider at a time.

Does AvaTax support cash-basis accounting?

For Relationship Invoicing, yes. Choose Cash Basis as your Accounting Method when connecting your account to defer the commit call to Avalara until an invoice is paid, instead of committing at invoice issue.

Can I view my AvaTax transaction history in Advanced Billing?

Yes. The View Tax History page under Taxes shows transaction ID, tax rate, amount, currency, and jurisdiction for synced tax activity, and can be exported as a CSV.

Best practices

• Keep your tax origin address complete and current.
• Mark every taxable Plan, Product, and Component as subject to tax, with a Tax Type assigned.
• Require a complete shipping or billing address at signup for taxable Plans.
• Reconnect your Avalara account promptly if tax stops calculating; Advanced Billing won't show an on-screen warning.
• Review the View Tax History page after launch to confirm AvaTax tax lines and jurisdictions appear as expected.