Innholdsfortegnelse
Sette opp integrasjonen
- Flere tilkoblinger
- Steg 1: Lag en API-nøkkel i Finago
- Steg 2: Koble Huma til Finago
- Steg 3: Aktiver integrasjonen, synkroniser brukere og velg hvordan konflikter eller manglende verdier skal håndteres
- Steg 4: Tilkoblingen mellom Huma og Finago er aktiv
Aktiv integrasjon
Finago (24SevenOffice)
Med Finago-integrasjonen kobler du Huma til Finago-kontoen deres, slik at det blir enkelt å importere og synkronisere ansattdata. Det sparer tid og holder HR- og lønnsinformasjonen oppdatert og lik i begge systemene.
-
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 Finago for å fullføre oppsettet, kan du kontakte Finago support for veiledning.
Flere tilkoblinger
Hvis du trenger å sette opp flere integrasjonsinstanser, følger du veiledningen her.
Steg 1: Lag en API-nøkkel i Finago
- Åpne «Innstillinger» i hovedmenyen
- Gå til fanen «Diverse»
- Lag en ny API-nøkkel nederst på siden
- Kopier API-nøkkelen til utklippstavlen
Steg 2: Koble Huma til Finago
- Logg inn i Huma som administrator
- Gå til «Integrasjoner» i hovedmenyen
- Åpne «Finago»
- Les gjennom dokumentasjonen
- Klikk «Sett opp» øverst til høyre
- Velg om dere vil synkronisere stillingsdata
- Lim inn API-nøkkelen du lagde i Finago, 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 Finago. Du bestemmer hvordan konflikter og/eller manglende verdier skal håndteres. Du kan velge om Finago skal oppdateres med verdiene fra Huma, eller omvendt
- Hvis brukere i Finago ikke finnes i Huma, kan du legge dem til i Huma
- Hvis brukere i Huma ikke finnes i Finago, kan du legge dem til i FinagoKlikk «Neste» og velg hvordan brukerne skal synkroniseres mellom Huma og Finago.
- Når du har valgt, klikker du «Synkroniser brukere»
- Huma begynner nå å synkronisere brukerne med Finago. Du får en e-post med resultatet
Steg 4: Tilkoblingen mellom Huma og Finago er aktiv
Endringer i støttede felt i Huma (se listen under) oppdateres automatisk i Finago i sanntid.
Du må synkronisere brukere for å hente inn de siste endringene fra Finago. Endringer i Finago 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 Finago, 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 Finago-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 Finago via integrasjonen.
- Hvis det oppstår en feil under synkroniseringen, finner du detaljert informasjon i «Feillogg» på integrasjonssiden for Finago i Huma.
- Du må synkronisere brukere for å hente inn de siste endringene fra Finago. Endringer i Finago blir ikke oppdatert automatisk i Huma.
Støttede felt: ansattfelt
| Huma-felt | Felt i Finago (24SevenOffice) | Merknad |
|---|---|---|
| E-postadresse* (PÅKREVD) | Må være unik i både Finago og Huma. | |
| Fornavn* (PÅKREVD) | firstname | |
| Etternavn* (PÅKREVD) | lastname | |
| Telefonnummer | telefon | Må være unikt i Huma. |
| Startdato for ansettelsen | startdate | |
| Sluttdato for ansettelsen | enddate | |
| Adresse |
postaddress zipcode city countryCode |
|
| Identifikasjoner |
internationalID.ID internationalID.countryCode internationalID.type |
Integrasjonen kan ikke tømme feltet i Finago når verdien fjernes i Huma. |
| Bankkontonummer | account | Må være et gyldig norsk bankkontonummer. |
|
account clearingno |
Må være et gyldig svensk bankkontonummer. | |
|
account bic |
Fylles ut hvis bankkontonummeret er i internasjonalt format (IBAN). |
Stillinger fra Huma til Finago
📄 Les mer om hvordan synkronisering av ansattdata fungerer i integrasjoner generelt.
⚠️ Når du aktiverer integrasjonen, overføres ikke historiske stillingsdata til Finago. Bare stillinger som opprettes eller oppdateres i Huma etter at integrasjonen er aktivert, blir synkronisert.
💡 Stillingsdata synkroniseres bare fra Huma til Finago, ikke fra Finago til Huma.
Stillingsfelt som synkroniseres
Dette er stillingsfeltene som synkroniseres fra Huma til Finago:
| Huma-felt | Felt i Finago | Merknad |
|---|---|---|
| Kontraktstype | employmentForm | Feltet kan ikke tømmes i Finago. |
| Stillingsprosent | employmentRate | Feltet kan ikke tømmes i Finago. |
| Startdato for kontrakt | startDate | Feltet kan ikke tømmes i Finago. |
| Sluttdato for kontrakt | endDate | |
| Sluttårsak | endReason |
⚠️ Merk
-
Integrasjonen kan ikke slette et arbeidsforhold i Finago. Hvis sluttdatoen for kontrakten eller sluttårsaken fjernes i Huma, blir verdien likevel fjernet i Finago også.
-
Finago tillater overlappende arbeidsforhold. Når du legger til en stilling i Huma, opprettes et nytt arbeidsforhold i Finago. Oppdateringer kobles på startdato.
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 Finago 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»
-
- Alle stillinger som opprettes eller oppdateres i Huma, overføres automatisk til Finago. Hvis startdatoen for kontrakten ikke stemmer med en eksisterende stilling i Finago, opprettes det en ny stilling.
- Stillinger sendes bare fra Huma til Finago, ikke fra Finago til Huma.
- Bare stillinger som opprettes eller oppdateres etter at integrasjonen er aktivert, blir overført til Finago.
Oppdaterer integrasjonen stillingsdata?
Ja. Når støttede stillingsfelt endres i Huma, sendes oppdateringene automatisk til Finago.
Det gjelder blant annet endringer i kontraktsdatoer, stillingsprosent, kontraktstype og sluttårsak.
I hvilken retning synkroniseres data?
Stillingsdata synkroniseres bare én vei:
Huma → Finago
Endringer som gjøres direkte i Finago, sendes ikke tilbake til Huma.
Når sendes stillingsdata til Finago?
Stillingsdata sendes til Finago når:
- en ny stilling opprettes i Huma
- en eksisterende stilling oppdateres i Huma
- endringen skjer etter at integrasjonen er aktivert
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 Finago, eller
- gjøre endringene du vil, lagre og deretter klikke «Opprett ny stilling»
Kan historiske stillinger overføres?
Nei. Integrasjonen overfører ikke automatisk historiske stillingsdata som fantes før integrasjonen ble aktivert.
Hvis historiske data må ligge i Finago, må de legges inn manuelt, eller overføres ved at du oppdaterer stillingen i Huma etter at integrasjonen er slått på.
Hvorfor synkroniseres ikke alle stillingsfelt?
Ikke alle stillingsfelt kan synkroniseres mellom Huma og Finago, fordi de to systemene lagrer og strukturerer informasjon om arbeidsforhold på ulike måter. Noen felt finnes bare i det ene systemet, eller datastrukturene passer ikke direkte sammen. I andre tilfeller er det begrensninger i Finago sitt API eller i hvordan data håndteres i Huma, som gjør at det ikke er mulig med en full én-til-én-overføring mellom systemene.