Incomes Register FAQs for software developers

Sending a record

If a record is so large that it must be sent in several parts, are these parts individual submissions or do they have to have an identifier which indicates that they are part of a larger entity?

Every record is an individual record. In other words, a record cannot consist of separate parts. You can include a version number on a report, which the data provider can use to target their corrections at a valid report. However, one record cannot contain the combinations "new-replacing" or "new-cancellation" targeted at the same report.

Can a customer test the validation of materials in the e-service if they do not have a testing agreement? (15/06/2018)

Testing cannot be done without concluding a testing agreement first. Test IDs must be used to sign in to the e-service; they are provided after the testing agreement has been concluded.

Technical questions

Which file naming convention is used to name the Incomes Register's XML files in the OUT directory? (25/05/2018)

The OUT directory’s file names are based on the following convention:

<DeliveryDataType>_<FileId>_<IRDeliveryId>.xml. File naming is described on page 10 of the following document:

Do the tested services have dynamic WSDL files that can be retrieved from the Incomes Register’s servers when initiating a WS client? The certificate service’s WSDL file can be found at, but we have not been able to find a similar address for other services in any of the documents. (25/05/2018)

The Incomes Register's Web Service is only available to users who have identified themselves with a customer certificate. Under present conditions, the opportunity to dynamically retrieve WSDL files via the Web Service will not be provided. We recommend using the WSDL descriptions provided on the website.

Why are the time stamps of the record subscription and the response message not in the same format?

In the subscription, we provide the query start and query end times, as presented below. As I understand it, the time of day is in Finland’s time zone when it is in format “+02:00”.





The response had the retrieved timespan. However, the timespan was in a different format – “+02:00” was missing from it.  



Why does the time zone in the response differ from the time zone in the subscription? (15/06/2018)

The query timespan is saved in the Incomes Register’s database based on the time in UTC, regardless of what the time zone is on the subscription.

The time of day stated on the subscription is based on standard time in Finland, which is two hours ahead of the time in UTC:


In the Incomes Register’s database, time is in UTC as follows:


 Queries are always launched on the basis of the time in Finland.

If the processing feedback returns any given Error element – MessageErrors, DeliveryErrors or ItemErrors – does it always mean that the actual response file cannot be generated? Or are some types of errors such that individual erroneous cases can be listed in the Error element, but the status is DeliveryDataStatus = 3, and a response file is generated nonetheless?

For example, if a list of Business IDs is provided on a “multiple payers” call and one Business ID is erroneous, will the whole request fail, or will a response be returned on all other Business IDs except the erroneous one? (15/06/2018)

If the record subscription has erroneous data, the whole record subscription will be rejected and no distributable file will be generated for retrieval.

Reports and their submission

What does a report mean? If several different payments of wages are made to a single wage earner on the same payment date (including overtime pay and sick pay), how many reports need be submitted?

A report refers to the data on one payment transaction paid to a single income earner. If a single transaction includes several payments to an individual wage earner, only one report need be submitted. One report can contain several income types. 

How does the data provider benefit from the submission of optional data, such as whether the income earner's employment is permanent or fixed-term?

This information is needed by benefits payers, such as unemployment funds, the Education Fund, pay subsidy, municipalities and Kela (the Social Insurance Institution of Finland). The information is also needed by occupational health and safety and Statistics Finland. For some information users, pay reporting at the mandatory minimum level does not provide a sufficient level of detail. By submitting complementary information to the Incomes Register, the payer can ensure that the submitted information will not be requested again. If the information is not submitted, it will be requested from the payer, or the employee or accounting company, if necessary.

How should absences be reported? Only the period of absence that falls within the pay peri-od in question, or the entire period of absence?

Data on absences is optional, and there is no actual deadline for submitting it. The recommendation is that absences of the previous pay period should be submitted in the pay report of the current period. In this case, the data would be available fast enough for the users’ needs. 

Can several reports be submitted for a single person if the employer has pay data in many different systems?

Yes. Several reports concerning the same person can be given for a single pay period, and the data can be produced from a number of different systems. When you select the report type “New”, the previous report is not overwritten, and both remain valid. 

How should payments made in arrears or other data referring to past periods be submitted? 

Example 1: Seniority bonus is paid in arrears for two years 
Example 2: Entire pay amount is paid in arrears 
Example 3: Report for an unpaid absence is submitted two months later


  • Payment date: the date on which the payment is made, for example 30 May
  • Pay period: pay period during which the income is paid, for example 1 May – 31 May.
  • Income type: ”total wages” or ”other wage supplement”
  • Earnings period: 1 January 2019–30 December 2021 (the earnings period is optional data that can be entered to indicate the period over which the income was accrued)


If a public service employment relationship starts on 20 January and the wages for January are paid on 15 February:

  • Payment date: 15 February
  • Pay period: 1 February–28 February
  • Income type: total wages
  • Earnings period: 20 January–30 January


  • Payment date or other report date: 15 April
  • Period of unpaid absence: 1 January–28 February
  • Reason for absence: Illness

Should data on different payment types be submitted separately or as a total?

Wages can be entered as a total (reporting method 1 for wages). The most common wage component types can also be entered separately in the report (reporting method 2 for wages). In such a case, there is no need to add them up. Certain payments or components must, however, always be itemised, including benefits in kind and expense allowances. The information on the income earner's earnings payment report is formed in one of the following ways:

  • Wages according to reporting method 1, or
  • wages according to reporting method 2, and
  • separately reported income items.

Reporting method 1 and reporting method 2 cannot be used simultaneously in the same report, but the payer can use different reporting methods in different reports. However, the recommendation is that wages should be reported by components according to reporting method 2, allowing all users of the Incomes Register data to use the data contained in the register. 

If the payer of wages also pays benefits or pensions, how will they be notified in 2019? Can this information be submitted together with the pay data, or should an annual report be submitted on these?

Pensions and other social benefits have their own data flow, and they cannot be included in reports or data sets that concern wages and other employer contributions. However, if a wage payer complements a sickness allowance paid by the employer’s sickness fund or pays a pension to an old employee, this data should also be included in the wage report in 2019, similarly to the annual report of employer contributions currently submitted to the Tax Administration.

There is no income type for a monthly salary in the report. How should data on a monthly salary be submitted?

A monthly salary should be entered under the income type ”total wages” (if the so-called brief report is used) or ”time-based wages” (if the data is itemised in greater detail). The data can be specified by stating that the form of pay is a monthly salary. The form of pay can be given as optional complementary data.

If the same person is paid both a monthly salary and an hourly wage on the same date (as the form of pay has changed in the middle of the pay period), how should this be reported? 

A single report may contain several different forms of pay. In other words, both a monthly salary and hourly wages can be selected as the form of pay in the report. Various income types can have different forms of pay or, if the pay form of an income type changes in the middle of the pay period, you can make two different entries for the same income type. 

Does it matter whether the income is from a primary or a secondary occupation?

Primary and secondary income will no longer be differentiated, with the adoption of the Incomes Register.

What income types should be used when reporting dividends, interest and royalties paid, and their withheld amounts?

There are two separate income types for royalties: compensation for use (earned income) and compensation for use (capital income). Dividends and interest are not included in the Incomes Register reports. They continue to be reported directly to the Tax Administration, and their withheld amounts are reported on a tax return for self-assessed taxes. It is worth noting, however, that dividends based on work effort are reported to the Incomes Register. If the royalty is paid to a foreign person, you must also remember to enter the "non-resident taxpayer" information. In the same way, if an income earner is paid, for example, interest on wage arrears, this is reported to the Incomes Register with the income type Capital income payment.  

What reference data can be used to allocate corrections and cancellations to the original reports?

In the Incomes Register, reports can have two separate uniquely identifying references: the Incomes Register report reference and the payer's report reference. The Incomes Register automatically assigns an Incomes Register report reference to a report when it is saved in the Incomes Register. The payer must also provide a payer's report reference they can freely choose when submitting data via the technical interface or the download service. Corrections and cancellations can be allocated to the original report both with the Incomes Register report reference and the payer's report reference.

How are fees and compensations reported to the Incomes Register?

Fees and compensations can be reported using the "Total wages" income type (the brief reporting method 1) or in a more itemised manner according to the income types (reporting method 2). We recommend reporting the fees and compensations according to the paid income. If, for example, the payment was a meeting fee or a compensation for a membership in a governing body, it can be reported as its own income type to the Incomes Register.

Are there restrictions to the service hours of the Incomes Register's SFTP interface or Web Service interface? For example, can data be retrieved only on weekdays, or can data also be retrieved during holidays and weekends?

There are no restrictions related to service hours in the use of the services of the technical interface. The services can be used at any time.

What data cannot be corrected with a replacement report? When does the previous report have to be cancelled and a new report submitted?

To date, the following situations involving the need to correct data by cancelling the previous report and submitting a new one have been identified:

  • Payday correction;
  • Pay period correction;
  • Correction of the payer's and income earner's customer IDs;
  • Correction of the income earner's birth date;
  • Correction of a pension policy number;
  • Correction of "Type of exception to insurance" data;
    • Retroactive changes to "No obligation to provide insurance" data; and
    • Retroactive changes to "Not subject to Finnish social security" data.

What do the reporting methods 1 and 2 mean?

Reporting method 1 is the mandatory minimum level for reporting wages. This data corresponds to the payment types 'wages for primary job' and 'wages for secondary job' in the Tax Administration's current annual returns for wages.

The payer can report wages also in a more itemised manner than required by the mandatory reporting method (the higher level of detail for reporting monetary wages, or the so-called reporting method 2). The complementary income types (36 in total) of reporting method 2 are itemised in the Incomes Register to the level of detail required by some data users.

Reporting method 1 and reporting method 2 cannot be used simultaneously in the same report, but the payer can use different reporting methods in different reports. However, the recommendation is that wages should be reported in an itemised manner according to reporting method 2, allowing all users of the Incomes Register data to utilise the data contained in the register. If the data is reported using the brief reporting method 1, some data users may have to ask the payer for more details.

Is pay data reported payment-specifically?

Yes. The Incomes Register is an up-to-date and centralised database to which data is reported only once during the payment of wages.

Can data be reported to the Incomes Register without a customer ID?

Data can be reported to the Incomes Register also without a customer ID if the payer or income earner does not have the identifier in question, such as a Business ID, personal identification number, tax identification number or a foreign personal identification number. In such a case, additional information on the payer or income earner must be reported, such as the date of birth and basic details (name and address).

If data is reported without a customer ID, despite the fact that the payer or income earner has one, the payer is in violation of the obligations laid down in the Act on the Income Information System.

Can the cancellation of a record and a report be submitted in the same earnings payment report in which new and replacement reports are submitted?

The cancellation of a record or a report should not be submitted with the same earnings payment report with which the new and replacement reports are submitted. The cancellation of reports has been separated into its own record type. This record type can be used to cancel an individual report, the entire earnings payment record, an employer's separate report, or a record subscription. Because cancellation has been separated into a separate schema structure, having to resubmit the mandatory data of the earnings payment report can be avoided when cancelling, for example, an individual earnings payment report.

Are labour market organisation membership fees collected from the employee reported to the Incomes Register?

Labour market organisation or unemployment fund membership fees collected from the employee are not reported to the Incomes Register; these membership fees will continue to be reported to the Tax Administration on the annual return separately defined by the Tax Administration.

How are payments made in a currency other than the euro reported to the Incomes Register?

The paid amount must be reported to the Incomes Register as a euro amount, even if the payment was made in some other currency. If the payment was made in some other currency, the payment must be converted into euros using the European Central Bank's reference exchange rate valid on the payment date. If the payment is reported in the Incomes Register before the payment date, for example in connection with a payroll run, the income amount reported is converted using the reference exchange rate valid on the reporting date in question.

Why does the delivery return the error message “Unknown Finnish personal identity code or Business ID”? (15/06/2018)

The credentials must be included in the Incomes Register's stakeholder testing environment, in other words, you must use the Business IDs provided to you.

Could you confirm which payment dates we can use when submitting test materials to the Incomes Register?

Can the payday be the current day, or does it have to be a date that comes after 1 January 2019? (15/06/2018)

The limitations for the payment dates and other dates to be used in the test environment are provided in the following document:

Appendix 5: Configurations of the stakeholder testing environment

The document can be found at:

Correcting reports

If the report has been uploaded as a file, can a different channel be used for correcting errors, for example e-services?

Yes. Data can be submitted and corrected using different channels. The channel used to submit the original report need not be used to edit the data.

Currently, you only need to re-enter the data that has changed to edit your reports. According to the instructions issued for the Incomes Register, all data in a report must be re-entered, also data that did not contain errors. What does this mean in practice?

A report refers to data on one payment transaction paid to a single income earner. Several payments may have been included in one transaction (e.g. hourly wages, meeting attendance fees and overtime pay). Even if the error only affected one of these amounts, all data must be re-entered. 

A single data set may contain several reports, for example the reports for 50 employees. If the error only affected the report of a single employee, there is no need to re-enter the entire data set. The submitter can only edit an incorrect report by re-entering its data. In other words, there is no need to edit the reports for other employees in the data set if their data contains no errors. 

How can corrections of withholding payments be itemised in cumulative calculations when withholding tax is not calculated separately for each pay period?

Tax must be withheld unless the income is tax exempt, preassessed or exempt from withholding. Reports of withheld taxes should be submitted to the Incomes Register for each individual income earner. Net withholding will also be possible once the Incomes Register is deployed if the withholding amount is corrected in the same year, or the following year before the tax assessment is completed. Separate instructions will be issued on corrections. 

If a person’s employment relationship ends but he or she returns to the service of the same employer within a short period, how can any errors related to the previous period of fixed-term employment be corrected? If the start and end dates of the employment relationship have changed, how can they be changed in the report?

Errors in an earlier report can be corrected by submitting a new report that replaces the first one. The data of a new fixed-term employment relationship cannot be submitted on the same report. The method of making corrections within one pay period that concern the previous period will no longer be used. 

Changes are not always due to an actual error but, for example, pay rises in arrears. How, in this type of situations, can overtime or holiday pay based on the lower pay amount be corrected? 

Data on amounts earned during an earlier pay period should be submitted on the report for the pay period during which they are paid. As the earnings period can be given the earlier pay period during which the income was accrued. 

If a lower wage amount than what the person was actually paid has incorrectly been entered in the report for a pay period, the original report must be corrected by replacing it with a new one; in other words, all data must be re-entered. 

How can a report be edited if the error relates to such information as the dates of the employment relationship, an occupational title or the type of public service employment relationship, rather than to euro amounts?

In this case, too, corrections can be made by submitting a replacement report. The data that did not contain errors must also be re-entered in the replacement report. 

Can a replacement report be submitted using a different reporting method to that used in the original report? Reporting methods mean the reporting method 1 (total wages) and reporting method 2 (itemised by income type, such as supplements and compensations).

It is recommended that the same reporting method be used in both the original report and the corrections made on it. Wages in euro amounts are reported either using the mandatory minimum level for reporting wages in euro amounts (reporting method 1), or by reporting the wages in euro amounts in a more itemised manner (reporting method 2), by using the separate income types intended for such a purpose. All wages entered in the same report must be reported using the same method.

Which identifying data, for example in employment data, requires a replacement report when it changes, even if the euro amounts are correct?

As a rule, all data in the Incomes Register should be correct and up to date at all times. The employer or the accounting company authorised by the employer is responsible for the correctness of the data. If incorrect data is not corrected, a decision made by the user of the data, particularly in the case of social insurance and benefits, could be based on incorrect data, and a payment could thus be made on the wrong basis. By submitting complementary information to the Incomes Register, the payer can ensure that the submitted information will not be asked again.

Pay period, payment date

 What does the pay period of the pay date, or the wage payment period mean? What is this data needed for? The report also asks about the earnings period. Is it not the same as the pay period?

The pay period, or the wage payment period, is the period in which the wages are paid. The earnings period, on the other hand, is the period over which the income has been accrued. 

Under the Employment Contracts Act, wages must be paid at the latest on the last day of the pay period, unless otherwise agreed. The data users need the information on the pay period for such purposes as allocating recovery actions to the correct period.

Example: The employer’s pay period is one month. On 15 May, the wages earned in May, or EUR 4,000, and overtime for April, EUR 500, are paid to an employee.

  • Wage payment date 15 May
  • Pay period 14 May - 31 May
  • Time-based wages 4000,00
    • Earnings period 1 May–31 May 
  • Overtime 500,00
    • Earnings period 1 April–30 April

Or alternatively:

  • Total wages 4000,00
    • Earnings period 1 May–31 May
  • Total wages 500,00
    • Earnings period 1 April–30 April 

Not all payments have an earnings period in practice. For example, individual pay correction runs only have a payment date if individual compensation amounts are paid outside the normal pay period. In these situations, is it possible to only submit the payment date?

The payment date and pay period must always be submitted. The earnings period is optional. 

If, in connection with normal wage payment, an employee is paid for overtime that remains unpaid from the previous month, how should the pay period be entered? The pay periods of the wages and the overtime will, in this case, not be the same.

As the pay period should be entered the pay period of the actual wages, even if the overtime pay had been earned during an earlier pay period. As the earnings period of the overtime can be entered the period during which the income was earned (in this example, the previous month).

Example: On the payment date in February (15 February), the employee is paid the wages for February, EUR 2,500, and also EUR 350 in overtime pay for January. The data should be entered as follows:

  • Payment date: 15 February
  • Pay period: 1 February–28 February
  • Income type: Time-based wages EUR 2,500
  • Earnings period: 1 February–28 February
  • Income type: Overtime pay EUR 350
  • Earnings period: 1 January–31 January

Will the Incomes Register include checks that the payment date is within the pay period?

No, because the payment date can also be agreed to be other than that laid down by law.


  • Payment date 10 August
  • Pay period 1 July–31 July
  • Contract pay 4,000.00
    • Earnings period 1 June–30 June
  • Overtime 625.00
    • Earnings period 1 June–7 June

Can the wage payment date be in the future on a Incomes Register report?

Yes, but by no more than 45 days.

Withholding tax

The Incomes Register report does not ask about pay subject to withholding. How will the Tax Administration, among other users, obtain this data if it is not entered in the Incomes Register? 

Submitting the total amount of pay subject to withholding to the Tax Administration will no longer be necessary. The Tax Administration will calculate payments subject to withholding and the tax deducted from them based on the pay data report. 

It is presumed that any earned income reported to the Incomes Register is subject to withholding tax as a default. Some payments are exempt from withholding tax, for example overdue interest on late payment of wages or expense allowances to a natural person in connection with pay for a work performance. Even if withholding is not necessary, the income must be entered in the Incomes Register. 

Similarly, if an income earner receives taxable expense allowances for expenses incurred directly in performing work on which tax need not be withheld, these amounts should be entered either in the field “Deduction before withholding” or “Taxable expense allowance”, depending on the method used to deduct the costs. 

The Tax Administration will calculate the withholding data from the income earner specific earnings payment reports submitted by the payer. Although the total amount withheld no longer needs to be separately reported to the Incomes Register, the payer must report the amount of employer's health insurance contribution paid based on the total amount of wages paid monthly. The amount of health insurance contribution paid is reported on the employer's separate report no later than on the fifth day of the month following the payment month of the wages.  

The earnings period does not indicate when tax has been withheld from income?

Tax must be withheld when the income is paid. The data of one income earner at one time of payment is given on a report. The same report can have several income types, and each of them can have different earnings periods. Tax is withheld from the total amount of paid income.

The income types do not include withholding from non-wage compensation for work?

True, at least not as a separate entry. In these situations, non-wage compensation for work is also reported under its own income type, and withholding is reported by using the withholding income type.

If a person is paid both wages and non-wage compensation for work, can the withholding amount be reported as one sum?

Yes, it can. Only on rare occasions, however, is it likely that the same payer will pay part of the payment to the same income earner as wages and part as non-wage compen-sation for work. The withholding can be reported based on the total amount of paid in-come.

Reconciliation and reports

Will reconciliation be based on a return message from the register, or will data providers  have access to the Incomes Register so that they can check the uploaded data and base the reconciliation on it?

Should they wish, the payer of a transaction can obtain a reconciliation report on the data they submit to the Incomes Register. If the data in the Incomes Register differs from the data in the payroll system, any incorrect data in the Incomes Register must be corrected using the relevant procedure. 

How is reconciliation at the end of the year carried out? For example, checking that each person’s taxable income amount is the same in the payroll system and the Incomes Register? If not, how should the data be corrected? 

Should they wish, the payer of a transaction can obtain a reconciliation report on the data they submit to the Incomes Register. If the data in the Incomes Register differs from the data in the payroll system, any incorrect data in the Incomes Register must be corrected using the relevant procedure. 

Will such agencies as Kela still have their own e-service portals for submitting data on absences due to illness, for example? Or will all data on wage earners be exclusively communicated through the Incomes Register from 1 January 2019 on?

Data on absences can be entered as optional complementary data in the Incomes Register. It is likely that various agencies will continue to have their own e-services even after the Incomes Register becomes operational. 

Does the Incomes Register also produce log data on SFTP requests and responses? For us, they will be the system's “background operations”, which eliminates the need to monitor use. (25/05/2018)

The Incomes Register includes certain reports related to record subscriptions and records generated by the Incomes Register. Even though these are not log data in the true sense of the word, they contain matters referred to in the question. The reports are currently being defined and, at some stage, a more detailed description will be made and published for stakeholders.

Travel expense claims

Tax-free travel costs must also be reported. Does this mean that every travel expense claim paid from the travel management system must be reported in the Incomes Register based on the principle payment day + five days?

All reporting into the Incomes Register complies with the same principle: the data must be reported in the Incomes Register no later than on the fifth calendar day after the pay-ment date.

What data from the travel expense system must be reported?

Daily allowances and kilometre allowances, for example, must be reported to the Incomes Register. They must be reported within five days of their payment. In the case of tax-exempt daily allowances, the type of daily allowance must be itemised (partial daily allowance, full daily allowance, meal allowance, international daily allowance). If a tax-exempt kilometre allowance has been paid, the number of kilometres on which it is based must be reported. The information on the number of kilometres can be submitted, for example, by pay period, but in such a manner that the data for each year is submitted no later than in the last report of the year.

Some of the data reported to the Incomes Register is mandatory: such data must be included in each record. Mandatory data includes the pay period and payment date, for example. When data is reported via the technical interface or by uploading it as a file, certain technical record information must also be provided. The payer and income earner must lso be uniquely identified in the record, either using customer IDs or, if these are unavailable, using other contact information. This mandatory data must be reported also when reporting data from the travel expense system.

Tax at source

How are income taxed at source and normal income itemised? Is this determined from the tax type?

If the income is paid to a non-resident taxpayer, the report must include the information that the recipient of the payment is a non-resident taxpayer, as well as the amount of tax at source collected with its own income type, "Tax at source". With the deployment of the Incomes Register, the current self-assessed tax return for employer contributions will no longer be used. Reporting to the Incomes Register will replace this return.

If a person is a foreigner, will income subject to tax at source also be created automatically from the income types, if the withholding is reported as tax at source?

A non-resident taxpayer and the collected tax at source are itemised in the data. If the income of a non-resident taxpayer is subject to withholding, information on this is also itemised.  Tax at source and withholding are also reported as their own income types.

The information "wages and other payments subject to tax at source" or "wages and other payments subject to withholding" currently reported on a self-assessed tax return will no longer be reported into the Incomes Register for employer contributions.

What income types should be used to report the income subject to tax at source of a foreign national permanently living abroad and residing in Finland for no more than six months?

Wages in euro amounts paid to a foreign income earner can be reported to the In-comes Register using either reporting method (mandatory minimum level or including op-tional data). The income must be reported according to the type of payment. All income types of the Incomes Register are available in reporting. In addition to the income type, report the "Non-resident taxpayer" information and the amount of tax at source collected under "Tax at source". If the income earner's tax card contains an entry for a tax at source deduction, the deduction made from the wages is separately reported under "Tax at source deduction".

International situations

How can foreign payers be obliged to report payments to the Finnish Incomes Register?

The data must be reported to the Incomes Register, if the payer has an information re-porting requirement for a Finnish information user in the Incomes Register. An information reporting requirement applies to the pension, unemployment and accident sectors, if the person is insured in Finland. In these situations, the income data must be reported to the Incomes Register, even if the payer is foreign. With respect to taxation, the information reporting requirement applies to a foreign employer only if the income earner works in Finland for over six months, the employer has voluntarily become registered as an employer with regular wage payments, or if it is deemed to have a permanent establishment in Finland. In these situations too, the data must be reported to the Incomes Register for insurance needs, if the person is insured in Finland.

Distribution of data from the Incomes Register

Can you retrieve payments subject to withholding made to a tradesman or a professional who has a Business ID but is not registered in the Prepayment Register?

Non-wage compensation for work is reported to the Incomes Register if the income earner is not registered in the Prepayment Register. A report must be submitted even if the recipient of the non-wage compensation for work is not a natural person – for example, a limited liability company, general partnership or a limited partnership.

A data user can obtain data on the paid non-wage compensation for work from the Incomes Register if the data user has the right to obtain the income earner's income data from the Incomes Register, confidentiality regulations notwithstanding.

Version 1, which was selected in the first query, was submitted to the Incomes Register in query time range 1. Versions 2 and 3 are submitted in query time range 2. If the query criterion was IncludeAllVersions = ”False”, will the only version selected from query time range 2 be version 3? (25/05/2018)

Only version 3 is selected.

From the Incomes Register's perspective, are replacement and cancellation comparable? In other words, if the previous question's version 3 was a cancellation rather than a replacement, would the query work in the same way and only the cancellation (version 3) be selected?

Yes, that is exactly right.

What about in a situation in which version 1 and the cancellation (version 2) were submitted in the same query time range? In such a case, is only the cancellation (version 2) selected for the message based on the criterion IncludeAllVersions = ”False”?


We are testing the retrieval of earnings payment reports via the real-time Web Service interface. We are attempting to retrieve a single income earner’s earnings payment reports for the period 1 January 2018 – 31 December 2020. We are using a broad timespan on purpose, because we do not yet know what times are included in the test record. Despite several attempts (tested with approximately 30 different test customers’ personal identity codes), we have not retrieved any earnings payment reports. (15/06/2018)

It seems that you have attempted retrieval with the personal identity codes that have been provided to you by email. These personal identity codes do not have ready-made earnings payment reports; they must be generated separately in the Incomes Register. This can be done, for example, by using the Incomes Register's Excel sheet for generating earnings payment reports or, alternatively, by agreeing with a data provider that they will generate the earnings payment reports.

How does the timing element work with messages in SFTP traffic? If I give the current day as the ValidFrom data item and the time of day is a past time, will the query be launched immediately?






I assumed that the query would not be launched until that time is reached next but this was not how it went. If I want to set the time for the early hours of the next day, do I need to give the next day as the ValidFrom date? (15/06/2018)

If the ValidFrom date of a one-off subscription is the current day and the time is a past time, the query will be launched immediately. In other words, if the intention is to have the query launched the next day, a future date must be set for the one-off subscription.

In a timed subscription, the query will be launched when the time set is reached next.


Which ones of the current reports to the authorities will the Incomes Register replace?

The mandatory data contents of the Incomes Register will replace the data that an employer currently submits to the Tax Administration, the earnings-related pensions sector, the Employment Fund and non-life insurers in annual reports. Additional information can also be submitted to the Incomes Register on a voluntary basis, including information on absences and data related to a public service employment relationship. The data can be accessed by all Incomes Register users, including Kela, unemployment funds, non-life insurance and pension providers, the municipalities and Statistics Finland.

The employer contributions reported to the Incomes Register will also replace the tax return on employer contributions submitted to the Tax Administration once every tax period. In the case of public limited companies and other corporations, the Incomes Register will also replace reports of withholdings in the tax return on self-assessed taxes (data currently provided as tax type 25). 

Information about the KATRE project and its progress