How AvaTax Calculates Tax in Maxio

After setup is complete, Advanced Billing uses AvaTax in the background to calculate sales tax for eligible taxable charges. This article explains what Advanced Billing sends to Avalara and how tax appears in Advanced Billing.

Reminder: AvaTax calculation depends on a complete tax origin address, a usable customer destination address, and a taxable Plan or Product with a Tax Type assigned.

How calculation works

Advanced Billing always requests a non-committing tax calculation from AvaTax, whether the charge is being previewed or actually billed. Separately, if Post documents to Avalara is enabled, a second step posts and commits the resulting document to Avalara. Calculating tax and posting a document to Avalara are two distinct actions, not one.

What triggers a calculation

A calculation call to AvaTax happens on:

• Subscription creation (signup).
• Subscription or renewal preview, and component allocation preview.
• Component allocation (a metered or quantity change actually applied).
• Invoice generation and issuance.
• Ad-hoc charge creation, and recalculating an open invoice's line items.
• Arrears and statement billing charge generation.
• Surcharge calculation.

Editing a taxable Plan or Product doesn't call Avalara directly; it only changes whether the next charge, invoice, or preview is treated as taxable.

Not every one of these calls actually reaches Avalara. A line item is skipped if the customer is tax-exempt, the charge amount is zero, or the destination address is empty.

Preview and invoice behavior

• Previews: the ad-hoc line-item tax-preview widget and proforma-invoice previews always call AvaTax live. Subscription and renewal cost previews may show a cached or unset tax amount instead of a live calculation, depending on your account configuration.
• Invoice generation: when an invoice is finalized, Advanced Billing requests the same non-committing tax calculation and records the resulting tax line items on the invoice.
• Posting to Avalara: with Post documents to Avalara enabled, classic invoicing posts on specific billing events (successful payment, refund, statement settlement, and component allocation changes); Relationship Invoicing posts on invoice issue, payment, or void. See Maxio Invoice and AvaTax Transaction Sync for the full mapping.
• Errors: an authentication or account-level error with your Avalara connection quietly stops further tax calculation and document posting until you reconnect your account, with no error banner shown in Advanced Billing. A missing or invalid customer address is treated as an expected condition, not an error, and simply results in no tax being calculated for that line. Connection timeouts are retried once, then logged for investigation.

Tax display in Advanced Billing

When AvaTax returns a tax amount, Advanced Billing creates a tax charge on the invoice. You can review synced tax activity, including transaction ID, tax rate, amount, currency, and jurisdiction, on the View Tax History page under Taxes, and export it as a CSV.