News for software developers – 2/2024

New version of Ilmoitin.fi has released on 26 March 2024

Key changes:

• You can check and send annual information returns for 2024.
  • Checks, as defined in the data format specifications, of annual information returns for 2024 are added (data format specifications available on tax.fi).
• This update contains finalised corrections to the deletion report of the 2023 Annual information return on foreign dividends (VSULKOSE), which previously could not be sent at all.
• The update also contains process-related corrections to the "Tilinpaatos" (up to tax year 2023) and "Vahvistettu tilinpaatos" (from tax year 2024 on) file attachments.
• For CRS/DAC2 and WHT information returns, bank code 798 is now added denoting the VIVA bank, which is added to the accepted bank groups.
• New information added to the General description of electronic filing.
  • Personal identity codes can be replaced by an updated artificial string, ppkkvvAUUUU. Accordingly, the following two artificial ID codes are now available for use: ppkkvv-UUUU and ppkkvvAUUUU.

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.

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.