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

      Visma.net Payroll integration

      This is how you connect Visma.net Payroll to Huma to enable an automated sync of employee data

      Step 1: Get a Tenant ID from Visma.net Payroll

      Step 2: Connect Huma to Visma.net Payroll

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

      Step 4: Your connection between Huma and Visma.net Payroll is active 🥳

      How to sync users

      Supported fields

       

      Step 1: Get a Tenant ID from Visma.net Payroll

      1. Log in to Visma.net Payroll as an administrator (with access to the App Store)
      2. Go to the App Store and find and open the Huma HR app 
      3. Click Authorize app in the bottom

        Screenshot 2023-03-29 at 13.20.29
      4. Make sure both 'Read employees' and 'Write employees' are activated before you click Integrate

      5. Click on your name in the top right and copy the Tenant ID to your clipboard

      Step 2: Connect Huma to Visma.net Payroll

      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 Visma.net Payroll

      4. Read through the documentation
      5. Click 'Connect' in the upper right corner




      6. Paste the Tenant ID and check the box to verify you have the proper authority.



      7. Click 'Connect' and a connection is now established between the two systems. Now: On to the next step - it's where the magic happens.

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

      1. When connected click 'Synchronize users'
        Screenshot 2023-03-17 at 16.15.52

      2. Huma will inform you of any conflicts or inconsistency between Huma and Visma.net Payroll and you will have to decide how to handle conflicts and/or missing values. You can decide wether or not you want to update Visma.net Payroll based on values in Huma or the other way around.



      3. Click 'Next' and decide how you want to sync users between Huma and Visma.net Payroll.
        • If users in Visma.net Payroll do not exist in Huma, you can add users to Huma
        • If users in Huma do not exist in Visma.net Payroll, you can add users to Visma.net Payroll.

      4. After deciding on the above click 'Synchronize users'



      5. Huma will now start synchronizing users with Visma.net Payroll. You will receive an email confirming the result.

       

      Step 4: Your connection between Huma and Visma.net Payroll is active 🥳

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

      Please be aware that you need to sync users to get the latest changes from Visma.net Payroll. Changes made in Visma.net Payroll 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"

      Screenshot 2023-03-20 at 11.17.51

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

       

      Supported fields

      These are the fields that will be synced between Huma and Visma.net Payroll

      Field Comment
      Given name

      Syncing Huma to Visma
      Will set an end date on current name in Visma and add a new from today.

      Syncing Visma to Huma
      Current name will be used.
      Family name
      Email Will update business email
      Phone

      Will update business phone
      First workday

      Syncing Huma to Visma
      Will set the activeStart of the selected position* to match the First workday in Huma

      Syncing Visma to Huma
      Will set the First workday in Huma to match the activeStart of the selected position*.
      Last workday

      Syncing Huma to Visma
      Will set the activeEnd of the selected position* to match the Last workday in Huma

      Syncing Visma to Huma
      Will set the Last workday in Huma to match the activeEnd of the selected position*.
      Employment ID

      Visma.net Payroll restricts max length to 12, longer IDs will be rejected

      Required to create employee in Visma.net Payroll

      Can not be unset in Visma.net Payroll
      Bank account

      Only Norwegian national bank account are sent to Visma. Other countries are reported as “Cash”. Use International bank account for other countries.
      Address

      Second line of the street address in Huma will not be synced to Visma.net Payroll.
       
       

      Selected position*


      If the employee has a current position, this will be the selected position.

      If the employee doesn't have a current position, the most recent position will be the selected position.

      If the employee doesn't have a current or past position, the future position will be the selected position.

       

      Why do Huma only send Last day of work when Visma.net Payroll also requires “End reason” when registering Last day of work?

      Ordinary contract and Maritime employment types of positions in Visma require Position end reason to be filled when position activeEnd is setup. In such cases Position end reason will be set to "The employee has resigned from his/her position".

      Similarly when Employment End Date in Huma is emptied we will clear Position end reason in Visma.