API Docs / Schemas / SaveMtdOtherEmploymentIncomeRequest

SaveMtdOtherEmploymentIncomeRequest

Saves the year's other employment income at HMRC — share options, shares awarded or received,
lump sums, and the disability and foreign service deductions.

A full replacement: every entry that should survive must be in the request,
because what is absent is cleared. Clearing the year is a delete, not an empty save.

Properties

Name Type Description
shareOptionarray of ShareOptionItem

Share option events. HMRC's scheme plan types are emi, csop, saye and other.

Share option events. HMRC's scheme plan types are emi, csop, saye and other.

sharesAwardedOrReceivedarray of SharesAwardedOrReceivedItem

Shares awarded or received. HMRC's scheme plan types are sip and other.

Shares awarded or received. HMRC's scheme plan types are sip and other.

disabilityEmploymentDeductionItem
foreignServiceEmploymentDeductionItem
lumpSumsarray of EmploymentLumpSums

Lump sums, grouped by employer. HMRC require the employer identity on every entry.

Lump sums, grouped by employer. HMRC require the employer identity on every entry.

JSON Example

{
  "shareOption": [
    {
      "employerName": "...",
      "employerRef": "...",
      "schemePlanType": "...",
      "dateOfOptionGrant": "...",
      "dateOfEvent": "..."
    }
  ],
  "sharesAwardedOrReceived": [
    {
      "employerName": "...",
      "employerRef": "...",
      "schemePlanType": "...",
      "dateSharesCeasedToBeSubjectToPlan": "...",
      "noOfShareSecuritiesAwarded": "..."
    }
  ],
  "disability": {
    "customerReference": "string",
    "amountDeducted": 0
  },
  "foreignService": {
    "customerReference": "string",
    "amountDeducted": 0
  },
  "lumpSums": [
    {
      "employerName": "...",
      "employerRef": "...",
      "taxableLumpSumsAndCertainIncome": "...",
      "benefitFromEmployerFinancedRetirementScheme": "...",
      "redundancyCompensationPaymentsOverExemption": "..."
    }
  ]
}

Used By Operations