- Home
- Apps
- SaaS Tools
- UK Making Tax Digital (HMRC VAT) for ERPNext
Illustrative previewA build-to-order ERPNext app that submits your VAT return directly to HMRC's Making Tax Digital API,
with UK VAT tax templates, CIS handling, and a UK chart of accounts.
ECOSIRE builds, installs, and supports it after we agree your scope.
What is UK Making Tax Digital (HMRC VAT) for ERPNext?
A build-to-order ERPNext app that submits your VAT return directly to HMRC's Making Tax Digital API, with UK VAT tax templates, CIS handling, and a UK chart of accounts. ECOSIRE builds, installs, and supports it after we agree your scope. Built to order by ECOSIRE for ERPNext v15, v16 — indicative price from $999.00 USD; request a quote for a scoped proposal.
Key Features
Built to order, done for you
No DIY setup — a working app, built, installed and supported by ECOSIRE.
- 1
You order
Start with a one-time build price. We scope it with you at kickoff.
- 2
We build & install
ECOSIRE builds, configures and installs it on your ERPNext.
- 3
Go live + support
You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.
Technical Specifications
- ERPNext Compatibility
- —
- License
- Licence confirmation required
- Python Requirement
- Python 3.10+
- Database
- MariaDB 10.6+
About this Product
Since April 2022 every VAT-registered UK business must keep digital records and submit VAT returns through HMRC's Making Tax Digital (MTD) API — manual keying into the HMRC portal is closed. ERPNext gives you accurate VAT accounting and a nine-box picture of your liability, but it has no native OAuth 2.0 connection to HMRC, no fraud-prevention header handling, and no obligations/liabilities/payments retrieval. That gap is where UK finance teams end up copying figures into third-party bridging spreadsheets, breaking the digital link HMRC requires.
We build a proper Frappe app (its own module, installed on your bench via bench get-app and bench install-app) that closes the loop end to end. A custom HMRC VAT Return DocType maps directly onto ERPNext's VAT-boxed tax accounts, computing all nine boxes from your posted Sales Invoice, Purchase Invoice, and Journal Entry data for the selected obligation period. Whitelisted server methods (@frappe.whitelist()) drive the HMRC VAT (MTD) endpoints — retrieve open obligations, submit the return, and read back liabilities and payments — over OAuth 2.0 with encrypted token storage and automatic refresh. Every request carries the mandatory Gov-Client- and Gov-Vendor- fraud-prevention headers HMRC now enforces, assembled server-side and from a lightweight client script so submissions aren't rejected.
The app ships UK localization as installable fixtures: standard (20%), reduced (5%), and zero-rated VAT tax templates and a Sales/Purchase Taxes and Charges rate table, plus a UK chart of accounts and a VAT control account structure that reconciles to the nine boxes. Where you operate under the Construction Industry Scheme, we add CIS deduction handling — a contractor/subcontractor flag on suppliers, CIS deduction accounts, and calculation logic wired into purchase transactions via hooks.py doc events so the deduction is captured at source and reported cleanly. A dedicated MTD VAT Settings single DocType holds your VRN, HMRC client credentials, and environment toggle (sandbox vs. production), and a scheduler event polls for approaching obligation deadlines so nothing is missed.
Because this is build-to-order, nothing is downloaded from a marketplace and switched on blind. After a short scoping call we confirm your ERPNext version (v15 or v16), your VAT scheme (standard, flat-rate, cash accounting), whether CIS applies, and your existing account mappings. We build against that scope, test the full submit flow against HMRC's sandbox, deploy to a staging bench for your UAT, and only then cut over to production with a rollback plan. You receive the full source, a git repository handover, documentation, a training session, and a post-go-live support window. Typical delivery is one working week from confirmed scope.
What you get
- Installable source code for your ERPNext version (v15 or v16), packaged as a standalone Frappe app
- Installation and configuration on your bench, including HMRC credential setup and sandbox-to-production cutover
- Technical documentation: DocType reference, hooks, whitelisted methods, and OAuth/credential handling
- User guide plus a live training session for your accounting team on the file-a-return workflow
- UAT on a staging bench with the full HMRC sandbox submit flow, plus a documented rollback plan
- Post-go-live support window for defect fixes and filing-cycle questions
- Git repository handover with full commit history and a tagged release
- UK localization fixtures (VAT templates, chart of accounts, CIS accounts) as re-importable data
Who this is for
UK VAT-registered SME finance lead
Runs ERPNext as the books of record and needs quarterly VAT returns filed straight to HMRC under MTD, without exporting figures into a bridging spreadsheet and breaking the digital link.
Accountant or bookkeeping practice on ERPNext
Files VAT for multiple client companies and wants a repeatable, in-system submission flow with obligation retrieval, sandbox testing, and an audit trail per VRN.
Construction firm under CIS
Needs UK VAT plus Construction Industry Scheme deduction handling on subcontractor purchases, with the deduction captured at source and reconciled to the VAT and CIS control accounts.
Finance director migrating off legacy accounting
Moving from Sage or QuickBooks to ERPNext and needs UK localization — chart of accounts, VAT rates, and MTD filing — in place before the first live return is due.
How UK Making Tax Digital (HMRC VAT) for ERPNext Compares
| Criterion | ECOSIRE | Custom Build | Competitor | ERPNext Native |
|---|---|---|---|---|
| HMRC MTD submission | Direct OAuth 2.0 submit from a DocType, sandbox-tested | Possible but you build the API and header logic yourself | Some marketplace bridges exist, quality and header support vary | No native HMRC connection at all |
| Fraud-prevention headers | Full `Gov-Client-*`/`Gov-Vendor-*` set, server + client | Must be researched and implemented from HMRC spec | Often partial, a common cause of rejections | Not handled |
| UK VAT templates & CoA | Installed as fixtures, mapped to nine boxes | Configured manually per project | Sometimes bundled, mappings may not fit your accounts | Generic templates, no UK box mapping |
| CIS support | Deduction logic via hooks, when in scope | Built from scratch | Rarely included | Not available |
| Fit to your setup | Built to your version, scheme, and account map | Fully bespoke but slow and costly | One-size-fits-all, adapt your books to it | N/A |
| Testing before live filing | HMRC sandbox + staging UAT + rollback plan | Depends on your team's discipline | Usually production-only | N/A |
| Source & ownership | Full source + git repo handover | You own it, you built it | Closed source, licence-locked | N/A |
| Support & upgrades | Post-go-live window + optional agreement | Your team maintains it | Vendor SLA, variable | Community only |
Frequently Asked Questions about UK Making Tax Digital (HMRC VAT)
How long does delivery take?
This is a build-to-order app, so it is built to your confirmed scope rather than downloaded. Typical delivery is one working week from the point we agree scope on the scoping call, covering build, HMRC sandbox testing, staging UAT, and production cutover. CIS or multi-company requirements sit at the longer end of that range.
Is this an instant download from the Frappe marketplace?
No. Nothing is switched on blind. ECOSIRE builds the app against your ERPNext version and VAT setup, tests the full submit flow against HMRC's sandbox, and installs it on your bench. You then own the source and git repository.
How do updates and support work after go-live?
Every engagement includes a post-go-live support window for defect fixes and filing-cycle questions. Because you receive the full source and git repo, your team or ours can maintain it. We also offer ongoing support agreements to cover HMRC API changes, fraud-prevention header updates, and ERPNext version upgrades.
Does it handle HMRC's fraud-prevention header requirements?
Yes. HMRC rejects MTD submissions that omit the required `Gov-Client-*` and `Gov-Vendor-*` fraud-prevention headers. The app assembles these server-side and, for browser-device values, via a client script, so your submissions are accepted.
Which ERPNext versions and VAT schemes are supported?
We build for Frappe/ERPNext v15 and v16. On the scoping call we confirm your scheme — standard, flat-rate, or cash accounting — and whether CIS applies, and tailor the box calculations and account mappings accordingly.
Does it support the Construction Industry Scheme (CIS)?
Yes, when it's in scope. We add contractor/subcontractor flags on suppliers, CIS deduction accounts, and deduction logic wired into purchase transactions via `hooks.py` doc events, so the deduction is captured at source and reconciles to your control accounts.
Can we test before filing a real return?
Yes. The app is sandbox-first: the complete retrieve-obligations and submit-return flow is verified against HMRC's test environment on a staging bench during UAT before any live return is filed against production.
Related Modules

UAE VAT & E-Invoicing for POS (Peppol/FTA)
FTA-compliant UAE tax invoices and Peppol/PINT-AE-ready e-invoices emitted directly from the ERPNext POS, with bilingual Arabic/English receipts, TRN validation, and 5% VAT plus exemption handling. Built, installed, and supported by ECOSIRE on your ERPNext v15/v16 instance.

UAE WPS Payroll & SIF File Generator
A build-to-order ERPNext app that turns every payroll run into a validated, MOHRE-compliant WPS SIF file in one click. ECOSIRE builds, installs, and supports it on your Frappe v15/v16 site — no more hand-editing bank templates each pay cycle.

Universal Biometric Device Connector
A build-to-order Frappe app that syncs attendance from mixed biometric hardware — eSSL, Suprema, Hikvision, Matrix, Realtime and more — into ERPNext as clean Employee Checkin records. ECOSIRE scopes, builds, installs, and supports it for your device fleet.

USA 1099 & E-File Pack
A build-to-order ERPNext app that captures W-9/TIN data on suppliers, tags every bill and payment with the correct 1099 box, and produces e-file-ready output plus recipient copies at year end. ECOSIRE scopes, builds, installs and supports it on your Frappe bench.
UK Making Tax Digital (HMRC VAT)
A build-to-order ERPNext app that submits your VAT return directly to HMRC's Making Tax Digital API, with UK VAT tax templates, CIS handling, and a UK chart of accounts. ECOSIRE builds, installs, and supports it after we agree your scope.
- Custom `HMRC VAT Return` DocType that computes all nine VAT boxes from posted Sales Invoice, Purchase Invoice, and Journal Entry data for the selected obligation period
- OAuth 2.0 connection to HMRC's VAT (MTD) API with encrypted access/refresh token storage and automatic token refresh on expiry
- Whitelisted `@frappe.whitelist()` server methods for retrieve-obligations, submit-return, view-liabilities, and view-payments endpoints
- Mandatory HMRC fraud-prevention headers (`Gov-Client-*` and `Gov-Vendor-*`) assembled server-side plus a client script for browser-originated device values