News for software developers – 02/2026

New version of Ilmoitin.fi will be launched on 24 March 2026

During the downtime on 24 March 2026 between 7 am and 9 am, the Ilmoitin.fi website and its software interfaces are temporarily unavailable.

Key changes:

• Annual information returns 2026:
  • Check processes added for 2026.
  • In addition to annual changes, changes have been made to the following data flows: VSLAINAE / Number of debtors (111) does not allow the value 0.
  • You can find data format specifications on Annual information returns & Instructions - vero.fi
• Changes in the test environment:
  • The archive can no longer open a sent file. (This change will also be in Production in the fall).
  • The error file of a file sent for background check (File Submission and File Inspection) can only be opened by entering the same email address that was used to send the file.

---

News about Vero API

Extending the validity period of the authorization token.

Since the current token-based solution did not reduce the number of calls as expected, the validity period of the token has been extended from the previous 60 minutes to 8 hours.

The operating principle remains the same as before, but the time window for acting on behalf of another party has been significantly increased:

• One call to the GetToken interface is still required for customers who need a token. After that, they will have 8 hours to perform all required Vero API calls.
• When the tokens expire, the GetToken interface must be called again to retrieve new tokens for the next 8 hour period.
• Software implementations must take into account that the same token is used for its entire validity period (8 hours), instead of obtaining a new token for each individual API call.

This change entered into production on 5 March 2026 and documentation has been updated in Vero API portal: Get Vero API Suomi.fi authorization token.
 
We will monitor the effects of the change and ensure that the transition from 60 minutes to 8 hours is implemented as expected across the services.

---

News about certificate service

Changes to the Tax Administration’s IP addresses of the certificate service, for production certificates, the changes will take place on 25 March 2026.

Some of the existing IP addresses will be used in a different way as the certificate service will undergo a technical update. You can find the changes on the page: News about certificate service.

The changes listed may require that your organization should make adjustments, etc. especially with regard to firewalls, if you utilize firewalls to restrict access to interfaces or to the locking addresses of certificates. Accordingly, if your organization uses PKI APIs for retrieving certificates or for renewing them, we’d like to ask you to make sure – after the changes described – that your internal firewall settings will still allow connection.

Note: Changes to IP addresses may also affect calls made to the Vero API production environment. Service disruptions may occur between 25 and 27 March 2026.

---

Events for Software developers 

“Clinics” on Teams (in Finnish)

For 2026, there is schedule for upcoming events on Teams, which you can find our website Tilaisuudet - vero.fi.

Our “clinic” style events will offer IT developers a wide variety of information updates. If you have questions or suggestions for issues to be discussed at the next “clinic”, you are welcome to send e-mail to ohjelmistotalot(at)vero.fi – for subject, write: Klinikka.

The Tax Administration and software developers collaboration day online (in Finnish)

The Tax Administration and software developers spring collaboration day online on May 26, 2026. The day will start at 9:00 AM.

The day will feature current presentations on changes in taxation and their impact on software development. The day's presentations and a detailed schedule will be published closer to the event.

Register for the day (in Finnish)

---

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.