Innholdsfortegnelse
- Flere tilkoblinger
- Unimicro
- Sette opp integrasjonen
- Funksjoner som støttes
- Støttede felt: ansattfelt
- Støttede felt: stillingsfelt
- Fravær mellom Unimicro og Huma
- Lønn mellom Unimicro og Huma
- Generelle spørsmål
Flere tilkoblinger
Hvis du trenger å sette opp flere integrasjonsinstanser, følger du veiledningen her.
Har Unimicro-kontoen deres flere «Underenheter», og trenger dere en egen tilkobling for hver? Da må du sette opp én integrasjonsinstans per «Underenhet».
Unimicro
Bruker dere DNB Regnskap, SpareBank 1 Regnskap, Eika Regnskap eller Azets? Da har vi gode nyheter: Huma har nå integrasjon med disse systemene.
Det betyr at du ikke trenger å logge inn i Unimicro hvis dere bruker DNB Regnskap, SpareBank 1 Regnskap, Eika Regnskap eller Azets. Bruk systemet dere har fra listen over.
Sette opp integrasjonen
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 Unimicro for å fullføre oppsettet, kan du kontakte Unimicro support for veiledning.
Kom raskt i gang med disse stegene:
- Gå til Integrasjoner
- Gå til «Unimicro» og klikk «Ny tilkobling»
- Les «Oversikt» og «Detaljer»
- Klikk «Sett opp», fyll inn navn og velg hvem som skal være med i integrasjonen
- Velg miljø og lim inn organisasjonsnummeret
- Slå av eller på innstillingene for «Brukere», «Stillinger», «Lønn» og «Fravær»
- Du blir sendt til Unimicro og bedt om å autorisere tilkoblingen til Unimicro-kontoen deres
- Koble fraværstyper hvis fravær er slått på
- Du må synkronisere brukere manuelt for å aktivere integrasjonen. Klikk «Synkroniser brukere»
Funksjoner som støttes
-
Synkronisere brukere mellom Unimicro og Huma
Når du synkroniserer brukere manuelt, sammenligner Huma brukerne i Unimicro med brukerne i organisasjonen i Huma. Du bestemmer hva som skal skje med verdier som ikke stemmer eller mangler, og med brukere som ikke finnes i begge systemene.
⚠️ Du må synkronisere på nytt for å legge til nye brukere. De blir ikke lagt til automatisk.
-
Hold profilene oppdatert fra Huma til Unimicro i sanntid
Endringer i de støttede profilfeltene blir automatisk oppdatert i Unimicro.
⚠️ Endringer du gjør i Unimicro, blir ikke oppdatert automatisk i Huma. For å få dem inn må du synkronisere manuelt på nytt.
💡Merk Hvis det oppstår en feil under synkroniseringen, finner du detaljert informasjon i «Feillogg» på integrasjonssiden for Unimicro i Huma.
Støttede felt: ansattfelt som synkroniseres
Endringer i støttede felt i Huma (se listen under) oppdateres automatisk i Unimicro i sanntid. Endringer som gjøres i Unimicro, må derimot synkroniseres manuelt til Huma.
| Huma-felt | Unimicro-felt | Merknad |
|---|---|---|
| E-postadresse | employee.businessRelation.emails[].emailAddress | Må være unik i Huma. |
| Ansettelses-ID* (PÅKREVD) | employee.employeeNumber | Integrasjonen kan ikke oppdatere feltet i Unimicro med verdien fra Huma. Må være unik i både Unimicro og Huma. |
| Fornavn | employee.businessRelation.name | |
| Etternavn | employee.businessRelation.name | |
| Telefonnummer | employee.businessRelation.phones[].number | Må være unik i både Unimicro og Huma. |
| Fødselsdato | birthdate | |
| Identifikasjoner |
employee.socialSecurityNumber employee.internationalID employee.internasjonalIDType employee.internasjonalIDCountry |
|
| Adresse | employee.addresses[].address | |
| Kjønn | employee.sex | Unimicro støtter foreløpig bare synkronisering av mann og kvinne. Hvis kjønn ikke er angitt i Unimicro, blir det stående uendret i Huma. Hvis kjønnet er egendefinert i Huma, blir det «ikke angitt» i Unimicro. |
Støttede felt: stillingsfelt som synkroniseres
📄 Les mer om hvordan synkronisering av ansattdata fungerer i integrasjoner generelt.
⚠️ Når du aktiverer integrasjonen, overføres ikke historiske stillingsdata til Unimicro. Bare stillinger som opprettes eller oppdateres i Huma etter at integrasjonen er aktivert, blir synkronisert.
💡 Stillingsdata synkroniseres bare fra Huma til Unimicro, ikke fra Unimicro til Huma.
| Huma-felt | Unimicro-felt | Merknad |
|---|---|---|
| Kontraktstype | employee.employments[].employmentType | Integrasjonen kan ikke sette verdien i Unimicro fra Huma. Oppdateringer og slettinger støttes. |
| Stillingsprosent | employee.employments[].workPercent | Integrasjonen kan ikke sette verdien i Unimicro fra Huma. Oppdateringer og slettinger støttes. |
| Startdato for kontrakt | employee.employments[].startDate | Integrasjonen kan ikke sette verdien i Unimicro fra Huma. Oppdateringer og slettinger støttes. |
| Stillingstittel | employee.employments[].jobName | Integrasjonen kan ikke sette verdien i Unimicro fra Huma. Oppdateringer og slettinger støttes. |
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 Unimicro 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 Unimicro, ikke fra Unimicro til Huma.
⚠️ Bare stillinger som opprettes eller oppdateres etter at integrasjonen er aktivert, blir overført til Unimicro.
Opprette stillinger i Huma
Du kan ikke opprette en stilling i Huma og få den synkronisert slik at den opprettes i Unimicro. Du må først opprette stillingen i Unimicro, og deretter opprette den i Huma. For at synkroniseringen skal fungere, må stillingene være like på disse feltene:
Kontraktstype, Stillingsprosent, Startdato for kontrakt og Stillingstittel.
Oppdaterer integrasjonen stillingsdata?
Ja. Når støttede stillingsfelt endres i Huma, sendes oppdateringen automatisk til Unimicro.
Det gjelder for eksempel når en stilling opprettes, eller når felt som kontraktsdatoer, stillingsprosent eller kontraktstype endres.
I hvilken retning synkroniseres data?
Stillingsdata synkroniseres bare én vei:
Huma → Unimicro
Endringer som gjøres direkte i Unimicro, sendes ikke tilbake til Huma.
Hvordan kobles stillinger mellom Huma og Unimicro?
Stillinger kobles ut fra startdatoen for kontrakten.
Hvis en eksisterende stilling i Unimicro har samme startdato som stillingen som oppdateres i Huma, oppdaterer Huma stillingen i Unimicro med de nye verdiene.
Hvis startdatoen er forskjellig, blir ikke den eksisterende stillingen oppdatert.
Det betyr at når du endrer den første stillingen som Huma oppretter automatisk når Ansatthistorikk lanseres, må startdatoen for stillingen være den samme som for den tilsvarende stillingen i Unimicro.
Når sendes stillingsdata til Unimicro?
Stillingsdata sendes til Unimicro når:
- en ny stilling opprettes i Huma
- en eksisterende stilling oppdateres i Huma
- endringen skjer etter at integrasjonen er aktivert
Kan historiske stillinger overføres?
For å få historiske stillingsdata registrert i Unimicro må du enten gjøre det manuelt, eller oppdatere stillingen i Huma etter at integrasjonen er aktivert.
Integrasjonen overfører ikke historiske stillingsdata som fantes før integrasjonen ble aktivert.
Hvorfor sendes ikke all stillingsinformasjon fra Huma til Unimicro?
Ikke alle stillingsfelt synkroniseres mellom Huma og Unimicro, fordi informasjonen i de to systemene er strukturert forskjellig. Noen felt finnes bare i det ene systemet, eller de har ulik oppbygning eller betydning.
I noen tilfeller skyldes det også tekniske begrensninger i Unimicro sitt API eller i hvordan data håndteres i Huma. På grunn av disse forskjellene er det ikke alltid mulig med en full én-til-én-overføring av alle stillingsfelt mellom systemene.
Hvorfor blir ikke stillingen fjernet i Unimicro når jeg sletter den i Huma?
Dessverre støttes ikke dette, så stillinger må slettes manuelt i Unimicro.
Fravær mellom Unimicro og Huma
⛓️💥 Les mer om hvordan synkronisering av fravær fungerer i integrasjoner generelt.
💡 Synkroniseringen av fravær fungerer bare fra Huma til Unimicro. Fravær som registreres direkte i Unimicro, synkroniseres ikke tilbake til Huma.
Fraværsfelt som synkroniseres
Disse fraværsfeltene synkroniseres fra Huma til Unimicro:
| Huma-felt | Unimicro-felt |
|---|---|
| Fraværstype* (PÅKREVD) | timeoff.code |
| Tidsperiode* (PÅKREVD) | timeoff.fromDate / timeoff.toDate |
| Grad* (PÅKREVD) | timeoff.extent |
| Notat | timeoff.description |
Hvordan kobler jeg fraværstyper mellom Huma og Unimicro?
Gå gjennom fraværstypene i Huma, og velg tilsvarende fraværskode (Timearter) i Unimicro for hver av dem. Riktig kobling er nødvendig for at synkroniseringen skal fungere. En fraværstype som ikke er koblet, blir ikke overført.
- Hvis du allerede har en aktiv integrasjon: Gå til integrasjonssiden i Huma, klikk på de tre prikkene øverst til høyre og velg «Rediger tilkoblingsinnstillinger». Huk av for autoritet og klikk «Neste». Deretter kan du slå på fravær.
- Hvis du setter opp en integrasjon fra bunnen av: Følg disse stegene.
Hvordan kobles fravær mellom Huma og Unimicro?
Fraværet kobles til et arbeidsforhold i Unimicro hvis arbeidsforholdets periode dekker fraværsdatoene. Hvis den ansatte har flere aktive arbeidsforhold som dekker perioden, registreres fraværet på alle, ikke bare på ett.
Hva utløser at fravær sendes til Unimicro?
Et fravær sendes når:
- den ansatte er synkronisert til Unimicro
- fraværstypen er koblet til en fraværskode i Unimicro
- minst ett arbeidsforhold dekker fraværsperioden
- det ikke allerede finnes et overlappende fravær i Unimicro for samme periode
Hva skjer med fraværet i Unimicro når det gjøres endringer i Huma?
Det avhenger av om fraværstypen er endret:
- Samme type: Det eksisterende fraværet i Unimicro blir oppdatert.
- Endret type: Unimicro sletter det gamle fraværet og oppretter et nytt. Da må både den opprinnelige og den nye fraværstypen være koblet til en fraværskode.
💡 Endringen gjøres på alle arbeidsforhold der det opprinnelige fraværet finnes.
Hva skjer hvis et fravær slettes i Huma?
Unimicro finner fraværet eller fraværene som passer med typen og datoperioden, og sletter dem på alle arbeidsforhold som passer.
⚠️ Hvis fraværstypen ikke er koblet til en fraværskode når fraværet slettes, forsøker ikke Huma å slette noe i Unimicro, og det vises ingen feil. Sørg for at koblingen blir stående hvis du har fravær av denne typen som allerede er synkronisert.
Hvorfor blir noen fravær avvist når de registreres i Huma?
Vanlige årsaker:
- Fraværstypen er ikke koblet til en fraværskode i Unimicro
- Ingen arbeidsforhold i Unimicro dekker fraværsperioden
- Det finnes allerede et overlappende fravær i Unimicro for samme periode
For en detaljert forklaring kan du se feilloggen på integrasjonssiden for Unimicro i Huma.
Lønn mellom Unimicro og Huma
💰 Integrasjonen støtter bare lønn i NOK. Lønnsdata i andre valutaer blir avvist og ikke sendt til Unimicro.
⛓️💥 Synkroniseringen av lønn fungerer bare fra Huma til Unimicro.
Lønnsfelt som synkroniseres
| Huma-felt | Unimicro-felt |
|---|---|
| Startdato | EmploymentSalaryHistory.FromDate |
| Lønnsbeløp* (PÅKREVD) | EmploymentSalaryHistory.HourRate / YearRate / MonthRate, avhengig av periodeenhet |
💡Periodeenheten bestemmer hvilket felt beløpet skrives til: månedlig → MonthRate, årlig → YearRate, per time → HourRate.
⚠️ Ukelønn støttes ikke. Unimicro har ikke noe felt for ukesats, så ukelønn blir avvist.
Hvordan slår jeg på synkronisering av lønn?
- Hvis du allerede har en aktiv integrasjon: Gå til integrasjonssiden i Huma, klikk på de tre prikkene øverst til høyre og velg «Rediger tilkoblingsinnstillinger». Huk av for autoritet og klikk «Neste». Deretter kan du slå på lønn.
- Hvis du setter opp en integrasjon fra bunnen av: Følg disse stegene.
Hvordan kobles lønn til riktig arbeidsforhold i Unimicro?
Når lønnen opprettes, kobles den til arbeidsforholdet som har en periode som dekker lønnens startdato. Hvis flere arbeidsforhold passer, brukes det som er merket som standard arbeidsforhold i Unimicro.
Hva skjer hvis jeg endrer eller sletter en lønn som ikke har en tilsvarende registrering i Unimicro?
Når du endrer eller sletter en lønn, ser Huma etter en eksisterende lønnsregistrering i Unimicro med samme startdato som den opprinnelige lønnen. Hvis det ikke finnes noen som passer, blir endringen avvist, og du må gjøre den manuelt i Unimicro.
💡 Unimicro setter automatisk startdatoen for den første lønnsregistreringen til startdatoen for arbeidsforholdet, uansett hvilken dato som er satt i Huma. Det kan gjøre at en senere endring ikke finner riktig registrering første gang, fordi datoene ikke lenger stemmer. Sjekk direkte i Unimicro hvis dette skjer.
Hvordan håndterer integrasjonen ulike valutaer?
Integrasjonen støtter bare lønn i NOK. Lønnsdata i andre valutaer overføres ikke til Unimicro, og det logges en integrasjonsfeil.
Hva skjer når en lønn slettes i Huma?
Den tilsvarende lønnsregistreringen i Unimicro blir slettet, så lenge Huma finner en registrering som passer (se over).
Generelle spørsmål
Hvordan fungerer integrasjonen mellom Huma og Unimicro?
Med integrasjonen kan du synkronisere brukere mellom Huma og Unimicro. Når systemene er koblet sammen, overføres endringer på brukere i Huma automatisk til Unimicro for felt som støttes. Du kan også kjøre en manuell synkronisering for å sammenligne brukerne og håndtere eventuelle forskjeller.
Hva skjer når jeg oppdaterer et felt i Huma?
Hvis et støttet felt endres i Huma, overføres endringen automatisk til Unimicro i sanntid.
Hvis jeg oppdaterer et felt i Unimicro, hvorfor ser jeg ikke endringen i Huma?
Endringer i Unimicro oppdateres ikke automatisk i Huma. For å hente inn oppdateringer fra Unimicro til Huma må du kjøre en manuell synkronisering.
Hvorfor blir det ikke opprettet et arbeidsforhold når jeg legger det til i Huma?
Integrasjonen oppretter ikke arbeidsforhold i Unimicro automatisk. Du må legge dem til manuelt i Unimicro.
Hvordan sørger jeg for at endringer i arbeidsforhold blir oppdatert i Unimicro?
Hvis den ansatte allerede har et standard arbeidsforhold i Unimicro, oppdateres endringer i de støttede feltene i Huma automatisk.
Hvis det ikke finnes noe arbeidsforhold, må du først opprette et manuelt i Unimicro.
Kjør deretter én manuell synkronisering for å koble dataene. Etter det overføres fremtidige oppdateringer fra Huma automatisk.
Hvorfor oppdateres ikke ansettelses-ID-en i Unimicro når jeg endrer den i Huma?
Ansettelses-ID-en kan ikke endres via integrasjonen, fordi den er en unik identifikator i Unimicro. Hvis du endrer den i Huma, må du oppdatere den manuelt i Unimicro for at alt skal stemme.