Integration guide
An Odoo TaxJar integration lets Odoo calculate US sales tax with TaxJar's rates while quotations and invoices are written, then sends each posted invoice and credit note to TaxJar for reporting and filing. The TeqStars Odoo TaxJar Connector does both for the states where you have nexus, with exempt customers, product tax categories and address validation.
What does an Odoo TaxJar integration do?
It puts TaxJar's US sales tax rates into Odoo and Odoo's sales into TaxJar. Tax is calculated by TaxJar for each quotation and invoice line shipped to a nexus state, and every posted invoice and credit note is sent to TaxJar, where the sales tax reports and returns are prepared.
Connect your Odoo ERP with TaxJar and simplify the way you manage sales tax compliance. Instead of spending hours calculating taxes manually and preparing reports, automate the entire process in just a few clicks. With the integration, your tax calculations, transaction tracking, and reporting become faster, more accurate, and completely streamlined.
The connector automatically computes sales tax using TaxJar real-time rates based on customer shipping addresses and product inventory locations. It also synchronizes transactions from Odoo to TaxJar, ensuring accurate record-keeping and simplified tax filing. This removes manual data entry and keeps TaxJar's records in step with the invoices in Odoo.
Why Integrate TaxJar with Odoo?
If you sell across multiple states or through marketplaces, sales tax compliance is not optional: it's critical. Integrating TaxJar with Odoo helps you:
- Automatically calculate accurate sales tax
- Apply state-specific tax rates from TaxJar
- Reduce manual errors
- Simplify reporting and filings
- Save valuable accounting time
This integration is ideal for eCommerce sellers, wholesalers, and growing businesses operating in multiple tax jurisdictions.
How does Odoo calculate US sales tax with TaxJar?
Odoo asks TaxJar for the rate of each line as it is written, and sends the finished invoice to TaxJar once it is posted.
A line is added or changed
On a quotation, sales order or invoice for a customer in a nexus state, Odoo sends the ship-from and ship-to addresses, the amount, the product's tax category and the customer's exemption type.
TaxJar returns the rate
Odoo finds or creates the matching sales tax, as one tax or split into state, county, city and special taxes, and puts it on the line.
The invoice goes to TaxJar
When the invoice is posted, it is sent to TaxJar as an order transaction; a credit note goes as a refund linked to its invoice.
| What Odoo sends | From where in Odoo |
|---|---|
| Ship-from address | The warehouse on a sales order, the company on an invoice |
| Ship-to address | The delivery address of the customer |
| Amount, quantity and discount | The order or invoice line |
| Shipping | The delivery line, so TaxJar decides if freight is taxable |
| Product tax code | The product's TaxJar Category, or its product category's |
| Exemption type | The TaxJar Exempt Type on the delivery address |
Tax is calculated for your nexus states
Sync State brings your nexus states from TaxJar and sets them on the TaxJar fiscal position. Customers outside those states get no TaxJar tax; Export All US State Transactions? still sends their invoices to TaxJar.
Key Features
We make every moment count with solutions designed just for you.
Automated Sales Tax Calculation
Automatically calculate accurate sales tax in Odoo based on real-time TaxJar rates and location data.
Product Taxability Management
Manage product-specific tax rules to ensure correct tax application based on item type and jurisdiction.
Real-Time Tax Rate Updates
Keep up with changing tax rates: rates come from TaxJar when tax is calculated, and are reused only for the refresh period you set.
Transaction Upload to TaxJar
Upload sales transactions from Odoo to TaxJar for accurate reporting and tax filing.
Customer Address Validation
Validate customer addresses to ensure precise tax rate determination and compliance accuracy.
Exemption Customer Handling
Easily manage tax-exempt customers and apply exemption rules automatically during transactions.
Every setting is described on the Odoo TaxJar Connector page.
Send Odoo transactions to TaxJar without a spreadsheet import
With Transaction Sync? on, nothing has to be imported into TaxJar by hand. Each invoice is sent when it is posted, with its lines, shipping and sales tax, and amounts in other currencies are converted to US dollars.
Posted invoices
Sent to TaxJar as order transactions, noted in the invoice's chatter and found with the TaxJar Transaction filter.
Credit notes
Sent as refunds that point to the original invoice, so TaxJar nets them against the sale.
Older invoices
The Backfill Transactions button sends every posted invoice and credit note between two dates that has not reached TaxJar yet.
Resetting an invoice removes it from TaxJar
Reset to Draft deletes the matching transaction in TaxJar first, so the two stay in agreement. If TaxJar refuses, the invoice stays posted. A failed export instead creates a TaxJar Export Error activity for the users you name on the account.
Which customers can be tax exempt?
Each contact has a TaxJar Exempt Type, sent to TaxJar with every calculation and transaction. Apply to Child Contacts copies it to the contact's delivery addresses, and a banner on the order or invoice offers to correct a mismatch.
| TaxJar Exempt Type | For |
|---|---|
| Wholesales Or Resale Exempt | Customers who buy to resell |
| Government Entity Exempt | Government buyers |
| Entity Exempt | Other exempt organizations |
| Not Exempt | Everyone else, the default |
How the Integration Works
Have these ready first:
- A TaxJar account with API access, and its sandbox token if you want to test first
- An Odoo company based in the United States, with complete company and warehouse addresses
- Your nexus states set up in TaxJar
- Odoo Community or Enterprise on Odoo.sh or on-premise: Odoo Online cannot install third-party apps
Connect TaxJar API with Odoo
Link your TaxJar account with Odoo using secure API credentials to enable automated tax calculation and reporting.
Configure Tax Settings
Set up tax regions, product tax categories, and nexus settings to ensure accurate tax calculation based on your business requirements. Sync State and Sync Category bring them from TaxJar.
Sync Transactions with TaxJar
Automatically send posted Odoo invoices and credit notes to TaxJar for proper record keeping.
Generate Tax Reports & File Returns
Use TaxJar data to generate tax reports and simplify sales tax filing directly from your synchronized transaction records.
Read the full setup in the TaxJar Connector user guide.
- 4customer exemption types sent to TaxJar
- 4tax levels when the breakdown is on: state, county, city and special
- 7ready tax name formats for the taxes Odoo creates
Where the TaxJar integration stops
A good fit when
- A US company sells from Odoo into several states.
- Invoices are written in Odoo and the returns are filed in TaxJar.
- Some customers buy tax exempt.
Look at it again when
- The company is outside the United States, or needs VAT: the connector is for US sales tax.
- Exemption certificates or customers must be stored in TaxJar.
- Point of Sale orders must be taxed by TaxJar.
Why Choose Our Integration?
At TeqStars Technologies, we deliver reliable and scalable ERP integrations tailored to your business processes. Our TaxJar and Odoo integration ensures:
- TaxJar registered Certified Integration
- Smooth implementation
- Secure API configuration
- Dedicated support
- Customization if required
Frequently asked questions
Does Odoo integrate with TaxJar?
Not out of the box: Odoo has no built-in TaxJar connector. An Odoo app such as the TeqStars Odoo TaxJar Connector adds it, calculating US sales tax from TaxJar on quotations and invoices, and sending posted invoices and credit notes to TaxJar for reporting and filing.
How do Odoo invoices get into TaxJar?
Through TaxJar's transactions API: each posted invoice is created in TaxJar as an order transaction and each credit note as a refund. Older invoices are sent with the Backfill Transactions wizard, so no spreadsheet has to be exported from Odoo and imported into TaxJar.
Does Odoo charge sales tax in states where I have no nexus?
No TaxJar tax is added for them: the connector calculates for the nexus states it imported from TaxJar. Invoices to other states can still be sent to TaxJar with the option Export All US State Transactions?.
Can Odoo validate a customer's address with TaxJar?
Yes. With address validation allowed on the company, a Validate (TaxJar) button on US contacts asks TaxJar for the verified address and lets you save it, so the right local rates are used.
Can sales tax be split into state, county and city taxes in Odoo?
Yes. With Apply Tax Breakdown on, each line gets separate state, county, city and special taxes instead of one combined rate, named with the tax formats you choose.
