MtdEmploymentsDto
The employments HMRC know for a client and tax year, and the employment income that belongs to
no single employment.
Employments come from two places and what can be done to them differs entirely, which is the
single most important thing this list carries. An employment HMRC hold — built from the
employer's own RTI submissions — cannot be edited or deleted, only ignored, which
tells HMRC to leave it out of the tax calculation. A custom employment, added by the client or
their agent for something HMRC do not hold, can be amended and deleted but never ignored.
Offering the wrong action gets a refusal from HMRC, so
SodiumHQ.DTOs.MtdSubmissions.MtdEmploymentDto.IsHmrcHeld is what the UI keys its actions off.
Properties
| Name | Type | Description |
|---|---|---|
| clientCode | string | The Sodium client the employments belong to, stamped by the API on the way out. |
The Sodium client the employments belong to, stamped by the API on the way out. | ||
| taxYear | string | The tax year, in HMRC's format, e.g. 2025-26. |
The tax year, in HMRC's format, e.g. 2025-26. | ||
| employments | array of MtdEmploymentDto | Every employment for the year, HMRC-held and custom together, each flagged with which it is. |
Every employment for the year, HMRC-held and custom together, each flagged with which it is. | ||
JSON Example
{
"clientCode": "string",
"taxYear": "string",
"employments": [
{
"employmentId": "...",
"employerName": "...",
"isHmrcHeld": "...",
"dateIgnored": "...",
"lastAction": "..."
}
]
}