GCC VAT Compliance Suite

Key Features

Country VAT Profile DocType pinning return format, box mapping, filing frequency and currency for UAE, KSA, Bahrain, Oman and Qatar

Submittable VAT Return DocType with fields mapped to each authority's actual return layout (e.g. UAE VAT 201 boxes, KSA return schedule)

Tax Treatment Rule DocType mapping ERPNext tax templates and tax categories to the correct return box and reverse-charge flag

FAF / audit-file export via a whitelisted method producing the authority-required CSV or XML layout as a File attachment

Reverse-charge (RCM) self-assessment entries auto-raised on qualifying imports and intra-GCC supplies through on_submit doc events

Designated-zone and import-VAT handling with distinct treatment rules so free-zone and customs-cleared lines report correctly

hooks.py doc_events on Sales Invoice, Purchase Invoice and Payment Entry to stamp resolved tax treatment at validate and submit time

Whitelisted generate_return method that aggregates GL and tax ledger rows into the period return for review before filing

Nightly scheduler_event running VAT reconciliation of output/input tax control accounts against filed returns with variance flagging

VAT reconciliation reports surfacing box-level totals, control-account ties and unreconciled or misclassified transactions

Dedicated VAT Compliance Manager role profile with per-company permission scoping for multi-entity GCC groups

Client Scripts adding in-form country selection, box preview and one-click return generation without patching ERPNext core

Full Frappe REST API exposure of return generation and audit-file export for downstream or portal automation

Fixtures-based install of country profiles, tax categories and default treatment rules for reproducible deployment across environments

Built and tested against Frappe/ERPNext v15 and v16

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

You order

Start with a one-time build price. We scope it with you at kickoff.

We build & install

ECOSIRE builds, configures and installs it on your ERPNext.

Go live + support

You go live in about 2–4 weeks, with a post-launch support window.

About this Product

GCC finance teams running a single ERPNext instance across UAE, KSA, Bahrain, Oman and Qatar hit the same wall: ERPNext ships a generic tax engine and a basic "VAT Audit Report", but it has no concept of a FTA VAT 201 return, a ZATCA-shaped audit file, an Oman VAT return schema, or the reverse-charge and designated-zone rules that differ by country. Teams end up hand-copying figures from the general ledger into spreadsheets each period, re-keying the same numbers into five different tax-authority portals, and hoping nobody applied the wrong tax template to an import or an intra-GCC supply. That manual gap is exactly where filing errors, missed reverse-charge entries and audit exposure come from.

ECOSIRE builds the GCC VAT Compliance Suite as a proper Frappe app (its own module, hooks.py, fixtures and CI-friendly source) layered on top of your existing ERPNext, not a fork of it. At its core is a Country VAT Profile DocType that pins the return format, box mapping, currency and filing frequency per jurisdiction, plus a VAT Return submittable DocType whose fields mirror each authority's actual return (for example the UAE VAT 201 boxes or the KSA return schedule). A Tax Treatment Rule DocType maps ERPNext Sales Taxes and Charges Template / Item Tax Template combinations to the correct box, tax category and reverse-charge flag, so standard-rated, zero-rated, exempt, out-of-scope, import and designated-zone lines land in the right place automatically.

Technically, the suite hooks into the transaction lifecycle rather than bolting on a report. doc_events in hooks.py fire validate and on_submit server-side handlers on Sales Invoice, Purchase Invoice and Payment Entry to stamp each line with its resolved tax treatment and to raise the RCM self-assessment entry where the rule requires it. A whitelisted method (generate_return) aggregates GL and tax rows for the period into the country's return DocType, and a second whitelisted method exports the FAF / audit file in the authority's required layout (CSV or XML) to a File attachment. All of this is reachable through the Frappe REST API for downstream automation, and a nightly scheduler_event runs the VAT reconciliation that ties output/input tax control accounts back to filed returns and flags variances. Access is governed by a dedicated "VAT Compliance Manager" role profile and per-company permissions so a multi-entity group keeps each jurisdiction's data segregated. Client Scripts add the in-form helpers (country selector, box preview, one-click return generation) without patching core ERPNext.

Because every organisation's chart of accounts, entity structure and jurisdiction mix is different, this is a build-to-order engagement, not an off-the-shelf download. It starts with a short scoping call to confirm which of the five countries you file in, your ERPNext version (v15 or v16) and your tax-template setup. ECOSIRE then configures the country profiles and treatment rules to your data, builds against your requirements, and delivers on a staging site for UAT before go-live. Typical delivery is 2-4 weeks from confirmed scope, and you receive the installable source, a git repository handover, documentation and a post-go-live support window.

What you get

Installable source code for your commissioned version of the app (Frappe app installable via bench get-app / bench install-app)

Installation and configuration on your ERPNext v15/v16 site, including country profiles and tax treatment rules tuned to your chart of accounts

Technical documentation covering DocTypes, hooks.py doc events, whitelisted methods, scheduler jobs and the REST API surface

End-user guide plus a live training session for your finance and compliance team

UAT on a staging site with a documented test plan and a rollback plan before production go-live

Post-go-live support window for defect fixes and configuration adjustments

Private git repository handover with full commit history and branch access

Deployment notes for reproducing the setup across staging and production (fixtures, roles, dependencies)

Who this is for

Group Tax / VAT Manager (multi-entity GCC)

Owns VAT filing for legal entities across several GCC countries on one ERPNext instance. Needs each jurisdiction's return generated in the authority's own format, correct reverse-charge treatment, and audit files ready without exporting to spreadsheets.

Finance Controller / CFO

Responsible for accuracy and audit-readiness of filed returns. Wants tax control accounts to reconcile automatically to the numbers actually filed, with variances flagged before submission rather than discovered during an audit.

ERPNext Administrator / Implementation Partner

Maintains the ERPNext site and integrations. Wants a clean Frappe app with proper DocTypes, hooks and role profiles that installs via bench, upgrades cleanly across v15/v16, and does not patch core.

Tax Compliance Analyst

Prepares and reviews returns each period. Needs in-form box previews, one-click return generation and reconciliation reports that trace every box total back to source transactions.

How GCC VAT Compliance Suite Compares

Criterion	ECOSIRE	Custom Build	Competitor
GCC coverage (5 jurisdictions)	Built for all five with per-country profiles	Whatever you scope and build yourself	Usually single-country (often KSA or UAE only)
Return form output	Fields mapped to each authority's actual return	Possible but you design every box	One country's format if any
FAF / audit-file export	Authority-shaped CSV/XML via whitelisted method	You build the export format	Sometimes, single format
Reverse charge & designated zones	Rule-driven, auto self-assessment on submit	Manual to design and test	Limited or manual
Reconciliation to control accounts	Nightly scheduler job flags variances	Build it yourself	Rarely included
Fit to your data	Configured to your COA and entities in scoping	Fully bespoke, high effort	Generic, you adapt to it
Delivery & support	2-4 weeks, UAT, docs, support window, git handover	Depends on your team's capacity	Download now, self-serve support
Upgrade safety (v15/v16)	Separate app, no core patching	Depends on discipline	Varies by vendor

Frequently Asked Questions about GCC VAT Compliance Suite

Is this an existing app I can download and install right now?

No. The GCC VAT Compliance Suite is build-to-order. ECOSIRE configures the country profiles and tax treatment rules to your ERPNext data, builds against your confirmed requirements, tests on a staging site, then installs it. You are not downloading a generic marketplace app; you receive a version tailored to your entities and chart of accounts.

How long does delivery take?

Typical delivery is 2-4 weeks from confirmed scope. The exact timeline depends on how many of the five GCC jurisdictions you file in, your entity structure and the state of your existing tax-template setup. We confirm the delivery window with you at the end of the scoping call before any build work begins.

Which countries and ERPNext versions are supported?

The suite covers VAT return preparation, treatment mapping and audit-file export for UAE, KSA, Bahrain, Oman and Qatar. It is built and tested against Frappe/ERPNext v15 and v16. During scoping we confirm which jurisdictions you need and target your specific version so upgrades stay clean.

How does it handle reverse charge, designated zones and import VAT?

Each scenario is a Tax Treatment Rule that maps your ERPNext tax templates and tax categories to the correct return box and flags. Reverse-charge self-assessment entries are raised automatically via on_submit doc events on qualifying imports and intra-GCC purchases, and designated-zone and import lines are routed to their correct treatment rather than lumped into standard-rated.

Does it modify ERPNext core or replace the built-in tax engine?

No. It is a separate Frappe app layered on top of ERPNext. It reuses your existing Sales/Purchase tax templates and tax categories, and adds its own DocTypes, hooks.py doc events, whitelisted methods, scheduler jobs, role profile and Client Scripts. Nothing in ERPNext core is patched, which keeps future ERPNext upgrades straightforward.

What about support and updates after go-live?

Every engagement includes a post-go-live support window for defect fixes and configuration adjustments, and you receive the full git repository so your team or ours can maintain it. Ongoing support, enhancements, and updates for new authority requirements or ERPNext versions can be arranged as a separate support agreement; we scope that with you based on your filing cadence.

Can we integrate return data with other systems?

Yes. Return generation and audit-file export are exposed through the Frappe REST API via whitelisted methods, so downstream systems, portals or automation scripts can trigger and retrieve returns programmatically, subject to the VAT Compliance Manager role and per-company permissions.