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 Finago | Tilgang til innstillinger, slik at du kan lage en API-nøkkel |
💡 Usikker på hvilke roller du trenger i Finago? Kontakt systemadministratoren for Finago eller Finago support.
Slik flyter dataene
| Data | Huma → Finago | Finago → Huma | Når |
|---|---|---|---|
| Profilfelt | ✅ Automatisk | ✅ Bare manuelt | Endringer i Huma sendes i sanntid. Endringer i Finago hentes inn når du klikker «Synkroniser brukere». |
| Nye ansatte | ✅ Bare manuelt | ✅ Bare manuelt | Når du klikker «Synkroniser brukere» |
| Stillinger (arbeidsforhold) | ✅ Automatisk, hvis slått på | ❌ | Når en stilling opprettes eller oppdateres i Huma |
| Fravær | ❌ | ❌ | Støttes ikke |
| Lønn | ❌ | ❌ | Støttes ikke |
⚠️ Historiske data overføres ikke. Bare stillinger som opprettes eller oppdateres etter at integrasjonen er aktiv, sendes til Finago.
Før du starter
- Du har en systemrolle med full tilgang til Organisasjon i Huma.
- Du, eller en kollega, kan logge inn i Finago og lage en API-nøkkel.
- Ansatte som finnes i begge systemene har samme e-postadresse i Huma og Finago. Huma matcher ansatte kun på e-post.
- Du vet om selskapet i Finago er norsk eller svensk. Huma bruker landet til selskapet for å velge hvilke kontrakttyper og sluttårsaker som sendes.
Sett opp integrasjonen
Steg 1: Lag en API-nøkkel i Finago
- Logg inn i Finago.
- Åpne «Innstillinger» i hovedmenyen.
- Gå til fanen «Diverse».
- Lag en ny API-nøkkel nederst på siden.
- Kopier API-nøkkelen.
Steg 2: Koble Huma til Finago
- I Huma, gå til «Integrasjoner» og velg «Finago».
- 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 API-nøkkelen fra Finago.
- 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
Finago har én innstilling. Du kan endre den senere.
| Innstilling | Når den er på | Når den er av |
|---|---|---|
| Stillinger: Opprett, oppdater og slett | En ny stilling i Huma oppretter et nytt arbeidsforhold i Finago. Endringer på en stilling i Huma oppdaterer det tilsvarende arbeidsforholdet i Finago. | Ingen stillingsdata sendes til Finago. |
⚠️ Stillinger som slettes i Huma, slettes ikke i Finago. Integrasjonen kan ikke slette et arbeidsforhold i Finago, selv om innstillingen nevner sletting.
💡 Vi anbefaler at du slår på stillinger før du begynner å administrere stillinger i Huma.
💡 Nye ansatte i Huma opprettes ikke automatisk i Finago. Klikk «Synkroniser brukere» for å opprette dem i Finago.
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 Finago, om Finago 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: Finago → Huma, eller Huma → Finago.
- 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.
Når integrasjonen er aktiv
Dette skjer automatisk
- Endringer i støttede profilfelt i Huma sendes til Finago i sanntid.
- Hvis stillinger er slått på, sendes nye og oppdaterte stillinger i Huma til Finago.
Når du må synkronisere manuelt
Klikk «Synkroniser brukere» når:
- Du har endret et støttet felt i Finago og vil ha det inn i Huma.
- Du har lagt til ansatte i Finago som skal opprettes i Huma.
- Du har lagt til ansatte i Huma som skal opprettes i Finago.
Slik kobles stillinger
- Finago tillater overlappende arbeidsforhold. Hver nye stilling i Huma oppretter et nytt arbeidsforhold i Finago.
- Når du oppdaterer en stilling, finner Huma arbeidsforholdet i Finago som har samme startdato som stillingen hadde før endringen.
- Hvis ingen arbeidsforhold i Finago har den startdatoen, sendes ikke oppdateringen, og du får en feil i feilloggen.
- Hvis du legger inn en sluttdato uten sluttårsak, får Finago sluttårsaken «Arbeidstaker har sagt opp selv».
💡 Når du endrer den første stillingen som Huma opprettet automatisk da Ansatthistorikk ble lansert, må startdatoen være den samme som for arbeidsforholdet i Finago. Eller gjør endringene, lagre og klikk «Opprett ny stilling».
Når en ansatt slutter
Deaktivert i Huma:
- Den ansatte deaktiveres ikke i Finago.
- Den ansatte låses for oppdateringer fra integrasjonen.
Slettet i Huma:
- Den ansatte slettes ikke i Finago.
- Neste gang du klikker «Synkroniser brukere», foreslås det å opprette den ansatte i Huma igjen.
💡 For å registrere at arbeidsforholdet avsluttes i Finago, setter du sluttdato og sluttårsak på stillingen i Huma.
Endre innstillinger eller API-nøkkel
- Gå til Finago-integrasjonen i Huma.
- Klikk ··· øverst til høyre.
- Velg et alternativ:
- «Rediger tilkoblingsinnstillinger» for å endre innstillingen eller lime inn en ny API-nøkkel.
- «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 Finago hentes inn med «Synkroniser brukere».
| Felt i Huma | Felt i Finago | Påkrevd | Merknader |
|---|---|---|---|
| E-postadresse | E-post | ✅ | Brukes til å matche ansatte. Må være unik i Huma og Finago. Når du endrer e-posten i Huma, oppdateres den i Finago. API-navn: email |
| Fornavn | Fornavn | ✅ | API-navn: firstname |
| Etternavn | Etternavn | ✅ | API-navn: lastname |
| Telefonnummer | Telefon | Må være unikt i Huma. API-navn: telefon |
|
| Adresse | Adresse, Postnummer, Sted, Land | Adresselinjene sendes som én linje, skilt med komma. API-navn: postaddress, zipcode, city, countryCode |
|
| Identifikasjon | Personnummer og Internasjonal ID | Finago har plass til to identifikasjoner. Et norsk fødselsnummer går til personnummer. Én annen identifikasjon går til internasjonal ID. Andre identifikasjoner sendes ikke. Personnummeret tømmes i Finago når du fjerner det i Huma. Internasjonal ID kan ikke tømmes av integrasjonen. Du får en advarsel i feilloggen, og må fjerne den manuelt i Finago. API-navn: personnr, internationalID.ID, internationalID.countryCode, internationalID.type |
|
| Bankkonto | Kontonummer, Clearingnummer, BIC | Norsk konto: kontonummer. Svensk konto: clearingnummer og kontonummer. Internasjonal konto: IBAN og BIC. Kontoen må være gyldig for formatet. API-navn: account, clearingno, bic |
Stillingsfelt (Huma → Finago)
Sendes bare når «Stillinger: Opprett, oppdater og slett» er slått på.
| Felt i Huma | Felt i Finago | Påkrevd | Merknader |
|---|---|---|---|
| Kontraktens startdato | Startdato | Brukes til å koble oppdateringer til riktig arbeidsforhold. Kan ikke tømmes i Finago. API-navn: startdate |
|
| Kontraktens sluttdato | Sluttdato | Tømmes i Finago når du fjerner den i Huma. API-navn: enddate |
|
| Stillingsprosent | Stillingsprosent | Kan ikke tømmes i Finago. API-navn: employment_rate |
|
| Kontrakttype | Ansettelsesform | Se tabellen under. Kan ikke tømmes i Finago. API-navn: employment_form |
|
| Sluttårsak | Sluttårsak | Se tabellen under. Hvis det er sluttdato, men ingen sluttårsak, sendes «Arbeidstaker har sagt opp selv». API-navn: enddate_reason |
Kontrakttyper
| Kontrakttype i Huma | Norsk selskap i Finago | Svensk selskap i Finago |
|---|---|---|
| Fast | Fast | Tillsvidare |
| Midlertidig | Midlertidig | Tidsbegränsad |
| Sesongbasert | Midlertidig | Behovsanställd |
| Vikar/tilkallingshjelp | Midlertidig ansatt som tilkallingsvikar | Behovsanställd |
| Lærling | Midlertidig | Tidsbegränsad |
| Yrkeskompetanseprogram | Midlertidig | Tidsbegränsad |
Sluttårsaker
| Sluttårsak i Huma | Norsk selskap i Finago | Svensk selskap i Finago |
|---|---|---|
| Den ansatte har sagt opp | Arbeidstaker har sagt opp selv | Egen begäran |
| Arbeidsgiver har sagt opp den ansatte | Arbeidsgiver har sagt opp arbeidstaker | Uppsagd arbetsbrist |
| Kontrakten, engasjementet eller vikariatet er utløpt | Kontrakt, engasjement eller vikariat er utløpt | Tidsbegränsad anställning |
| Endring i organisasjonsstruktur eller intern jobboverføring | Endring i organisasjonsstruktur eller byttet jobb internt | Annan orsak |
| Endret lønnssystem eller regnskapsfører | Byttet lønnssystem eller regnskapsfører | Annan orsak |
| Annen | Arbeidsforholdet skulle aldri vært rapportert | Annan orsak |
⚠️ For norske selskaper sendes sluttårsaken «Annen» som «Arbeidsforholdet skulle aldri vært rapportert». Velg en mer presis sluttårsak når du kan.
Feillogg og feilsøking
Her finner du feilloggen
- Gå til Finago-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 Finago. 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 |
|---|---|---|
| We couldn't find a matching position … | Ingen arbeidsforhold i Finago har samme startdato som stillingen du oppdaterte i Huma. | Sjekk at arbeidsforholdet finnes i Finago med samme startdato. Rett startdatoen i ett av systemene, eller opprett en ny stilling i Huma. |
| An identification could not be removed from Finago | Internasjonal ID kan ikke tømmes av integrasjonen. | Fjern internasjonal ID manuelt i Finago. |
| Email mismatch when trying to update | E-postadressen i Finago stemmer ikke lenger med den ansatte i Huma. | Sørg for at e-postadressen er lik i begge systemene, og klikk «Synkroniser brukere». |
| Tilkoblingen til Finago slutter å virke | API-nøkkelen virker ikke lenger, for eksempel fordi den er slettet i Finago. | Lag en ny API-nøkkel i Finago og lim den inn i «Rediger tilkoblingsinnstillinger». |
Vanlige spørsmål
Hvorfor vises ikke endringer jeg gjør i Finago i Huma?
Endringer går bare automatisk fra Huma til Finago. For å hente endringer fra Finago inn i Huma klikker du «Synkroniser brukere».
Hvorfor blir ikke en ny ansatt i Huma opprettet i Finago?
Finago har ingen innstilling for å opprette ansatte automatisk. Klikk «Synkroniser brukere» og velg å opprette den ansatte i Finago.
Hva skjer i Finago når jeg sletter en stilling i Huma?
Ingenting. Integrasjonen kan ikke slette arbeidsforhold i Finago. Fjern arbeidsforholdet manuelt i Finago om nødvendig.
Hvorfor får jeg en feil når jeg oppdaterer en stilling?
Huma kobler stillingen til et arbeidsforhold i Finago på startdato. Hvis ingen arbeidsforhold har samme startdato, feiler oppdateringen. Sjekk startdatoen i begge systemene.
Kan jeg synkronisere fravær eller lønn med Finago?
Nei. Finago-integrasjonen støtter bare profilfelt og stillinger.
Kan historiske stillinger overføres?
Nei. Bare stillinger som opprettes eller oppdateres etter at integrasjonen er aktiv, sendes. For å sende en eldre stilling oppdaterer du den i Huma etter at integrasjonen er slått på.
Relaterte artikler