Innhold
- Roller og tilgang
- Slik flyter dataene
- Før du starter
- Sett opp integrasjonen
- Når integrasjonen er aktiv
- Støttede felt
- Feillogg og feilsøking
- Vanlige spørsmål
- Relaterte artikler
Roller og tilgang
| Rolle i Huma | Systemrolle med full tilgang til Organisasjon |
| Rolle i Netvisor | Administrator, slik at du kan lage en API-identifikator og endre tilganger til API-ressurser |
💡 Usikker på hvilke roller du trenger i Netvisor? Kontakt systemadministratoren for Netvisor eller Netvisor support.
💡 Netvisor-integrasjonen er merket som beta i Huma.
Slik flyter dataene
| Data | Huma → Netvisor | Netvisor → Huma | Når |
|---|---|---|---|
| Profilfelt | ✅ Automatisk | ✅ Bare manuelt | Endringer i Huma sendes i sanntid. Endringer i Netvisor hentes inn når du klikker «Synkroniser brukere». |
| Nye ansatte | ✅ Bare manuelt | ✅ Bare manuelt | Når du klikker «Synkroniser brukere» |
| Stillinger (ansettelsesperioder) | ✅ Automatisk, hvis slått på | ❌ | Når en stilling opprettes, endres eller slettes i Huma |
| Fravær | ❌ | ❌ | Støttes ikke |
| Lønn | ❌ | ❌ | Støttes ikke |
⚠️ Historiske data overføres ikke. Bare stillinger som opprettes, endres eller slettes etter at integrasjonen er aktiv, sendes til Netvisor.
Før du starter
- Du har en systemrolle med full tilgang til Organisasjon i Huma.
- Du, eller en kollega, kan logge inn i Netvisor som administrator.
- Ansatte som finnes i begge systemene har samme e-postadresse i Huma og Netvisor. Huma matcher ansatte kun på e-post.
- Ansatte du vil opprette i Netvisor fra Huma, har et finsk personnummer (HETU) og minst én stilling med startdato i Huma.
Sett opp integrasjonen
Steg 1: Lag en API-identifikator i Netvisor
- Logg inn i Netvisor som administrator.
- Åpne selskapsmenyen og velg «API identifiers».
- Lag en ny API-identifikator med knappen til høyre.
- Kopier «User ID» og «Key», og ta vare på dem til senere.
Gi tilgang til API-ressursene
- Åpne selskapsmenyen og velg «API resource access rights».
- Bla ned til avsnittet «Salaries».
- Tillat disse ressursene hvis de ikke allerede er tillatt:
- employee.nv
- getemployee.nv
- getemployees.nv
- patchemployee.nv
- addjobperiod.nv, editjobperiod.nv og deletejobperiod.nv, hvis du skal sende stillinger til Netvisor
Finn Business ID
- Åpne selskapsmenyen og velg «Service Management».
- Kopier «Business ID», og ta vare på den til senere.
Steg 2: Koble Huma til Netvisor
- I Huma, gå til «Integrasjoner» og velg «Netvisor».
- Les fanene «Oversikt» og «Detaljer».
- Klikk «Sett opp» øverst til høyre.
- Gi tilkoblingen et navn.
- Velg hvem som skal være med i tilkoblingen: alle, eller et bestemt team, lokasjon eller selskap.
- Klikk «Fortsett».
- Lim inn User ID, Key og Business ID fra Netvisor.
- Bekreft at du har myndighet til å godta vilkårene på vegne av organisasjonen.
- Klikk «Fortsett».
🔗 Trenger du flere tilkoblinger, for eksempel én per selskap? Se Flere tilkoblinger.
Steg 3: Velg hva som skal synkroniseres
Netvisor har én innstilling. Du kan endre den senere.
| Innstilling | Når den er på | Når den er av |
|---|---|---|
| Stillinger: Opprett, oppdater og slett | Stillinger som opprettes, endres eller slettes i Huma, oppretter, endrer eller sletter den tilsvarende ansettelsesperioden i Netvisor. | Ingen stillingsdata sendes til Netvisor. |
💡 Vi anbefaler at du slår på stillinger før du begynner å administrere stillinger i Huma.
💡 Nye ansatte i Huma opprettes aldri automatisk i Netvisor. Klikk «Synkroniser brukere» for å opprette dem.
Steg 4: Synkroniser brukere for å aktivere integrasjonen
Etter oppsettet står det «Denne integrasjonen er satt opp, men ikke aktiv» på integrasjonssiden. Ingenting sendes før du har fullført dette steget.
- Klikk «Synkroniser brukere».
- Matchende brukere er ansatte med samme e-post i begge systemene.
- Se hvilke felt som har ulike eller manglende verdier.
- For hvert tilfelle velger du om Huma skal oppdateres med verdien fra Netvisor, om Netvisor skal oppdateres med verdien fra Huma, eller om du vil la det være.
- Klikk «Neste».
- Ikke-matchende brukere er ansatte som bare finnes i ett av systemene.
- Velg om du vil opprette alle, bare de du velger, eller ingen.
- Velg retning: Netvisor → Huma, eller Huma → Netvisor.
- Klikk «Synkroniser brukere».
Statusen endres til «Tilkoblet og aktiv». Du får en e-post med resultatet.
💡 Merk
Før du synkroniserer, bør du bestemme hvilket system som har de mest oppdaterte opplysningene. Valgene du gjør her overskriver data.
⚠️ Brukere som mangler påkrevde felt, synkroniseres ikke før verdiene er fylt ut. For å opprette en ansatt i Netvisor må den ansatte ha et finsk personnummer (HETU) og en stilling med startdato i Huma.
Når integrasjonen er aktiv
Dette skjer automatisk
- Endringer i støttede profilfelt i Huma sendes til Netvisor i sanntid.
- Hvis stillinger er slått på, sendes nye, endrede og slettede stillinger i Huma til Netvisor.
Når du må synkronisere manuelt
Klikk «Synkroniser brukere» når:
- Du har endret et støttet felt i Netvisor og vil ha det inn i Huma.
- Du har lagt til ansatte i Netvisor som skal opprettes i Huma.
- Du har lagt til ansatte i Huma som skal opprettes i Netvisor.
Slik sendes stillinger
- Huma kobler stillinger til ansettelsesperioder i Netvisor på startdato og stillingstittel.
- Når du legger til en stilling i Huma, opprettes en ny ansettelsesperiode i Netvisor. Finnes det allerede en periode med samme startdato og stillingstittel, opprettes ingenting nytt.
- Når du endrer en stilling, finner Huma perioden med startdatoen og stillingstittelen stillingen hadde før endringen. Finnes den ikke, sendes ikke endringen, og du får en feil i feilloggen.
- Når du sletter en stilling, sletter Huma den tilsvarende perioden i Netvisor. Finnes den ikke, slettes ingenting.
- Netvisor tillater ikke overlappende ansettelsesperioder. En ny eller endret stilling som overlapper en annen periode, sendes ikke, og du får en feil i feilloggen.
- Når en ansatt opprettes i Netvisor, blir den første stillingen i Huma den første ansettelsesperioden.
💡 Når du endrer den første stillingen som Huma opprettet automatisk da Ansatthistorikk ble lansert, må startdato og stillingstittel være de samme som for perioden i Netvisor. Eller gjør endringene, lagre og klikk «Opprett ny stilling».
Viktig informasjon til lønnsansvarlig
Når ansatte opprettes i Netvisor fra Huma, bør du sjekke disse feltene manuelt i Netvisor under «Employee's information»:
- Payroll information: «Salary model» settes til «No salary model».
- Settlement points: TyEL settes til «No handling». Det gir feil når du oppdaterer den ansatte. Velg en passende arbeidspensjonsforsikring.
Når en ansatt slutter
Deaktivert i Huma:
- Den ansatte deaktiveres ikke i Netvisor.
- Den ansatte låses for oppdateringer fra integrasjonen.
Slettet i Huma:
- Den ansatte slettes ikke i Netvisor.
- Neste gang du klikker «Synkroniser brukere», foreslås det å opprette den ansatte i Huma igjen.
💡 For å registrere at arbeidsforholdet avsluttes i Netvisor, setter du sluttdato og sluttårsak på stillingen i Huma.
Endre innstillinger eller tilkoblingen
- Gå til Netvisor-integrasjonen i Huma.
- Klikk ··· øverst til høyre.
- Velg et alternativ:
- «Rediger tilkoblingsinnstillinger» for å endre innstillingen eller User ID, Key og Business ID.
- «Rediger tilkoblingsdetaljer» for å endre navnet eller hvem som er med i tilkoblingen.
Koble fra eller fjerne
- Koble fra: Stopper synkroniseringen, men beholder oppsettet.
- Fjern: Stopper synkroniseringen og sletter alt lagret oppsett.
Støttede felt
Profilfelt
Endringer i Huma sendes automatisk. Endringer i Netvisor hentes inn med «Synkroniser brukere».
| Felt i Huma | Felt i Netvisor | Påkrevd | Merknader |
|---|---|---|---|
| E-postadresse | ✅ | Brukes til å matche ansatte. Må være unik i Huma. Når du endrer e-posten i Huma, oppdateres den i Netvisor. API-navn: employeebaseinformation.email |
|
| Identifikasjon | Personal identity code | ✅ | Et gyldig finsk personnummer (HETU) kreves for å opprette ansatte i Netvisor. Personnumre fra andre land godtas når du henter ansatte fra Netvisor inn i Huma. Kan ikke oppdateres eller tømmes av integrasjonen. API-navn: employeebaseinformation.employeeidentifier |
| Fornavn | First name | ✅ | API-navn: employeebaseinformation.firstname |
| Etternavn | Last name | ✅ | API-navn: employeebaseinformation.lastname |
| Adresse | Street address, Municipality, Post number, Country | ✅ | Alle fire må være fylt ut i Netvisor for at adressen skal synkroniseres til Huma. API-navn: streetaddress, municipality, postnumber, country |
| Ansatt-ID | Employee number | Må være unik. Maks 10 tegn. API-navn: employeepayrollinformation.employeenumber |
|
| Telefonnummer | Phone number | Må være unikt i Huma. API-navn: employeebaseinformation.phonenumber |
|
| Nasjonalitet | Nationality | Hvis nasjonalitet mangler i Huma, brukes finsk. Kan oppdateres, men ikke tømmes, av integrasjonen. API-navn: employeebaseinformation.nationality |
|
| Kjønn | Gender | Hentes fra personnummeret i Netvisor. Hentes bare inn i Huma. Kan ikke oppdateres eller tømmes av integrasjonen. API-navn: employeebaseinformation.gender |
|
| Fødselsdato | Date of birth | Hentes fra personnummeret i Netvisor. Hentes bare inn i Huma. Kan ikke oppdateres eller tømmes av integrasjonen. API-navn: employeebaseinformation.dateofbirth |
|
| Bankkonto | IBAN account number og Bank's BIC code | Bare internasjonalt format (IBAN og BIC). API-navn: bankaccountnumber, bankidentificationcode |
Stillingsfelt (Huma → Netvisor)
Sendes bare når «Stillinger: Opprett, oppdater og slett» er slått på.
| Felt i Huma | Felt i Netvisor | Merknader |
|---|---|---|
| Kontraktens startdato | Start date og Company start date | Påkrevd. Brukes sammen med stillingstittel til å finne perioden. Kan ikke tømmes i Netvisor. API-navn: startdate, companystartdate |
| Stillingstittel | Profession | Påkrevd. Brukes sammen med startdato til å finne perioden. Kan ikke tømmes i Netvisor. API-navn: profession |
| Kontraktens sluttdato | End date | API-navn: enddate |
| Sluttdato for prøvetid | Probation end date | API-navn: probationenddate |
| Stillingsprosent | Employment form og Part-time percent | 100 % sendes som heltid. Alle andre prosenter sendes som deltid med prosenten. API-navn: employmentform, parttimepercent |
| Kontrakttype | Employment method | Se tabellen under. API-navn: employmentmode |
| Sluttårsak | End reason | Se tabellen under. API-navn: endreason |
Kontrakttyper
| Kontrakttype i Huma | Sendes til Netvisor som |
|---|---|
| Fast, Midlertidig, Sesongbasert, Vikar/tilkallingshjelp, Yrkeskompetanseprogram | Employed |
| Konsulent, Frilans, Tredjepart | Leased employee |
| Lærling | Trainee |
| Annet | Sendes ikke |
| Employment method i Netvisor | Hentes inn i Huma som |
|---|---|
| Employed, Self employed | Fast |
| Leased employee | Konsulent |
| Trainee | Lærling |
| Voluntary work | Midlertidig |
Sluttårsaker
| Sluttårsak i Huma | Sendes til Netvisor som |
|---|---|
| Den ansatte har sagt opp | Employee's own request |
| Arbeidsgiver har sagt opp den ansatte | Reason attributable to the employee |
| Kontrakten, engasjementet eller vikariatet er utløpt | Fixed-term employment |
| Endring i organisasjonsstruktur eller intern jobboverføring | Other reason |
| Endret lønnssystem eller regnskapsfører | Other reason |
| Annen | Other reason |
⚠️ «Arbeidsgiver har sagt opp den ansatte» sendes som «Reason attributable to the employee». Hvis oppsigelsen skyldtes økonomiske eller produksjonsmessige grunner, retter du sluttårsaken i Netvisor.
Feillogg og feilsøking
Her finner du feilloggen
- Gå til Netvisor-integrasjonen i Huma.
- Åpne fanen «Feillogg».
Feilene er gruppert per dag. Hver oppføring viser en melding, tidspunktet, hvilken ansatt den gjelder og et nivå:
| Nivå | Betydning |
|---|---|
| 🔴 Feil | Noe ble ikke sendt til Netvisor. Du må gjøre noe. |
| 🟡 Advarsel | Noe trenger oppmerksomheten din. |
| 🔵 Info | Til informasjon. Du trenger ikke gjøre noe. |
Status for integrasjonen
| Status på integrasjonssiden | Hva du gjør |
|---|---|
| Denne integrasjonen er satt opp, men ikke aktiv | Klikk «Synkroniser brukere» for å aktivere den. |
| Tilkoblet og aktiv | Alt fungerer. |
Vanlige feil
| Problem | Hva det betyr | Slik løser du det |
|---|---|---|
| User must have a position with contract start date to create employee in netvisor | Den ansatte har ingen stilling med startdato i Huma. | Legg til en stilling med startdato i Huma, og klikk «Synkroniser brukere». |
| Netvisor does not allow overlapping employment periods | Stillingen overlapper en annen ansettelsesperiode i Netvisor. | Juster datoene slik at periodene ikke overlapper. |
| Fant ingen matchende stilling | Ingen ansettelsesperiode i Netvisor har startdatoen og stillingstittelen stillingen hadde før endringen. | Sammenlign perioden i Netvisor med stillingen i Huma, og gjør endringen manuelt i Netvisor. |
| Email mismatch when trying to update | E-postadressen i Netvisor stemmer ikke lenger med den ansatte i Huma. | Sørg for at e-postadressen er lik i begge systemene, og klikk «Synkroniser brukere». |
| Feil når en ansatt som er opprettet fra Huma, oppdateres | TyEL er satt til «No handling» i Netvisor. | Velg en passende arbeidspensjonsforsikring i Netvisor. |
| Tilkoblingen til Netvisor slutter å virke | API-identifikatoren virker ikke lenger, eller tilgangene til API-ressursene mangler. | Sjekk API-identifikatoren og tilgangene i Netvisor, og oppdater dem i «Rediger tilkoblingsinnstillinger». |
Vanlige spørsmål
Hvorfor vises ikke endringer jeg gjør i Netvisor i Huma?
Endringer går bare automatisk fra Huma til Netvisor. For å hente endringer fra Netvisor inn i Huma klikker du «Synkroniser brukere».
Hvorfor blir ikke en ny ansatt i Huma opprettet i Netvisor?
Ansatte opprettes aldri automatisk. Klikk «Synkroniser brukere» og velg å opprette den ansatte i Netvisor. Den ansatte må ha et finsk personnummer og en stilling med startdato.
Kan ansettelsesperioder overlappe?
Nei. Netvisor tillater ikke overlappende ansettelsesperioder. Stillinger med overlappende datoer sendes ikke.
Hva skjer i Netvisor når jeg sletter en stilling i Huma?
Huma sletter ansettelsesperioden med samme startdato og stillingstittel. Finnes den ikke, slettes ingenting.
Kan jeg synkronisere fravær eller lønn med Netvisor?
Nei. Netvisor-integrasjonen støtter bare profilfelt og stillinger.
Kan historiske stillinger overføres?
Nei. Bare stillinger som opprettes, endres eller slettes etter at integrasjonen er aktiv, sendes.
Relaterte artikler