Scam messages have been sent out in the Tax Administration’s name. Read more about scams

News for software developers – 2/2024

News, 3/27/2024

New version of 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
  • 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 authorization process for Vero API interfaces

The interfaces have checked the 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 authorization.
Authorization will be handled in the future with authorization tokens, which can be retrieve with the GetToken interface call. The authorization token is a technically signed data structure that contains the 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 authorization tokens will become mandatory on May 1, 2024. The mandatory use of the authorization token does not apply to interfaces where 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

How to contact us or make enquiries

  • ohjelmistotalot(at)

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.
Page last updated 3/27/2024