A client's employment income for a tax year under MTD Income Tax: the employments themselves, the financial details held against each, and the income belonging to no single employment (non-PAYE tips, share schemes, lump sums, deductions). Employments come from two places and what can be done to them differs: one HMRC hold from the employer's RTI submissions cannot be edited or deleted, only ignored, while a custom employment added here can be amended and deleted but never ignored.

Save Employment Financial Details

PUT /tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/{employmentId}/financial-details

Sends the pay, tax, benefits in kind and deductions for one employment. A full replacement of the figures provided from this side — not of the employer's, which HMRC keep alongside. The figures sent here take precedence for the year, which is why deleting them restores the employer's rather than leaving nothing.

Parameters

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

Request Body*

SaveMtdEmploymentFinancialDetailsRequest

{
  "pay": {
    "taxablePayToDate": 0,
    "totalTaxToDate": 0
  },
  "deductions": {
    "studentLoans": "..."
  },
  "benefitsInKind": {
    "accommodation": 0,
    "assets": 0,
    "assetTransfer": 0,
    "beneficialLoan": 0,
    "car": 0
  },
  "offPayrollWorker": false
}

Responses

200 OK

MtdSubmissionReceiptDto

400 Bad Request

401 Unauthorized – Invalid or missing API key

404 Not Found