Britixo CRMBritixo CRMEnterprise Help Centre
Ctrl K
MTD - HMRC Compliant Module · How-to guide

Install and activate the MTD - HMRC Compliant Module

Install the reusable module through the normal Britixo module lifecycle without modifying Accounting or CRM core files. The guide then takes you through the correct route, the checks to complete before making changes, the workflow in order, and the evidence to review afterwards.

Audience: Administrators, finance managers and authorised tax staffModule v1.0.0Code-backed
Jump to steps
Where to goSetup → Modules / Tax Centre → Settings
Before you startRequired access: Administrator or the relevant MTD settings/access permission. Work on the correct tenant and taxpayer profile. Reconcile the underlying Accounting & Bookkeeping records before relying on prepared tax totals.

What you’ll accomplish

Install the reusable module through the normal Britixo module lifecycle without modifying Accounting or CRM core files. The MTD module stores tax profiles, HMRC authority, obligations, frozen filing snapshots, approvals and audit evidence, while Accounting remains the primary financial record system.

Follow these steps

  1. Go to Setup → Modules in the Britixo administrator area for the current master or tenant runtime.
  2. Upload the installable ZIP with the single mtd_hmrc_compliant/ module root.
  3. Install and activate the module through the native module lifecycle so install.php runs with the current database prefix.
  4. Go to the new MTD - HMRC Compliant Module menu and confirm the Overview page loads.
  5. Check the Accounting & digital link panel; do not attempt a filing if Accounting cannot be proven active.
  6. Assign only the permissions needed by the staff who will prepare, review, approve or submit tax data.
  7. Configure HMRC application values in the protected deployment environment before starting OAuth.

Checks before you continue

Taxpayer profileAlways verify the correct profile, tax regime and masked identifiers before preparing or submitting.
Tenant contextTax records, HMRC authority and audit history must stay inside the current Britixo tenant/runtime.
Accounting sourceSource tax figures must come through the verified Accounting digital-link adapter with transaction lineage.
Approval stateThe exact frozen snapshot must carry the approvals required by its filing mode before HMRC submission.

Technical basis for this guidance

This guide was checked against mtd_hmrc_compliant.php; controllers/Mtd_hmrc_compliant.php; views/admin/settings.php; install.php. The user instructions describe only behaviour exposed or enforced by the supplied module. Internal secrets, encrypted token values and database identifiers are intentionally not shown to ordinary users.

Compliance and operational boundaries

  • Britixo Accounting & Bookkeeping remains the authoritative ledger; the MTD module is a tax preparation/submission layer.
  • Government Gateway usernames and passwords must never be entered into or stored by Britixo.
  • A tax filing must not proceed when transaction-level digital lineage cannot be proven.
Accounting interlinkFor transaction creation, tax mappings, banking, reconciliation, journals, reports and source-document corrections, use the Accounting & Bookkeeping Help Centre. Correct the bookkeeping source first; do not type replacement totals into MTD merely to clear an error.
Accounting & BookkeepingOpen related guidanceAll MTD - HMRC Compliant guidesOpen related guidance