New subscription
You can subscribe transcripts or records as a one-off subscription in the e-service.
Records or transcripts subscribed are delivered in the language that has been defined as the service language for the company or organisation in the Business Information System (Finnish, Swedish or English).
Subscriptions placed by private individuals are delivered in the language that has been defined as the service language for the individual in the Population Information System (Finnish or Swedish).
The range of transcripts and records available for subscription depends on your roles and authorisations in the Incomes Register’s e-service.
Retrieving a transcript or record
300 series records are records in XML format, and they are sent to your organisation’s SFTP folder. 600 and 700 series records are transcripts in PDF or CSV format, and they are added to the Subscription details page in the e-service.
Payer’s records and transcripts
- 312 Summary of payer’s earnings payment data (xml, one-off subscription)
- 600 Summary of payer’s earnings payment data (pdf, one-off subscription)
- 630 Summary of payer’s earnings payment data (csv, one-off subscription)
- 618 Income type specific summary of payer’s earnings payment reports (csv, one-off subscription)
- 614 Summary of payer’s benefits payment reports (pdf, one-off subscription)
- 620 Income type specific summary of payer’s benefits payment reports (csv, one-off subscription)
- 632 Summary of payer’s benefits payment reports (csv, one-off subscription)
- 610 Summary of errors detected on the reports (pdf, one-off subscription)
Data user’s records and transcripts
- 300 Earnings payment reports – all income earners
- 300 Earnings payment reports – several earnings-related pension providers
- 305 Earnings payment reports – missing earnings-related pension policy number
- 306 Employer’s separate reports – all payers
- 308 Employer’s separate reports – several earnings-related pension providers
- 310 Access log data for the party’s users
- 314 Earnings payment reports – several report references
- 315 Benefits payment reports – all income earners
- 318 Benefits payment reports – several report references
- 700 Summary of data user’s record queries (pdf, one-off subscription)
- 702 Access log data for the data user (pdf)
- 710 Access log data for the data user (csv)
General information
The subscriber’s information is imported into the subscription from the Incomes Register’s customer data.
Type of subscriber
Select whether you are ordering the record as a provider of earnings payment data or as a provider of benefits payment data. The selection of transcripts and records you can order depends on the type of subscriber you select.
Subscription details
Enter the query date and time for the subscription. The subscription will be queried according to the selected date and time. By default, the current date and time have been set for the query.
You can also enter the subscriber’s reference to identify the subscription. The allowed characters for the reference are the numerals 0–9, the letters a–z and A–Z, and the special characters “_” and “-”. The reference may not contain spaces.
If you do not enter any reference, the Incomes Register will generate it for you. The format of the reference generated by the Incomes Register is IR-202X-XX.
Subscribed records
Add a subscribed record by selecting Add record, and select the record from the drop-down menu. You can subscribe to several records using a single subscription. However, the records you have selected determine what other records you can add to the same subscription. In addition, the Incomes Register recommends that only one record be selected for a single subscription.
Filter the query using query criteria
You can limit the record content by using various query criteria. The range of query criteria depends on the subscribed record or transcript. Some query criteria are mandatory and some are voluntary.
Time range
Select the time range, over which you want information to be added to the transcript or record. The maximum length of the time range depends on the subscribed transcript or record.
The time range can be the time range of payment date, the time range of reporting period or the query time range for changes. Either the query time range for changes concerning the entire subscription or the time range given in record data must be given for all subscriptions.
Time range of payment date: The record or transcript will include reports, whose payment date or other report date is within the given time range.
Time range of reporting period: The record or transcript will include data over the given time range.
Query time range for changes: If you enter the query time range for changes, all records in your subscription will be queried over the same time range. The record will include reports, which have been saved in the Incomes Register or which have been corrected or cancelled during this time range. If you do not enter any end date, reports will be queried until the query date.
Payer’s suborganisation
If your organisation has submitted data to the Incomes Register using a suborganisation identifier, you can enter the suborganisation identifier as the query criterion. In this case, the record or transcript will only include data submitted using the suborganisation identifier in question. Please note that the transcript always contains all the employer’s separate reports submitted by the organisation irrespective of the suborganisation data. If the organisation has limited the placement of subscriptions using a suborganisation identifier, you cannot change this selection.
Select the type of identifier from the drop-down menu and add the suborganisation identifier.
Reporter type
Select either payer or substitute payer as the reporter type.
Payer: The record will only include the reports, on which your organisation has been the payer or, in the case of substitute payers, the actual employer.
Substitute payer: The record will only include the reports, on which your organisation has been the substitute payer.
Preview
Preview the data you have entered. If any subscription details are missing or there are errors, return to subscription details to add missing details or correct the errors. Finally, select Submit. You will receive an acknowledgement of receipt after your subscription has been saved successfully in the Incomes Register.
General information
The subscriber’s information is imported into the subscription from the Incomes Register’s customer data.
Subscription details
Enter the query date and time for the subscription. The subscription will be queried according to the selected date and time. By default, the current date and time have been set for the query.
You can also enter the subscriber’s reference to identify the subscription. The allowed characters for the reference are the numerals 0–9, the letters a–z and A–Z, and the special characters “_” and “-”. The reference may not contain spaces.
If you do not enter any reference, the Incomes Register will generate it for you. The format of the reference generated by the Incomes Register is IR-202X-XX.
Subscribed records
Add a subscribed record by selecting Add record, and select the record from the drop-down menu. You can subscribe to several records using a single subscription. However, the records you have selected determine what other records you can add to the same subscription. In addition, the Incomes Register recommends that only one record be selected for a single subscription.
File the query using query criteria
You can limit the record content by using various query criteria. The range of query criteria depends on the subscribed record or transcript. Some query criteria are mandatory and some are voluntary.
Data access profile
Select the data access profile from the drop-down menu. The record will only include the data, which you have the right to access based on the data user’s profile.
Report version query
Select what report versions are selected for the record.
Query all report versions: The record will include all report versions: new, replacement and cancelled reports.
Query only the latest report version: The record will only include the latest report version: new, replacement or cancelled report.
Time range
Select the time range, over which you want information to be added to the transcript or record. The maximum length of the time range depends on the subscribed transcript or record.
The time range can be the time range of payment date, the time range of reporting period or the query time range for changes. Either the query time range for changes concerning the entire subscription or the time range given in record data must be given for all subscriptions.
Time range of payment date: The record or transcript will include reports, whose payment date or other report date is within the given time range.
Time range of reporting period: The record or transcript will include data over the given time range.
Query time range for changes: If you enter the query time range for changes, all records in your subscription will be queried over the same time range. The record will include reports, which have been saved in the Incomes Register or which have been corrected or cancelled during this time range. If you do not enter any end date, reports will be queried until the query date.
Query criterion: no substitute payer’s reports
No selection: This is the default selection. If you do not want to filter the query, do not change this selection.
No reports where the payer is a substitute payer: The record will only include the reports with no substitute payer.
Incomes Register report reference
You can enter at most 200 Incomes Register report references as query criteria. The Incomes Register report reference is a technical system reference in GUID format (e.g. 40c5d83b-b2f6-4f4c-8f95-51f9224c7388). The record will include the reports that include any of the Incomes Register report references you have defined as the query criterion.
User ID
You can filter the query by entering the customer identifier of a specific user. The transcript will only include data about the specific user’s actions.
Preview
Preview the data you have entered. If any subscription details are missing or there are errors, return to subscription details to add missing details or correct the errors. Finally, select Submit. You will receive an acknowledgement of receipt after your subscription has been saved successfully in the Incomes Register.
Viewing a transcript
Your subscription will shortly be displayed on the Subscriptions made page in the e-service.
Select the subscription and download the queried transcript by selecting Download the transcript. You can also print a complete file by pressing CTRL + P, or you can save it on your computer, for example.
Viewing a record
Your subscription will shortly be displayed on the Subscriptions made page in the e-service. You can retrieve the queried record from your organisation’s SFTP folder.