NAV / Altinn integration

Follow these steps to automatically have your employees’ sick leaves in NAV added to Huma

Why should we use this integration? Read our blog post about how the NAV/Altinn integration can help your company


Sick leaves from NAV can only be created on Huma users with a valid Norwegian identification number, or D-number.

When activating this integration there will be some limitations to the sick leave follow-up process.

Read more here

1. Set up permissions in Altinn

To be able to send Sick leaves to Huma, you need to give Huma access to your company's sick leaves in Altinn

It's important that you set up access in Altinn as we explain below for the integration to work.

Also, remember to set up the correct access in Altinn before configuring the integration in Huma.

  1. Log in to Altinn with a user who has access to the company.
    1. Ensure the user has the role of either 'Tilgangsstyring' or 'Hovedadministrator' in Altinn. This is often the CEO of the company.
  2. Navigate to the organization you wish to integrate sick leaves for.





  3. Navigate to 'Innstillinger' > 'Andre med rettigheter til virksomheten' and '+ Legge til ny person eller virksomhet'



  4. Choose 'Ekstern virksomhet' and add Huma's details:
    Org. nr: 912159329
    Navn: Huma

  5. Select 'Gi tilgang til enkelttjenester,' then search for 'sykmelding' and click 'Legg til.' After that, click 'Gå videre' to continue.





  6. Complete permission set up by clicking 'Fullfør delegering'

  • For organizations that have only a single "underenhet", it doesn’t matter whether they connect the "hovedenhet" or "underenhet".
  • For organizations that have one "hovedenhet" with multiple underenhet, they must connect the "hovedenhet".

Read more about sub units and what they are for at Brønnøysundregistrene.

2. Connect NAV / Altinn integration in Huma

 

NB! Please note the following before continuing:

  • Altinn may take some time to actually process the permissions you have just granted to Huma, so if you run into a problem in completing the setup below, you may have to just wait some minutes and try again.
  • To connect the integration, you first need to enable graded absence for the sick leave type in the absence settings.
    • 1. Go to "Absence module"
    • 2. Navigate to "Settings"
    • 3. Click on absence type "Sick leave" and "Edit absence type"
    • 4. Click on "Allow graded absence" and choose between "Count as full days in Huma" or "Count as partial days in Huma"

Screenshot 2024-09-06 at 13.40.03-1

  1. Copy or write down the org. nr of the sub unit in Altinn

  2. Log in to your Huma account
  3. Go to 'Integrations' in the main menu and choose 'NAV / Altinn'
  4. Please read and make sure you understand the information about the NAV / Altinn integration before moving to the next step.
  5. Click 'Set up' in the upper right corner

  6. Accept the terms & conditions, add the org. nr. of your sub unit which you got from Altinn, and click 'Continue'.

  7. Choose from which date you want to fetch sick leaves and click 'Save'.
    Note that absence administrators (fx. system admins) will receive separate notifications for every sick leave that is fetched, including those that have already ended.

    User with absence approval permissions (fx. managers, supervisor) will receive separate notifications for every sick leave concerning their subordinates. 

    Employees will receive separate notifications for their sick leave registrations from the chosen date.
    1. Huma will recognize sick leaves that match those fetched from NAV and automatically cancel the duplicates.

3. Pending integration

Once you save, the integration will be marked as pending until Huma verifies that the submitted organization number matches your company. This process may take up to 10 business days. You will be notified as soon as the verification is complete, and the integration will then become active.

4. Active integration

When the NAV/Altinn integration is active, all sick leaves that are added to NAV by a doctor will be sent to Huma via your company's Altinn account.

Huma will retrieve data from NAV/Altinn daily at 8:00 AM.

Note - you will need a...

  • system role to set up the integration
  • role with "full access over absence" to handle the sick leave 

You cannot view the physical sick leave note in Huma; it will only appear as a type of absence.

 

What if an absence record in Huma already exists for the same dates as the sick leave from NAV?

When Huma receives a sick leave from NAV, the system handles pre-existing absences in different ways:

  • Any sick leave from NAV, regardless of percentage, will cancel any manually created sick leave in Huma.
  • Any sick leave from NAV, regardless of percentage, will overlap with any absence type other than sick leave in Huma.

Examples:

Vacation created in Huma  
- Receives sick leave from NAV  
- The vacation remains, and the sick leave overlaps.

Example: Anna has a vacation registered in Huma from June 1 to June 10. If she receives a sick leave for June 5 to June 15, the vacation entry for June 5-10 will remain while the sick leave overlaps.

Sick leave manually created in Huma  
- Receives sick leave from NAV
- The sick leave created manually in Huma is canceled.

Example: Anna has a sick leave registered in Huma from June 1 to June 10. If she receives a  sick leave for June 5 to June 15, the sick leave entry for June 5-10 will be Canceled.

 

What does Huma do with sick leave that contains different degrees?

Huma do not support sick leave from Nav/Altinn that contains different degrees.

Fx.
You receive the following sick leave: October 1-5: 100% October 6-10: 80%

Huma only receives the sick leave for October 1-5 at 100%, and you will then need to manually create a sick leave for the period October 6-10 at 80%.

 

What if I have integrated with another system that is fetching absence data from Huma?

Sick leave records from the date selected in step 2.7, if matching, will be replaced by the sick leave from NAV in any other integrations.

If an issue occurs, a record will be created in the integration's error log, and a notification will be sent to administrators with integration access.

Example with Tripletex

1. Sick leave manually registered in Huma is synced with Tripletex.

2. After that, a sick leave is received from Altinn/Nav.

3. The manually registered sick leave in Tripletex will be replaced by the one received from Nav/Altinn.

Limitations to the sick leave follow-up process

If you're using Huma's sick leave follow-up process together with this integration, please be aware that there will be some limitations to the follow-up process for norwegian employees.

Due to technical limitations, when a sick leave is extended in NAV, a new entry will be created in Huma, which will cause the ongoing follow-up process to stop.

  • For organizations that have only a single underenhet*, it doesn’t matter whether they connect the hovedenhet or underenhet.
  • For organizations that have one hovedenhet with multiple underenhet, they must connect the hovedenhet.