What are the Vero API interfaces
Vero API is an interface service provided by the Tax administration, that allows software companies, accounting offices and other service providers to report or retrieve taxation-related information in real-time. API or Application Programming Interface is a programming interface between two different software or systems. Vero API interfaces are developed in Tax Administration for variety of uses cases in taxation, that have been identified to make managing of tax affairs easier and faster and to also help reduce the burden of administrative work for different parties, such as: tax liable companies and individual customers, organizations who are acting on behalf of another parties or accounting offices.
There are more than 80 different Vero API interfaces currently in production and they are used in different areas of taxation and other purposes related to taxation. The interfaces are divided into two main categories: submitting information and retrieving information. The Tax administration designs, develops and releases new Vero API interfaces according to new identified needs of taxation and customers.
Use of the interfaces do not cost anything, but the software company must develop the integration for the Vero API interface for their own software by themself. In addition, the software’s development work, solutions and development costs belong to the software company themself.
For whom the interfaces are meant for and what are the benefits of using them?
The Vero API interface service is intended for software providers and other service providers who do their own software development. The interfaces can be integrated to various user software, such as: accounting-, payroll- or ERP-software.
For example: processes can be built in the same software where the necessary tax filing or data retrieving processes are automated using the Vero API interfaces and the use of the interfaces is integrated as an integral part of the software’s other functions, such as accounting functions.
For example: an accounting or payroll software develops and integrates the Witholding Percentage Request -interface, which enables the software user to request all the latest tax cards for their employees directly from Tax administration’s own system.
The same accounting software can use the Letter request interfaces. With these interfaces the software’s user can retrieve the latest letters of their customers which have arrived from the Tax Administration and they can react to those letters immediately. The accounting or payroll office doesn’t have to request and collect the tax cards of their employees manually and they don’t have to log into Omavero as authorized representative to manage the customer’s tax affairs.
Roles in the use of Vero API interfaces
The following examples describe the roles of the different parties involved in the Vero API - service.
- Provides the Vero API interface service for software companies to use.
- Provides technical support to software companies for the use and implementation of the interfaces.
- Explores the selection of different Vero APIs, chooses the interfaces that suit the business and the software.
- Develops a Vero API integration for their own software and offers the software for other parties to use.
- For example, an accounting company may use financial management software developed by a software company to manage the tax affairs of its individual and corporate clients on their behalf.
- For example, an accounting or consulting firm that handles the tax affairs for different individuals or companies on their behalf.
- The organization acts either as an authorized representative (Suomi.fi) or based on a different mutual agreement.
- Uses a software which has a Vero API integration implemented to it, as an assisting tool in its main business. The software is purchased as a ready package, or it has been ordered separately from a software company.
- For example, a larger financial management and software development company or platform service.
- Develops its own Vero API integration into its own software.
- Handles its own clients' tax affairs directly through its own software.
- Does not offer its own software for other parties.
- A tax liable company or person on whose behalf tax matters are handled through the interface integration.
- The customer's tax affairs are handled by another organization, using Suomi.fi authorization or using some other form of mutual agreement.
- For example, a client of an accounting firm, consulting firm or other service provider.