File VAT 201 from ERPNext: The Box-by-Box UAE Guide

Every VAT-registered business in the UAE files the VAT 201 return on EmaraTax within 28 days of the end of its tax period, and pays by the same date¹. Most tax periods are quarterly; the FTA assigns monthly filing to larger businesses².

The typical SME process: export ledgers to Excel, rebuild the numbers by hand, discover a mismatch, repeat. The point of this post is that a properly configured ERPNext produces the return's numbers directly, and the configuration is a one-time job.

VAT 201 in one screen

The return is a set of numbered boxes³:

Two structural things to understand before configuring anything.

First, the emirate split in Boxes 1a to 1g is not cosmetic. Allocation must reflect the actual place of supply, and since FTA Decision 8 of 2024 took effect on 1 January 2025, reporting standard-rated supplies against the wrong emirate requires a Voluntary Disclosure to correct even when the total tax due does not change⁴.

Second, reverse charge is symmetric. An imported service appears as output in Box 3 (goods via Box 6) and as input in Box 10 or 11. Claiming the input side while forgetting the output declaration is a classic audit trigger, even when the net effect is zero².

The ERPNext setup that makes it automatic

This is the asset. Four configuration decisions, made once.

1. UAE VAT settings and the built-in VAT 201 report

ERPNext ships UAE VAT features including a VAT 201 style report that aggregates your sales and purchase taxes into the return's structure. Configure UAE VAT Settings, and quarter end becomes running a report instead of building a spreadsheet.

2. Emirate on every address

The emirate field on your Company and Customer addresses is what drives the 1a to 1g split. One missing emirate and your split is wrong, and wrong-emirate reporting now forces a Form 211 Voluntary Disclosure even with zero tax difference⁴. Make the emirate mandatory on address entry. This is a five-minute customization that prevents a statutory filing.

3. Item tax templates for 5% / zero-rated / exempt

Boxes 1, 4, and 5 are only as accurate as item-level tax classification. Standard, zero-rated, and exempt each get an Item Tax Template, applied on the item master, never hand-edited at invoice time. The same discipline feeds e-invoicing validation, covered in our PINT AE guide.

4. RCM configuration that keeps both sides symmetric

Configure reverse charge so the output entry and the input entry post together. In ERPNext this is a purchase taxes template with the reverse-charge account flow, so Box 3/6 and Box 10/11 stay in lockstep by construction rather than by memory².

The quarter-end runbook

Day 1 after period end: reconcile the VAT control accounts against the GL. Chase unposted invoices and pending credit notes into the right period.

Day 2 to 3: run the VAT 201 report. Compare against the prior quarter for anomalies: a sudden emirate shift, a zero-rated spike, an RCM asymmetry.

Day 4: enter the figures on EmaraTax, attach nothing you were not asked for, submit, pay. The deadline is the 28th day after period end, moving to the next business day if it falls on a weekend or holiday¹².

Nil quarter? File anyway. Nil returns are mandatory and skipping one carries the same penalty as any late filing².

Penalty math after Cabinet Decision 129/2025

The penalty framework changed on 14 April 2026⁵.

Late filing: AED 1,000 first offence, AED 2,000 for a repeat within 24 months⁵.

Late payment: 14% per annum, calculated monthly on the outstanding balance, replacing the old 2% / 4% / 1%-daily structure⁵.

One AED example. You owe AED 100,000 and pay 60 days late: roughly 14% × 100,000 × 2/12 ≈ AED 2,333, plus the filing fine if the return was late too. The old regime front-loaded harder; the new one accrues steadily and is kinder to a short slip, but a balance parked unpaid for a year now costs about 14%.

Corrections go through Voluntary Disclosure (Form 211). Under the new framework, disclosing before an audit notification costs 1% of the tax difference per month from the original due date; after notification it is a fixed 15% plus the same 1% monthly⁵. Discovering errors early is now directly and mechanically cheaper.

And the record-keeping baseline: VAT records are kept for at least 5 years, 15 for real estate, under Article 78 of the VAT law².

The five mistakes we see in inherited systems

When we take over an ERPNext system another vendor set up, the VAT problems repeat.

1. Wrong or missing emirate mapping. The 1a to 1g split silently defaults everything to Dubai. Since 1 January 2025, that is a Voluntary Disclosure, not a shrug⁴.
2. One-sided RCM. Input claimed in Box 10, output never declared in Box 3. Zero net effect, full audit exposure².
3. Credit notes issued outside the period of the original invoice without adjustment, distorting both periods.
4. The skipped nil return. "We had no sales" is not a filing exemption².
5. Tourist refund box misuse. Box 2 belongs to the Planet Tax Free flow, not to your export sales³.

FAQ

When is the UAE VAT return due? Within 28 days of the end of the tax period, filing and payment both, on EmaraTax. If the deadline lands on a weekend or holiday, it moves to the next business day¹².

Are tax periods monthly or quarterly? Quarterly as standard; the FTA assigns monthly filing to larger businesses. Your assignment shows on EmaraTax².

Do I file if I had no transactions? Yes. Nil returns are mandatory, and skipping one carries the standard late-filing penalty².

Why does VAT 201 split sales by emirate? Boxes 1a to 1g report standard-rated supplies by actual place of supply. Since FTA Decision 8 of 2024, a wrong-emirate allocation must be corrected by Voluntary Disclosure even with no tax difference⁴.

What changed in penalties in 2026? Cabinet Decision 129 of 2025, effective 14 April 2026: late payment now accrues at 14% per annum monthly, replacing the old structure. Late filing stays AED 1,000 / 2,000⁵.

How does reverse charge appear on the return? Symmetrically: output in Box 3 (or Box 6 for imported goods) and input in Box 10 or 11. One-sided entries are an audit trigger².

Can ERPNext really produce the return? ERPNext's UAE VAT features aggregate the boxes' figures from your invoices and purchases; filing itself happens on EmaraTax. The accuracy depends on emirate data, item tax templates, and RCM configuration, which is one-time setup work.

How long do VAT records have to be kept? 5 years, 15 for real estate records².

Get ERPNext live fast, VAT-configured from day one

The Dxbitz Starter Package: AED 9,900, no per-user fees, free e-invoicing integration included. Priced in one call. WhatsApp us · See the Starter Package

References

1. UAE Federal Tax Authority, "Filing VAT Returns And Making Payments," tax.gov.ae. (accessed July 2026) ↩ ↩² ↩³

2. GrowAcross, "UAE VAT Return Filing 2026: Deadlines, EmaraTax & Penalties," growacross.com. (accessed July 2026) ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷ ↩⁸ ↩⁹ ↩¹⁰ ↩¹¹ ↩¹² ↩¹³

3. ClearTax, "UAE VAT Return: How to File on EmaraTax, Deadlines and Mistakes to Avoid," cleartax.com. (accessed July 2026) ↩ ↩²

4. Muhami, "FTA Decision No. 8 of 2024: Correcting VAT Return Errors in the UAE," muhami.ae. (accessed July 2026) ↩ ↩² ↩³ ↩⁴

5. Fastlane, "UAE VAT Penalty Changes April 2026: Cabinet Decision 129/2025 Explained," fastlanecareer.com. (accessed July 2026) ↩ ↩² ↩³ ↩⁴ ↩⁵