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

The Making Tax Digital (MTD) for VAT app provides seamless HMRC VAT integration for ERPNext, enabling UK VAT-registered businesses to connect with HMRC and file VAT returns directly from ERPNext using the HMRC Making Tax Digital (MTD) VAT APIs.

Built on the Frappe Framework, the app simplifies HMRC compliance by managing VAT obligations, preparing VAT returns, and securely submitting them to HMRC.

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.