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

News for software developers – 4/2024

News, 9/24/2024

New version of Ilmoitin.fi has released on on 24 September 2024

Key changes:

  • You can check and submit self-employed businesses? income tax returns (Forms 2, 2Y, 2C, 5, 6A, 7K) for tax year 2024.
  • Direct transfers of withholding data for 2025
    • You can check and submit:
      • direct transfers of resident pension recipients (VKESSELE)
      • direct transfers of non-resident pension recipients (RVKSSELE)
      • direct transfers of withholding data on wages (VKESSPAE) and
      • data on YEL and MYEL work income (VKTYOSVA) for purposes of the 2024 preassessment.
    • The example materials on the Ilmoitin/IT Developers site have been updated
  • Corrections to the reporting platform operator?s annual information return (VSDPIFIN/DAC7):
    • TIN check to apply to both the IndividualSeller and EntitySeller structures.
    • The PlatformBusinessName element is required information in the PlatformOperator structure.
    • PlatformOperator/TIN and ReportableSeller/EntitySeller/TIN cannot be identical.
    • If AddressFix has been given and Address/CountryCode is FI, the postal code must be a 5-digit number.
    • The DPIXML version number of the schema has changed from 1.09 to 1.0, so the new one is DPIXML_v1.0.xsd (in the new version isodpitypes.xsd has changed).
  • Corrections to Payment service provider?s return on cross-border payments (CESOP)
    • The check "If ´ReportedPayee/EmailAddress´ has been given, it must contain data" has been removed because it is an optional element in the schema.

News about Vero API

Push Notification Service has released on 17 September 2024

The push notification service is additional service to receive different notification types from the Tax Administration almost in real-time using Push-typed JSON calls. The user doesn’t have to poll for the latest notifications by using the ListNotifications interface continuously. Notification is a simple message that tells you that something taxation-related has happened for a customer.

Available notification types on 17 September 2024:

  • Excise tax’s EMCS-system and the transactions related to it

Upcoming notification types:

  • Withholding percentage inquiry
  • Decisions and letters
  • Tax period inquiry

Read more about the service's instructions, technical requirements and documentation:

Ordering production certificates will change in October

The Tax Administration’s certificate service will allow users to request API rights and new certificates, not only Tax Administration certificates but also Incomes Register certificates. After the launch of the new certificate service, API rights or certificates can no longer be managed in the Incomes Register’s e-service.

The production certificates section will be opened for users of the Tax Administration’s, the Incomes Register’s, and the Positive Credit Register’s interface on Wednesday, October 9, 2024, at 9 AM.

Read more about the changes:

Tax cards will become valid in January starting next year

Starting in 2025, tax cards will be valid from the beginning of the year. In other words, the tax card for 2025 will become valid on 1 January 2025. Until now, tax cards have become valid in February. The change will make it easier for taxpayers to keep an eye on the tax rate and income ceiling.

The preparation of basic tax cards for 2025 will start on 22 November 2024. The calculations will take approximately two weeks. You can use VeroAPI to retrieve withholding data as the basic calculations proceed. Payment date controls which withholding percentage is returned. Latest active tax card data in relation to payment date is returned. Withholding percentages that become active after payment date are not returned.

The schedules for direct transfers will remain the same: using direct transfer, employers can retrieve 2025 tax cards after 10 December. Direct transfer is available until 15 February 2025.

For more information on VeroAPI, see the Tax Administration’s API instructions on vero.fi. Read more: Vero API - vero.fi

Schedules and timeframes

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.
Page last updated 9/24/2024