Odoo Tax Automation: Fiscal Positions, Tax Returns and E-Invoicing
Odoo tax automation in 19 and 20: fiscal positions, tax mapping, tax reports, VAT return checks, lock dates, closing entries and e-invoicing explained.
Tax errors in an ERP rarely come from bad math. They come from a wrong fiscal position, a missing tax grid or an invoice posted into a closed period. Our Odoo consulting services start with exactly that review.
Related service: Odoo for finance teams — accounting, tax and reporting automation.
This guide is for finance managers, controllers and accountants who run VAT, GST or sales tax in Odoo 19 or 20 and want less manual work at period end. If you are new to the ledger side, read how Odoo Accounting works first.
What does Odoo tax automation cover?
Odoo tax automation covers four linked steps: computing tax on each line, posting tax journal items, mapping taxes by fiscal position, and building the tax return. One bad setting shows up everywhere.
According to Odoo's taxes documentation, taxes are added on lines in Sales, Purchase, Accounting and Point of Sale. Odoo then computes the amount, creates the tax payable journal item and adds tax grids that the tax return report reads.
This guide stays country-neutral. Local rules sit in Odoo's fiscal localization packages, and we link our country guides rather than repeat them.
What can Odoo automate in tax, and what stays manual?

Odoo can automate the routine tax work, while judgment calls and the legal filing stay with people. The table shows where the line usually falls in a well-configured database.
| Tax task | What Odoo automates | What you still own |
|---|---|---|
| Tax on each line | Default product taxes and computation | Choosing the right rate per product |
| Customer or vendor location | Fiscal position detection by country and VAT | Correct addresses and VAT numbers |
| Tax journal items | Tax payable lines and tax grids | Tax accounts on each tax |
| Tax return | Report built from tax grids, with checks | Reviewing anomalies before you validate |
| Period close | Tax lock date and closing entry | Deciding when the period is final |
| E-invoicing | Format chosen by customer country | Registration and local legal rules |
Odoo repeats a rule thousands of times without error. It cannot tell whether the rule is right, so setup and every change need someone who knows your tax position.
How do taxes compute automatically in Odoo?
Taxes compute automatically in Odoo from the product's default taxes, the tax's computation method and whether prices are tax included or excluded. Getting these three right removes most manual tax edits.
Set default sales and purchase taxes in Accounting settings so new products get them. Localization packages create most rates inactive, with only the main rate active, so activate the ones you use.
Odoo's tax computation documentation lists the methods you can pick:
- Fixed: a set amount per unit, such as a deposit fee.
- Percentage of Price: the standard method for most VAT, GST and sales tax.
- Group of Taxes: several taxes applied together, such as a tax plus a retention.
- Custom Formula: a Python expression, with the Taxes as Python Code module.
Included in Price decides whether the line price already contains tax. Affect Base of Subsequent Taxes lets one tax, such as an environmental levy, raise the base of the next.
The distribution sections decide which accounts and tax grids each tax hits. A 100% and a minus 100% line model reverse charge; two 50% lines model partly deductible input tax.
How do Odoo fiscal positions work?
Odoo fiscal positions are rules that replace default taxes and accounts automatically when a customer or vendor sits in another country, country group or tax status. They are the core of tax automation for any business that sells across borders.
You create them under Accounting, then Configuration, then Fiscal Positions. Odoo's fiscal positions documentation describes three ways to apply them: automatic detection, manual choice on a document, or a default set on the partner.
With Detect Automatically ticked, you can require a VAT number and limit the rule to a country or country group. If the Verify VAT Numbers feature is on, rules that require VAT only apply when the number is marked Intra-Community Valid through the EU VIES check.
Sequence matters. When several fiscal positions match, the first wins, so a single-country rule must sit above a country group that contains it, or the wrong tax applies silently.
Fiscal positions also map accounts, for example to a separate export income account, and can add legal notes that print on quotes, invoices and bills.
How does Odoo tax mapping work in Odoo 19 and 20?
In Odoo 19 and 20, tax mapping is set on the tax itself: you link a tax to fiscal positions and use its Replaces field to say which default taxes it swaps out. The fiscal position form no longer holds the mapping table.
For example, a 0% export tax linked to a Foreign Trade fiscal position can replace your 15% domestic tax. Mapping only works with active taxes.
Odoo 20 tightened the rule. Our Odoo 20 accounting release notes explain that a tax linked to fiscal positions can now only be used within them. If a product's default tax does not belong to the invoice's fiscal position, Odoo removes it, even when no replacement exists.
That is safer, but lines that used to keep a domestic tax may now show no tax at all after an upgrade. Test invoices per fiscal position on a staging copy, as in our Odoo 20 accounting upgrade checklist.
How do cash basis, withholding and US sales tax work in Odoo?
Odoo handles special tax rules with settings rather than custom code: cash basis taxes, withholding taxes and an Avalara link for North American sales tax. Each one changes when or how tax hits the ledger.
Cash basis taxes are due when payment arrives, not when the invoice posts. Enable Cash Basis in settings, pick the cash basis journal, and set the tax's exigibility to Based on Payment with a transition account. Odoo posts the tax entry when you reconcile the payment.
Withholding taxes are negative taxes in their own tax group. In Odoo 20, bills show Amount Due, Withhold Due and Net Due, and the payment wizard can pay the withholding, the payment or both.
For US, Canadian and Brazilian companies, Odoo integrates with Avalara AvaTax for rates by state, county and city. Odoo notes that excise taxes, such as fuel or tobacco, are not supported. Our Odoo integration services cover tax engines and other connectors.
How does Odoo tax reporting work?
Odoo tax reporting reads the tax grids stamped on every invoice and bill line, then sums base and tax amounts per grid for the period. If the grids are right, the report lines match the official form in most countries.
The grids show in the Journal Items tab of any invoice. Your localization ships a country tax report built on them, plus a Generic Tax report. Both export to PDF and XLSX.
For EU sellers to consumers in other member states, the Distance Selling setting creates fiscal positions and taxes per country, and the Generic Tax report offers OSS Sales and OSS Imports exports.
Odoo's tax return documentation warns that different contacts sharing one VAT ID can make the report wrong. Use parent and child contacts for related companies and branches instead of duplicate records.
How do you file an Odoo VAT return?
You file an Odoo VAT return from the Tax Returns view in three steps: Review, Submit and Pay. Odoo lists each pending return with its period, deadline and status, and sends reminders based on the periodicity you set.
- Set periodicity: in Accounting settings, set the tax return periodicity, the reminder deadline and the journal for tax returns.
- Post everything: post or re-date draft invoices and bills for the period, and attach documents to bills.
- Review: open the return and work through the automatic tax checks, fixing each anomaly or marking it reviewed.
- Validate: click Validate, which updates the tax lock date and posts the closing entry in the Tax Returns journal.
- Submit: preview the local report, file it with your tax authority, then click Submit or Mark as Submitted.
- Pay: use the payment details, with a QR code where your localization supports it, then click Mark Paid.
Checks depend on your localization: bank matching for missing bills, bill attachments, company data, draft entries, negative VAT amounts, and taxes that do not match the customer's country.
You can add your own checks in developer mode under Accounting, then Configuration, then Check, for example for vendors whose bills must carry a reverse charge tax.
How do the tax lock date and closing entry work in Odoo?
The tax lock date stops changes to VAT entries in a closed period, and the closing entry moves the period's tax balances to the tax payable or receivable account. Together they make the filed return match the books.
Validating a return sets the Lock Tax Return date. New transactions dated before it have their tax moved to the next open period, so a filed report never changes.
Set the lock date yourself before the review; otherwise Odoo locks on the closing entry's date. Resetting a posted tax return entry to draft needs a lock date exception, which should be rare and approved.
Tax close is one part of a wider period close. Our Odoo month end close checklist puts bank, accruals, tax and lock dates in one order, and the year end closing checklist adds the annual steps.
Where does e-invoicing fit into Odoo tax automation?
E-invoicing sits at the end of the tax flow: once a posted invoice carries the right taxes, Odoo generates the electronic file your customer's country expects. Bad tax data means a rejected e-invoice.
Per Odoo's electronic invoicing documentation, the format offered in the send window depends on the customer's country. You can also fix a format per customer on the contact's Accounting tab.
For Peppol, Odoo acts as access point, registration is free and available in Odoo Community, and sending supports BIS Billing 3.0, XRechnung CIUS and NLCIUS.
Which format you need is a country question. Our Odoo e-invoice formats comparison covers Factur-X, XRechnung, UBL and Peppol BIS, and our guide to Odoo invoice requirements by country covers mandatory invoice fields.
Odoo tax automation by industry
The tax setup that matters most depends on how you sell: cross-border, through stores, on projects or under special regimes.
| Industry | Pain or cost driver | Odoo approach | How iVentureTeam helps |
|---|---|---|---|
| Wholesale and export | Wrong tax on foreign B2B sales | Fiscal positions with VAT required and country groups | Map rates per market, test each route |
| eCommerce | Consumer VAT across many countries | Distance selling taxes and OSS reports | Refresh tax mapping, check OSS output |
| Retail and POS | Tax fixed per product at the till | Product taxes, changed only by fiscal position | Clean product taxes before go-live |
| Professional services | Tax due only when clients pay | Cash basis taxes with a transition account | Set exigibility, reconcile test payments |
| Construction and contracting | Retentions and withholding on invoices | Negative taxes and withholding on payment | Model retentions, train payables staff |
| Accounting and tax firms | Many clients, frequent filings | Tax Returns view, checks and lock dates | Add custom checks and report templates |
How do you set up Odoo tax automation step by step?
Start from your localization package, then confirm each rate, mapping and grid against your last filed return before you trust the automation.
- Confirm the company's fiscal country and install the right localization.
- Activate only the tax rates you use and set default sales and purchase taxes.
- Check every tax's accounts and tax grids in both distribution sections.
- Build fiscal positions, set their sequence and link replacement taxes.
- Turn on VAT number verification if you sell to EU businesses.
- Set tax return periodicity, reminders and the tax returns journal.
- Rebuild one past period in a test database and compare it line by line with the return you filed.
Not sure where your current database stands? Our free Odoo health check flags common configuration gaps before you start changing taxes in production.
How iVentureTeam helps with Odoo tax automation

We set up and repair Odoo tax configurations so your returns come out right the first time, not after a manual rework. We have delivered 150+ ERP projects across 35+ countries with 40+ Odoo specialists, led by a consultant with 13+ years in Odoo.
- Tax setup audit: taxes, grids, accounts and fiscal positions checked against your last filed return.
- Mapping and fiscal positions: sequence, country groups and Replaces fields built for every market you sell to.
- Odoo 20 upgrade checks: invoices tested per fiscal position so no tax quietly drops from lines.
- Reports and checks: custom tax checks and localized reports through our Odoo customization services.
- Training: your team learns the Review, Submit and Pay flow and when to use a lock date exception.
Odoo tax automation case study: Fernando Tax Management
A Dutch tax advisory firm replaced manual, duplicate entries with automated workflows and localized tax reports on Odoo 18. Fernando Tax Management B.V. was founded in 2008 by a tax lawyer.
Its legacy system could not be customized, and hand-keyed data created duplicate records. Reports also had translation gaps, a real risk for output that feeds government compliance.
We migrated the firm to Odoo 18.0 in 10 weeks, built custom tax compliance reports for its Netherlands and Curaçao work, resolved a hidden journal lines issue and fixed translation defects in the tax and reporting modules.
The firm reports a 60% reduction in manual data entry and clean multi-language reports. Read the Fernando Tax Odoo accounting automation case study.
The bottom line on Odoo tax automation
Odoo can run most of your tax cycle on its own, but the automation is only as good as the taxes, fiscal positions and grids behind it. Treat the setup as a finance project, not a settings screen.
Test one past period against your filed return, recheck fiscal positions after upgrading to Odoo 20, and keep lock date discipline. Then the return becomes a short checklist.
Ready to make your tax returns run themselves?

Let a team that has fixed many tax setups check yours before the next filing. Request an Odoo tax configuration review, call +91-90235-15208, or email business@iventureteam.com.
Frequently Asked Questions
Can Odoo file my VAT return automatically?
+
Odoo builds the return, runs checks, posts the closing entry and locks the period. In most countries you still submit the figures on the tax authority's portal, then mark the return submitted and paid in Odoo.
What is a fiscal position in Odoo?
+
A fiscal position is a rule that swaps default taxes and accounts for another set based on the partner's country, country group or VAT status. It can apply automatically, be set on a partner, or be chosen on a document.
Why is my fiscal position not applied automatically?
+
Common causes are Detect Automatically being off, a missing or unverified VAT number, a wrong country on the contact, or a broader fiscal position placed higher in the sequence. The first matching rule in the sequence wins.
What changed for taxes and fiscal positions in Odoo 20?
+
A tax linked to fiscal positions can now only be used within them. If a product's default tax does not belong to the invoice's fiscal position, Odoo removes it, even without a replacement, so test invoices after upgrading.
How does the tax lock date work in Odoo?
+
Validating a tax return sets the Lock Tax Return date. New transactions dated before it have their tax moved to the next open period, so the filed report stays unchanged. Corrections go into the following period.
Does Odoo support cash basis taxes?
+
Yes. Enable Cash Basis in Accounting settings, choose the cash basis journal, and set each tax's exigibility to Based on Payment with a transition account. The tax posts when you reconcile the customer payment.
Can Odoo calculate US sales tax by state?
+
Yes, through the Avalara AvaTax integration for companies whose fiscal country is the United States, Canada or Brazil. It handles state, county and city rates, but Odoo notes that excise taxes are not supported.
Which e-invoice format does Odoo use?
+
It depends on the customer's country, and you can set a format per customer. For Peppol, Odoo supports BIS Billing 3.0, XRechnung CIUS and NLCIUS, and Peppol registration is free.
Free e-invoicing and tax readiness check
Getting Odoo ready for e-invoicing?
We check your Odoo version, localization and invoice flows against e-invoicing, then send what to set up, what to test and the effort involved.
Free, with no obligation. A senior consultant replies within 12 business hours.
Free Odoo tools
All tools- Odoo Health CheckVersion, modules, findings and upgrade cost
- Odoo App SelectorWhich apps you need, by industry
- Odoo Project EstimateIndicative cost and timeline in minutes
- Odoo Implementation Cost CalculatorImplementation cost and timeline, in minutes
- Odoo Migration Cost CalculatorVersion jump or legacy ERP, priced in minutes
Continue reading
Odoo Singapore GST Setup: Tax Codes, GST F5 and InvoiceNow in 19/20
Set up Odoo Singapore GST in Odoo 19 and 20: IRAS tax codes, the 9% rate, GST F5 boxes, PINT SG and the InvoiceNow timeline, plus when you need an AP.
Odoo Accounting for CFOs in the GCC: VAT, E-Invoicing and Controls
Odoo accounting for CFOs in the GCC: UAE and Saudi VAT, ZATCA and UAE e-invoicing, AED and SAR multi-currency, lock dates and hashed audit controls.
Odoo Argentina Localization: ARCA E-Invoicing, ARBA and Withholdings
Odoo Argentina localization for Odoo 19 and 20: l10n_ar_edi ARCA e-invoicing, ARBA retenciones, IIBB percepciones, setup steps and the padron gap.
