Upload service

You can use the upload service to send XML files to the Incomes Register or make record subscriptions concerning data submitted to the Incomes Register. Generate the file in your own system before sending it to the upload service. Your rights to send information are determined by the authorisations of your user role. The service will check your authorisations when you send the file.

It takes a moment for the file to be uploaded to the Incomes Register as the upload service runs checks on the record while it is uploading. You can monitor the status of the file being uploaded in the upload service.

Once the file has been uploaded to the Incomes Register, it takes a few minutes before the file is displayed on the Records sent page.

You can send payer 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. However, 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 requests, message subscriptions, and log data subscriptions. You can also use the upload service to send messages generated by your system to the Incomes Register.

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.

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

Error situations

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

In some of the error situations, only the error code is displayed. You can check the description of the error in the Error codes (xls).

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 and you cannot send the file.

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. You can also download the error message in text format by clicking the link Download technical error message. The error message presents the errors encountered during schema validation. The Send files button will not be active, and you cannot upload the data to the Incomes Register.

No rights to send the record: If you do 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 you cannot upload the data to the Incomes Register.

The sent file contains errors: If you send a file using the Send files button and the file contains errors, you can view the errors by clicking the link Download processing feedback. 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 some of the files being sent contain errors while some do not, the error-free files can be sent to the Incomes Register. 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.