TaxCloud calculates the sales tax rate in real time for every state, city, and special jurisdiction in the United States. It keeps track of which products are exempt from sales tax and in which states each exemption applies.
Register an account on TaxCloud.com and complete the setup. Once you go live, get the TaxCloud API Keys by clicking on Stores, then Get Details.
Go to Taxes section enable TaxCloud.and in the
Add the store’s Login ID under API ID and the store’s Key under API KEY. Click on Save.
Click the Refresh button (🗘) next to Default Category to import the TIC Taxability Information Codes product categories from TaxCloud. Some categories may imply specific tax rates or exemptions.
Select a Default Category and Save. The Default Category is applied when no TaxCloud Category is set on your products or product categories, or when no product is found on an order/invoice.
Set TaxCloud categories on products
If you need to use more than one TIC category (i.e., the Default Category), go to the product’s General Information tab and select a TaxCloud Category.
If you want to configure multiple products simultaneously, ensure they share the same Product Category and click on the external link button (🡕) to set a TaxCloud Category on the Product Category instead.
Automatically post taxes in the correct tax payable account
To make sure the new taxes generated by the TaxCloud integration are created with the correct Tax Payable account, create a user-defined default. This process should be repeated for each one of your companies that uses TaxCloud.
To do so, go to Tax Payable account, and click on Setup. Take note of the number after
id= in the URL string; it is the Tax Payable account ID and will be used later.
Activate the developer mode, then go to and click on Create.
Click on Field drop-down menu and then on Search More….
Use the search bar to filter for the Tax Repartition Line model, and use it a second time to filter for the Account field. Select the line with Tax Repartition Line under the Model column.
Once you are back to the User-defined Defaults creation, enter the Tax Payable account ID you took note of earlier under the Default Value (JSON format) field.
Select the company for which this configuration should apply under the Company field and click Save.
Automatically detect the fiscal position
Sales taxes are calculated in Odoo based on fiscal positions. A fiscal position for the United States is created when enabling TaxCloud.
You can configure Odoo to automatically detect to which customers the fiscal position should be applied. To do so, go to Automatic Tax Mapping (TaxCloud). Enable Detect Automatically and then Save.and select
Now, this fiscal position is automatically set on any order or invoice if the customer country is United States. This triggers the automated tax computation.
Interaction with coupons and promotions
If you use the Coupon or Promotion Programs, the integration with TaxCloud might behave unexpectedly. Indeed, as TaxCloud does not accept lines with negative amounts as part of the tax computation, the amount of the lines added by the promotion program must be deduced from the total of the lines it impacts.
Another unexpected behavior is possible. For example, you sell a product for which you have a promotion program that provides a 50% discount. If the product’s tax rate is 7%, the tax rate computed from the TaxCloud integration displays 3.5%. This happens because the discount is included in the price sent to TaxCloud. However, in Odoo, the discount is on another line entirely. Still, the tax computation is correct. Indeed, a 3.5% tax on the full price is the equivalent of a 7% tax on half the price, but this might be unexpected from a user point of view.