Versions Compared

Version Old Version 6 New Version 7
Changes made by

yuriy.biryukov

yuriy.biryukov

Saved on

Key

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

...

Expand

Version

Date

Description

2023.20.1.1

APMPI-830

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

...

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

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’.

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

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

You will be asked to install the certificate:

The system throws the following warning, press Ok to continue

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

Image RemovedImage Added

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.

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 Vera 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.

Field

Value

Test > URL

Pre-filled

Test > APIKey

Use the following:

0-046-611-932

Production > URL

Pre-filled

Production > APIKey

Use the following:

0-046-611-932

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.

...