Innholdsfortegnelse
Sette opp integrasjonen
- Flere tilkoblinger
- Steg 1: Lag en API-identifikator i Netvisor
- Steg 2: Koble Huma til Netvisor
- Steg 3: Aktiver integrasjonen, synkroniser brukere og velg hvordan konflikter eller manglende verdier skal håndteres
- Steg 4: Tilkoblingen mellom Huma og Netvisor er aktiv
Aktiv integrasjon
- Slik synkroniserer du brukere
- Deaktiverte eller slettede brukere
- Viktig informasjon til lønnsansvarlig
- Støttede ansattfelt
- Stillinger mellom Netvisor og Huma
Netvisor
Med Netvisor-integrasjonen kobler du Huma til Netvisor-kontoen deres og synkroniserer ansattdata automatisk. Det sparer tid og holder HR- og lønnsinformasjonen riktig og oppdatert.
For å sette opp en integrasjon i Huma må du ha en «Systemrolle med full tilgang til Organisasjon».
Hvis du er usikker på hvilke roller som kreves i Netvisor for å fullføre oppsettet, kan du kontakte Netvisor support for veiledning.
Flere tilkoblinger
Hvis du trenger å sette opp flere integrasjonsinstanser, følger du veiledningen her.
Steg 1: Lag en API-identifikator i Netvisor
- Logg inn som administrator
- Åpne selskapsmenyen > «API identifiers»
- Lag en ny API-identifikator ved å klikke på knappen til høyre
- Kopier «User ID» og «Key», og lim dem inn i et eget dokument eller notat til senere
- Sjekk at du har riktige tilganger til API-ressursene. Åpne selskapsmenyen > «API resource access rights»
- Bla ned til avsnittet «Salaries» og tillat disse hvis de ikke allerede er tillatt:
- «employee.nv»: Allow
- «getemployee.nv»: Allow
- «getemployees.nv»: Allow
- «patchemployee.nv»: Allow
- Hent «Business ID». Åpne selskapsmenyen > «Service Management»
- Kopier «Business ID», og lim den inn i et eget dokument eller notat til senere
Steg 2: Koble Huma til Netvisor
- Logg inn i Huma som administrator
- Gå til «Integrasjoner»
- Åpne Netvisor
- Les gjennom dokumentasjonen
- Klikk «Sett opp» øverst til høyre
- Velg om stillinger skal sendes til Netvisor når de opprettes, oppdateres eller slettes i Huma
- Lim inn «User ID», «Key» og «Business ID» fra Netvisor, og huk av for at du har nødvendig autoritet
Steg 3: Aktiver integrasjonen
Synkroniser brukere og velg hvordan konflikter eller manglende verdier skal håndteres
- Når du har klikket «Lagre», kommer du til steget for å synkronisere brukere
- Huma viser deg eventuelle konflikter eller forskjeller mellom Huma og Netvisor. Du bestemmer hvordan konflikter og/eller manglende verdier skal håndteres. Du kan velge om Netvisor skal oppdateres med verdiene fra Huma, eller omvendt
- Klikk «Neste» og velg hvordan brukerne skal synkroniseres mellom Huma og Netvisor:
- Hvis brukere i Netvisor ikke finnes i Huma, kan du legge dem til i Huma
- Hvis brukere i Huma ikke finnes i Netvisor, kan du legge dem til i Netvisor
- Når du har valgt, klikker du «Synkroniser brukere»
- Huma begynner nå å synkronisere brukerne med Netvisor. Du får en e-post med resultatet
Steg 4: Tilkoblingen mellom Huma og Netvisor er aktiv
Endringer i støttede felt i Huma (se listen under) oppdateres automatisk i Netvisor i sanntid.
Du må synkronisere brukere for å hente inn de siste endringene fra Netvisor. Endringer i Netvisor blir ikke oppdatert automatisk i Huma.
Slik synkroniserer du brukere
Bruk «Synkroniser brukere» når du har oppdatert et av de støttede feltene i Netvisor, eller når du vil opprette nye brukere. For at synkroniseringen skal fungere, må e-postadressen alltid være lik i begge systemene.
- Gå til Netvisor-integrasjonen i Huma
- Klikk «Synkroniser brukere»
- Følg stegene. Les mer om stegene her
💡 Merk
- Hvis du har opprettet en bruker i Huma, må du gjøre en «Manuell synkronisering» for å opprette brukeren i Netvisor via integrasjonen.
- Hvis det oppstår en feil under synkroniseringen, finner du detaljert informasjon i «Feillogg» på integrasjonssiden for Netvisor i Huma.
- Du må synkronisere brukere for å hente inn de siste endringene fra Netvisor. Endringer i Netvisor blir ikke oppdatert automatisk i Huma.
Deaktiverte eller slettede brukere
Når en bruker deaktiveres i Huma …
- blir brukeren ikke deaktivert i Netvisor
- blir brukeren låst for oppdateringer. Dette skjer først ved en manuell synkronisering
Når en bruker slettes i Huma …
- blir brukeren ikke slettet i Netvisor
- ber den manuelle synkroniseringen deg om å opprette brukeren i Netvisor
- kan brukeren ikke synkroniseres hvis det er gjort endringer på brukeren i Netvisor
Viktig informasjon til lønnsansvarlig
Sørg for at den lønnsansvarlige i organisasjonen kjenner til dette før dere begynner å bruke integrasjonen.
Opprette brukere i Netvisor via synkronisering
Hvis du oppretter brukere i Netvisor via synkronisering fra Huma, bør noen felt sjekkes manuelt i Netvisor.
Under «Employee's information»:
- Payroll information: «Salary model» settes til «No salary model».
- Settlement points: Verdien for TyEL settes til «No handling». Det gir feil når du prøver å oppdatere den ansatte. Du må velge en passende arbeidspensjonsforsikring.
Under «Employments»: Se detaljer om sending av stillinger her.
Støttede ansattfelt
| Huma-felt | Felt i Netvisor | Merknad |
|---|---|---|
| E-postadresse* (PÅKREVD) |
employeebaseinformation.email |
Må være unik i Huma. |
| Identifikasjoner* (PÅKREVD) |
Personal identity code employeebaseinformation.employeeidentifier |
Integrasjonen kan ikke tømme eller oppdatere feltet i Netvisor med verdien fra Huma. Må være et unikt og gyldig finsk personnummer. |
| Fornavn* (PÅKREVD) |
First name employeebaseinformation.firstname |
|
| Etternavn* (PÅKREVD) |
Last name employeebaseinformation.lastname |
|
| Fødselsdato |
Date of birth employeebaseinformation.dateofbirth |
Integrasjonen kan ikke tømme eller oppdatere feltet i Netvisor med verdien fra Huma. |
| Ansettelses-ID |
Employee number employeepayrollinformation.employeenumber |
Må være unik i Netvisor. Maks 10 tegn. |
| Nasjonalitet |
Nationality employeebaseinformation.nationality |
|
| Kjønn |
Gender employeebaseinformation.gender |
Integrasjonen kan ikke tømme eller oppdatere feltet i Netvisor med verdien fra Huma. |
| Adresse* (PÅKREVD) |
Address employeebaseinformation.streetaddress employeebaseinformation.municipality employeebaseinformation.postnumber employeebaseinformation.country |
Alle feltene må være fylt ut i Netvisor for at adressen skal synkroniseres til Huma. |
| Telefonnummer |
Phone number employeebaseinformation.phonenumber |
Må være unikt i Huma. |
| Bankkontonummer |
IBAN account number Bank's BIC code employeebaseinformation.bankaccountnumber employeebaseinformation.bankidentificationcode |
Finsk IBAN. |
Stillinger fra Huma til Netvisor
⚠️ Stillingsdata sendes bare fra Huma til Netvisor, ikke fra Netvisor til Huma.
⚠️ Historiske stillinger overføres ikke automatisk når integrasjonen aktiveres. Bare stillinger som opprettes eller oppdateres i Huma etter aktivering, blir synkronisert.
Disse stillingsfeltene støttes i integrasjonen:
| Huma-felt | Felt i Netvisor |
|---|---|
| Startdato for ansettelsen* (påkrevd) |
employmentperiods[].employmentperiod.startdate employmentperiods[].employmentperiod.companystartdate |
| Stillingstittel* (påkrevd) | employmentperiods[].employmentperiod.profession |
| Kontraktstype | employmentperiods[].employmentperiod.employmentmode |
| Stillingsprosent |
employmentperiods[].employmentperiod.employmentform employmentperiods[].employmentperiod.parttimepercent |
| Sluttdato for prøvetid | employmentperiods[].employmentperiod.probationenddate |
| Sluttdato for ansettelsen | employmentperiods[].employmentperiod.enddate |
| Sluttårsak | employmentperiods[].employmentperiod.endreason |
⚠️ Hvis startdatoen for ansettelsen eller stillingstittelen fjernes i Huma, kan ikke integrasjonen fjerne verdien i Netvisor.
Må jeg slå på synkronisering av stillingsdata?
Ja. Vi anbefaler på det sterkeste at du har en aktiv integrasjon og har slått på synkronisering av «Stillinger» før du begynner å administrere stillinger i Huma.
Slik gjør du det:
- Gå til integrasjonssiden for Netvisor i Huma
- Klikk på de tre prikkene øverst til høyre og velg «Rediger tilkoblingsinnstillinger»
- Huk av for juridisk myndighet og klikk «Fortsett»
- Slå på «Stillinger: opprett, oppdater og slett»
- Stillinger sendes bare fra Huma til Netvisor, ikke fra Netvisor til Huma.
- Bare stillinger som opprettes eller oppdateres etter at integrasjonen er aktivert, blir overført til Netvisor.
Hvordan kobles stillinger mellom Huma og Netvisor?
Stillinger kobles med:
- startdato for kontrakten
- stillingstittel
Når en stilling oppdateres i Huma, bruker integrasjonen de tidligere verdiene i disse feltene til å finne riktig stilling i Netvisor og oppdatere den.
Hvis ingen stilling passer, gir integrasjonen en feilmelding, slik at feil registrering ikke blir oppdatert.
Når opprettes en ny stilling i Netvisor?
En ny stilling opprettes når:
- en stilling legges til på en ansatt i Huma, og
- det ikke finnes noen stilling med samme startdato og stillingstittel i Netvisor
Da oppretter Huma en ny ansettelsesperiode for den ansatte i Netvisor.
Det betyr at når du endrer den første stillingen som Huma oppretter automatisk når Ansatthistorikk lanseres, må du enten:
- sørge for at startdatoen for stillingen er den samme som for den tilsvarende stillingen i Netvisor, eller
- gjøre endringene du vil, lagre og deretter klikke «Opprett ny stilling»
Hva skjer når en stilling oppdateres i Huma?
Når en stilling oppdateres i Huma, prøver integrasjonen å finne den tilsvarende stillingen i Netvisor ved hjelp av de tidligere verdiene for:
- startdato for kontrakten
- stillingstittel
Hvis Huma finner en stilling som passer, oppdateres denne ansettelsesperioden i Netvisor med de nye verdiene.
Hvis Huma ikke finner noen stilling som passer, gir integrasjonen en feilmelding, slik at feil stilling i Netvisor ikke blir oppdatert.
Hva skjer når en stilling slettes i Huma?
Hvis en stilling slettes i Huma, leter integrasjonen etter stillingen i Netvisor som passer med startdato og stillingstittel.
- Hvis Huma finner en stilling som passer, blir ansettelsesperioden slettet i Netvisor.
- Hvis Huma ikke finner noen, blir stillingen ikke slettet, slik at dere ikke mister data ved en feil.
Kan ansettelsesperioder overlappe?
Nei. Netvisor støtter ikke overlappende ansettelsesperioder.
Hvis Huma sender stillinger med overlappende datoer, gir integrasjonen en feilmelding, og oppdateringen feiler.
Hvorfor synkroniseres ikke alle stillingsfelt?
Huma og Netvisor strukturerer ansettelsesdata forskjellig. Noen felt finnes bare i det ene systemet, mens andre lagres i ulike formater. På grunn av disse forskjellene og noen begrensninger i API-et kan ikke alle stillingsfelt synkroniseres én-til-én mellom systemene.
Synkronisering av kontraktstype («Employment method» i Netvisor)
Fra Huma til Netvisor:
| Verdi i Huma | Verdi i Netvisor | |
|---|---|---|
| Vikar/tilkallingshjelp | blir | Employed |
| Konsulent | blir | Leased employee |
| Fast | blir | Employed |
| Midlertidig | blir | Employed |
| Lærling | blir | Trainee |
Fra Netvisor til Huma:
| Verdi i Netvisor | Verdi i Huma | |
|---|---|---|
| Employed | blir | Fast |
| Leased employee | blir | Konsulent |
| Self employed | blir | Fast |
| Trainee | blir | Lærling |
| Voluntary | blir | Midlertidig |