AvaTax Troubleshooting and FAQs

Most AvaTax problems have one of three causes: a connection that quietly expired, an incomplete address, or a document that was never meant to post. Find the symptom that matches what you're seeing, then work through the checks for it.

Troubleshooting

These symptoms cover the connection itself, tax calculation, and documents that don't reach Avalara.

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.

Zero-amount charges don't appear in Avalara

A charge or Invoice for a zero (or fully discounted) amount creates no document in Avalara, so the absence is expected rather than a sync failure. Advanced Billing treats a charge reduced to zero by a 100% Coupon the same way as one that starts at zero. The most common case is the renewal charge on a free Subscription.

On Relationship Invoicing, a zero-amount line still posts as part of its Invoice when other lines on that Invoice carry an amount. Only an Invoice whose lines all come to zero is skipped. Zero-amount documents already in your Avalara account stay there.

Frequently asked questions

These answers cover how AvaTax works alongside other tax providers, where tax codes are assigned, and what reaches Avalara.

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 these practices in mind to avoid the most common AvaTax problems:

• 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 doesn't show an on-screen warning.
• Review the View Tax History page after launch to confirm AvaTax tax lines and jurisdictions appear as expected.

Related information

To see exactly which billing activity posts to Avalara and which Avalara field each piece of it lands in, see the Understand How Maxio Billing Activity Syncs to AvaTax help article.

To turn document posting on or off, or to change your tax origin address, see the Set Up AvaTax in Maxio Invoicing Suite help article.

To prepare the Tax Types, addresses, and exemptions AvaTax needs before it can calculate correctly, see the Configure AvaTax Tax Calculation Data help article.