Documentation

• Published on 25 November 2024
• The document describes
  • the income types of the earnings payment report used in the Incomes Register, code values of the income types and their descriptions
  • tax withholding and payment of social insurance contributions for each income type
  • the situations in which the income types are used.

Document for 2025:

• Published a version of the document containing the 2025 changes to data contents and other updates of the Incomes Register Unit. The changes apply when the payment date of the income is on 1 January 2025 or later.
• The descriptions of the following income types were clarified:
  • 201 Time-rate pay
  • 216 Other compensation
  • 224 Monetary compensation from a working time bank
  • 317 Other fringe benefit
  • 328 Private caretaker's fee
  • 336 Non-wage compensation for work
  • 353 Taxable reimbursement of expenses

Document for 2026:

• Published a new document Wages - Codes - Income types 2026, combining the data content of the previous documentation:
  
  • Wages – Descriptions of income types and items deducted from income 2025
  • Wages – Codes – Income types 2025

• Published on 10 October 2025
• The document describes data content in earnings payment report and covers what to report under each individual section.

Application instructions on the data contents of an earnings payment report 2026 (pdf)

• Published on 6 November 2025

Application instructions on the data contents of an earnings payment report 2027 (pdf)

• Published on 6 November 2025

Document for 2025:

• The code definition of value 9 in the codeset Reason for unpaid absence has been changed from Job alternation leave to Job alternation leave (before 1.4.2025).

Document for 2026:

• 8 October 2025:
  • Published a version of the document containing the 2026 changes to data content and other updates of the Incomes Register Unit. The changes apply when the income payment date is 1 January 2026 or later.
  • Added two new additional income earner details (IncomeEarnerType) and explanations:
    
    • Leased employee living abroad, working on board a Finnish aircraft
    • Leased employee living abroad, working on board a Finnish ship
  • Added new value (Partial special pregnancy leave) to Paid Absence and Unpaid absence value lists.
    Updated Reimbursement application data by adding new value to the processing rule.
• 6 November 2025:
  • Removed partial special pregnancy leave (PaidAbsence code 24) from Reimbursement application data processing rule (Payment data type).
  • Description of car emissions value has been updated.

Document for 2027:

• 27 October 2025:
  • Published a version of the document containing the 2027 changes to data content and other updates of the Incomes Register Unit. The changes apply when the income payment date is 1 January 2027 or later.
  • Added a new information Reference of the demand for rectification of personal data to the data group Service data (ReportData).
• 6 November 2025:
  
  • Description of car emissions value has been updated.

Application instructions for the employer's separate report 2022 (pdf)

• Published on 27 December 2022
• The document describes data content in employer´s separate report and covers what to report under each individual section.

• Added Introduction and Reading instructions.

• Previous versions of data content application guidelines for wages

• Published on 8 October 2025
• The document describes
  • the benefits and pensions reported to the Incomes Register, with code values and descriptions
  • the situations in which the income types are used.

Document for 2025:

• Description for income types 1024 and 1424 updated.

Document for 2026:

• Published a new document Benefits - Codes - Income types 2026 (xls), combining the data content of the previous documentation:
  
  • Benefits – Descriptions of income types and items deducted from income 2025
  • Benefits – Codes – Income types 2025

Application instructions on the data contents of a benefits payment report 2025 (pdf)

• Published on 27 June 2025
• The document describes data content in benefits payment report and covers what to report under each individual section.

Application instructions on the data contents of a benefits payment report 2027 (pdf)

• Published on 27 October 2025

Document for 2025:

• A version of the document containing the 2025 changes to the data content has been published. The changes apply when the income payment date is 1 January 2025 or a later date.
• In chapter Basic substitute recipient details the defi nition of the Type of substitute recipient Municipality or other social services body has been changed to Wellbeing services county.

Document for 2027:

• A version of the document containing the 2027 changes to the data content has been published. The changes apply when the income payment date is 1 January 2027 or a later date.
• Added a new information Reference of the demand for rectification of personal data to the data group Service data (ReportData).

• Previous versions of data content application guidelines for benefits

Wages – Codes – Income types 2025 (xls)

Wages – Codes – Income types 2025 (pdf)

• Published on 8 January 2025
• The document contains
  • the codes for income types and deductibles on earnings payment report, reporting modes and social insurance premiums used as default in the income types
  • the codes for income types on employer´s separate report.

Wages - Codes - Income types 2026 (xls)

• Published on 13 October 2025
• The document describes
  • the income types of the earnings payment report used in the Incomes Register
  • the codes for income types and deductibles, descriptions and reporting modes
  • tax withholding and payment of social insurance contributions for each income type
  • the situations in which the income types are used
  • the codes for income types on employer´s separate report.

Document for 2025:

• Published a version of the document containing the 2024 changes to the data contents. The changes apply when the payment date of the income is on 1 January 2025 or later.
  The name of the income type code 363 has been corrected from “Tax-exempt share of bicycle benefit” to “Bicycle benefit, tax-exempt share”.

Document for 2026:

• 19 June 2025:
  • Published a new version of the document, combining the data content of the previous documentation:
    
    • Wages – Descriptions of income types and items deducted from income 2025
    • Wages – Codes – Income types 2025
• 13 October 2025:
  • The description of income type 366 (Copyright royalties, earned income) has been clarified.

Benefits – Codes – Income types 2025 (xls)

Benefits – Codes – Income types 2025 (pdf)

• Published on 5 November 2024
• The document contains the codes for the income types of the benefits payment report, codes for the items deducted from income, reporting methods and whether additional information is mandatory.

Benefits - Codes - Income types 2026 (xls)

• Published on 8 October 2025
• The document describes
  • the benefits and pensions reported to the Incomes Register
  •  the codes for the income types of the benefits payment report, codes for the items deducted from income, descriptions, reporting methods and whether additional information is mandatory 
  • the situations in which the income types are used.

Document for 2025:

• Updated the name of income type 1218.

Document for 2026:

• Published a new version of the document, combining the data content of the previous documentation:
  
  • Benefits – Descriptions of income types and items deducted from income 2025
  • Benefits – Codes – Income types 2025
• Description for income types 1024 and 1424 updated.
• Added the income type 1445 General social security benefit (unemployed)
• Added income type 1446 Partial special pregnancy allowance

Codes 2025 (xls)

Codes 2025 (pdf)

• Published on 8 October 2025
• The document contains the codes used in the technical interface of the Incomes Register.

Codes 2026 (xls)

• Published on 8 October 2025

Codes 2027 (xls)

• Published on 27 October 2025

Document for 2025:

• Added the following value to codeset ‘Record type, distributed from Incomes Register’ (QueryDataType):
  
  • 320 Earnings payment reports – all payers (xml)
• Added the following value to codeset Record schema version (QueryDataSchemaVersion):
  Schema for the distribution of all payers
• Added the following values to codeset ‘Applicable collective agreement’ (CBACode):
  
  • 225 Collective agreement for the administration and support service personnel of Vocational Adult Education Centres ·
  • 226 Collective agreement for the teaching personnel of Vocational Adult Education Centres
  • 227 Collective agreement for the administration and support service personnel of the private teaching sector
  • 228 Collective agreement for the teaching personnel of the private teaching sector

Document for 2026:

• 28 May 2025:
  • Published a version of the document containing the 2026 changes to data content. The changes apply when the payment date of the income is on 1 January 2026 or later.
  • Added the following value to codeset Type of additional income earner data (IncomeEarnerType)
    
    • 18 Leased employee living abroad, working on board a Finnish aircraft
      Added the following value to codeset Type of additional income earner data (IncomeEarnerType)
    • 19 Leased employee living abroad, working on board a Finnish ship
  • Added the following value to codeset Query criterion type for record subscription (ParameterType)
    
    • 30 Record owner's record reference
• 8 October 2025:
  • Added the following value to codeset Record schema version (QueryDataSchemaVersion): •
  • Schema for the distribution of all payers
  • Added the following value to codeset Record type, distributed from Incomes Register (QueryDataType):
  • Added the following values to codeset ‘Applicable collective agreement’ (CBACode):
    
    • 225 Collective agreement for the administration and support service personnel of Vocational Adult Education Centres
    • 226 Collective agreement for the teaching personnel of Vocational Adult Education Centres
    • 227 Collective agreement for the administration and support service personnel of the private teaching sector
    • 228 Collective agreement for the teaching personnel of the private teaching sector
  • Removed the following values from codeset ‘Applicable collective agreement’ (CBACode):
    
    • 4 Collective Agreement for Vocational Adult Education Centres
    • 187 Collective Agreement for the Private Education Sector
  • Added the following value to codeset Reason for unpaid absence:
    
    • 18 (Partial special pregnancy leave)
  • Added the following value to codeset Reason for paid absence:
    
    • 24 (Partial special pregnancy leave)
  • Changed the label of the value 30 of Parameter type: “Record owner’s record reference” is now “Query on an employer’s separate report”

Document for 2027:

• Published a version of the document containing the 2027 changes to data content. The changes apply when the payment date of the income is on 1 January 2027 or later.
• Added the following value to codeset 2.1 Record schema version (QueryDataSchemaVersion):
  
  • Schema for the distribution of missing earnings payment reports
  • Schema for the distribution of missing benefits payment reports
• Added the following value to codeset 2.5 Record type, distributed from Incomes Register (QueryDataType):
  
  • 321 Missing earnings payment reports - all income earners (xml)
  • 322 Missing earnings payment reports - several income earners (xml)
  • 323 Missing benefits payment reports - all income earners (xml)
  • 324 Missing benefits payment reports - several income earners (xml)
  • 410 Missing earnings payment reports - one income earner (WS real-time, xml)
  • 411 Missing benefits payment reports - one income earner (WS real-time, xml)
• Added the following values to codeset 2.7 Query criterion type for record subscription (ParameterType):
  
  • 33 Only reports with a dispute indication
  • 34 Displaying disputed data and data missing from the report
• Added the following new codesets:
  
  • Type of missing data (MissingDataType)
  • Dispute Status (DisputeStatus)
  • Only reorts with a dispute indication (OnlyReportsWithDispute)
  • Displaying disputed data and data missing from the report (ShowDisputeInformation)

• Published on 8 October 2025
• The codes contain the descriptions for the error codes of the technical interface.

Codes – Error codes 2026 (xls)

• Published on 6 November 2025

Codes – Error codes 2027 (xls)

• Published on 6 November 2025

Document for 2025:

• The text of the error code BEV0540 has been changed.

Document for 2026:

• 28 May 2025:
  • Document for 2026 published.
    The following error codes added: AV0390, AV0400, AV0410, EV0180, EV0190, IDV0140, IDV0150, IDV0160, IDV0170, IDV0180, IEBV0090, IEOV0040, IEOV0050, TBVA0240, TBVA0241, TBVA0242, TBVA0243, TBVA0244.
    The following error code definitions have changed: EV0070, EV0110, EV0130, EV0140, TBVA0240, WPIDV0020.
• 13 August 2025:
  • The following error code added: BEV0540
  • The following error code added: WPIDV0040.
  • The following error code definitions have changed: WPIDV0020.
• 8 October 2025:
  • MP846: he following error code added: AV0420
  • Added new error code AV0430
  • The text of the error code BEV0540 has been changed.

Document for 2027:

• Document for 2027 published.
• The following error codes added: RDV0100, RDV0110

Incomes Register´s Classification of Occupations (TK10) (stat.fi)

• The name of the Incomes Register's own occupational classification is “Incomes Register’s Classification of Occupations (TK10)”, but the old name “Statistics Finland’s Classification of Occupations (TK10)” is still used in the Incomes Register systems.
• Classification is available on Statistics Finland’s website.

• Previous versions of codes

Transcripts from the Incomes Register 2025 (pdf)

• Published on 8 October 2025
• The document describes the transcripts generated from the Incomes Register for data providers, data users and income earners.

Transcripts and records from the Incomes Register 2026 (pdf)

• Published on 8 October 2025
• The document describes
  • the transcripts generated from the Incomes Register for data providers, data users and income earners
  • the query criteria for the records distributed on the basis of a record subscription
  • how the information for the Incomes Register transcripts is calculated.

Transcripts and records from the Incomes Register 2027 (pdf)

• Published on 27 October 2025

Document for 2025:

• A restriction has been added to report 701: the number of notifications is not counted for data type 320.

Document for 2026:

• 19 June 2025:
  • A new version of the document has been published, combining the data content of the following previously valid documents:
    
    • Transcripts from the Incomes Register 2025
    • Income data – Calculation rules 2023
    • Technical interface – Distribution of data from the Incomes Register 2025 (transcript content descriptions)
  • The following content concerning the annual changes of 2026 have been included in the document:
    
    • Section 4.10: For records 312 and 313 Summary of payer’s earnings payment data, a new data group “Sum data of employer’s separate notifications” has been added.
    • Section 9.2: New calculation rule added: The total number of “No wages payable” reports (NoWages).
• 8 October 2025:
  • New record type 320 - all payers (xml) has been added to the table in the foreword. Version Date Description New chapter 6.8 Earnings payment reports - all payers (xml) has been added.

Document for 2027:

• Published a version of the document containing the 2027 changes to the data contents. The changes apply when the payment date of the income is on 1 January 2027 or later.
• Added the following new sections:
  
  • 1.3 Records distributed from the Incomes Register
  • 6.19 Missing earnings payment reports – all income earners (xml)
  • 6.20 Missing earnings payment reports – several income earners (xml)
  • 6.21 Missing benefits payment reports – all income earners (xml)
  • 6.22 Missing benefits payment reports – several income earners (xml)
  • 7.10 Missing earnings payment reports – one income earner (xml)
  • 7.11 Missing benefits payment reports – one income earner (xml)
• Added for reports 700 and 701:
  
  • In the Transcript data section, a note stating that “This data item is not calculated for record types 321, 322, 323, 324, 410, and 411.”
• Added for reports 702 and 710:
  
  • In the Transcript data section, a note explaining how the data is displayed if the action target is Period of missing data.
• Added new parameters 33 – Only reports with a dispute indication and 34 – Displaying disputed data and data missing from the report for material types 300–305 and 314–319 as well as 400–402 and 406–409

Income data – Calculation rules 2023 (pdf)

• Published on 10 October 2023
• The document describes how the information for the Incomes Register transcripts is calculated.

Document for 2023:

• Corrected translation "employee's pension insurance contribution" to "employee's earnings-related pension insurance contribution".

Document for 2026:

• A new document Transcripts and records from the Incomes Register 2026 (pdf) has been published, combining the data content of the following previously valid documents:
  
  • Transcripts from the Incomes Register 2025
  • Income data – Calculation rules 2023
  • Technical interface – Distribution of data from the Incomes Register 2025 (transcript content descriptions)

• Previous versions of content descriptions of transcripts

Technical interface – Submitting data to the Incomes Register 2021 (pdf)

• Published on 6 June 2022
• The document
  • provides an overview of how data is submitted via the technical interface and the upload service
  • describes the data reception services of the Incomes Register and the structure of the records to be submitted
  • describes the recommendations for submitting data.

Document for 2021:

• Clarified the description of the cancellation and ending of a record subscription in Section 9.3.2.

Document for 2026:

• A new document Technical interface application instructions for the submission and distribution of data 2026 has been published, combining the data content of the following previously valid documents:
  
  • Technical interface – Submitting data to the Incomes Register 2021
  • Technical interface – Distribution of data from the Incomes Register 2025
  • Technical interface – Application guidelines 2024 

Data delivery – Schemas – Earnings payment reports 2025 (pdf)

• Published on 3 June 2024
• The document describes the schema WageReportsToIR, which is used to submit earnings payment reports to the Incomes Register.

Data delivery – Schemas – Earnings payment reports 2026 (pdf)

• Published on 6 November 2025

Data delivery – Schemas – Earnings payment reports 2027 (pdf)

• Published on 6 November 2025

Document for 2025:

• Published a version of the document containing the 2025 changes to the data contents. The changes apply when the payment date of the income is on 1 January 2025 or later.
• Added a processing rule for the Original payment period (OrigPaymentPeriod) data in the Additional details on recovery (RecoveryData) data group:
  • The income type code for a recovery must be valid partially or completely during all the original payment periods or dates of payment.
• Added new value to processing rule for the Payment data type (PaymentType) data in the Paid Absence (PaidAbsence) data group: 2 (part-time sick leave)
• Added a processing rule for the Identifier type (Type) data in the Occupational accident insurance (AccidentInsurance) data group:
  • Type of identifier must not be a “Personal Identification Number (Finnish)” or a “Foreign personal identification number”
• Added a new value "3 (Kela, compensation for annual leave costs)" to processing rules for
  • the E-mail address (Email) and Field of responsibility (ResponsibilityCode) data in the Contact persons for the record (ContactPersons) data group
  • the Identifier type (Type) data in the Payer identifiers (PayerIds) data group
  • the Identifier type (Type) data in the Income earner identifiers (IncomeEarnerIds) data group
  • the Start date (StartDate), Employment period (EmploymentPeriods), Forms of payment (PaymentTypes), Form of payment (PaymentType) and Employment type (EmploymentCode) data in the Employment relationship data (Employment) data group
  • the End date (EndDate) and Payment data (ReimbPayment) data in the Paid Absence (PaidAbsence) data group
• Added a processing rule for the Payment data type (PaymentType) data in the Paid Absence (PaidAbsence) data group:
  • If ‘Payment data type’ = 3 (Kela, compensation for annual leave costs), the ‘Reason for paid absence’ must be 23 (compensation for annual leave costs).

Document for 2026:

• 27 May 2025:
  • Published a version of the document containing the 2026 changes to the data contents. The changes apply when the payment date of the income is on 1 January 2026 or later.
  • Added Pension provider code 27 to the processing rules for data groups Employment period (EmploymentPeriods) and Termination of employment (EmploymentEndings).
    Added a new processing rule to Termination of employment (EmploymentEndings) data “If ‘Earnings-related pension provider code’ is 27, the report must include one reason for termination in accordance with the ‘Bank of Finland codes’ reason codeset. In addition, a report can always include a reason for termination in accordance with the ‘Incomes Register codes’ reason codeset.” in the data group Reason for the termination of employment (EmploymentEnding).
    Added a new processing rule to Termination of employment (EmploymentEndings) data “A reason for termination in accordance with the Keva codes reason codeset and a reason for termination in accordance with the Bank of Finland reason codeset cannot be given on the same report.” in the data group Reason for the termination of employment (EmploymentEnding).
    Removed the processing rule “An income earner can have several grounds for registration but only one value in accordance with the “Type of registration grounds” data item.” from Grounds for registration (EmploymentReg) from the data group Employment registration (EmploymentRegs).
    Added a new processing rule “An income earner can only have one ground for registration at a time.” to Grounds for registration (EmploymentReg) in the data group Employment registration (EmploymentRegs).
  • Removed the processing rule “If the "Type of identifier" is "Other identifier", the identifier must not be a Finnish Business ID or a Finnish Personal Identification Number.” in the following data groups:
    
    • Payer identifiers (PayerIds)
    • Employer identifier (EmployerId)
    • Representative identifiers (RepresentativeIds)
    • Employer identifiers (FinServiceRecipientIds)
    • Principal identifiers (ServiceRecipientIds)
    • Income earner identifiers (IncomeEarnerIds)
  • Added a processing rule “If the "Identifier type" is other than "Business ID" or "Finnish Personal Identification Number" identifier must not be Finnish personal identification number or Business ID”.
    for the following data groups:
    • Record owner (DeliveryDataOwner)
    • Payer identifiers (PayerIds)
    • Employer identifier (EmployerId)
    • Income earner identifiers (IncomeEarnerIds)
    • Occupational accident insurance company identifier (AccInsProvId)
    • Representative identifiers (RepresentativeIds)
    • Employer identifiers (FinServiceRecipientIds)
    • Principal identifiers (ServiceRecipientIds)
  • Added a processing rule “Country code "FI" must not be specified, if the specified "Identifier type" is other than "Business ID", "Finnish Personal Identification Number" or "Other identifier"”.
    for the following data groups:
    • Record owner (DeliveryDataOwner)
    • Payer identifiers (PayerIds)
    • Employer identifier (EmployerId)
    • Income earner identifiers (IncomeEarnerIds)
    • Occupational accident insurance company identifier (AccInsProvId)
    • Representative identifiers (RepresentativeIds)
    • Employer identifiers (FinServiceRecipientIds)
    • Principal identifiers (ServiceRecipientIds)
  • Removed the processing rule “The value must be a non-negative number.” from Pay for period of paid absence (Amount) from the data group Paid Absence (PaidAbcense)
  • Added the processing rule “The value must be greater than 0.” to Pay for period of paid absence (Amount) to the data group Paid Absence (PaidAbcense)
  • Added the processing rule “The value cannot be over 29 characters.” to Payment specifier (PaymentSpecifier) to the data group Paid Absence (PaidAbcense)
  • Added the processing rule “The value cannot be over 20 characters.” to Payment's reference number (PaymentRef) to the data group Paid Absence (PaidAbcense)
  • Added a new processing rule for Income type codes (TransactionCode) in the General details on the income type (TransactionBasic) data group:
    If the “Income type code” is 321-325, a Type of exception to insurance corresponding the chosen income type cannot be given on the same report:
    • Income type 321 and Type of exception to insurance code No obligation to provide insurance (earnings-related pension, health, unemployment or accident and occupational disease insurance), No obligation to provide insurance (earnings-related pension insurance), No obligation to provide insurance (unemployment insurance), No obligation to provide insurance (accident and occupational disease insurance) or No obligation to provide insurance (health insurance) cannot be given on the same report.
    • Income type 322 and Type of exception to insurance code No obligation to provide insurance (earnings-related pension insurance) cannot be given on the same report.
    • Income Type 323 and Type of exception to insurance code No obligation to provide insurance (unemployment insurance) cannot be given on the same report.
    • Income Type 324 and Type of exception to insurance code No obligation to provide insurance (accident and occupational disease insurance) cannot be given on the same report.
    • Income Type 325 and Type of exception to insurance code No obligation to provide insurance (health insurance) cannot be given on the same report.
  • Added a new processing rule “If multiple identifiers have been given in the data group, the identifier types cannot be the same. The same combination of identifier type and country code cannot be entered multiple times. There can only be one identifier type of “Finnish Personal Identification Number” or “Finnish Business ID” in the data group.” to the following data groups:
    • Payer identifiers (PayerIds)
    • Income earner identifiers (IncomeEarnerIds)
    • Representative identifiers (RepresentativeIds)
    • Employer identifiers (FinServiceRecipientIds)
    • Principal identifiers (ServiceRecipientIds)
  • Removed the processing rule “If several Finnish Personal Identification Numbers have been issued to the income earner, the birth date derived from the Personal Identification Numbers
  • Added a new processing rule “If the “Identifier type” is set as “Finnish Personal Identification Number” or “Finnish Business ID” the country code can only be “FI”.” to the Country Code (CountryCode) data in the following data groups:
    • Record owner (DeliveryDataOwner)
    • Record submitter (DeliveryDataSender)
    • Record creator (DeliveryDataCreator)
    • Payer identifiers (PayerIds)
    • Employer identifier (EmployerId)
    • Income earner identifiers (IncomeEarnerIds)
    • Occupational accident insurance company identifier (AccInsProvId)
    • Representative identifiers (RepresentativeIds)
    • Employer identifiers (FinServiceRecipientIds)
    • Principal identifiers (ServiceRecipientIds)
  • Added new processing rules to Type of additional income earner (IncomeEarnerType) data: The same earnings payment report can only have one of the following Type of additional income earner data values:
    • Leased employee living abroad
    • Leased employee living abroad, working on board a Finnish aircraft
    • Leased employee living abroad, working on board a Finnish ship
    • Income earner did not stay longer than 183 days in Finland during the Tax-Treaty-defined sojourn period
  • Mandatory data Group if the report contains a "Form type" for "Employee leasing notice".
    In this case, one of the following Type of additional income earner data values must be provided:
    • Leased employee living abroad
    • Leased employee living abroad, working on board a Finnish aircraft
    • Leased employee living abroad, working on board a Finnish ship
  • Two new types of additional income earner information added to Work periods in Finland (WorkPeriodsInFinland) processing rule:
    "Leased employee living abroad, working on board a Finnish aircraft" and "Leased employee living abroad, working on board a Finnish ship".
  • Added a new processing rule “The data must not begin or end with non-printable whitespace characters, such as spaces. The data cannot contain non-printable whitespace characters, excluding space. The characters that are not to be used, are listed in chapter 1.2 Character set." in the following data groups:
    • Record owner (DeliveryDataOwner)
    • Payer identifiers (PayerIds)
    • Employer identifier (EmployerId)
    • Income earner identifiers (IncomeEarnerIds)
    • Occupational accident insurance company identifier (AccInsProvId)
    • Representative identifiers (RepresentativeIds)
    • Employer identifiers (FinServiceRecipientIds)
    • Principal identifiers (ServiceRecipientIds)
• 7 July 2025:
  • The explanation for white space character set has been modified: character set is valid for Occupational accident insurance policy number and for Identifiers.
• 8.10.2025:
  • Added new Payment type code: 3 (Contract pay)
  • The processing rule of Paid Absence (PaidAbsence) has been updated:
    the new value 24 (Partial special pregnancy leave) has been added to the list of valid payment types in case of 'Payment data type' is 1 (Kela, daily allowance application)
• 6 November 2025:
  • Corrected “Income type details (transactions)” to “Income type details (transaction)”.
  • The processing rule of Paid Absence (PaidAbsence) has been updated:
    value 24 (Partial special pregnancy leave) has been removed from the list of valid payment types in case of 'Payment data type' is 1 (Kela, daily allowance application)
  • Updated the processing rule of Car emissions value (EmissionsValue): value can be 0, if Payment date or other reporting date is in 2026-2029

Document for 2027:

• 27 October 2025:
  • Published a version of the document containing the 2027 changes to the data contents. The changes apply when the payment date of the income is on 1 January 2027 or later.
  • Added a new voluntary data group Reference data of the demand for rectification of personal data (DemandForRectificationIds) to the data group Service data (ReportData).
  • Corrected “Income type details (transactions)” to “Income type details (transaction)”.
• 6 November 2025:
  • Updated the processing rule of Car emissions value (EmissionsValue): value must be 0, if Payment date or other reporting date is in 2026-2029.

• Published on 3 June 2024
• The document describes the schema PayerSummaryReportsToIR, which is used to submit employer´s separate reports to the Incomes Register. 

Data delivery – Schemas – Employer's separate reports 2026 (pdf)

• Published 4 July 2025

Document for 2025:

• Published a version of the document containing the 2025 changes to the data contents. The changes apply when the payment date of the income is on 1 January 2025 or later.
• Added a processing rule for the Identifier type (Type) data in the Occupational accident insurance (AccidentInsurances) data group:
  • Type of identifier must not be a “Personal Identification Number (Finnish)” or a “Foreign personal identification number”.

Document for 2026:

• 27 May 2025:
• Published a version of the document containing the 2026 changes to data content. The changes apply when the payment date of the income is on 1 January 2026 or later.
• Removed the processing rule “If the "Type of identifier" is "Other identifier", the identifier must not be a Finnish Business ID or a Finnish Personal Identification Number.” ” in the following datagroups (MP781):
  • Payer identifiers (PayerIds)
• Added a processing rule “If the "Identifier type" is other than "Business ID" or "Finnish Personal Identification Number" identifier must not be Finnish personal identification number or Business ID”. for the following data groups:
  • Record owner (DeliveryDataOwner)
  • Payer identifiers (PayerIds)
  • Occupational accident insurance company identifier (AccInsProvId)
• Added a processing rule “Country code "FI" must not be specified, if the specified "Identifier type" is other than "Business ID", "Finnish Personal Identification Number" or "Other identifier"”. for the following data groups:
  • Record owner (DeliveryDataOwner)
  • Payer identifiers (PayerIds)
  • Occupational accident insurance company identifier (AccInsProvId)
• Added a new processing rule to the data group Payer identifiers (PayerIds) “If multiple identifiers have been given in the data group, the identifier types cannot be the same. The same combination of identifier type and country code cannot be entered multiple times. There can only be one identifier type of “Finnish Personal Identification Number” or “Finnish Business ID” in the data group.”.
• Added a new processing rule “If the “Identifier type” is set as “Finnish Personal Identification Number” or “Finnish Business ID”, the country code can only be “FI”.” to the Country Code (CountryCode) data in the following data groups:
  • Record owner (DeliveryDataOwner)
  • Record submitter (DeliveryDataSender)
  • Record creator (DeliveryDataCreator)
  • Payer identifiers (PayerIds)
  • Occupational accident insurance company identifier (AccInsProvId)
• Added a new processing rule “The data must not begin or end with non-printable whitespace characters, such as spaces. The data cannot contain non-printable whitespace characters, excluding space.” in the following data groups:
  • Record owner (DeliveryDataOwner)
  • Payer identifiers (PayerIds)
  • Occupational accident insurance company identifier (AccInsProvId)
• 4 July 2025:
  • Added white space character set (1.2)

• Published on 8 October 2025
• The document describes the schema BenefitReportsToIR, which is used to submit benefits payment reports to the Incomes Register.

• Published on 8 October 2025

Data delivery - Schemas - Benefits payment reports 2027 (pdf)

• Published on 27 October 2025

Document for 2025:

• The previous rule has been clarified: the deduction income type code must be partly or entirely valid during the original earnings period of the benefit or on the payment date of DeliveryData -group.

Document for 2026:

• 4 June 2025:
  • Published a version of the document containing the 2026 changes to data content. The changes apply when the payment date of the income is on 1 January 2026 or later.
  • Added a processing rule “If the "Identifier type" is other than "Business ID" or "Finnish Personal Identification Number" identifier must not be Finnish personal identification number or Business ID.” for the following data groups:
    • Record owner (DeliveryDataOwner)
    • Payer identifiers (PayerIds)
    • Income earner identifiers (IncomeEarnerIds)
    • Policyholder's identifiers (InsurancePolicyHolderIds)
    • Substitute recipient identifiers (IncomeBeneficiaryIds)
  • Added a processing rule “Country code "FI" must not be specified, if the specified "Identifier type" is other than "Business ID", "Finnish Personal Identification Number" or "Other identifier"”. for the following data groups:
    • Record owner (DeliveryDataOwner)
    • Payer identifiers (PayerIds)
    • Income earner identifiers (IncomeEarnerIds)
    • Policyholder's identifiers (InsurancePolicyHolderIds)
    • Substitute recipient identifiers (IncomeBeneficiaryIds)
  • Added a new processing rule “If multiple identifiers have been given in the data group, the identifier types cannot be the same. The same combination of identifier type and country code cannot be entered multiple times. There can only be one identifier type of “Finnish Personal Identification Number” or “Finnish Business ID” in the data group.” to the following data groups:
    
    • Payer identifiers (PayerIds)
    • Income earner identifiers (IncomeEarnerIds)
    • Substitute recipient identifiers (IncomeBeneficiaryIds)
    • Policyholder's identifiers (InsurancePolicyHolderIds)
  • Removed the processing rule “If several Finnish Personal Identification Numbers have been issued to the income earner/substitute recipient/policyholder, the birth date derived from the Personal Identification Numbers must be the same for all Personal Identification Numbers.“ from the data groups Income earner identifiers (IncomeEarnerIds), Substitute recipient identifiers (IncomeBeneficiaryIds) and Policyholder's identifiers (InsurancePolicyHolderIds).
  • Added a new processing rule “If the “Identifier type” is set as “Finnish Personal Identification Number” or “Finnish Business ID”, the country code can only be “FI”.” to the Country Code (CountryCode) data in the following data groups:
    • Record owner (DeliveryDataOwner)
    • Record submitter (DeliveryDataSender)
    • Record creator (DeliveryDataCreator)
    • Payer identifiers (PayerIds)
    • Income earner identifiers (IncomeEarnerIds)
    • Substitute recipient identifiers (IncomeBeneficiaryIds)
    • Policyholder's identifiers (InsurancePolicyHolderIds)
  • Added a new processing rule “The data must not begin or end with non-printable whitespace characters, such as spaces. The data cannot contain non-printable whitespace characters, excluding space." in the following data groups:
    • Record owner (DeliveryDataOwner)
    • Payer identifiers (PayerIds)
    • Income earner identifiers (IncomeEarnerIds)
    • Substitute recipient identifiers (IncomeBeneficiaryIds)
    • Policyholder's identifiers (InsurancePolicyHolderIds)
  • Added a new processing rule "If the income earner/policyholder/substitute recipient is given both a Business ID and a Finnish Personal Identification Number, the identifiers must refer to the same customer." in the following data groups:
    • Income earner identifiers (IncomeEarnerIds)
    • Policyholder's identifiers (InsurancePolicyHolderIds)
    • Substitute recipient identifiers (IncomeBeneficiaryIds)
  • Added white space character set (1.2)
• 13 August 2025:
  • Added a processing rule for the Deductions (Deductions) data in the Deduction income type code (DeductionTransactionCode) data group:
    • The deduction income type code must be partly or entirely valid during the original earnings period of the benefit or on the original payment date.
  • Added a processing rule for the Deductions (Deductions) data in the Earnings period of original benefit (OrigBenefitEarningPeriod) data group:
    • The deduction income type code must be partly or entirely valid during the original earnings period of the benefit or on the original payment date.
• 8 October 2025:
  • The previous rule has been clarified: the deduction income type code must be partly or entirely valid during the original earnings period of the benefit or on the payment date of DeliveryData -group.

Document for 2027:

• Published a version of the document containing the 2027 changes to data content. The changes apply when the payment date of the income is on 1 January 2027 or later.
• Added a new voluntary data group Reference data of the demand for rectification of personal data (DemandForRectificationIds) to the data group Service data (ReportData).

Data delivery – Schemas – Record subscriptions 2025 (pdf)

• Published on 24 November 2025
• The document describes the schema SubscriptionsToIR, which is used to submit record subscriptions to the Incomes Register.

• Published a version of the document containing the 2025 changes to the data contents.
  
  • Added to the processing rule of Record owner (DeliveryDataOwner) data group: “The organisation must have a customer ID. If the identifier of the Record creator differs from the identifier of the Record subscriber, the data access rights of the Record creator are used in the record query.”

Data delivery – Schemas – Cancellation data 2025 (pdf)

• Published on 8 January 2025
• The document describes the schema InvalidationsToIR, which is used for cancelling incomes payment reports, record subscriptions and records from the Incomes Register.

Data delivery – Schemas – Cancellation data 2026 (pdf)

• Published on 4 July 2025

Document for 2025:

• A version of the document containing the 2025 changes to the data content has been published. The changes apply when the income payment date is 1 January 2025 or a later date.
• Updated the description of the section “Cancellation or ending of a record subscription” in the data group Items to be Cancelled (Items).

Document for 2026:

• 28 May 2025:
  • A version of the document containing the 2026 changes to the data content has been published. The changes apply when the income payment date is 1 January 2026 or a later date.
  • Added a new processing rule “The data must not begin or end with non-printable whitespace characters, such as spaces. The data cannot contain non-printable whitespace characters, excluding space." in the data group Record data (DeliveryData).
• 4 July 2025:
  • Added white space character set (1.2)

Data delivery – Schemas – Acknowledgement of receipt 2024 (pdf)

• Published on 3 June 2024
• The document describes the schema AckFromIR, which the Incomes Register uses to delivers an acknowledgement of receipt for the record submitted to the register.
• The schema is used in the deferred Web Service interface.

• Corrected Record owner's record reference (DeliveryId) data in the data group Details of the received record (DeliveryData) to be voluntary (V).

Data delivery – Schemas – Request for processing feedback 2021 (pdf)

• Published on 6 June 2022
• The document describes the schema StatusRequestToIR, by which the record submitter can submit a request for processing feedback to the Incomes Register concerning the submitted record.
• The schema is used in the deferred Web Service interface.

• Corrected ‘Type’ data in the data groups ‘Record owner’ (DeliveryDataOwner), ‘Record creator’ (DeliveryDataCreator) and ‘Record sender’ (DeliveryDataSender): type ‘mtirt:Id’ changed to ‘smt:Id’. The correction has no impact on the implementation.

Data delivery – Schemas – Processing feedback 2024 (pdf)

• Published on 3 June 2024
• The document describes the schema StatusResponseFromIR, by which the Incomes Register delivers a processing feedback to record submitted to the register.

• Corrected Record owner's record reference (DeliveryId) data in the data group Details of the received record (DeliveryData) to be voluntary (V).

• Previous versions of content descriptions of data delivery

Technical interface – Distribution of data from the Incomes Register 2025 (pdf)

• Published on 8 October 2025
• The document
  • provides an overview of the distribution of data from the Incomes Register via the technical interface
  • describes the services distributing data from the Incomes Register and the structure of the records to be distributed
  • describes the query criteria for the records distributed on the basis of a record subscription
  • describes the recommendations for the distribution
  • describes the records for payers Summary of payer’s earnings payment data (312/313).

Document for 2025:

• New record type 320 - all payers (xml) has been added to the table in the foreword.
  New chapter 6.8 Earnings payment reports - all payers (xml) has been added.

Document for 2026:

• A new document Technical interface application instructions for the submission and distribution of data 2026 has been published, combining the data content of the following previously valid documents:
  
  • Technical interface – Submitting data to the Incomes Register 2021
  • Technical interface – Distribution of data from the Incomes Register 2025
  • Technical interface – Application guidelines 2024

Data distribution – Schemas – Earnings payment reports 2024 (pdf)

• Published on 11 September 2023
• The document describes the schema WageReportsFromIR, which is used to distribute earnings payment reports from the Incomes Register.

Data distribution – Schemas – Earnings payment reports 2027 (pdf)

• Published on 27 October 2025

Document for 2024:

• a processing rule for the Payer identifiers (PayerIds) data in the Payer's identifier (Id) data group: A payer can have up to three identifiers.

Document for 2027:

• Published a version of the document containing the 2027 changes to the data contents. The changes apply when the payment date of the income is on 1 January 2027 or later.
• A new data element has been added to several different data groups to indicate whether the information has been disputed by the data subject.
• The following new data groups have been added under section 2.17 Service data (ReportData):
  
  • Reference data of the demand for rectification of personal data (DemandForRectificationIds)
  • Disputes related to the report (ReportDisputes)
• New data group Report’s missing information (MissingData) has been added to section 2.60.

Data distribution – Schemas – Employer's separate reports 2024 (pdf)

• Published on 11 September 2023
• The document describes the schema PayerSummaryReportsFromIR, which is used to distribute employer´s separate reports from the Incomes Register.

• Added a processing rule for the Payer identifiers (PayerIds) data in the Payer's identifier (Id) data group: A payer can have up to three identifiers.

Data distribution – Schemas – Benefits payment reports 2024 (pdf)

• Published on 11 September 2023
• The document describes the schema BenefitReportsFromIR, which is used to distribute benefits payment reports from the Incomes Register.

Data distribution - Schemas - Benefits payment reports 2027 (pdf)

• Published on 27 October 2025

Document for 2024:

• Added a processing rule for the Payer identifiers (PayerIds) data in the Payer's identifier (Id) data group: A payer can have up to three identifiers.

Document for 2027:

• Published a version of the document containing the 2027 changes to data content. The changes apply when the payment date of the income is on 1 January 2027 or later.
• A new data element has been added to several different data groups to indicate whether the information has been disputed by the data subject.
• The following new data groups have been added under section 2.14 Service data (ReportData):
  
  • • Reference data of the demand for rectification of personal data (DemandForRectificationIds)
    • Disputes related to the report (ReportDisputes)
• New data group Report’s missing information (MissingData) has been added to section 2.38.

Data distribution – Schemas – Service Request 2021 (pdf)

• Published on 1 June 2020
• The document describes the schema DataRequestToIR, which an Incomes Register data user uses to submit a service request (requests information from the Incomes Register).
• The schema is used in the real-time Web Service interface.

• Contents of the document correspond to the document for 2020.

Data distribution – Schemas – Log Data 2025 (pdf)

• Published on 8 January 2025
• The document describes the schema LogDataFromIR, which is used to distribute log data from the Incomes Register.

Data distribution – Schemas – Log Data 2027 (pdf)

• Published on 27 October 2025

Document for 2025:

• Document for 2025 published.
• Added new data to Log events (LogEvents) data group:
  • User’s name
  • Data user’s role

Document for 2027:

• Document for 2027 published.
• A new data group 'Period of missing data' (MissingDataPeriodTargetItem) has been added to section 2.5 Log event targets.

Data distribution – Schemas – Summary of payer's earnings payment data 2021 (pdf)

• Published on 6 June 2022
• The document describes the schema WageReportSummaryFromIR, which is used to distribute the summary of payer’s earnings payment data (312/313) from the Incomes Register.
• The record is intended for payers of contributions.

Data distribution – Schemas – Summary of payer's earnings payment data 2026 (pdf)

• Published on 27.5.2025

Document for 2021:

• Missing ‘Type’ data of data groups were added to the general record structure described in Section 2 ‘Summary of payer's earnings payment data (WageReportSummaryFromIR)‘. The correction has no impact on the implementation.

Document for 2026:

• Published a version of the document containing the 2026 changes to data content. The changes apply when the payment date of the income is on 1 January 2026 or later.
• A new data group has been added to the record: Sum data of employer’s separate notifications by reporting period.

Data distribution – Schemas – Rejected reports submitted on paper form 2024 (pdf)

• Published on 11 September 2023
• The document describes the schema RejectedPaperReportsFromIR, which is used to distribute the Rejected reports record submitted on paper form (950) from the Incomes Register. The record contains the rejected earnings payment reports and employer’s separate reports submitted on paper form.

• Added a processing rule for the Payer identifiers (PayerIds) data in the Payer's identifier (Id) data group: A payer can have up to three identifiers.

Data distribution – Schemas – All payers 2025 (pdf)

• Published on 8 October 2025
• The document describes the schema WageReportPayersFromIR, which is used to distribute a summary of the identifiers of the payer, substitute payer and actual employer who have submitted declarations to the Incomes Register during the period of the payment date.

• The version for 2025 published.
• New schema created.

Data distribution - Schemas – Missing benefits payment reports – 2027 (pdf)

• Published on 27 October 2025
• The document describes the schema MissingBenefitReportsFromIR, which is used to distribute missing benefits payment reports.

• Document published.

Data distribution – Schemas – Missing earnings payment reports – 2027 (pdf)

• Published on 27 October 2025
• The document describes the schema MissingWageReportsFromIR, which is used to distribute missing earnings payment reports.

• Document published.

• Previous versions of content descriptions of data distribution

Technical interface – Application guidelines 2024 (pdf)

• Published on 12 December 2023
• This document describes the principles governing the implementation of the technical interface of the Incomes Register from the perspective of the party implementing system integration.

Technical interface – Application instructions for the submission and distribution of data 2026 (pdf)

• Published on 8 October 2025
• This document
  • describes the principles governing the implementation of the technical interface of the Incomes Register from the perspective of the party implementing system integration
  • describes the data reception services of the Incomes Register and the structure of the records to be submitted
  • provides an overview of how data is submitted via the technical interface and the upload service
  • describes the services distributing data from the Incomes Register and the structure of the records to be distributed
  • provides an overview of the distribution of data from the Incomes Register via the technical interface
  • describes the recommendations for submitting and distributing data.

Technical interface – Application instructions for the submission and distribution of data 2027 (pdf)

• Published on 27 October 2025

Document for 2024:

• Published a version of the document containing the data content changes for 2024.
• Details of the distribution of records 312 and 313 to the record creator’s SFTP folder have been added in paragraph 4.1.1.

Document for 2026:

• A new version of the document has been published, combining the data content of the following previously valid documents:
  
  • Technical interface – Submitting data to the Incomes Register 2021
  • Technical interface – Distribution of data from the Incomes Register 2025
  • Technical interface – Application guidelines 2024

Document for 2027:

• Published a version of the document containing the 2027 changes to data content.
• Chapters 10.1.5 Codesets and 10.2.5 Codesets have been removed. The content previously included in these chapters has been integrated into chapter 10 General information on submitting and distribution data.
• Additions to the document:
  
  • Chapter 6: Added maximum record sizes and allowed root elements for materials conforming to the new distribution schemas.
  • Chapter 5.2.2: Added new Web Service operations that can be used to query missing earnings or benefits payment reports.
  • Chapter 9.1: Added new data user services (321–324, 410, 411) that can be used to query missing earnings or benefits payment reports.
  • Chapter 9.5.2: Added new distribution schemas for retrieving missing earnings or benefits payment reports.
  • Chapter 10.2.3: Updated the text regarding the principle of derived data.
  • Added a new chapter 10.2.4 Restriction of Personal Data Processing.
  • Chapter 12.2.3: Added a new data element: Reference of the request for rectification.

Technical interface – ZIP file for application developers 2025 (zip)

Technical interface – ZIP file for application developers 2025 (pdf)

• Published on 8 January 2025
• The ZIP file that contains xsd descriptions and WSDL descriptions of services.
• The PDF document describes the ZIP file’s contents.

Technical interface – Zip file for application developers 2027 (zip)

Technical interface – Zip file for application developers 2027 (pdf)

• Published on 27 October 2025

Document for 2025:

• Published a version of the document containing the 2025 changes to the data contents.
• Description of changed data content added.

Document for 2027:

• Published a version of the document containing the 2027 changes to the data contents.
• Added new services to the WSDL descriptions:
  • MissingWageReportQueryService
  • MissingBenefitReportQueryService
• Added new schemas to the XSD schema files:
  
  • MissingBenefitReportsFromIR.xsd
  • MissingBenefitReportsFromIRTypes.xsd
  • MissingWageReportsFromIR.xsd
  • MissingWageReportsFromIRTypes.xsd

Technical interface – Message signing, sample implementation (zip)

Technical interface – Message signing, sample implementation (pdf)

• Published on 23 March 2018
• The ZIP file contains a client implementation of a call sent to the Echo service (EchoService) and the signing of the request message sent.
• The PDF document describes the ZIP file’s contents.

• Previous versions of application developer's guidelines