Guidance

Self Assessment technical specifications (2023) for individual returns

Use this technical documentation for individual returns if you're a software developer working with the Self Assessment online service.

• From: HM Revenue & Customs
• Published: 20 January 2023
• Last updated: 5 January 2024 — See all updates

Documents

Self Assessment Individual RIM artefacts version 1.0

ZIP, 3.62 MB

This file may not be suitable for users of assistive technology.

Request an accessible format.

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

Tax and National Insurance contributions calculation version E ― version 2.1.1

ODT, 676 KB

This file is in an OpenDocument format

This file may not be suitable for users of assistive technology.

Request an accessible format.

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

Stage 13 (Payments on Account) Tax and National Insurance contributions calculation version 1.0.0

ODT, 10.5 KB

This file is in an OpenDocument format

This file may not be suitable for users of assistive technology.

Request an accessible format.

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

Test case generator version 2.1.2

ZIP, 3.13 MB

This file may not be suitable for users of assistive technology.

Request an accessible format.

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

MTR mapping document version 1.1

ZIP, 23.1 KB

This file may not be suitable for users of assistive technology.

Request an accessible format.

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

Special Cases Version 3.1

ODT, 56.6 KB

This file is in an OpenDocument format

This file may not be suitable for users of assistive technology.

Request an accessible format.

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

Exclusion Cases Version 3.1

ODT, 57 KB

This file is in an OpenDocument format

This file may not be suitable for users of assistive technology.

Request an accessible format.

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

Details

Use this technical documentation for individual returns if you’re a software developer working with the Self Assessment online service.

Published 20 January 2023
Last updated 5 January 2024 + show all updates

1. 5 January 2024

   Special Cases Version 3.1 and Exclusion Cases Version 3.1 have been added.

2. 27 November 2023

   Exclusion Cases version 3.0a has been added.

3. 28 September 2023

   Special Cases version 3.0a document has been added.

4. 2 August 2023

   Special Cases and Exclusion Cases documents updated with new versions (2.0a).

5. 5 May 2023

   We have added special cases version 1.0a and exclusion cases version 1.0a.

6. 16 March 2023

   Special cases version 0.1a and exclusion cases version 0.1a have been added.

7. 20 January 2023

   First published.