UAE VAT configuration is one of the most important — and most frequently misconfigured — elements of any Odoo setup in the UAE. Get it right and your invoices are FTA-compliant, your VAT returns are accurate, and your finance team works with confidence. Get it wrong and you are looking at incorrect tax calculations, non-compliant invoices, and FTA audit exposure no UAE business wants. This guide walks you through every step of setting up UAE VAT correctly in Odoo 17 — from activating the right localization module through to generating a compliant VAT return.
UAE VAT Basics Every Odoo User Needs to Know
Before touching any configuration, your team needs to understand the three UAE VAT categories Odoo must handle:
Standard Rate — 5%
Applies to the majority of goods and services in the UAE. Most B2B transactions between mainland businesses fall here.
Zero Rate — 0%
Tax is charged at zero percent but the supply is still VAT-registered and must be reported to the FTA. Common zero-rated supplies include exports outside the UAE and international transport. Zero-rated is not the same as exempt — this distinction matters significantly in Odoo configuration.
Exempt
No VAT is charged and the supply is not reported as a taxable transaction. Certain financial services and residential property transactions fall here.
Your TRN — Tax Registration Number — must be correctly entered in Odoo's company settings and must appear on every tax invoice generated. Your VAT return period — monthly or quarterly as assigned by the FTA — must also be configured to match your filing obligations exactly.
Step 1 — Activate the UAE Localization Module
The UAE localization module installs the UAE-specific chart of accounts, pre-configured tax groups, fiscal positions, and FTA-compliant invoice templates your system needs.
Go to Settings → General Settings
Scroll to Companies → Fiscal Localization
Select United Arab Emirates from the dropdown
Click Save then Install when prompted
After installation confirm the following have been created under Accounting → Configuration:
UAE chart of accounts
Pre-configured tax groups — 5%, 0%, and exempt
UAE fiscal positions
FTA-compliant invoice templates
Then go to Accounting → Configuration → Settings and confirm your TRN is correctly entered in the Tax ID field. Every invoice your system generates will display this number — missing or incorrect TRN means every invoice is technically non-compliant.
Step 2 — Configure and Verify Tax Groups
Go to Accounting → Configuration → Taxes and verify these four taxes are correctly configured:
VAT 5% Sales — Tax Type: Sales, Amount: 5%, mapped to output VAT account, set to Price Excluded
VAT 0% Sales — Tax Type: Sales, Amount: 0%, Tax Group: VAT. This tax must still appear on zero-rated invoices — it signals to the FTA that the supply is VAT-registered but zero-rated, not exempt
Exempt Sales — Tax Type: Sales, Amount: 0, Tax Group: Exempt. This is a separate tax group from zero-rated — the distinction is critical for VAT return accuracy
VAT 5% Purchase — Tax Type: Purchase, Amount: 5%, used on vendor bills to track recoverable input VAT
The most commonly missed configuration at this stage is the Tax Grid field on each tax. The tax grid maps each tax to the correct box on your UAE VAT return report. Without correct grid mapping your VAT return will not populate the right boxes — meaning the figures you submit to the FTA will not match your actual tax position.
Step 3 — Set Up Fiscal Positions
Fiscal positions automatically apply the correct tax treatment based on where your customer or supplier is located — so your finance team does not need to manually select the right tax on every invoice.
Go to Accounting → Configuration → Fiscal Positions and verify these three default positions are installed:
UAE Domestic — maps all products and services to 5% VAT. Set this as the default for all UAE contacts.
GCC Countries — applies to transactions with Saudi Arabia, Bahrain, Kuwait, Oman, and Qatar. Review carefully if your business has significant GCC trade volume.
International / Export — automatically maps 5% VAT products to 0% zero-rated export tax for customers outside the UAE and GCC.
To assign a fiscal position to a contact go to Contacts → Sales & Purchase tab → Fiscal Position field. Run a check on all your existing customers and ensure every contact has a fiscal position assigned. Missing fiscal positions cause Odoo to fall back to the product default tax — which may be incorrect for international customers.
Step 4 — Verify Your FTA-Compliant Invoice Template
Every Odoo invoice must display all FTA mandatory fields. Create a test invoice and print it — then check every item on this list:
✓ The words "Tax Invoice" prominently displayed
✓ Your business name as registered with FTA
✓ Your TRN
✓ Invoice date and sequential invoice number
✓ Customer name, address, and TRN (B2B invoices above AED 10,000)
✓ Description, quantity, unit price, and line total per item
✓ Subtotal before VAT
✓ VAT amount per line and total VAT amount
✓ Total invoice amount including VAT
✓ Currency — AED or foreign currency with AED equivalent
If any field is missing go to Settings → Technical → Reporting → Paper Formats and adjust the UAE invoice template. If your business issues Arabic invoices — common for government clients — confirm Arabic language is installed under Settings → Translations → Languages and that RTL layout renders correctly on a test print.
Configure and test your credit note template at the same time. Credit notes must display "Credit Note" rather than "Tax Invoice" and must reference the original invoice number. Leaving credit note configuration until after go-live is one of the most common oversights in UAE Odoo setups.
Step 5 — Configure VAT Return Reporting
Go to Accounting → Configuration → Settings → Fiscal Periods
Set Tax Return Periodicity to match your FTA-assigned filing period — Monthly or Quarterly
Set a reminder 7 days before your filing deadline
Click Save
To generate your VAT return go to Accounting → Reporting → Tax Report and set the date range to your filing period. Cross-reference every box against your EmaraTax portal balance before submitting — the two must match exactly. Discrepancies are almost always caused by incorrect tax grid mapping, transactions posted in the wrong period, or a credit note not linked to its original invoice.
After filing lock the period immediately:
Go to Accounting → Accounting → Lock Dates
Set the Tax Return Lock Date to the last day of the filed period
Click Save
This prevents backdated entries from changing figures you have already submitted to the FTA.
Common UAE VAT Mistakes to Avoid
Confusing zero-rated and exempt — Zero-rated appears in Box 3 of your VAT return. Exempt appears in Box 4. Applying the wrong tax code means every VAT return is incorrect.
Missing customer TRN numbers — Every B2B invoice above AED 10,000 must show the buyer's TRN. Run a customer report and collect missing TRNs before your next invoice run.
Not locking periods after filing — Unlocked periods allow backdated entries that create discrepancies between your Odoo records and your filed VAT return.
Incorrect tax grid mapping — The most common cause of VAT return discrepancies. Audit every tax under Accounting → Configuration → Taxes and verify the tax grid field is correctly mapped.
Wrong invoice dates — UAE VAT must be reported in the period the tax point occurs. Backdated invoices posted into already-filed periods create compliance failures that compound over time.
Final Thoughts
UAE VAT configuration in Odoo is straightforward when done correctly from the start — but the consequences of getting it wrong compound quietly with every invoice and every filing period. Follow the steps in this guide in order, test at every stage, and lock your periods after every filing.
If you want a certified UAE Odoo consultant to review your VAT configuration before you go live — or if you have an existing setup and are not confident it is correct — book a free consultation with our team today. A VAT configuration review is significantly less expensive than correcting years of incorrect filings after the fact.