Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/boomerdigital/spree_avatax_certified

Improve your Spree store's sales tax decision automation with Avalara AvaTax
https://github.com/boomerdigital/spree_avatax_certified

Last synced: 3 months ago
JSON representation

Improve your Spree store's sales tax decision automation with Avalara AvaTax

Awesome Lists containing this project

README

        

SpreeAvataxCertified
===========

[![Build Status](https://travis-ci.org/boomerdigital/spree_avatax_certified.svg?branch=master)](https://travis-ci.org/boomerdigital/spree_avatax_certified)

SpreeAvataxCertified is the *only* [officially certified Avatax solution](http://www.avalara.com/avalara-certified/) that integrates with SpreeCommerce. With this extension you can add instantaneous sales tax decisions to your store.

From Avalara's own explanation of the certification program:

> Relax. It’s certified.
>
> Our “Certified for AvaTax” Program features integrations that perform at the highest level, providing the best possible customer experience.

> Avalara’s partners who have created certified integrations for AvaTax have demonstrated that those integrations contain elements which are essential to providing customers with easy-to-use software that gives accurate sales tax calculations. The certification criteria used to demonstrate these elements are based on Avalara’s years of experience integrating into ERP, ecommerce and point-of-sale applications.

Installation
------------
```ruby
gem 'spree_avatax_certified', github: 'boomerdigital/spree_avatax_certified', branch: 'master'
```
```shell
bundle install
```
```shell
bundle exec rails g spree_avatax_certified:install
```

Setup
-----

In the Spree Admin site configure the Avalara Setting.
![avatax_example](https://cloud.githubusercontent.com/assets/6445334/5670974/aedc85ec-9752-11e4-9bf6-23b7433fc7ab.png)

Enter the Entity Use Codes that are configured in your Avalara site. If you chose to seed the use codes, these will already be set up for you.
![avalara_entity_use_codes](https://cloud.githubusercontent.com/assets/6445334/5671017/f468e2d6-9752-11e4-8e53-efd95feeffb1.png)

Edit Tax Categories configuration settings. If left blank, the tax code will default to P0000000.
![taxcategories](https://cloud.githubusercontent.com/assets/6445334/5671227/2b840c18-9754-11e4-9f68-99efbfcc9fcd.png)

Edit the Shipping Methods configuration settings, to add Tax Use Code for each type of Shipping Method. The Use code must be matched to a value that is configured in the Avalara site.
![shipping](https://cloud.githubusercontent.com/assets/6445334/5671020/f6115b68-9752-11e4-8af9-d60f8fd3fa81.png)

Configure specific users to utilize Avalara Entity Use Code, and Exemption number; Customer Code will be the user's id. Exemption Number are sourced from the Avalara site and the Avalara Entity Use code is a searchable drop down that was previously configured in the system.
![userinfoavalara](https://cloud.githubusercontent.com/assets/6445334/5671095/5e01cdca-9753-11e4-9900-6946c79ad614.png)

Versions
--------
To help make the gem easier to maintain and to keep users are the same page, we have set up master to support 2-4-stable & up. If you are on those versions, please upgrade to use master.

Testing
-------

Be sure to bundle your dependencies and then create a dummy test app for the specs to run against.

$ bundle
$ bundle exec rake test_app
$ bundle exec rspec spec

Copyright (c) 2016 Boomer Digital, released under the New BSD License

# CHANGELOG
See [CHANGELOG.md](CHANGELOG.md) for change history.