HiBob
HiBob-integrasjonen kobler mTime til HiBob (Bob), HR-systemet deres. Den importerer ansatte, ansettelser, avdelinger samt godkjent fravær fra HiBob, slik at HR-dataene bare vedlikeholdes ett sted: i HiBob. Integrasjonen leser bare fra HiBob og endrer aldri noe der.
Hva den synkroniserer
Integrasjonen importerer følgende fra HiBob til mTime:
- Ansatte — navn, e-post, fødselsdato og lønnsnummer
- Ansettelser — leder, start- og sluttdato, arbeidsmønster og ansettelsestype
- Organisasjonsenheter — avdelinger blir organisasjonsenheter, med den lederen som enhetsleder som flest av avdelingens medlemmer rapporterer til. Avdelinger som ingen aktive hører til, utelates.
- Fravær — godkjente fraværssøknader, også sykdom som registreres i etterkant, og når de avbrytes eller endres
Fravær som er importert fra HiBob, styres av HiBob: det kan ikke endres eller avbrytes i mTime. Se Fravær fra HiBob.
Før du starter: en tjenestebruker i HiBob
mTime leser fra HiBob som en tjenestebruker (service user). Gå i Bob til Settings > Integrations > Service users, opprett en tjenestebruker for mTime, og noter ID og token.
Gi deretter tjenestebrukeren en tilgangsgruppe. mTime ber bare om det den leser, og den bare leser: den endrer aldri noe i HiBob, så tjenestebrukeren trenger bare View — aldri Edit, og aldri View history. Der Bob lar deg gi tilgang til ett enkelt felt i stedet for en hel kategori, gir du bare tilgang til feltene nedenfor. HiBob sier ikke fra når en tilgang mangler — dataene utelates bare — så mTime synkroniserer det den kan se, og viser resten under Ikke synkronisert ved siste kjøring på integrasjonssiden.
| Tilgang | Hva mTime leser | Hva det brukes til | Uten den |
|---|---|---|---|
| Access data for — alle ansatte, også de som har sluttet | Hvilke ansatte som finnes | Hver ansatt synkroniseres; de som har sluttet, slik at ansettelsen får sluttdato | Ansatte utenfor den synkroniseres ikke. Standarden dekker bare ansatte som fortsatt jobber, så de som har sluttet, beholder en åpen ansettelse i mTime. |
| People’s data → Basic info — View | E-post, fornavn, etternavn | Å koble ansatte til mTime og gi dem navn | Ingen e-post: lagring avvises, fordi ingen ansatt kan kobles. Ikke noe navn: synkroniseres tomt. |
| People’s data → Personal → Date of birth — View. Valgfri. | Fødselsdato | Bursdager i mTime | Synkroniseres tomt. Bob viser hele datoen, med årstall, bare til en bruker som også kan redigere den, så med bare View forblir fødselsdatoen som regel tom. mTime trenger den ikke for å synkronisere. |
| People’s data → Work — View på startdato, avdeling, reports to og lønnsnummerfeltet | Startdato, avdeling, leder (reports to) og som standard lønnsnummeret | Ansettelsens start, organisasjonsenhet og leder, og den ansattes lønnsnummer | Ingen startdato: ansettelsen synkroniseres ikke. Ingen avdeling eller leder: beholdes slik de er i mTime. Ikke noe lønnsnummer: synkroniseres tomt. |
People’s data → Lifecycle → Termination date — View bare på dette ene feltet (internal.terminationDate) | Sluttdato | Ansettelsens sluttdato | De som har sluttet, beholder en åpen ansettelse i mTime. |
| People’s data → Employment — View på arbeidsmønster, ukentlige timer, FTE og ansettelsestype | Arbeidsmønster, ukentlige timer, FTE, ansettelsestype | Ansettelsens arbeidstidsnorm, og ansettelsesvilkårene via Ansettelsesvilkår per type | Arbeidstidsnormen og ansettelsesvilkårene beholdes slik de er i mTime. |
| Time off → See who’s out, pluss See who’s out because of a private policy | Godkjent fravær og endringer i det | Import av fravær | Ikke noe fravær importeres; mTime melder at den ikke fant noe for det siste året. Uten private regelverk utelates sykefravær. |
mTime trenger ikke, og du bør ikke gi:
- Lifecycle, utover sluttdatoen: verken lifecycle-tabellen eller feltene status og lifecycle status. HiBob gir ut hele lifecycle-tabellen — inkludert permisjonsstatuser og -årsaker — og mTime henter datoene den trenger fra startdatoen og sluttdatoen. Etter en gjenansettelse flytter HiBob startdatoen til den nye starten.
- View history på noen tabell. mTime leser bare den nåværende oppføringen.
- Time off requests (opprette, redigere og avbryte), saldoer eller fraværsinnstillinger. mTime leser godkjent fravær via See who’s out. Policytypene du skal fylle inn under Fraværsaktiviteter per policytype , finner du selv i fraværsinnstillingene i Bob.
Oppsett i mTime
- Gå til og velg HiBob
- Fyll inn Service user-ID og Service user-token
- Gå gjennom innstillingene nedenfor — i hvert fall Fraværsaktiviteter per policytype
- Slå på integrasjonen og lagre
- Klikk Synkroniser nå for å kjøre den første synkroniseringen
Når du lagrer, leser mTime inn noen få ansatte fra HiBob for å sjekke at tjenestebrukeren ser dem og e-postadressene deres. Uten dem kan ingen ansatte synkroniseres, så lagringen feiler.
Alt annet tjenestebrukeren kanskje ikke ser — navn, fødselsdatoer, lønnsnumre, startdatoer, fravær — stopper ikke synkroniseringen: mTime synkroniserer det den kan, og viser det den ikke fikk med, under Ikke synkronisert ved siste kjøring på integrasjonssiden. Gi View på de nevnte feltene i tjenestebrukerens tilgangsgruppe, så fyller neste synkronisering dem inn.
| Innstilling | Beskrivelse |
|---|---|
| Felt med lønnsnummer | Feltet i HiBob som inneholder den ansattes lønnsnummer (EE-nummer). Det synkroniseres til attributtet Lønnsnummer. Standard: work.employeeIdInCompany. Ligger lønnsnummeret i et egendefinert felt, oppgir du det feltets id i stedet. |
| Felt med ansettelsestype | Feltet i HiBob som inneholder ansettelsestypen. Det synkroniseres til ansettelsens attributt HiBob-ansettelsestype. Standard: payroll.employment.type. |
| Ansettelsesvilkår per type | Hvilke ansettelsesvilkår ansettelser av hver HiBob-ansettelsestype får — for eksempel Permanent → de vanlige vilkårene deres. Skriv typen slik HiBob viser den. Typer som ikke står i listen, beholder vilkårene de har i mTime. |
| Fraværsaktiviteter per policytype | Hvilken fraværsaktivitet i mTime hver HiBob-policytype registreres på — for eksempel Holiday → Ferie og Sick → Sykdom. Skriv policytypen slik HiBob viser den. Fravær på en policytype som ikke står i listen, importeres ikke og rapporteres etter hver synkronisering. |
| Importer fravær fra | Hvor langt tilbake den første synkroniseringen importerer fravær. La feltet stå tomt for å starte 1. januar i inneværende år. |
| API-adresse | Adressen til HiBob. Behold standarden, med mindre du kobler til en HiBob-sandkasse (https://api.sandbox.hibob.com/v1). |
| Direkteoppdateringer | Overfører endringer i HiBob når de skjer, via en webhook i Bob. Slått av som standard. Se Direkteoppdateringer. |
| Signeringsnøkkel for webhook | Signeringsnøkkelen Bob viser for webhooken. Trengs bare for direkteoppdateringer. |
Slik matches ansatte
Hver ansatt i HiBob matches mot en ansatt i mTime på HiBob-ansatt-ID når en tidligere synkronisering har koblet dem sammen, og ellers på e-postadresse. Finnes det ikke noe treff, opprettes en ny ansatt i mTime.
Fravær fra HiBob
Bare godkjent fravær importeres. Alle slags søknader i HiBob blir med: hele dager, halve dager (formiddag eller ettermiddag), timer på en dag — en søknad på 6 timer blir 6 timers fravær den dagen — klokkeslett, prosenter og fravær uten sluttdato.
- Den første synkroniseringen importerer alt godkjent fravær fra datoen i Importer fravær fra og ett år frem.
- Hver påfølgende synkronisering importerer det som er endret i HiBob siden forrige gang: nye søknader, sykdom registrert i etterkant, og endrede eller avbrutte søknader — en søknad som avbrytes i HiBob, fjernes også fra mTime.
- Saldoene blir i HiBob. Importert fravær trekker ikke fra noen fraværskonto i mTime.
Styres av HiBob
Fravær fra HiBob vises med merket Styres av HiBob og kan bare endres i HiBob. I mTime kan ingen — verken ansatt, leder eller administrator — endre, avbryte, avslutte før tiden eller godkjenne det, endre timene i timelisten, registrere annet fravær oppå det eller overskrive det med en Excel-import. Gjør endringen i HiBob i stedet; neste synkronisering tar den med til mTime.
Fravær som er registrert direkte i mTime, berøres ikke — det kan endres som vanlig.
Attributter lagt til av HiBob
Når integrasjonen er aktiv, legger den til skrivebeskyttede attributter på synkroniserte poster. Attributtene styres av HiBob og kan ikke redigeres i mTime.
| Attributt | Beskrivelse |
|---|---|
| HiBob-ansatt-ID | Den ansattes unike id i HiBob |
| Lønnsnummer | Den ansattes lønnsnummer, hentet fra Felt med lønnsnummer |
| HiBob-ansettelsestype | Ansettelsestypen, hentet fra Felt med ansettelsestype |
| HiBob-enhets-ID | Avdelingen organisasjonsenheten kommer fra |
De vises i en egen seksjon på hver post, med integrasjonens navn. Se Egendefinerte attributter for mer om hvordan integrasjonsattributter fungerer.
Hva du kan forvente etter hver synkronisering
Integrasjonen synkroniserer én gang hver natt, eller med en gang via Synkroniser nå . Etter hver synkronisering:
- Ansatte fra HiBob er koblet til postene sine i mTime, og de som manglet, er opprettet — se
- Hver ansatts ansettelse får leder, datoer, arbeidsmønster og ansettelsestype fra HiBob, og ansettelsesvilkårene du har koblet til typen
- Avdelinger er opprettet eller oppdatert under . En avdeling som arkiveres i HiBob, eller som ingen aktive lenger hører til, fjernes fra mTime.
- Godkjent fravær er importert, og fravær som er avbrutt i HiBob, er fjernet
- Alt synkroniseringen ikke kunne importere — et felt tjenestebrukeren ikke ser, eller fravær på en policytype som ikke er koblet — står i resultatet av synkroniseringskjøringen under
Arbeidsmønsteret hentes fra den ansattes ukentlige, 14-dagers eller fleksible mønster i HiBob. Finnes det ikke, bruker mTime de ukentlige timene, eller arbeidsstedets arbeidsmønster ganget med den ansattes stillingsprosent (FTE).
Hva som ikke synkroniseres
- Bare den nåværende ansettelsen synkroniseres — ikke tidligere ansettelsesperioder, og heller ikke historikken over bytte av avdeling og leder.
- Team synkroniseres ikke — bare avdelinger. Team er et egendefinert felt i HiBob, satt opp ulikt i hver bedrift.
- HiBob har ikke noe hierarki av avdelinger, så alle avdelinger står side om side i mTime.
- HiBob har ingen enhetsledere, så mTime velger den lederen som mer enn halvparten av en avdelings aktive medlemmer rapporterer til, direkte eller lenger opp i linjen. En avdeling uten en slik leder beholder enhetslederen den har i mTime.
- En avdeling som slettes helt i HiBob (i stedet for å arkiveres), blir værende i mTime.
Direkteoppdateringer
Når Direkteoppdateringer er slått på, gir HiBob mTime beskjed om hver endring idet den gjøres, og mTime overfører den kort etter — en nyansatt eller en godkjent ferie trenger ikke å vente til natten. Den daglige synkroniseringen kjører fortsatt og henter inn alt en direkteoppdatering gikk glipp av, for eksempel mens mTime ikke kunne nås.
Direkteoppdateringer overfører:
- Ansatte — en ny, endret eller fratredende ansatt med det nåværende arbeidsforholdet, lest på samme måte som ved den daglige synkroniseringen. En ny ansatt opprettes i mTime med en gang.
- Fravær — fravær som godkjennes, endres eller får en sluttdato i HiBob, og fravær som avslås, avbrytes eller slettes der.
Dette venter fortsatt på neste daglige synkronisering, eller på Synkroniser nå :
- Avdelinger. Nye, omdøpte eller arkiverte avdelinger, og endrede enhetsledere, kommer til mTime med neste synkronisering. En ansatt som flyttes til en avdeling som ennå ikke finnes i mTime, beholder den forrige til da.
- Endringer som ble gjort mens direkteoppdateringer var slått av, eller før webhooken ble lagt til i Bob.
Hver oppdatering HiBob sender om en ansatt, vises i med retningen Innkommende, slik at du ser om den ble tatt i bruk, og hvis ikke, hvorfor.
Oppsett av direkteoppdateringer
Dette krever en HiBob-administrator som kan legge til webhooks i Bob. Tjenestebrukeren endres ikke.
- Åpne HiBob under i mTime, slå på Direkteoppdateringer
og lagre. Siden viser deretter webhookens URL for arbeidsområdet deres — den slutter på
/api/webhooks/hibob/etterfulgt av arbeidsområdets id. Du trenger ikke å fylle inn tjenestebrukeren på nytt for å lagre. - Gå i Bob til Settings > Integrations > Webhooks og legg til en webhook:
- Version: 2
- URL: URL-en mTime viser
- Events: hendelsene for ansatte (employee), for tabelloppføringer (table entry) og for fraværssøknader (time off request)
- Bob viser en signeringsnøkkel (signing secret) for webhooken. Skriv den inn i Signeringsnøkkel for webhook i mTime og lagre.
mTime kontrollerer hver oppdatering mot signeringsnøkkelen og avviser dem som ikke er signert med den. Inntil nøkkelen er lagret i mTime, ignoreres oppdateringer fra HiBob. Bobs test av webhooken lykkes likevel, så du kan legge til webhooken før du skriver inn nøkkelen.
Feilsøking
Neste steg
Når integrasjonen kjører, se Integrasjoner for hvordan du sjekker synkroniseringsstatus, utløser manuelle synkroniseringer, justerer innstillinger og feilsøker problemer.