Earnings payment records can be uploaded as files to the Incomes Register

Sending data to the Incomes Register

You can use the upload service of the Incomes Register's e-service to send XML files to the Incomes Register or make record subscriptions. Your rights to send information are determined by the access rights of your user role.

  • More information on usage rights is available on the Authorisation page.

You can use the upload service to send files of different types:

Data providers can send the following types of files through the upload service:

  • Earnings payment report, new or replacement report
  • Cancellation of an earnings payment report
  • Cancellation of a record containing earnings payment reports
  • Employer's separate report, new or replacement
  • Cancellation of an employer's separate report
  • Cancellation of a record containing employer's separate reports
  • Record subscription: transcripts, messages or access log data
  • Message record

Data users can send the following types of files through the upload service:

  • Record subscription, new subscription (record or transcript)
    • Transcripts: record subscription summary, e-service use data and access log data. Access log data can be ordered as a record or transcript.
  • Cancellation of a record subscription
  • Cancellation of a record containing record subscriptions
  • Message record

The upload service of the Incomes Register's e-service is a one-way service for sending files to the Incomes Register. Records in XML or PDF format can be ordered through the upload service. If you have ordered PDF transcripts, you can download them by logging into the e-service in the selected corporate or individual customer's area. The e-service has a dedicated page for downloading records. The transcripts are always in PDF format and are downloaded from the e-service's transcript subscription area. XML records are downloaded through the SFTP interface.

Generating files

First, generate the file in your financial administration system. Files sent through the upload service must be in XML format and correspond to the schema requirements of the Incomes Register. Additional information is available on the Documentation page.

The maximum file size is 50 MB. A record to be submitted to the Incomes Register cannot be divided into parts. If there is a large amount of data, it must be submitted in separate records. Each record must have a unique record reference.

Sending files

After you have logged into the Incomes Register's e-service, you can send files to the Incomes Register through the upload service. You can send data for more than one payer in a single upload. You can include files of different types in a single upload. However, each file can only contain the data of a single payment made by a single company, and only data of a single type, such as earnings payment reports. The file can contain reports on more than one income earner.

You can use the upload service to send earnings payment reports and employer's separate reports, or to make record subscriptions, including transcript subscriptions, message subscriptions and log data subscriptions. You can also use the upload service to send messages generated by your system to the Incomes Register. 

Message exchange will be introduced after 1 January 2019. The schedule will be specified at a later date.

You can send new files even if the processing of the records contained in the previous upload is still underway.

You can add files, delete individual files or clear the entire list of selected files before uploading.

Navigating away from the page or closing the browser will have no effect on the processing.

The status of the record will be updated when it is processed. If no errors were detected in the record, the status of the record will be “Saved in the Incomes Register”. If there are errors in the contents of the record, its status will be either ”Rejected” or ”Partly rejected”, according to whether the entire record or only a part of it was rejected.

The upload service displays the reception time of the record and a link to processing feedback. Records will be removed from the list in three months from reception.

Error situations

If you attempt to send an erroneous file through the upload service, you can receive one of the following error messages:

Incorrect file format: If the file extension is not XML or the file format is otherwise incorrect, the message ”Incorrect file” will be displayed. If this is the case, the ”Send files” button will not be active.

XML file did not pass schema validation: If the contents of the XML file do not correspond to the schema of the Incomes Register, the notification ”Reading of file failed” will be displayed. The ”Download technical error message” link will be displayed as additional information. The error message is in text format and presents the errors encountered during schema validation. If this is the case, the ”Send files” ‑button will not be active, and the data cannot be uploaded to the Incomes Register.

No rights to send the record: If the user of the upload service does not have rights to send the record, an authorisation error message will be displayed. If this is the case, the ”Send files” button will not be active, and the data cannot be uploaded to the Incomes Register.

The sent file contains errors: If the user of the upload service sends a file using the ”Send files” button and the file contains errors, the “Download processing feedback” will be displayed. The processing feedback corresponds to the Incomes Register's processing feedback schema and contains the error codes returned by the Incomes Register and their descriptions.

Several files, some of which contained errors: If a part of the files being sent contain errors while a part do not, the error-free files can be sent to the Incomes Register through the upload service. In such cases, the ”Send files” button will be active, but only the error-free files will be sent to the Incomes Register. The files that contain errors will remain on the list.

Supported browsers

The upload service can be used with the browsers and operating systems displayed in the table.

Browser/Operating system Versions
Internet Explorer IE 11
Edge Supported from version 14 (spring 2016) onwards
Safari Supported from version 10 (autumn 2016) onwards
Chrome The two latest versions are supported version-to-version
Firefox The two latest versions are supported version-to-version
Android The latest version of the browsers (Chrome, Firefox, AOSP Browser, Samsung Internet) is supported on devices with Android 6.0 (Marshmallow) and later (autumn 2015).
iOS Supported from iOS 10 (autumn 2016) onwards