Payroll & accounting
      Back to home
      1. Knowledge base
      2. Integrations
      3. Payroll & accounting

      Netvisor integration

      Step 1: Create an API identifier in Netvisor

      Step 2: Connect Huma to Netvisor

      Step 3: Activate the integration. Synchronize users and choose how to handle conflicts or missing value

      Step 4: Your connection between Huma and Netvisor is active 🥳

      How to sync users

      Supported fields

      Step 1: Create an API identifier in Netvisor

      1. Log in as administrator
      2. Open the company menu > API and identifiers

      3. Create a new API identifier by clicking the button to the right

         
      4. Copy and paste the User ID and the Key to a separate document/note for later

      5. Get the Business ID. Open the company menu > Service Management

      6. Copy and paste the Business ID to a separate document/note for later

      Step 2: Connect Huma to Netvisor

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

      1. Login to your Huma account as administrator
      2. Go to System settings > Integrations
      3. Open Netvisor

      4. Read through the documentation
      5. Click 'Set up' in the upper right corner
      6. Paste the Netvisor User ID, Key,  Business ID and check the box to verify you have the proper authority.


      Step 3: Activate the integration. Synchronize users and choose how to handle conflicts or missing values

      • After clicking 'Save' you will end up in the Synchronize users step
      • Huma will inform you of any conflicts or inconsistency between Huma and Netvisor and you will have to decide how to handle conflicts and/or missing values. You can decide wether or not you want to update Netvisor based on values in Huma or the other way around.



      • Click 'Next' and decide how you want to sync users between Huma and Netvisor.


        • If users in Netvisor does not exist in Huma, you can add users to Huma
        • If users in Huma does not exist in Netvisor, you can add users to Netvisor
      • After deciding on the above click 'Syncronize users'
      • Huma will now start synchronizing users with Netvisor. You will receive an email confirming the result.

      Step 4: Your connection between Huma and Netvisor is active 🥳

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

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

       

       

      How to sync users

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

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

      Supported fields

      Huma field Netvisor field
      Email address* (REQUIRED) 
      employeebaseinformation.email

      Huma requires this field’s value to be unique.

      Identifications* (REQUIRED)

       

      		 
      employeebaseinformation.employeeidentifier

      The integration can’t unset or update this field’s value in Netvisor with the value in Huma.

      Must be unique and valid Finnish National identification number (SSA)
      Given name* (REQUIRED) 
      employeebaseinformation.firstname
      Family name* (REQUIRED) 
      employeebaseinformation.lastname
      Employment start date* (REQUIRED) 
      employementperiods[].startdate

      The integration can’t unset this field’s value in Netvisor when the value is unset in Huma.
      Job title* (REQUIRED) 
      employementperiods[].employmentperiod.profession
      Date of birth 
      employeebaseinformation.dateofbirth
      Employment ID 
      employeepayrollinformation.employeenumber

      Netvisor requires this field’s value to be unique.

      Max. length 10 characters
      Probation end date 
      employementperiods[].employmentperiod.probationenddate
      Employment end date 
      employmentperiods[].employmentperiod.enddate
      Employment ID 
      employeepayrollinformation.employeenumber

      Netvisor and Huma requires this field’s value to be unique.
      Nationality 
      employeebaseinformation.nationality

      The integration can’t unset this field’s value in Netvisor with the value in Huma.
      Gender 
      employeebaseinformation.gender

      The integration can’t unset or update this field’s value in Netvisor with the value in Huma.
      Date of birth 
      employeebaseinformation.dateofbirth

      The integration can’t unset or update this field’s value in Netvisor with the value in Huma.
      Address 
      employeebaseinformation.streetaddress
      employeebaseinformation.municipality
      employeebaseinformation.postnumber
      employeebaseinformation.country

      All of the above must be filled in Netvisor if address should be synced to Huma
      Phone number 
      employeebaseinformation.phonenumber

      Huma requires this field’s value to be unique.
      Bank account number 
      employeebaseinformation.bankaccountnumber
      employeebaseinformation.bankidentificationcode