Versions Compared

Version Old Version 7 New Version Current
Changes made by

yuriy.biryukov

Daria Chebotaieva

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Page Properties

Description

Finnish tax cards import

Latest Version

2023.

...

30.1.1

Release Date

...

Download Path

Download

Type

APM Plugin

Change Log: 

Expand

Version

Date

Description

2023.20.1.1

APMPI-830

Fixed the issue with handling values while automatic Tax Cards update in ‘Withholding Percentage’ and ‘Additional Percentage’ fields.

2023.30.1.1

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
minLevel1
maxLevel2
outlinefalse
excludeContents
typelist
printablefalse

Functionality

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

Image Modified

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 Modified

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 Modified

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 Modified

Choose the Income type codes for the tax card:

Image Modified

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 Modified

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

You can check the result on Payroll -> Constants:

Image Modified

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 Modified

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 Modified

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.

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 Modified

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 Modified

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 Modified

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 Modified

You will be asked to install the certificate:

Image Modified

The system throws the following warning, press Ok to continue

Image Modified

Image Modified

To be sure, you can check if the certificate and key files are in place:

Image Modified

Sent the contents to Vero API support to enable the certificate.

The Income register creates the certificate, and the Vero API Portal needs to register and enable this certificate.
Following: After the above, you need to send the content of the certificate file to Vero API support (You can use Notepad to open the file and copy/paste it to the E-mail). Vero API support will add/enable the certificate to their site, confirm with you, and then you can start to send tax card requests.

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 Modified

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.

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 Modified

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 before running the import, the Income Type in this field defines the Finish Tax fields in the persons payroll constants.

Import Income Type codes

Expand

  1. Go to Plugin > Setup

  2. Select Import Income Type codes

    Image ModifiedImage Modified

  3. Select the Year for import

  4. Load From File and the file from which you will import the codes

  5. 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
nameAPI_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 Modified

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