Earnings payment records can be uploaded as files in the upload service

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.

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 and replacement report
  • Cancellation of an earnings payment report
  • Cancellation of a record containing earnings payment reports
  • Employer's separate report, new and replacement
  • Cancellation of an employer's separate report
  • Cancellation of a record containing employer's separate reports
  • Record subscription: records or transcripts 

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

  • Record subscription: records and transcripts (e.g. access log data)
  • Cancellation of a record subscription
  • Cancellation of a record containing record subscriptions

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 also be ordered through the upload service.

If you have ordered PDF transcripts, you can retrieve them by signing in to the e-service in the selected corporate or individual customer's area. The e-service has a dedicated page for retrieving transcripts. Records are retrieved via 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 signed in to 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 and log data subscriptions. 

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

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

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.

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.

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.