MtdBusinessYearConfigDto
The per-tax-year configuration HMRC hold for one income source: the accounting basis, the
periods of account, and the late accounting date rule election.
These are separate HMRC resources fetched together because they are one screen to the practice
— the year's setup for a business, decided before its figures mean anything. Periods of account
and the late accounting date rule are self-employment only; for a property business they come
back absent, which is correct rather than missing.
Properties
| Name | Type | Description |
|---|---|---|
| clientCode | string | The Sodium client the income source belongs to, stamped by the API on the way out. |
The Sodium client the income source belongs to, stamped by the API on the way out. | ||
| businessId | string | HMRC's identifier for the income source. |
HMRC's identifier for the income source. | ||
| taxYear | string | The tax year, in HMRC's format, e.g. 2025-26. |
The tax year, in HMRC's format, e.g. 2025-26. | ||
| accountingType | enum | Cash Accrual |
Cash Accrual | ||
| lastAccountingTypeAction | MtdSubmissionStampDto | |
| supportsPeriodsOfAccount | boolean | Whether periods of account apply to this income source at all. False for a property business, Without this a caller cannot tell "does not apply" from "nothing declared yet" — both arrive |
Whether periods of account apply to this income source at all. False for a property business, Without this a caller cannot tell "does not apply" from "nothing declared yet" — both arrive | ||
| periodsOfAccount | PeriodsOfAccountResponseDto | |
| lastPeriodsOfAccountAction | MtdSubmissionStampDto | |
| supportsLateAccountingDateRule | boolean | Whether the late accounting date rule applies to this income source at all. False for a |
Whether the late accounting date rule applies to this income source at all. False for a | ||
| lateAccountingDateRule | LateAccountingDateRuleDto | |
| lastLateAccountingDateRuleAction | MtdSubmissionStampDto | |
JSON Example
{
"clientCode": "string",
"businessId": "string",
"taxYear": "string",
"accountingType": "Cash",
"lastAccountingTypeAction": {
"kind": "string",
"action": "string",
"reference": "string",
"taxYear": "string",
"performedByUserCode": "string"
}
}