News for software developers – 1/2024

New version of Ilmoitin.fi has released on 6 February 2024

Key changes:

• Ilmoitin.fi accepts income tax returns for corporate taxpayers 2024 accounting periods. Users can both check and submit returns (Forms 4, 6, 6B, 6C and 6U).
  • In addition to the annual changes, there have been other changes to the following data format specifications: 4, 6, 6B, 6C, 6U, 8A, 67Y, 74, 81, VSYENN
  • Attachment type "Tilinpaatos" changed to "Vahvistettu tilinpaatos".
  • New attachment type: "Voitonjakotiedot kaupparekisteriin"
  • Data format specifications are available on Data file specifications - income tax returns.
• Changes to background checking:
  • If a user submits multiple files and even one of them is larger than 5 MB (or 1 MB for XML files), they will now be given the option to submit them to background processing.
  • Due to data security concerns, error codes have been removed from the e-mail sent to the user after the checking has been completed. Users can view the errors on Ilmoitin.fi as follows:
    • If the filing was submitted while logged in: go to "Archive", select "Large filings for background checking", and click "Errors".
    • If the filing was submitted via the background checking functionality without logging in, the file containing errors must be checked again without submitting it to background processing: go to "Submit for background checking" and select "I want to launch the check process immediately".
• The data format specifications for annual information returns for the 2024 reporting year are published on 5 February, but their formats will not be available until the March version of Ilmoitin.fi is launched on 26 March 2024. The specifications are available on Annual information returns & Instructions.

News about Vero API

Upcoming changes in Suomi.fi authorization process for Vero API interfaces

The interfaces have checked the Suomi.fi authorization for each interface call. In the future, the interface user must retrieve the authorization with the GetToken interface before making calls to those interfaces that require Suomi.fi authorization.

Authorization will be handled in the future with Suomi.fi authorization tokens, which can be retrieve with the GetToken interface call. The authorization token is a technically signed data structure that contains the Suomi.fi authorizations granted to the interface user. The authorization token gives the right to act on behalf of another organization for 60 minutes from the time of token creation.

The use of Suomi.fi authorization tokens will become mandatory on May 1, 2024. The mandatory use of the authorization token does not apply to interfaces where Suomi.fi authorization is not currently required.

Read more about the upcoming change on the Vero API Acting on behalf of other organizations -page and also from the interface documentation on the API portal.

Lomake.fi will close down in February 2024

Annual information returns that could be submitted in the Lomake.fi e-service, as well as the real estate agent’s and securities broker’s transfer tax returns, were moved to MyTax at the end of 2023.

Lomake.fi will close down at the end of February 2024. If you need to save any of the information in Lomake.fi, retrieve it from the service by the end of February.

This change does not affect filing in Ilmoitin.if, the Vero APIs or MyTax.

New MyTax functionality replaces Lomake.fi services

Schedules and timeframes

• e-Filing of tax returns and information returns, schedules for 2024 (in Finnish)
• Schedule of updates to the Tax Administration’s file check module (in Finnish)
• Planned maintenance downtime

How to contact us or make enquiries

• ohjelmistotalot(at)vero.fi

You can use the e-mail address of the Tax Administration (for software houses) to ask questions related to the Incomes Register as well. We forward the questions to the Incomes Register Unit. However, we remind all users that our e-mail is:

• Intended for those who work with IT development at commercial software vendor companies
• Designed to give guidance and support to IT development
• Not at all for error processing
• Instead, if you detect an error or become aware of a technical problem, always use the observation form to inform the Incomes Register Unit of it.