Software developers

The Incomes Register will be deployed on 1 January 2019.

The Incomes Register is a national online database that will be deployed on 1 January 2019. It contains comprehensive wage, pension and benefit data at the individual level. The information will be reported in real time, within five days of the date of each payment, and individually for each income earner.

Data can be reported via the technical interface, the e-service using an online form or by uploading the data as a file. In special circumstances, the data can be reported on a paper form.

  1. Wages: wages paid on 1 January 2019 and later will be reported to the Incomes Register
    • The interface descriptions were published on 13 June 2017.
    • The stakeholder testing plan was published on 25 October 2017.
    • Stakeholder testing will start on 1 March 2018.
  2. Benefits: benefits paid on 1 January 2020 and later will be reported to the Incomes Register
    • Interface descriptions will be published in the summer of 2018.
    • Expanded testing will be performed in 2019.
  3. The service will open for income earners on 1 January 2019.

Incomes Register’s technical interface

The language of the technical interface is English. To support this, materials in Finnish and Swedish are provided, such as the interface application instructions and instructions on the data contents. The data format of the Incomes Register's technical interface is XML, and the schemas are in English.

Interface descriptions related to the submission and distribution of earnings payment data, including application instructions

Use of the Incomes Register's interface services requires a valid service contract and the use of a certificate compliant with the Incomes Register's certificate service. The Incomes Register's certificate is used to identify and authorise both organisations providing data and those using data. Additionally, the integrity of a record is ensured with a certificate (digital signature).

Interface documentation of the Incomes Register's certificate service