Account TaxCloud

Account TaxCloud

Description

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

This App is replacing the App that was previously supported by Odoo.  See this link for an explanation. 

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 info@sodexis.com, 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 here. If you're interested in learning how TaxCloud can automate your Odoo sales tax collection, find more information at https://taxcloud.com/integrations/odoo/ .

About TaxCloud

TaxCloud ( https://taxcloud.com/) is a sales tax compliance solution with over 15 years of experience in tax technology. Trusted by more than 4,000 companies, TaxCloud streamlines the management of sales taxes from collection and calculation to filing. It supports e-commerce businesses in navigating the complex U.S. tax regulations across all 50 states and over 13,000 jurisdictions. With TaxCloud, businesses can accurately calculate taxes, reduce the hassle of keeping up with changing tax laws, and ensure effortless compliance. Say goodbye to the stress and frustration of sales tax with TaxCloud.

Module Installation:

• Download all the TaxCloud Official Apps listed below from the Odoo Apps Store before proceeding with the installation process, even if you don’t use the related odoo TaxCloud module. This ensures you get all the TaxCloud features and proper data transmission. If you are using “Deploy on Odoo.sh” in the Apps Store, deploy all the apps listed below.

• Account TaxCloud - Sale
• Account Taxcloud - Sale (loyalty)
• Account Taxcloud - Sale (loyalty) - Delivery
• Account TaxCloud - Ecommerce
• TaxCloud and Subscriptions
• Amazon/TaxCloud Bridge

• For example, you might not have the Subscription module installed but the Sales module is installed, we still recommend downloading all the TaxCloud Official modules and then installing the “Account TaxCloud” module. This will install the “Account TaxCloud - Sale” modules based on your installed module list. But In the future, installing the Subscription module will automatically install the needed “TaxCloud and Subscription” module. This ensures you do not miss any of the TaxCloud features.

•  If you are not using the Odoo App, you can install this App by clicking on the “Activate” button and then proceed with the configuration, see below.

• If you are using the Odoo TaxCloud App, do not uninstall it before installing our App, you will lose all your data.  Install our App by clicking on the “Activate” button. Our module will take care of the transition of configuration and data from the existing App and uninstall the odoo TaxCloud App. Do not reinstall the Odoo Taxcloud App once you have switched to this new one.

For any technical questions or  support contact us at 📧taxcloud@sodexis.com or visit our website at 🌐 sodexis.com/odoo-taxcloud-integration.  We will provide free support for the installation to the first few customers, so contact us if you want help.

Configuration

Go to Accounting - - > Configuration - - > Settings - - > Taxcloud TC.

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

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

1. The Refresh button at the bottom of the 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.

The “Default Tax Template” boolean is found under the Default Category field. When the “Default Tax Template” boolean is enabled, a new field “Default Tax” appears.

Once the Default Tax is set, any tax created through the API will use this template to generate new taxes. However, fields such as Tax Name, Amount, and Label on Invoices are left to override.

To be Notified About Updates

The button “Get Notified about Updates” allows the users to be notified about the major updates and bug fixes.

Clicking the button opens the Compose Email wizard.

From the wizard, users can compose and send a confirmation email to receive notifications from our team regarding major updates and bug fixes..

Discover more about keeping your business compliant with sales tax regulations:

• Explore TaxCloud Taxability Information Codes (TICs) for detailed product tax classifications: https://app.taxcloud.com/tic
• Access TaxCloud comprehensive resources including a tax rate threshold map, tax rate lookup tool, and state-specific sales tax guides: State Guides

Rounding Method

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

Use the “Round Globally” as the Rounding method to round the tax values.

Set Taxcloud Categories on Product:

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 the TaxCloud Category is not set on a product, then Odoo considers the Taxcloud category set on its Product Category.

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 the TaxCloud Category on the All Product Category, it is not applied to the All/Sales Product Category.

Set the TaxCloud category for the Shipping Products and Down Payment Products to get the correct tax computed.

Upon installing our module, the Fiscal Position is set as 'Automatic Tax Mapping (TaxCloud)' with the 'Use TaxCloud API' enabled.

When you create a sale order and invoice with the TaxCloud Fiscal Position, taxes will be calculated based on the delivery address.

If you do not set the Fiscal Position as 'Automatic Tax Mapping (TaxCloud)', taxes will not be calculated from the TaxCloud.

To automatically set the Fiscal Position, you can use the Odoo base 'Detect Automatically' option in the Fiscal Position.When 'Detect Automatically' is enabled, you have options such as “Country Group, Zip Range, and Federal States”, which can be configured based on your requirements.

Here, we have used the “Country” as "United States". If the delivery address selected in the sale order/invoice is in the United States, then the 'Automatic Tax Mapping (TaxCloud)' Fiscal Position will be applied automatically.

Functionality

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 on the 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 a credit note is applied for the posted Invoice, TaxCloud updates the tax and total as “0” on the original record with the status as “Returned” as shown below.

 

Document Version: 2.2

Credits

Contributors

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

Sodexis <📧taxcloud@sodexis.com> or visit our website at <🌐 sodexis.com/odoo-taxcloud-integration>