API Docs / Schemas / AmendMtdCustomEmploymentRequest

AmendMtdCustomEmploymentRequest

Amends a custom employment — a full replacement of its record at HMRC, so
every value that should survive must be present.

Only custom employments can be amended. An employment HMRC hold from the employer's own
submissions is theirs to correct; the way to take it out of the calculation is to ignore it.

Properties

Name Type Description
employerRefstring

The employer's PAYE reference.

The employer's PAYE reference.

employerName*string

The employer's name. Required by HMRC.

The employer's name. Required by HMRC.

startDate*string

The employment's start date. Required by HMRC.

The employment's start date. Required by HMRC.

cessationDatestring

The employment's cessation date, when it ended in the year.

The employment's cessation date, when it ended in the year.

payrollIdstring

The payroll identifier.

The payroll identifier.

occupationalPension*boolean

Whether the employment is an occupational pension. Required by HMRC.

Whether the employment is an occupational pension. Required by HMRC.

JSON Example

{
  "employerRef": "string",
  "employerName": "string",
  "startDate": "2024-01-01",
  "cessationDate": "2024-01-01",
  "payrollId": "string",
  "occupationalPension": false
}

Used By Operations