API Docs / Schemas / SaveMtdEmploymentFinancialDetailsRequest

SaveMtdEmploymentFinancialDetailsRequest

Saves the financial details for one employment — pay, tax, benefits in kind and deductions — as
a full replacement of what HMRC hold from this side.

These are the customer-provided figures. Sending them does not overwrite what the employer
submitted: HMRC keep both and the customer figures take precedence for the year, which is why
clearing them restores the employer's.

Properties

Name Type Description
pay*EmploymentPayInput
deductionsEmploymentDeductions
benefitsInKindBenefitsInKind
offPayrollWorkerboolean

Whether the client is an off-payroll worker for this engagement (IR35).

Whether the client is an off-payroll worker for this engagement (IR35).

JSON Example

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

Used By Operations