Skip to main content
UK Making Tax Digital (HMRC VAT) for ERPNext — A build-to-order ERPNext app that submits your VAT return directly to HMRC's M — 1/1Illustrative preview

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.

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

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
UK VAT tax templates as installable fixtures: standard 20%, reduced 5%, and zero-rated, with matching Sales/Purchase Taxes and Charges rate tables
UK chart of accounts and a VAT control account structure that reconciles cleanly to the nine-box return
CIS (Construction Industry Scheme) deduction handling with contractor/subcontractor supplier flags and dedicated CIS deduction accounts
CIS deduction logic wired into purchase transactions via `hooks.py` doc events (`before_save`/`on_submit`) so deductions are captured at source
`MTD VAT Settings` single DocType holding VRN, HMRC client credentials, and a sandbox/production environment toggle
Scheduler event that polls HMRC obligations and flags approaching filing deadlines to the accounting role
Role profile and DocType permissions so only the VAT/Accounts Manager role can submit returns to HMRC
Digital-link preservation: figures flow from source transactions to the return without manual re-keying, meeting HMRC's record-keeping rule
Full audit trail — submitted returns store HMRC's `processingDate`, `formBundleNumber`, and payment reference against an immutable record
Sandbox-first testing path so the complete submit flow is verified against HMRC's test environment before any live filing
Compatible with ERPNext / Frappe v15 and v16, installed as a standalone app that survives `bench update`

Built to order, done for you

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

  1. 1

    You order

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

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your ERPNext.

  3. 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

CriterionECOSIRECustom BuildCompetitorERPNext Native
HMRC MTD submissionDirect OAuth 2.0 submit from a DocType, sandbox-testedPossible but you build the API and header logic yourselfSome marketplace bridges exist, quality and header support varyNo native HMRC connection at all
Fraud-prevention headersFull `Gov-Client-*`/`Gov-Vendor-*` set, server + clientMust be researched and implemented from HMRC specOften partial, a common cause of rejectionsNot handled
UK VAT templates & CoAInstalled as fixtures, mapped to nine boxesConfigured manually per projectSometimes bundled, mappings may not fit your accountsGeneric templates, no UK box mapping
CIS supportDeduction logic via hooks, when in scopeBuilt from scratchRarely includedNot available
Fit to your setupBuilt to your version, scheme, and account mapFully bespoke but slow and costlyOne-size-fits-all, adapt your books to itN/A
Testing before live filingHMRC sandbox + staging UAT + rollback planDepends on your team's disciplineUsually production-onlyN/A
Source & ownershipFull source + git repo handoverYou own it, you built itClosed source, licence-lockedN/A
Support & upgradesPost-go-live window + optional agreementYour team maintains itVendor SLA, variableCommunity 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.

Request a quote

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

Request a Quotation

Tell us about your UK Making Tax Digital (HMRC VAT) requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.