Spree Avalara AvaTax official extension

The officially supported Avalara AvaTax extension for Spree Commerce using Avalara REST API v2.

• Introduction
• Maintenance & support
• Features
• Installation
• Setup
• Contributing

Introduction

Avalara AvaTax is a cloud-based solution automating transaction tax calculations and the tax filing process. Avalara provides real-time tax calculation using tax content from more than 12,000 US taxing jurisdictions and over 200 countries, ensuring your transaction tax is calculated based on the most current tax rules.

Maintenance & support

This extension is maintained by the Spree Commerce core team and Avalara, and will be kept up to date with future Avalara platform changes.

For more information, support and guidance on how to implement the Spree AvaTax extension feel free to:

• Read the Spree Avalara AvaTax user documentation
• Reach out through the Spree contact form
• Join the Spree Discord at discord.spreecommerce.org

Features

1. Tax calculation (additional/included tax), US state tax, Canadian HST, VAT supported
2. Tax calculation on both line items and shipping charges
3. Tax codes support for products and shipping (assignable per tax category)
4. Multi-stock location support — origin-based tax calculation per shipment across your fulfilment network
5. Tax exemptions — Entity Use Codes, VAT Business Identification Numbers, and Exemption Numbers
6. Address validation for US & Canada
7. Committing complete orders as sales invoice transactions
8. Cancelling (voiding) orders
9. Refunding orders (full and partial)
10. Client-side logging

Installation

bundle add spree_avatax_official && bundle exec rails g spree_avatax_official:install

Restart your server so that it can find the assets properly.

Setup

Connect Spree to AvaTax

Navigate to the Integrations tab in the Spree admin, locate the Avalara tile, and click Connect Avalara to open the setup form.

Enter the following credentials from your Avalara account:

• Account Number: Your unique Avalara account identifier.
• License Key: The private key used to authenticate API requests.
• Company Code: Company profile identifier in the Avalara account.
• Environment: Select Sandbox for testing or Production for your live store.

For full setup instructions including tax codes, tax exemptions, transactions, and address validation, see the Spree Avalara AvaTax user documentation.

Contributing

If you'd like to contribute, please take a look at the instructions for installing dependencies and crafting a good pull request.

Copyright (c) 2026 Spark Solutions Sp. z o.o., Vendo Sp. z o.o., Vendo Connect Inc., released under MIT.