Innehållsförteckning
- Roller och åtkomst
- Så flödar data
- Innan du börjar
- Konfigurera integrationen
- När integrationen är aktiv
- Fält som stöds
- Felloggen och felsökning
- Vanliga frågor
- Relaterade artiklar
Roller och åtkomst
| Åtkomst | Krav |
|---|---|
| Roll i Huma | Systemroll med fullständig åtkomst till Organisation |
| Roll i Netvisor | Administratör, så att du kan skapa en API-identifierare och ändra åtkomsträttigheterna för API-resurser |
💡 Osäker på vilka roller du behöver i Netvisor? Kontakta er administratör i Netvisor eller Netvisor support.
💡 Netvisor-integrationen är markerad som beta i Huma.
Så flödar data
| Data | Huma → Netvisor | Netvisor → Huma | När |
|---|---|---|---|
| Profilfält | ✅ Automatiskt | ✅ Bara manuellt | Ändringar i Huma skickas i realtid. Ändringar i Netvisor hämtas när du klickar på «Synkronisera användare». |
| Nya anställda | ✅ Bara manuellt | ✅ Bara manuellt | När du klickar på «Synkronisera användare» |
| Tjänster (anställningsperioder) | ✅ Automatiskt, om aktiverat | ❌ | När en tjänst skapas, uppdateras eller raderas i Huma |
| Frånvaro | ❌ | ❌ | Stöds inte |
| Lön | ❌ | ❌ | Stöds inte |
⚠️ Historiska data överförs inte. Bara tjänster som skapas, uppdateras eller raderas efter att integrationen har blivit aktiv skickas till Netvisor.
Innan du börjar
- Du har en systemroll med fullständig åtkomst till Organisation i Huma.
- Du eller en kollega kan logga in i Netvisor som administratör.
- Anställda som finns i båda systemen har samma e-postadress i Huma och Netvisor. Huma matchar anställda enbart på e-postadress.
- Anställda som du vill skapa i Netvisor från Huma har en finsk personbeteckning (HETU) och minst en tjänst med startdatum i Huma.
🔗 Kom i gång med löne- och redovisningsintegrationer
Konfigurera integrationen
Steg 1: Skapa en API-identifierare i Netvisor
- Logga in i Netvisor som administratör.
- Öppna företagsmenyn och välj «API identifiers».
- Skapa en ny API-identifierare med knappen till höger.
- Kopiera «User ID» och «Key» och spara dem till senare.
Tillåt API-resurserna
- Öppna företagsmenyn och välj «API resource access rights».
- Scrolla ner till avsnittet «Salaries».
- Tillåt följande resurser om de inte redan är tillåtna:
- employee.nv
- getemployee.nv
- getemployees.nv
- patchemployee.nv
- addjobperiod.nv, editjobperiod.nv och deletejobperiod.nv, om du ska skicka tjänster till Netvisor
Hitta Business ID
- Öppna företagsmenyn och välj «Service Management».
- Kopiera «Business ID» och spara det till senare.
Steg 2: Anslut Huma till Netvisor
- Gå till Integrationer i Huma och välj Netvisor.
- Läs flikarna «Översikt» och «Detaljer».
- Klicka på «Konfigurera» uppe till höger.
- Ge anslutningen ett namn.
- Välj vilka som ska ingå i anslutningen: alla, eller ett visst team, en plats eller ett företag.
- Klicka på «Fortsätt».
- Klistra in User ID, Key och Business ID från Netvisor.
- Bekräfta att du har behörighet att acceptera villkoren på organisationens vägnar.
- Klicka på «Fortsätt».
🔗 Behöver ni mer än en anslutning, till exempel en per företag? Se Flera integrationer.
Steg 3: Välj vad som ska synkroniseras
Netvisor har en inställning. Du kan ändra den senare.
| Inställning | När den är på | När den är av |
|---|---|---|
| Tjänster: Skapa, uppdatera och ta bort | Tjänster som skapas, uppdateras eller raderas i Huma skapar, uppdaterar eller raderar den matchande anställningsperioden i Netvisor. | Inga uppgifter om tjänster skickas till Netvisor. |
💡 Vi rekommenderar att du aktiverar tjänster innan du börjar hantera tjänster i Huma.
💡 Nya anställda i Huma skapas aldrig automatiskt i Netvisor. Klicka på «Synkronisera användare» för att skapa dem.
Steg 4: Synkronisera användare för att aktivera integrationen
Efter konfigurationen står det «Den här integrationen har konfigurerats, men är inte aktiv.» på integrationssidan. Inget skickas förrän du har gjort det här steget.
- Klicka på «Synkronisera användare».
- Matchande användare är anställda med samma e-postadress i båda systemen.
- Granska vilka fält som har olika eller saknade värden.
- Välj för varje fall om Huma ska uppdateras med värdet från Netvisor, om Netvisor ska uppdateras med värdet från Huma, eller om det ska lämnas som det är.
- Klicka på «Nästa».
- Icke-matchande användare är anställda som bara finns i det ena systemet.
- Välj om alla, bara de du väljer eller ingen ska skapas.
- Välj riktning: Netvisor → Huma, eller Huma → Netvisor.
- Klicka på «Synkronisera användare».
Statusen ändras till «Ansluten och aktiv». Du får ett mejl med resultatet.
💡 Observera
Bestäm innan du synkroniserar vilket system som har den mest aktuella informationen. Dina val här skriver över data.
⚠️ Användare som saknar obligatoriska fält synkroniseras inte förrän värdena har fyllts i. För att skapa en anställd i Netvisor behöver personen en finsk personbeteckning (HETU) och en tjänst med startdatum i Huma.
När integrationen är aktiv
Det här sker automatiskt
- Ändringar i profilfält som stöds i Huma skickas till Netvisor i realtid.
- Om tjänster är aktiverade skickas nya, uppdaterade och raderade tjänster i Huma till Netvisor.
När du behöver synkronisera manuellt
Klicka på «Synkronisera användare» när:
- Du har ändrat ett fält som stöds i Netvisor och vill ha ändringen i Huma.
- Du har lagt till anställda i Netvisor som ska skapas i Huma.
- Du har lagt till anställda i Huma som ska skapas i Netvisor.
Så skickas tjänster
- Huma matchar tjänster mot anställningsperioder i Netvisor på startdatum och befattning.
- När du lägger till en tjänst i Huma skapas en ny anställningsperiod i Netvisor. Om det redan finns en period med samma startdatum och befattning skapas ingen ny.
- När du uppdaterar en tjänst letar Huma efter perioden med det startdatum och den befattning som tjänsten hade före ändringen. Om ingen hittas skickas inte uppdateringen, och du ser ett fel i felloggen.
- När du raderar en tjänst raderar Huma den matchande perioden i Netvisor. Om ingen hittas raderas ingenting.
- Netvisor tillåter inte överlappande anställningsperioder. En ny eller uppdaterad tjänst som överlappar en annan period skickas inte, och du ser ett fel i felloggen.
- När en anställd skapas i Netvisor blir personens första tjänst i Huma den första anställningsperioden.
💡 När du redigerar den första tjänsten som Huma skapade automatiskt när anställningshistorik lanserades, se till att startdatum och befattning stämmer med perioden i Netvisor. Eller gör dina ändringar, spara dem och klicka på «Skapa en ny tjänst».
Viktigt för löneadministratören
När anställda skapas i Netvisor från Huma, kontrollera följande fält manuellt i Netvisor under «Employee's information»:
- Payroll information: Lönemodellen är satt till «No salary model».
- Settlement points: TyEL är satt till «No handling». Det ger ett fel när du uppdaterar den anställda. Välj en lämplig arbetspensionsförsäkring.
När en anställd slutar
Inaktiverad i Huma:
- Den anställda inaktiveras inte i Netvisor.
- Den anställda låses för uppdateringar från integrationen.
Raderad i Huma:
- Den anställda raderas inte i Netvisor.
- Nästa gång du klickar på «Synkronisera användare» erbjuds du att skapa den anställda i Huma igen.
💡 För att registrera att en anställning avslutas i Netvisor anger du slutdatum och anledning till avslut på tjänsten i Huma.
Ändra inställningar eller anslutningen
- Gå till Netvisor-integrationen i Huma.
- Klicka på ··· uppe till höger.
- Välj ett alternativ:
- «Redigera anslutningsinställningar» för att ändra inställningen eller User ID, Key och Business ID.
- «Redigera anslutningsdetaljer» för att ändra namnet eller vilka som ingår i anslutningen.
Koppla ifrån eller ta bort
- Koppla ifrån: Stoppar synkroniseringen men behåller konfigurationen.
- Ta bort: Stoppar synkroniseringen och raderar all sparad konfiguration.
Fält som stöds
Profilfält
Ändringar i Huma skickas automatiskt. Ändringar i Netvisor hämtas med «Synkronisera användare».
| Fält i Huma | Fält i Netvisor | Obligatoriskt | Kommentar |
|---|---|---|---|
| E-postadress | ✅ | Används för att matcha anställda. Måste vara unik i Huma. När du ändrar e-postadressen i Huma uppdateras den i Netvisor. API-namn: employeebaseinformation.email | |
| Identifikationer | Personal identity code | ✅ | En giltig finsk personbeteckning (HETU) krävs för att skapa anställda i Netvisor. Identitetsnummer från andra länder accepteras när du hämtar anställda från Netvisor till Huma. Kan inte uppdateras eller tömmas av integrationen. API-namn: employeebaseinformation.employeeidentifier |
| Förnamn | First name | ✅ | API-namn: employeebaseinformation.firstname |
| Efternamn | Last name | ✅ | API-namn: employeebaseinformation.lastname |
| Adress | Street address, Municipality, Post number, Country | ✅ | Alla fyra måste vara ifyllda i Netvisor för att adressen ska synkroniseras till Huma. API-namn: streetaddress, municipality, postnumber, country |
| Anställnings-ID | Employee number | Måste vara unikt. Högst 10 tecken. API-namn: employeepayrollinformation.employeenumber | |
| Telefonnummer | Phone number | Måste vara unikt i Huma. API-namn: employeebaseinformation.phonenumber | |
| Nationalitet | Nationality | Om nationalitet saknas i Huma används finsk. Kan uppdateras, men inte tömmas, av integrationen. API-namn: employeebaseinformation.nationality | |
| Kön | Gender | Härleds från personbeteckningen i Netvisor. Hämtas bara till Huma. Kan inte uppdateras eller tömmas av integrationen. API-namn: employeebaseinformation.gender | |
| Födelsedatum | Date of birth | Härleds från personbeteckningen i Netvisor. Hämtas bara till Huma. Kan inte uppdateras eller tömmas av integrationen. API-namn: employeebaseinformation.dateofbirth | |
| Bankkonto | IBAN account number och Bank's BIC code | Bara internationellt format (IBAN och BIC). API-namn: bankaccountnumber, bankidentificationcode |
Tjänstefält (Huma → Netvisor)
Skickas bara när «Tjänster: Skapa, uppdatera och ta bort» är aktiverat.
| Fält i Huma | Fält i Netvisor | Kommentar |
|---|---|---|
| Avtalets startdatum | Start date och Company start date | Obligatoriskt. Används tillsammans med befattningen för att matcha perioden. Kan inte tömmas i Netvisor. API-namn: startdate, companystartdate |
| Befattning | Profession | Obligatoriskt. Används tillsammans med startdatumet för att matcha perioden. Kan inte tömmas i Netvisor. API-namn: profession |
| Avtalets slutdatum | End date | API-namn: enddate |
| Slutdatum för provanställning | Probation end date | API-namn: probationenddate |
| Anställningsprocent | Employment form och Part-time percent | 100 % skickas som heltid. All annan procent skickas som deltid med procenten. API-namn: employmentform, parttimepercent |
| Avtalstyp | Employment method | Se tabellen nedan. API-namn: employmentmode |
| Anledning till avslut | End reason | Se tabellen nedan. API-namn: endreason |
Avtalstyper
| Avtalstyp i Huma | Skickas till Netvisor som |
|---|---|
| Tillsvidareanställning, Visstidsanställning, Säsongsbaserad, Vikariat, Yrkesutbildningsprogram | Employed |
| Konsult, Frilans, Tredje part | Leased employee |
| Praktikant | Trainee |
| Övrig | Skickas inte |
| Employment method i Netvisor | Hämtas till Huma som |
|---|---|
| Employed, Self employed | Tillsvidareanställning |
| Leased employee | Konsult |
| Trainee | Praktikant |
| Voluntary work | Visstidsanställning |
Anledningar till avslut
| Anledning till avslut i Huma | Skickas till Netvisor som |
|---|---|
| Den anställde har sagt upp sig. | Employee's own request |
| Arbetsgivaren har sagt upp den anställde. | Reason attributable to the employee |
| Avtalet, uppdraget eller den tillfälliga anställningen har löpt ut. | Fixed-term employment |
| Förändring i organisationsstruktur eller intern arbetsförflyttning. | Other reason |
| Ändring av lönesystem eller revisor. | Other reason |
| Annan. | Other reason |
⚠️ «Arbetsgivaren har sagt upp den anställde.» skickas som «Reason attributable to the employee». Om uppsägningen berodde på ekonomiska eller produktionsrelaterade skäl, rätta anledningen till avslut i Netvisor.
Felloggen och felsökning
Här hittar du felloggen
- Gå till Netvisor-integrationen i Huma.
- Öppna fliken «Fellogg».
Felen grupperas per dag. Varje post visar ett meddelande, tidpunkten, vilken anställd det gäller och en nivå:
| Nivå | Betydelse |
|---|---|
| 🔴 Fel | Något skickades inte till Netvisor. Du behöver åtgärda det. |
| 🟡 Varning | Något behöver din uppmärksamhet. |
| 🔵 Info | För din information. Ingen åtgärd behövs. |
Integrationens status
| Status på integrationssidan | Vad du gör |
|---|---|
| Den här integrationen har konfigurerats, men är inte aktiv. | Klicka på «Synkronisera användare» för att aktivera den. |
| Ansluten och aktiv | Allt fungerar. |
Vanliga fel
| Problem | Vad det betyder | Så åtgärdar du det |
|---|---|---|
| User must have a position with contract start date to create employee in netvisor | Den anställda har ingen tjänst med startdatum i Huma. | Lägg till en tjänst med startdatum i Huma och klicka på «Synkronisera användare». |
| Netvisor does not allow overlapping employment periods | Tjänsten överlappar en annan anställningsperiod i Netvisor. | Justera datumen så att perioderna inte överlappar. |
| Ingen matchande tjänst hittades | Ingen anställningsperiod i Netvisor har det startdatum och den befattning som tjänsten hade före ändringen. | Jämför perioden i Netvisor med tjänsten i Huma och gör ändringen manuellt i Netvisor. |
| E-postadressen matchar inte vid uppdatering | E-postadressen i Netvisor matchar inte längre den anställda i Huma. | Se till att e-postadressen är densamma i båda systemen och klicka på «Synkronisera användare». |
| Fel vid uppdatering av en anställd som skapats från Huma | TyEL är satt till «No handling» i Netvisor. | Välj en lämplig arbetspensionsförsäkring i Netvisor. |
| Anslutningen till Netvisor slutar fungera | API-identifieraren fungerar inte längre, eller åtkomsträttigheterna för API-resurserna saknas. | Kontrollera API-identifieraren och åtkomsträttigheterna i Netvisor och uppdatera dem under «Redigera anslutningsinställningar». |
Vanliga frågor
Varför syns inte ändringar som jag gör i Netvisor i Huma?
Ändringar går bara automatiskt från Huma till Netvisor. För att hämta ändringar från Netvisor till Huma klickar du på «Synkronisera användare».
Varför skapas inte en ny anställd i Huma i Netvisor?
Anställda skapas aldrig automatiskt. Klicka på «Synkronisera användare» och välj att skapa den anställda i Netvisor. Den anställda behöver en finsk personbeteckning och en tjänst med startdatum.
Kan anställningsperioder överlappa?
Nej. Netvisor tillåter inte överlappande anställningsperioder. Tjänster med överlappande datum skickas inte.
Vad händer i Netvisor när jag raderar en tjänst i Huma?
Huma raderar anställningsperioden med samma startdatum och befattning. Om ingen hittas raderas ingenting.
Kan jag synkronisera frånvaro eller lön med Netvisor?
Nej. Netvisor-integrationen stöder bara profilfält och tjänster.
Kan historiska tjänster överföras?
Nej. Bara tjänster som skapas, uppdateras eller raderas efter att integrationen har blivit aktiv skickas.
Relaterade artiklar
🔗 Kom i gång med löne- och redovisningsintegrationer