Client - MTD Tax Return
Reviewing a client's Making Tax Digital Income Tax year and sending their tax return to HMRC. The review is thirty or more HMRC requests behind one call — every income source's obligations, reporting setup, held position and year-end work, all their other income, losses, liability adjustments, HMRC's calculation, and the declaration with whatever is standing in the way — so it is slow the first time a year is opened and fast afterwards. What it reports as standing in the way is advice rather than a gate: HMRC hold the real rules and a practice that disagrees may proceed. The one exception is the declaration, which HMRC require the software itself to enforce. Behind its own permission, separate from quarterly updates, because HMRC allow a supporting agent to file the second and not the first. This filing is not idempotent: a submission whose outcome is unknown is settled by reconciling it against HMRC's own record, never by sending again.
-
GET Review Tax ReturnEverything that has to be right before a client's tax return is sent: every income source's obligations, reporting setup, held position, year-end subm.../tenants/{tenant}/clients/{client}/mtd/tax-return/{taxYear}
-
POST Send Tax ReturnSends the client's tax return to HMRC against the calculation named in the request. Refused unless the declaration has been read and agreed, and refus.../tenants/{tenant}/clients/{client}/mtd/tax-return/{taxYear}/submit
-
POST Reconcile Tax ReturnSettles a tax return whose outcome nobody knows, by reading HMRC's own record back — the only safe way out of an in-flight submission, because sending.../tenants/{tenant}/clients/{client}/mtd/tax-return/{taxYear}/submissions/{submissionCode}/reconcile
-
GET List Tax ReturnsThe tax returns sent for this client from Sodium, newest first, optionally filtered to one tax year. A local read with no HMRC call — a year filed by .../tenants/{tenant}/clients/{client}/mtd/tax-return