Overview
Taxes is a Saleor app that allows delegating tax calculations to external tax providers. It can replace the default (flat rates) tax calculation method in Saleor. It affects both the checkout and the order creation process.
On August 24, 2023, the Taxes App will migrate to a new webhook events flow. Visit the "Migration" section of the Taxes App architecture article to see if you need to take any actions.
The currently supported providers are:
- TaxJar
- Avatax
- Avatax Excise [coming soon]
- Stripe Tax [coming soon]
Features
Taxes App offers:
- Integrations with Avatax and TaxJar
- Calculating taxes for order and checkout
- Creating multiple configurations for each provider and using them in different channels
- Mapping tax codes from your tax provider to Saleor tax classes
Avatax
Besides the shared features, Avatax integration also offers:
- Managing document recording
- Mapping the entity type
- Mapping the document code
- Mapping the tax calculation date
- Transaction voiding on
OrderCancelledevent
Architecture
If you want to explore how the Taxes App work, you can read the Taxes App architecture article.
Configuration
Channels
For a channel to appear on the Available channels list, you must first select "use tax app" as its tax calculation method. You can do that on the Tax Configuration page (Configuration → Taxes).
In the Taxes page, select the channel and change the value of Select the method of tax calculation to "Use tax app". Then save it and come back to the Taxes App.
Providers
In the Tax providers section, you can manage your tax provider instances. Each tax provider instance is a different configuration for a specific tax provider.
You can find instructions for configuring providers on their individual pages: