Fortnox integration

This is how you connect Fortnox to Huma to enable an automated sync of employee data

Skärmavbild 2021-11-10 kl. 09.10.50In Huma go to System settings > Integrations and choose Fortnox

Please read all the information about "How to use it""Supported features" and "Supported fields" the Fortnox integration before moving to next step.

After reading the information > Click connect

Fortnox requires you to have an integration-license active to be able to integrate any third-part system - Only one licens is required for all integrations. (If you already have this, you can skip this part).

How to activate the Integration-license:

- Go to Administrate Users > Add Licenses > Integration

Skärmavbild 2021-11-10 kl. 08.37.35-1

Skärmavbild 2021-11-10 kl. 08.37.01-1

Skärmavbild 2021-11-10 kl. 08.36.42-1

For more information about the licens/API go to Fortnox (Swedish language only) 

Please note that you need to have a license active from Fortnox. Please contact your Fortnox system administrator if you do not have the necessary privileges in Fortnox.

Connect Huma with Fortnox:

To access Integrations under System settings you'll need a System role with permissions to do Organization-wide settings. Read more here

Skärmavbild 2021-11-10 kl. 08.38.36-1


Check in the box to accept "The Terms of Service".

Skärmavbild 2021-11-10 kl. 08.38.59-1


Login to Fortnox and approve authorization

Skärmavbild 2021-11-10 kl. 08.40.31-1

Click connect and solve conflicts or missing values

After clicking connect, Huma will inform you of any conflicts or inconsistency between Huma & Fortnox and you will have to decide how to handle conflicts and/or missing values. You can decide wether or not you want to update Fortnox based on values in Huma or the other way around.

Skärmavbild 2021-11-10 kl. 08.49.32-1

NB! Make sure "Email", "Phone" and "Employment ID"  is unique in Huma and in Fortnox. Email is required first time you synchronize to be able to get a match.

Click next and decide how you want to sync users between Huma & Fortnox

Skärmavbild 2021-11-10 kl. 08.49.42-1

If users in Fortnox does not exist in Huma, you can add users to Huma

If users in Huma does not exist in Fortnox, you can add users to Fortnox

After deciding on the above click "Sync users"

Skärmavbild 2021-11-10 kl. 08.41.19-1A dialogue shows that the sync have started, you will receive an email confirming the result.

Skärmavbild 2021-11-10 kl. 09.56.38

You will see the current status in Huma (Connected)

Skärmavbild 2021-11-10 kl. 09.04.55-1

Any changes made to supported fields in Huma (listed below) will be automatically updated in Fortnox in real-time. 

Please be aware that you need to sync users to get the latest changes from Fortnox. Changes made in Fortnox will not be automatically be updated in Huma. 

How to sync users manually

If you want to sync users manually you can always click "Sync users"

Skärmavbild 2021-11-10 kl. 11.35.59

Please be aware that you need to sync users to get the latest changes from Fortnox. Changes made in Fortnox will not be automatically be updated in Huma. 

Supported fields

These are the profile fields that will be synchronized between Huma and Fortnox:

  • Email
    Note: Required. Needs to be unique and will be used to identify and match users when syncing users for the first time.
  • Employment ID
    Note: Needs to be unique. Will only be synchronized from Fortnox to Huma, and not the other way around, when syncing users manually.  
  • Given name
  • Family name
  • Phone number
    Note: Needs to be unique.
  • Address
  • Bank account number
    Note: Must be a valid Swedish bank account number
  • First day of work
  • Last day of work