Fortnox integration

Overview

Evatic Service Hub (ESH) integrates with Fortnox through the Asolvi integration services and the Fortnox API, for import and export of data.

Implemented imports

• Import Customers/addresses data from Fortnox to Evatic

Setting up the integration

A Fortnox integration has to be configured both in Evatic Service Hub and in Fortnox. This document gives instruction on how to set it up on the Evatic Service Hub side. Consult the Fortnox documentation on how to configure the integration on the Fortnox side.

NB: When you create an integration at the Fortnox side, an API key is generated. You need to keep this API key to use in your ESH integration.

Integration setup in ESH

In the Evatic Service Hub, on the Integrations tab, click Add integration. A list of available integration types will be shown in the Add new integration view. Locate Fortnox integration service and click Create on that row.

The Create Fortnox integration service view will be shown. Fill in the standard fields for integrations: select an Evatic database connection, add a name and description for the integration, and select a company.
Department is optional. If not set, the default department is used.

See the section below on the use of the Fortnox Api key field.

Getting a Fortnox Access token

Fortnox requires an access token for all data transfers. To obtain an access token, a valid Fortnox Api key is needed.

Enter the API key from Fortnox into the Fortnox API key field in your ESH integration setup, and Save the integration.

When the integration has been saved, open the Edit integration page by pressing the Edit button next to your Fortnox integration. Press the Get access token button next to the Fortnox API key field.
The access token will be put into the Fortnox Access token field.
Remember to press Save to save the access token.

NB! The access token can only be set once. Both API key and access token fields will now be read-only. Fortnox's API key will only be valid for 30 days. If it has expired before you get the access token, a new key must be generated in Fortnox.
The Fortnox Access token never expires, and once set, will not need to be renewed.

To test the connection, press Test connection (in the Edit view). A green message box will appear on top, saying the test went successfully. (or a red error message if not.)

Now your integration is ready to use.

Configure and run the import job

Back in the list of integrations, press the Open button next to your Fortnox integration, to see the list of available jobs, currently just one.

The job Import data from Fortnox is shown in the list. Click on the job, then press Enable to enable the job.
It has been default set to run once a day, at 2 AM. The time and frequency can be configured using the Configure button, or contact support if you need more custom configuration.

The job can also be run manually by pressing the Run button.