The new officially supported Avalara AvaTax extension for Spree Commerce using Avalara REST API v2. * Introduction * Maintenance & support * Features * Installation * Setup * Migrating from spree_avatax_certified * Testing * Contributing * About Spark Solutions
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.
The new officially certified Spree AvaTax extension helps Spree users and developers to switch from the old Avalara REST API V1 to the latest Avalara REST API v2. In the words of Avalara developers
the benefits are huge as the new API V2 offers improved AvaTax performance, reliability and a wide range of new functionality.
And since AvaTax delivers sales and use tax calculations at the time of checkout or billing — in real time — the business benefits from implementing the new Spree AvaTax V2 extension are significant, potentially improving conversion rates and sales results.
The new extension comes with technical support from both Spree Commerce core team and Avalara and will be maintained to keep up with the innovations introduced by Avalara in the future. The old extension will no longer be maintained or supported.
For more information, support and guidance on how to implement Spree AvaTax V2 extension feel free to: * reach out through the Spree contact form * join the Spree slack channel #spree-avatax at slack.spreecommerce.org
Add this extension to your
Gemfile with this line:
gem 'spree_avatax_official', github: 'spree-contrib/spree_avatax_official'
Install the gem using Bundler:
bundle exec rails g spree_avatax_official:install
If your server was running, restart it so that it can find the assets properly.
In order to configure tax calculation you need to: 1. Connect Spree to AvaTax 2. Configure Spree Stock Location 3. Configure AvaTax settings 4. Assign an AvaTax System Tax Code to a Tax Category
In order to use
spree_avatax_official extension, you need to configure your
Avatax credentials. To do so, open spree admin panel and go to Configurations
and then Avatax Settings.
Company code, account number and license key can be configured in the Avatax Credentials section of the form.
Service URL is an URL to connect to the Development or Production AvaTax services. It can be configured in the Avatax Endpoint urls section below.
You can test settings you provided using the Ping Avatax button under the form
In order for extension to be able to calculate the taxes, you need to set your stock locations addresses properly.
To do so, in Spree admin panel, go to
Configurations -> Stock Locations and edit addresses of all Stock Locations visible on the list.
Once connected, you configure additional settings.
In order to assign AvaTax System Tax Code to Spree Tax Category, you need to open Tax Categories settings screen (
Configurations -> Tax Categories), pick up existing or create a new Tax Category and fill the Tax Code input with the applicable AvaTax System Tax Code.
If left blank, the Tax Code will
To see a listing of all available AvaTax System tax codes, see http://taxcode.avatax.avalara.com
The old extension spree_avatax_certified using the old Avalara REST API V1 will no longer be maintained or supported by the Spree team.
If you need to migrate from the old spree_avatax_certified to the new spree_avatax_official, in order to take advantage of the improved AvaTax performance, reliability and new functionality, there are various ways of ensuring backwards compatibility of Orders (eg. for refund purposes) which were committed to Avatax using the old extension.
Please reach out through the Spree contact form to discuss an optimal strategy for your use case.
First bundle your dependencies, then run
rake will default to building the dummy app if it does not exist, then it will run specs. The dummy app can be regenerated by using
bundle bundle exec rake
When testing your applications integration with this extension you may use it's factories. Simply add this require statement to your spec_helper:
If you'd like to contribute, please take a look at the instructions for installing dependencies and crafting a good pull request.
We are passionate about open source software and available for hire.