New subscription

You can subscribe transcripts or records as a one-off subscription in the e-service.

The range of transcripts and records available for subscription depends on your roles and authorisations in the Incomes Register’s e-service.

Place a subscription for transcript or record

Transcripts are summaries in PDF or CSV format. If you want to process data in a spreadsheet program (such as Excel), request a transcript in CSV format.

As a payer, you can place a subscription for transcripts of 600 series. You can select the language in which the transcript is generated (Finnish, Swedish or English). If you use an API, you can also request certain data as an XML record (record 312). 

1. General information

The subscriber’s information is imported into the subscription from the Incomes Register’s customer data.

If you report both wages and benefits, select type of subscriber: 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 in stage 3 depends on the type of subscriber you select.

2. 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.

3. Subscribed records

Add a subscribed record by selecting Add record. 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. The Incomes Register recommends that only one record be selected for a single subscription.

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.

  • 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.
  • Time range of absences: The record or transcript will include reports in which at least one day of the time period for reporting absences or absence period is in the given time range. If you want to arrange absences according to the payment date, select the time range of payment date as the query parameter.
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. 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.

Submitter type

Select either payer or substitute payer as the submitter 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.
    • You can also enter a submitter type specifier if you only want to include the payments made by your organisation or those made by a substitute payer in the transcript. If you do not enter any specifier, all payments will be selected for the record, separated into payments made by your organisation and those made by a substitute payer.
  • Substitute payer: The record will only include the reports, on which your organisation has been the substitute payer.
Transcript language

You can select the language in which the transcript is generated (Finnish, Swedish or English). If you do not change the selection, the transcript is generated in the language that you are using when requesting the transcript.

4. Preview

Preview the data you have entered. If any subscription details are missing or there are errors, return to previous stage 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.

As a data user, you can place a subscription for XML records (300 series) or transcripts of 700 series. The transcript or the record is generated in the language that has been specified as the service language of the organisation in the Business Information System (Finnish, Swedish or English).

1. General information

The subscriber’s information is imported into the subscription from the Incomes Register’s customer data.

2. 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.

3. Subscribed records

Add a subscribed record by selecting Add record. 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. The Incomes Register recommends that only one record be selected for a single subscription.

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.

  • 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.

Define one of the different time ranges or the query time range for changes as the query parameter. The time range only applies to this record, while the query time range for changes applies to the entire subscription. 

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 individual, e.g. a personal identity code. The transcript will only include data about the specific individual’s actions in the e-service.

4. Preview

Preview the data you have entered. If any subscription details are missing or there are errors, return to previous stage 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.

Retrieving and viewing a transcript or record

Your subscription will shortly be displayed on the 'Subscriptions made' page in the e-service. You can monitor the progress of your subscription on the page.

Generating the requested transcript can take a few minutes.

Once the subscription has been completed, you can download the transcript (600 or 700 series) on the page 'Subscriptions made'.

If you requested a record to be retrieved through API (300 series), you can retrieve the record from your organisation’s SFTP folder.

Are you looking for these?

You can browse subscriptions on the page 'Subscriptions made'

Read more about transcripts or records on the page 'Record types'

See e-service instructions and sign in to the Incomes Register

Page last updated 11/16/2023