...

...

...

Access

To access the import routine:

Tools -> Import -> Finnish Tax Cards

The layout of the routine looks:

...

Setup

1. Certificate:

...

For Official Test and Production, it requests an Income register certificate. To get a certificate, you can use the Setup -> Certificate:

...

https://vero.fi/en/About-us/it_developer/tax-administration-interface-services/vero-api/testing/

The steps to Sign a new certificate:

By signing the start notification and sending it to ohjelmistotalot(at)vero.fi as a PDF file, you accept the terms and conditions. You will receive a secure mail afterward. Go to Sign New Certificate and fill up the fields according to the mail you received:

...

Click Execute.

...

It will return a RetrievalID, this ID will be used in the next step Get Certificate:

...

Setup the filename of the certificate and Execute

...

The certificate is received and saved in the location where you defined it.

2023.20.1.1 14 Feb 2023 APMPI-830 Fixed the issue with handling values while automatic Tax Cards update in ‘Withholding Percentage’ and ‘Additional Percentage’ fields. 2023.30.1.1 15 Dec 2023 APMPI-1063 Fixed the issue occurred when trying to sign a new certificate.

Introduction

Finnish electronic tax cards are provided by the Tax Office and can be automatically uploaded into the system.

Table of Contents
minLevel 1 maxLevel 2 outline false exclude Contents type list printable false

Functionality

The Import tool is available under Tools > Import > Finnish Tax Cards:

Image Added

Selection of employees for the import

The import window selects the employees based on the Employment State drop-down box and the open client. Similar to Crewlist in APM.

Note
If you want to change the Employment State filter, remember to use the “Refresh” button to load the list of employees accordingly.

Image Added

You can use the “Tag All”/”Untag All” buttons or filter by PIN and Name columns to control the selection of employees for whom you want to import the Tax Card:

Image Added

Import routine

Press the “Import Tax Card” button to import the tax card for the selected employees. The system shows you the imported data and the import log.

Image Added

Choose the Income type codes for the tax card:

Image Added

You can see the result messages on the right part of the window. All successfully received tax cards with details are displayed in the grid labeled “Result of Importing Tax cards”-

Image Added

In the example above, PIN 305 has received two tax cards, 000024, and 000038. 

You can check the result on Payroll -> Constants:

Image Added

Errors and warnings:

On the right-hand side, you will find a work log and warnings informing you what went wrong and what steps to take next.

Image Added

Multiple Tax Cards

In the case that a person has multiple tax cards available, then you can select the current Income Type from the list of Available Tax cards.

Image Added

Housekeeping

Certificate Registration

Expand

Applying for certificate Before you continue, your organization needs a certificate to connect the test and/or production environment. These are two different certificates, one for each environment test and/or production. See How to request a testing certificate See How to apply for a production certificate Once Vero Skatt approves your certificate application, they will send you the required information, which you use to fill out the information marked below. How to configure the certificate Got to > Setup > Certificate Image Added The steps are as follows, 1) Sign New Certificate, 2) Get the Certificate, 3) Install the Certificate on the Current Workstation. Before continuing with the following steps, select if you want to create a test or production certificate from the drop-down box. 1) Sign New Certificate Use the information received from Vero Skatt; see paragraph ‘applying for Certificate’. Image Added Field Value Service URL prefilled by plug-in Environment Based on the selection made Test or Productions Customer Name Free input write your company name Income Register All information in this section you find in the secure email from Vero Transfer Id Transfer Password Customer Id Authority Description Retrieval Id When executing the signing of the certificate, the system receives a Retrieval Id. This will be used in the next step: ‘Get Certificate.’ Get Certificate Image Added Field Value Service URL Prefilled by plug-in Environment Based on the selection made Test or Productions Customer Name Free input write your company name Income Register Customer Id Automatically filed from the previous step Retrieval Id Received in the previous step Certificate File The system will create a physical certificate in the location with the file name given in this field. Press execute to create a certificate file Image Added You will be asked to install the certificate:

...

Image Added The system throws the following warning, press Ok to continue Image Added Image Added To be sure, you can check if the certificate and key files are in place:

...

...

Go to the General tab, and to be sure the Environment selection is setup properly:

For example, If you have the certificate of Test, then the environment selection should be set as Official Test.

...

The APIkey (Software registration ID) is fixed: 0-046-611-932

For the other client workstation which is not original Sign/Get certificate, the functionality “Install Certificate On Current Workstation” will install an existing certificate:

...

Install Certificate on Current Workstation Other client workstations that are not used to ‘sign new’ and ‘get the certificate’ can use this function to install the certificate. Note You can not create certificates on multiple workstations or multiple times. Image Added Before you install the Certificate on the current workstation, you copy the three files (Certificate file, and Private/Public key files) from the original client workstation to the current workstation. The “Install Certificate On Current Workstation” will let you locate the certificate file, install the certificate, and set the path in the system.

2. General Setup:

a) Import the Income type codes for the tax card:

...

Image Removed

Choose a definition file and import the codes into the system.

b) To define one of the Income type codes as a standard code for auto-update.

The Vero API can return several tax cards for a person, in this case, the Import routine will update the person’s current tax card with this defined standard code.

...

Configure the connection Vero Skatt Configure Connection to Vero Skatt to import Finnish Tax Cards Add the URL and APIKey for the test and/or production environment in the general tab. Image Added Field Value Test > URL Pre-filled Test > APIKey Use the following: 0-046-611-932 Production > URL Pre-filled Production > APIKey Use the following: n8jvgpq8874ybyfkqf5rvdrjr75rf7bzjhp2cv6x Environment Selection Select the environment you want to use Payer ID Add your company payer id Income Type for Auto Update During importing Tax Card If the person has no tax card

...

...

User interfaces

...

On the left part, you can choose whom you want to import tax cards for. You can Tag/Untag the person(s).

Click “Import tax card” to import for the tagged person(s):

...

Choose the Income type codes for the tax card:

...

On the right part of the window, you can see the result messages. All successfully received tax cards with details shown in the middle list.

...

In the example above, PIN 305 has received two tax cards, 000024, and 000038.

You can check the result on Payroll -> Constants:

...

The person may have more than one tax card, you can setup person’s current tax card as below:

...

In the case when you set manually a tax card other than the default, next time importing will update with the same tax card type code as you selected. For example, if you change the person to use tax card 000038, then next time importing will check and update tax card 000038 only.

Housekeeping

...

running the import, the Income Type in this field defines the Finish Tax fields in the persons payroll constants.

Import Income Type codes

Expand

Go to Plugin > Setup Select Import Income Type codes Image AddedImage Added Select the Year for import Load From File and the file from which you will import the codes Start Update Note If the Income Type codes have not changed, they will be kept by the system from the first import. You can update the Income Type codes in case of any changes introduced by the Finnish Tax Office. Make sure the year in the import file and the year selected on the plugin screen match. View file name API_Type of income.csv

Company Setup

Expand
The import will be available for all crew employed by the company with Finnish National Payroll Code: Image Added

Installation

To install the plug-in, navigate to Install APM Plugin and follow the step-by-step instructions carefully.

The latest plug-in version is available here: http://download.adonis.no/files/upgrade/PersonnelManager/Plugins/FinnishTaxCards/

Test data on the official test of Vero API portal

verohallinto_iit-withholding-api-testdata.pdf

For example:

Image Added

Above is one of the test examples