---
title: Set Up Managed Sales Tax
url: https://docs.maxio.com/billing/taxes/set-up-taxes/set-up-managed-sales-tax
applies_to: Advanced Billing
updated: 2026-10-22
---

# Set Up Managed Sales Tax

> **Managed Sales Tax is being retired on November 20, 2026**
>
> Advanced Billing Managed Sales Tax is reaching end of life and will no longer be available starting November 20, 2026. To keep calculating tax through Avalara after that date, connect your own Avalara account with [Link My Avalara](https://docs.maxio.com/billing/taxes/integrations/avalara-avatax-for-advanced-billing/set-up-avatax-in-maxio-invoicing-suite) before then. Contact [support@maxio.com](mailto:support@maxio.com) if you have questions about moving over.

Advanced Billing Managed Sales Tax and <a href="https://docs.maxio.com/billing/invoicing/advance-invoices/set-up-automated-advance-invoicing" target="_blank" rel="noopener noreferrer">Advance invoicing</a> work together to help you bill accurately and collect revenue earlier. Managed Sales Tax uses <a href="http://www.avalara.com/" target="_blank" rel="noopener noreferrer">Avalara AvaTax</a> to automatically calculate and apply tax based on the addresses of your business and your customer, with tools to configure taxable regions, mark Plans and Products as taxable, and review tax history for compliance. Advance invoicing lets you bill subscription renewal charges before the current term ends while preserving billing dates, net terms, and dunning logic, so you can validate upcoming charges, apply taxes correctly, and manage scenarios such as metered usage, credits, and subscription changes.

> **Important:** This feature is not available for EU-hosted users. Contact [support@maxio.com](mailto:support@maxio.com) if you have any questions.

## Available jurisdictions

The in-house Avalara connection supports tax calculation for the following regions by subdivision:

- United States
- Australia
- Canada
- European Union

Additionally, the regions below are available for selection under the "Other" section, without support for tax by subdivision:

- United Arab Emirates
- Argentina
- Brazil
- Switzerland
- Chile
- Colombia
- Egypt
- Hong Kong
- Israel
- India
- Japan
- Jordan
- South Korea
- Mexico
- Malaysia
- Nigeria
- Norway
- New Zealand
- Philippines
- Pakistan
- Qatar
- Russian Federation
- Saudi Arabia
- Singapore
- Thailand
- Türkiye
- Taiwan
- Tanzania
- Vietnam
- South Africa

![Managed sales tax panel enabled, with a taxable regions table covering the United States and Canada](https://docs.maxio.com/content-images/billing/taxes/set-up-taxes/set-up-managed-sales-tax/24287034321037_avalara_taxable_regions.png)

*All regions available for taxation*

If your company needs to calculate taxes in a different country, consider looking into <a href="https://docs.maxio.com/billing/taxes/integrations/avalara-avatax-for-advanced-billing/set-up-avatax-in-maxio-invoicing-suite" target="_blank" rel="noopener noreferrer">an account with Avalara using Link My Avalara</a>.

## Configuring Avalara sales tax

If you use Avalara tax codes, tax is occasionally charged on only a percentage of the total taxable amount. If a tax amount doesn't match what you expect, check how much of the purchase actually qualifies for taxation before assuming the calculation is wrong.

### Enable Avalara sales tax

Click **Enable Advanced Billing Taxes** at the bottom of the Taxes page. This disables any <a href="https://docs.maxio.com/billing/taxes/set-up-taxes/configure-custom-taxes" target="_blank" rel="noopener noreferrer">custom taxes</a> you've already set up, and starts a short setup flow for the rest of this section.

### Set your Tax Origin Address

The first step in the setup flow defines your **Tax Origin Address**, your business's own address. Avalara needs a full address on file to calculate accurate tax rates.

### Tax Destination Address

The same Tax Destination Address options available for custom taxes apply to Managed Sales Tax. To learn more, see <a href="https://docs.maxio.com/billing/taxes/overview/configure-taxable-products-and-items" target="_blank" rel="noopener noreferrer">Configure Taxable Products and Items</a>.

### Configure your Taxable Regions

The last step in the setup flow defines your Taxable Regions. These regions inform Advanced Billing where your company wants to calculate and report tax.

![Taxable regions dialog for Canada, with a checkbox per province and territory](https://docs.maxio.com/content-images/billing/taxes/set-up-taxes/set-up-managed-sales-tax/24287034840845_avalara_2.png)

*Select your tax jurisdictions*

### Edit your taxable regions later

Once Managed Sales Tax is enabled, each region's row on the Taxes page carries its own **Edit** button. Click it to open a list of that region's states, provinces, or countries without leaving the page.

The **Edit** button appears only for team members with the permission described as *manages product catalog, settings, and integrations*. Everyone else sees the region summary as plain text.

Select or clear individual entries, or use **Select all** to toggle every entry at once, then click **Save**. The row's summary updates immediately and the selection persists after a reload; **Cancel** or **Esc** closes the list without saving. If no region has any states, provinces, or countries selected, the Taxes page shows a warning that Avalara will not compute tax for any orders.

## Marking Plans and Products as taxable

Unless otherwise specified, all Plans and Products are *not* eligible for taxes. Once a tax is defined, update your existing Plans and Products so they can be taxed by editing the Plan or Product and checking **Enable Taxes**.

Also check **Require Shipping Address** (found under **Require a Shipping or Billing Address**) for each Plan. The customer needs a complete shipping or billing address on file for Avalara to calculate their tax.

## Creating taxable Subscriptions

A Subscription can only be taxed once it has a shipping or billing address on file. The more complete and correctly formatted that address is, the more accurately Avalara can determine the customer's tax locale for each charge.

## Full address required for taxable Subscriptions

Advanced Billing sends whatever shipping or billing address a Subscription has on file to Avalara for tax calculation. Provide as much of the address below as you can, formatted correctly, so Avalara can accurately determine the customer's tax locale:

- Address 1
- Address 2 (optional, use when appropriate)
- City
- State (ISO format; required only for countries with subdivisions, such as the US, Canada, and Australia; see Required state format below)
- Country (ISO format)
- Postal Code / Zip

### Required country format for taxable Subscriptions

Advanced Billing requires that you use the ISO standard country codes when designating the subscriber's taxable location.

Countries should be formatted as 2 characters. For more information, see the following Wikipedia article on <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2" target="_blank" rel="noopener noreferrer">ISO 3166-1</a>.

### Required state format for taxable Subscriptions

Advanced Billing requires that you use the ISO standard state codes when designating the subscriber's taxable location:

- US states (2 characters): <a href="https://en.wikipedia.org/wiki/ISO_3166-2:US" target="_blank" rel="noopener noreferrer">ISO 3166-2</a>
- States outside the US (2-3 characters): to find the correct state codes outside of the US, go to <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2" target="_blank" rel="noopener noreferrer">ISO 3166-1</a> and click the link in the "ISO 3166-2 codes" column next to the country you want to populate.

## Coupons and taxes

When applied together, taxes are applied to the total cost of the Subscription after the Coupon adjustment has been accounted for.

## Tax history

View and export a history of all tax charges by clicking **View Tax History** at the top of the Taxes page.

![Tax history with a month filter, search and export control, each row carrying assessment and collection dates](https://docs.maxio.com/content-images/billing/taxes/set-up-taxes/set-up-managed-sales-tax/24287051846541_tax_history_detail.png)

*Tax history, with export options*

For more information on the contents of the tax exports, see <a href="https://docs.maxio.com/insights/data-export/understand-data-export" target="_blank" rel="noopener noreferrer">Understand Data Export</a>.
