Hibou Odoo Suite: Accounting Modules: US WA State SalesTax API


Purpose

The purpose of this documentation is to outline the use case and processes associated with Hibou's US WA State SalesTax API module. This module integrates the WA State SalesTax API for use with fiscal positions.

Getting Started

First thing's first, we want to install the module! Navigate to the Apps application and search 'US WA State SalesTax API'. When ready, hit the install button.

Odoo CMS - a big picture

  Good to Know!

The US WA State SalesTax API depends on the Invoicing module. However, if you do not already have this module installed Odoo will install it for you during this module's installation.

Processes

To get started, navigate to the Accounting application.

Odoo - Sample 1 for three columns


Creating a Backup Tax

Once there select Configuration followed by Taxes. We need to create a Tax to use as backup in case something goes wrong with the WA State SalesTax API. We will see a list of Taxes. To make a new one, hit the Create button.

After completing the required fields, hit the Save button.

Odoo CMS - a big picture

Creating a Fiscal Position

In the Accounting application select Configuration followed by Fiscal Positions. Here you will find a list view of all fiscal positions. Make a new one by hitting the Create button. Name the fiscal position. Check the checkbox next to Use WA State API. Once checked, a new dropdown for WA Base/Error Tax will appear. Select the previously created tax from the dropdown menu.

Check the checkbox for detect automatically. In the Country dropdown selected United States. In the Federal States dropdown select Washington.

Odoo CMS - a big picture

  Important!

Customers must have complete address information for the WA Tax to be used properly.

Technical

This modules adds two new fields to the Fiscal Position model:

  • `is_us_wa` Boolean field to flag use of WA State API

  • `wa_base_tax_id` Many2one field for the WA Base/Error Tax

 These two fields are used for the WA State API. Additionally, it includes a new class WATaxRequest used for making API requests to gather WA tax rates.

Additionally, two new fields are added to the `account.tax` model:

  • `wa_location_code` Integer field for the WA Location Code

  • `wa_location_zips` Char field for the WA Location Zips