Client - MTD Employments
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.
-
POST Add Custom EmploymentAdds an employment HMRC do not already hold from the employer's own submissions, and returns the identifier HMRC issue. Only for employments HMRC are .../tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}
-
PUT Save Non-PAYE Employment IncomeSends the year's non-PAYE employment income to HMRC — a full replacement of what they hold. Clearing the year is a delete rather than an empty save./tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/income/non-paye
-
DELETE Delete Non-PAYE Employment IncomeClears the non-PAYE employment income HMRC hold for the tax year./tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/income/non-paye
-
PUT Save Other Employment IncomeSends the year's share schemes, lump sums and employment deductions to HMRC. A full replacement — every entry that should survive must be in the reque.../tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/income/other
-
DELETE Delete Other Employment IncomeClears the other employment income HMRC hold for the tax year./tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/income/other
-
GET Get EmploymentReturns one employment in full: HMRC's record of it and the financial details currently held against it. HMRC keep the employer's figures and any prov.../tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/{employmentId}
-
PUT Amend Custom EmploymentAmends a custom employment — a full replacement of its record, so every value that should survive must be present. HMRC refuse this for an employment .../tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/{employmentId}
-
DELETE Delete Custom EmploymentDeletes a custom employment at HMRC. Only custom employments can be deleted — an HMRC-held one is the employer's record, and ignoring it is the way to.../tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/{employmentId}
-
POST Ignore EmploymentMarks an HMRC-held employment as ignored, leaving it out of the year's tax calculation. This is how a duplicated or wrong employment from an employer'.../tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/{employmentId}/ignore
-
DELETE Unignore EmploymentRemoves the ignored marker from an HMRC-held employment, putting it back into the year's tax calculation./tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/{employmentId}/ignore
-
PUT Save Employment Financial DetailsSends the pay, tax, benefits in kind and deductions for one employment. A full replacement of the figures provided from this side — not of the employe.../tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/{employmentId}/financial-details
-
DELETE Delete Employment Financial DetailsDeletes the financial details provided from this side for one employment, leaving whatever the employer submitted to stand./tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/{employmentId}/financial-details