Integrations
      Back to home
      1. Knowledge base
      2. Integrations

      Xledger integration

      Step 1: Get an API token from Xledger

      Step 2: Connect Huma to Xledger

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

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

      How to sync users

      Supported fields

       

       

      Step 1: Get an API token from Xledger

      1. Log in as administrator
      2. Go to administration > access control > Graph QL > Access tokens

      3. Generate a new access token and give the following access

        Human Resources Employee: read/write
        Common Address: read
        Contact: read/write
        Country: read
        Company: read
        Object Value: read
        Subledger: read/write
        Supplier: read/write
        System Value: read
        General ledger Bank: read


         
      4. Click Generate token
      5. Copy token to clipboard


       

      Step 2: Connect Huma to Xledger

      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 Xledger


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




      6. Paste the created Xledger API token key 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'


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



      3. Click 'Next' and decide how you want to sync users between Huma and Xledger.
        • If users in Xledger does not exist in Huma, you can add users to Huma
        • If users in Huma does not exist in Xledger, you can add users to Xledger

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



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

       

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

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

      Please be aware that you need to sync users to get the latest changes from Xledger. Changes made in Xledger 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 Xledger. Changes made in Xledger will not be automatically be updated in Huma. 

       

      Supported fields

      • Given name
      • Family name
      • Email address
      • Phone number
      • Date of birth

      • Bank account number

      • Address
      • Gender
      • Civil status
      • Employment ID
      • Job title
      • First day of work
      • Probation end date
      • Termination notice date
      • Last day of work