bench get-app https://github.com/imorphr/making-tax-digital

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=imorphr%2Fmaking-tax-digital)](https://frappegems.com/gems/apps/imorphr/making-tax-digital)

Making Tax Digital (MTD) for VAT - Frappe/ERPNext Integration

The Making Tax Digital (MTD) for VAT app enables UK VAT-registered businesses to file VAT returns from ERPNext directly to HMRC using official HMRC MTD VAT APIs.

It is built on the Frappe framework.

For feature specifications and business-flow documentation, see specs/index.md.

For local development setup, see docs/01devenvironment_setup.md.

For end-user guidance on filing VAT returns, see docs/userdocs/01user_guide.md.

What This App Provides

• HMRC OAuth 2.0 and VAT API access through the iMORPHr MTD Connector
• VAT obligation sync from HMRC
• VAT return preparation using configurable box filters
• VAT return submission to HMRC
• Submission receipt capture (correlation, receipt, processing metadata)
• HMRC fraud prevention header support
• VAT reporting and traceable return evidence

Key Functional Areas

• Company-level HMRC connection and box settings
• Global MTD settings (including sync behavior)
• Obligation synchronization into local return records
• Return lifecycle:
  • Open
  • Return Prepared
  • Sent To HMRC
  • Fulfilled

Typical Workflow

1. Configure company MTD connection and box filters.
2. Sync VAT obligations from HMRC.
3. Prepare VAT return for the tax period.
4. Review computed values and evidence data.
5. Submit to HMRC.
6. Track submission receipt and status updates.

User Documentation

End-user guides for business users filing VAT returns through the app.

1. See docs/userdocs/01user_guide.md for the complete guide: subscribing, configuring companies, connecting to HMRC, preparing returns, and submitting to HMRC.
2. https://imorphr.com/blog/uk-vat-return-filing-from-erpnext

Development Environment

See docs/01devenvironment_setup.md for local dev configuration: prerequisites, MTD Connector URL, networking scenarios, site subscription, company setup, and HMRC sandbox connection.