How to connect my Odoo store to TaxCloud


This App connects Odoo with TaxCloud, enabling automatic computation of sales tax on invoices within the Odoo platform and replaces the the previously supported Odoo.

Odoo released the code to TaxCloud and Sodexis is maintaining it. Bug fixing and new features will only be added to this module going forward.  If you are already using the Odoo app and want to benefit from those bug fixing and new features, you can transition to this App, see the instructions below. Please make sure you test this transition before you do it in production.

If you are not currently using the Odoo connector, you can install this app as any other app.

For previous versions of Odoo (<V17) you will need to first migrate to V17 and then transition to this new App.  If you need any help with the migration, contact Sodexis at, we have a full team of business analysts and developers that can help you.

If you have any questions about sales taxes, please feel free to reach out to the TaxCloud team at

  • If you're interested in learning how TaxCloud can automate your Odoo sales tax collection, find more information at .


Go to Accounting - - > Configuration - - > Settings - - > TaxCloud.

API credentials from the TaxCloud site are entered into the fields under the TaxCloud section. These steps are required in order to integrate Odoo with TaxCloud.

The credentials include API ID, API Key and the Default Category.

  1. Refresh button at the bottom of Default Category is used to import the TIC (Taxability Information Codes) product categories from TaxCloud.
  2. The Default Category is applied when no TaxCloud Category is set on your products or product categories.

Discover more about keeping your business compliant with sales tax regulations:
  • Explore TaxCloud Taxability Information Codes (TICs) for detailed product tax classifications:
  • Access TaxCloud comprehensive resources including a tax rate threshold map, tax rate lookup tool, and state-specific sales tax guides: State Guides

Rounding Method

  1. Go to Accounting - - > Configuration - - > Settings - - > Taxes.
  2. Use the “Round Globally” as the Rounding method to round the tax values.

Set Taxcloud Categories on Product:

  1. Go to Accounting - - > Configuration - - > Management  - - > TaxCloud Categories.

  • If we set a TaxCloud Category on a product and another on its Product Category, Odoo only considers the TaxCloud Category found on the product itself.
  • If both the TaxCloud Category on a product and its Product Category is not set, the Odoo considers the Default Category set under Accounting Settings.
  • A TaxCloud Category set on a parent product category does not apply to its child product categories. For example, if we set TaxCloud Category on the All Product Category, it is not applied to the All/Sales Product Category.

Fiscal Position “Automatic Tax Mapping (TaxCloud)” is created which computes taxes and accounts for invoices with a country set as “United States”.

Use “TaxCloud API” and “Detect Automatically” booleans are enabled in order to compute the taxes from the TaxCloud and to automatically detect the taxes respectively.


Go to Accounting - - > Customers -  - > Invoices. Create a new Invoice.

Note: We cannot compute taxes before the Invoice is posted.

Confirm the Invoice to get it posted. We could see that the computed tax from the Taxcloud is applied in the Invoice as shown below.

TaxCloud uses the Destination from the "Delivery Address" and the Customer from the "Customer ID" on the invoice.

Go to Transactions - - > Reports which shows the recent transactions in Odoo.

We could see that the Status of the Invoice in Taxcloud website will be “Captured” when the Invoice is posted in Odoo.

Taxes are computed based on the “Fiscal Position” configured initially which is added under the Other Info tab of the Invoice.

Canceling the Invoice:

We cannot cancel an Invoice sent to Taxcloud. We will get the below error message while trying to cancel it.

Credit Note:

To reverse the Invoice, we need to create a create note using the “Credit Note” button on the invoice. When credit note is applied for the posted Invoice, TaxCloud updates the tax and total as “0” on the original record with status as “Returned” as shown below.


For additional information or inquiries regarding TaxCloud, feel free to reach out to us at

Sodexis <📧> or visit our website at <🌐>

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us