Trigger Tax Return Calculation

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.

Asks HMRC to run the calculation a tax return declares: as an intent to finalise for the return itself, or as an intent to amend for a change to a return already sent. The in-year estimates the quarterly updates produce are never candidates, so nothing can be sent for a year until this has been run. HMRC work the calculation out after answering — read the review again a few seconds later for its figures. Each call creates a new calculation, and the review declares the newest.

Parameters

Name	Type	Description
tenant*	path string	The Tenant.Code
The Tenant.Code
client*	path string
taxYear*	path string

Request Body*

TriggerMtdTaxReturnCalculationRequest

{
  "declarationType": "Unknown"
}

Responses

200 OK

MtdTaxReturnCalculationDto

400 Bad Request

401 Unauthorized – Invalid or missing API key

ProblemDetails

404 Not Found