Previous documentation

Descriptions of income types and items deducted from income on an earnings payment report:

• Wages – Descriptions of income types and items deducted from income 2022 (pdf)
• Wages – Descriptions of income types and items deducted from income 2021 (pdf)
• Descriptions of income types and items deducted from income 2020 (pdf)
• Descriptions of income types and items deducted from income 2019 (pdf)

Application instructions on the data contents of an earnings payment report:

• Application instructions on the data contents of an earnings payment report 2023 (pdf)
• Application instructions on the data contents of an earnings payment report 2022 (pdf)
• Application instructions on the data contents of an earnings payment report 2021 (pdf)
• Application instructions on the data contents of an earnings payment report 2019 (pdf)

Application instructions for the employer's separate report:

• Application instructions for the employer's separate report 2021 (pdf)
• Application instructions for the employer's separate report 2019 (pdf)

Descriptions of income types and items deducted from income on a benefits payment report:

• Benefits – Descriptions of income types and items deducted from income 2022 (pdf)
• Benefits – Descriptions of income types and items deducted from income 2021 (pdf)

Application instructions on the data contents of a benefits payment report:

• Application instructions on the data contents of a benefits payment report 2023 (pdf)
• Application instructions on the data contents of a benefits payment report 2022 (pdf)
• Application instructions on the data contents of a benefits payment report 2021 (pdf)

Wages – Codes – Income types (in xls format):

• Wages - Codes - Income types 2022 (xls)
• Wages - Codes - Income types 2021 (xls)
• Wages - Codes - Income types 2020 (xls)
• Codes - Income types 2019 (xls)

Wages – Codes – Income types (in pdf format):

• Wages – Codes – Income types 2022 (pdf)
• Wages – Codes – Income types 2021 (pdf)
• Wages – Codes – Income types 2020 (pdf)
• Codes – Income types 2019 (pdf)

Benefits – Codes – Income types (in xls format):

• Benefits – Codes – Income types 2022 (xls)
• Benefits – Codes – Income types 2021 (xls)

Benefits – Codes – Income types (in pdf format):

• Benefits – Codes – Income types 2022 (pdf)
• Benefits – Codes – Income types 2021 (pdf)

Technical interface codes (in xls format):

• Codes 2023 (xls)
• Codes 2022 (xls)
• Codes 2021(xls)
• Codes 2020 (xls)
• Codes 2019 (xls)

Technical interface codes (in pdf format):

• Codes 2023 (pdf)
• Codes 2022 (pdf)
• Codes 2021 (pdf)
• Codes 2020 (pdf)
• Codes 2019 (pdf)

Technical interface error codes (in xls format):

• Codes - Error codes 2023 (xls)
• Codes - Error codes 2022 (xls)
• Codes - Error codes 2021 (xls)
• Codes - Error codes 2020 (xls)
• Codes - Error codes 2019 (xls)

Content descriptions of transcripts:

• Transcripts from the Incomes Register 2022 (pdf)
• Transcripts from the Incomes Register 2021 (pdf)

Calculation rules for income data:

• Income data – Calculation rules 2021 (pdf)
• Income data – Calculation rules 2019 (pdf)

General instructions for submitting data:

• Technical interface – Submitting data to the Incomes Register 2020 (pdf)
• Technical interface – Submitting data to the Incomes Register 2019 (pdf)

Schemas for submitting data: Earnings payment reports

• Data delivery – Schemas – Earnings payment reports 2023 (pdf)
• Data delivery – Schemas – Earnings payment reports 2022 (pdf)
  • Examples of submitting earnings payment reports. The examples were published on 17 September 2021.
    • Example 001: Exceptional insurance data – Income type 328 (pdf)
    • Example 002: Exceptional insurance data – Income types 341 and 363 (pdf)
    • Example 003: Unjust enrichment and recovery (pdf)
    • Example 004: Type of additional income earner data: Key employee (pdf)
    • Example 005: "Net-of-tax" employment contract (pdf)
    • Example 006: Non-resident taxpayer (pdf)
    • Example 007: Self-employed person, no obligation to take out YEL or MYEL insurance (pdf)
• Data delivery – Schemas – Earnings payment reports 2021 (pdf)
  • Examples of submitting earnings payment reports. The examples were published on 1 July 2020.
    
    • Example 001: Temporary employer 2021 (pdf)
    • Example 002: Employer with insurance contract, basic case 2021 (pdf)
    • Example 003: Foreign payer, foreign income earner 2021 (pdf)
    • Example 004: Public sector payer 2021 (pdf)
    • Example 005: Employment relationship data - Retirement 2021 (pdf)
    • Example 006: Work abroad and the NT 2 data 2021 (pdf)
    • Example 007: NT data 2021 (pdf)
    • Example 008: Employee leasing notice 2021 (pdf)
    • Example 009: Exception to insurance - Non-resident taxpayer 2021 (pdf)
    • Example 010: Insurance information type for income type 2021 (pdf)
    • Example 011: Absence data 2021 (pdf)
    • Example 012: Unjust enrichment, overpayment previously reported as other income 2021 (pdf)
    • Example 013: Recovery, gross recovery 2021 (pdf)
    • Example 014: Recovery, net recovery 2021 (pdf)
    • Example messages: Data delivery – Earnings payment report (zip)
• Data delivery – Schemas – Earnings payment reports 2020 (pdf)
• Data delivery – Schemas – Earnings payment reports 2019 (pdf)
• Example messages: Earnings payment report 2019
  • Example 001: Employer with insurance contract, basic case (pdf)
  • Example 002: Temporary employer (pdf)
  • Example 003: Foreign payer, foreign income earner (pdf)
  • Example 004: Public sector payer (pdf)
  • Example 005: Work abroad (pdf)
  • Example 006: Insurance exception 1, foreign employer (pdf)
  • Example 007: Insurance exception 2, based on age (pdf)
  • Example 008: Income earner is a non-resident taxpayer (pdf)
  • Example 009: Insurance information type for income type (pdf)
  • Example 010: Absence data (pdf)
  • Example 011: Unjust enrichment, overpayment previously reported as other income (pdf)
  • Example 012: Unjust enrichment, overpayment noticed before report is submitted (pdf)
  • Example 013: Recovery, gross recovery (pdf)
  • Example 014: Recovery 2, net recovery (pdf)
  • Example 015: Recovery 3, gross recovery, contains several income types (pdf)
  • Example 016: Recovery 4, entire amount recovered at the same time (pdf)
  • Example 017: Reimbursement of expenses (pdf)
  • Example 018: Non-wage compensation for work, the income earner is a natural person (pdf)
  • Example 019: Non-wage compensation for work, the income earner is an organisation (pdf)

Schemas for submitting data: Employer's separate reports

• Data delivery – Schemas – Employer's separate reports 2022 (pdf)
  • Examples of submitting employer’s separate reports. The examples were published on 17 September 2021.
    • Example 001: Payer type and validity of pension policy number (pdf)
• Data delivery – Schemas – Employer's separate reports 2021 (pdf)
• Data delivery – Schemas – Employer's separate reports 2020 (pdf)
• Data delivery – Schemas – Employer's separate reports 2019 (pdf)

Schemas for submitting data: Benefits payment reports

• Data delivery – Schemas – Benefits payment reports 2023 (pdf)
• Data delivery – Schemas – Benefits payment reports 2022 (pdf)
  • Examples of submitting benefits payment reports. The examples were published on 22 February 2021.
    • Example 001: Compensation for loss of earnings (motor liability insurance), related deduction of employee contributions and tax withholding (pdf)
    • Example 002: Partial disability pension paid retroactively when the income earner has already received sickness allowance (pdf)
    • Example messages: Data delivery – Benefits payment report (zip)
• Data delivery – Schemas – Benefits payment reports 2021 (pdf)

Schemas for submitting data: Record subscriptions

• Data delivery – Schemas – Record subscriptions 2020 (pdf)
• Data delivery – Schemas – Record subscriptions 2019 (pdf)
• Example messages: Record subscriptions 2019
  • Example 001: Earnings payment reports – all income earners, recurrent subscription (pdf)
  • Example 002: Earnings payment reports – several income earners 1, recurrent subscription (pdf)
  • Example 003: Earnings payment reports – several income earners 2, one-off subscription (pdf)
  • Example 004: Earnings payment reports – several payers 1, recurrent subscription (pdf)
  • Example 005: Earnings payment reports – several payers 2, one-off subscription (pdf)
  • Example 006: Earnings payment reports – several payers, several income earners, recurrent subscription (pdf)
  • Example 007: Earnings payment reports – several records, one-off subscription (pdf)

Schemas for submitting data: Cancellation data

• Data delivery – Schemas – Cancellation data 2021 (pdf)
• Data delivery – Schemas – Cancellation data 2020 (pdf)
• Data delivery – Schemas – Cancellation data 2019 (pdf),

Schemas for submitting data: Acknowledgement of receipt

• Data delivery – Schemas – Acknowledgement of receipt 2020 (pdf)
• Data delivery – Schemas – Acknowledgement of receipt 2019 (pdf)

Schemas for submitting data: Request for processing feedback

• Data delivery – Schemas – Request for processing feedback 2020 (pdf)
• Data delivery – Schemas – Request for processing feedback 2019 (pdf)

Schemas for submitting data: Processing feedback

• Data delivery – Schemas – Processing feedback 2020 (pdf)
• Data delivery – Schemas – Processing feedback 2019 (pdf)

General instructions for data distribution:

• Technical interface – Distribution of data from the Incomes Register 2022 (pdf)
• Technical interface – Distribution of data from the Incomes Register 2021 (pdf)
• Technical interface – Distribution of data from the Incomes Register 2020 (pdf)
• Technical interface – Distribution of data from the Incomes Register 2019 (pdf)

Data distribution schemas: Earnings payment reports

• Data distribution – Schemas – Earnings payment reports 2023 (pdf)
• Data distribution – Schemas – Earnings payment reports 2022 (pdf)
• Data distribution – Schemas – Earnings payment reports 2021 (pdf)
• Data distribution – Schemas – Earnings payment reports 2020 (pdf)
• Data distribution – Schemas – Earnings payment reports 2019 (pdf)

Data distribution schemas: Employer's separate reports

• Data distribution – Schemas – Employer's separate reports 2023 (pdf)
• Data distribution – Schemas – Employer's separate reports 2022 (pdf)
• Data distribution – Schemas – Employer's separate reports 2021 (pdf)
• Data distribution – Schemas – Employer's separate reports 2020 (pdf)
• Data distribution – Schemas – Employer's separate reports 2019 (pdf)

Data distribution schemas: Benefits payment reports

• Data distribution – Schemas – Benefits payment reports 2023 (pdf)
• Data distribution – Schemas – Benefits payment reports 2021 (pdf)

Data distribution schemas: Service Request:

• Data distribution – Schemas – Service Request 2020 (pdf)
• Data distribution – Schemas – Service Request 2019 (pdf)

Data distribution schemas: Log Data

• Data distribution – Schemas – Log Data 2020 (pdf)
• Data distribution – Schemas – Log Data 2019 (pdf)

Data distribution schemas: Summary of payer's earnings payment data

• Data distribution – Schemas – Summary of payer's earnings payment data 2020 (pdf)
• Data distribution – Schemas – Summary of payer's earnings payment data 2019 (pdf)

Data distribution schemas: Rejected reports submitted on paper form

• Data distribution – Schemas – Rejected reports submitted on paper form 2023 (pdf)
• Data distribution – Schemas – Rejected reports submitted on paper form 2021 (pdf)

Application guidelines for technical interface:

• Technical interface – Application guidelines 2021 (pdf)
• Technical interface – Application guidelines 2020 (pdf)
• Technical interface – Application guidelines 2019 (pdf)

ZIP files:

• Technical interface – ZIP file for application developers 2023 (zip)
• Technical interface – ZIP file for application developers 2022 (zip)
• Technical interface – ZIP file for application developers 2021 (zip)
• Technical interface – ZIP file for application developers 2020 (zip)
• Technical interface – ZIP file for application developers 2019 (zip)

Content descriptions of the ZIP files:

• Technical interface – ZIP file for application developers 2023 (pdf)
• Technical interface – ZIP file for application developers 2022 (pdf)
• Technical interface – ZIP file for application developers 2021 (pdf)
• Technical interface – ZIP file for application developers 2020 (pdf)
• Technical interface – ZIP file for application developers 2019 (pdf)

Technical interface – Message signing:

• No previous version published