Skip to main content

​
🚨 Prerequisites

Before you start, make sure you have:
  • an active Procountor account (Financials, Taloushallinto in Finnish)
  • admin access to the company in Procountor: you create a dedicated user and an API key for it
  • in Finland, the Procountor API add-on: €12.90 per month, plus €2.49 per month for each connected software, excl. VAT, with no opening fee. In Sweden, the API is included in every plan, with no opening fee. In both countries, entries created through the connection are billed like entries created in Procountor, per its price list. See Procountor’s Finnish price list and Swedish API page
One connection covers one Procountor company. If you manage several companies in Procountor, repeat these steps for each one.

​
🛠 Preparation

You create a dedicated Procountor user for the connection, then an API key for that user. Open the connection form first and keep it open: it shows the Client ID you need in step 4.
1

Create a dedicated user

In Procountor, go to Management › Users and user rights, then click Create new user.The Users and user rights page in Procountor, with the Create new user button at the topFill in the required fields. Under Password, select Deliver to user personally to see the password on screen straight away. Then click Save.The Create new user form in Procountor, with Deliver to user personally selected under PasswordUse a dedicated user for this connection rather than a personal login.
2

Give the user accounting rights

Select the user you just created. Under Accounting, set at least Rights for journal receipts and Search journal receipts to All rights, then click Save.The user rights of the new user in Procountor, with All rights on Rights for journal receipts and Search journal receipts
3

Open the API client keys page

At the top right, open the Basics menu (the person icon) and click API client keys.The Basics menu open at the top right of Procountor, with API client keys highlighted
4

Create the API key

Click New API key.The API client keys page in Procountor, with the New API key buttonIn the dialog, select the user you created in step 1. In Client ID, type the Client ID shown on the connection form, exactly as it appears. Check that Environment shows the company you want to connect, then click Create.The Create New API Key dialog in Procountor, with the User, Environment and Client ID fields
5

Copy the key

Select the new key in the list and click Copy key to clipboard. Keep it at hand: you paste it into the connection form next.The API client keys list in Procountor, with a key selected and the Copy key to clipboard button

​
⚡️ Connection

1

Name your connection

In Name of connection, enter a name you will recognize later.
2

Fill in the connection form

The Procountor connection form, with the Name of connection, Client ID and API key fields
3

Click Connect

There is no consent screen: the connection is created straight away.The confirmation that the Procountor connection is active

​
⚙️ Setup

​
Sending journal entries

To send journal entries to Procountor, the company must allow invoiceable API clients. A user with admin rights can turn this on:
  1. Go to Management › Company info › Usage settings › Integration settings (in Finnish: Hallinta › Yrityksen tiedot › Käyttöasetukset).
  2. Check Allow the usage of invoiceable API clients (in Finnish: Salli laskutettavien rajapintojen käyttö).
  3. Save.
If you skip this, Procountor rejects the entries with the error “Client is disabled in environment settings”: the company has not enabled the use of invoiceable APIs.

​
Sending entries with VAT

The VAT rate used in an entry must be a rate currently in use for the company, in Procountor’s VAT settings. If you skip this, the entry is rejected: no VAT code exists for that rate in the company.

​
Sending entries for a given period

An open fiscal year must exist in Procountor for the date of each entry. If you skip this, an entry dated in a closed fiscal year is rejected, with the message “The accounting period is closed in the accounting system.”

​
Entries with a client or supplier

When an entry line uses a client or supplier, it is booked on that partner’s default receivable or payable account in Procountor. Set this default account on every client and supplier used in entries. If you skip this, entries for that partner are rejected.

​
❓ Troubleshooting

The Client ID typed in Procountor when you created the key does not match the one on the connection form. The field is free text, so a typo is the most common cause.Create a new API key in Procountor with the exact Client ID shown on the connection form, then paste the new key into the form. You can revoke the old key under API client keys › Revoke key.
The key was created in a different Procountor environment from the one the connection uses: a key from Procountor’s test environment does not work in production, and the other way round.Create the key in the environment you were asked to connect, then paste it into the form again.
The key was created for another company. Each connection covers one company: the one shown as Environment when you created the key.Create a new key while logged in to the right company, then reconnect with it.
Your Procountor user may not have the rights to manage API keys.Ask your Procountor admin to create the key, or to give you the rights.
The company has not enabled the use of invoiceable APIs.A user with admin rights checks Allow the usage of invoiceable API clients under Management › Company info › Usage settings › Integration settings. See Sending journal entries above.
The VAT rate used in the entry is not a rate currently in use for the company in Procountor.Check the company’s VAT settings in Procountor, and use a VAT code that exists for the company.
The entry is dated in a fiscal year that is closed in Procountor.Check the entry’s date, or open a fiscal year that covers it in Procountor.
The client or supplier has no default receivable or payable account in Procountor.Set a default account on that partner in Procountor, then send the entry again.