HiBob
HiBob-integrationen forbinder mTime med HiBob (Bob), jeres HR-system. Den importerer medarbejdere, ansættelser, afdelinger samt godkendt fravær fra HiBob, så HR-data kun vedligeholdes ét sted: i HiBob. Integrationen læser kun fra HiBob og ændrer aldrig noget dér.
Hvad den synkroniserer
Integrationen importerer følgende fra HiBob til mTime:
- Medarbejdere — navn, e-mail, fødselsdato og lønnummer
- Ansættelser — leder, start- og slutdato, arbejdsmønster og ansættelsestype
- Organisationsenheder — afdelinger bliver til organisationsenheder med den leder som enhedsleder, som flest af afdelingens medlemmer refererer til. Afdelinger, som ingen aktive hører til, udelades.
- Fravær — godkendte fraværsanmodninger, også sygdom, der registreres bagefter, samt annulleringer og ændringer af dem
Fravær, der er importeret fra HiBob, styres af HiBob: det kan ikke ændres eller annulleres i mTime. Se Fravær fra HiBob.
Før du starter: en servicebruger i HiBob
mTime læser fra HiBob som servicebruger. Gå i Bob til Settings > Integrations > Service users, opret en servicebruger til mTime, og notér dens ID og token.
Giv derefter servicebrugeren en rettighedsgruppe. mTime beder kun om det, den læser, og den læser kun: den ændrer aldrig noget i HiBob, så servicebrugeren skal kun have View — aldrig Edit og aldrig View history. Hvor Bob lader dig give adgang til et enkelt felt frem for en hel kategori, så giv kun adgang til felterne nedenfor. HiBob melder ikke fra, når en rettighed mangler — dataene udelades bare — så mTime synkroniserer det, den kan se, og viser resten under Ikke synkroniseret ved seneste kørsel på integrationssiden.
| Rettighed | Hvad mTime læser | Hvad det bruges til | Uden den |
|---|---|---|---|
| Access data for — alle medarbejdere, også fratrådte | Hvilke medarbejdere der findes | Hver medarbejder synkroniseres; fratrådte, så deres ansættelse får sin slutdato | Medarbejdere uden for den synkroniseres ikke. Standarden dækker kun ansatte medarbejdere, så fratrådte beholder en åben ansættelse i mTime. |
| People’s data → Basic info — View | E-mail, fornavn, efternavn | At matche medarbejdere med mTime og give dem navn | Ingen e-mail: gem afvises, da ingen medarbejder kan matches. Intet navn: synkroniseres tomt. |
| People’s data → Personal → Date of birth — View. Valgfri. | Fødselsdato | Fødselsdage i mTime | Synkroniseres tomt. Bob viser kun hele datoen, med årstal, til en bruger, der også må redigere den, så med View alene forbliver fødselsdatoen som regel tom. mTime har ikke brug for den for at synkronisere. |
| People’s data → Work — View på startdato, afdeling, reports to og lønnummerfeltet | Startdato, afdeling, leder (reports to) og som standard lønnummeret | Ansættelsens start, organisationsenhed og leder samt medarbejderens lønnummer | Ingen startdato: ansættelsen synkroniseres ikke. Ingen afdeling eller leder: de bevares, som de er i mTime. Intet lønnummer: synkroniseres tomt. |
People’s data → Lifecycle → Termination date — View kun på dette ene felt (internal.terminationDate) | Fratrædelsesdato | Ansættelsens slutdato | Fratrådte beholder en åben ansættelse i mTime. |
| People’s data → Employment — View på arbejdsmønster, ugentlige timer, FTE og ansættelsestype | Arbejdsmønster, ugentlige timer, FTE, ansættelsestype | Ansættelsens arbejdstidsnorm og dens ansættelsesvilkår via Ansættelsesvilkår pr. type | Arbejdstidsnormen og ansættelsesvilkårene bevares, som de er i mTime. |
| Time off → See who’s out og See who’s out because of a private policy | Godkendt fravær og ændringer af det | Import af fravær | Intet fravær importeres; mTime melder, at den ikke fandt noget for det seneste år. Uden private politikker udelades sygefravær. |
mTime har ikke brug for, og du bør ikke give:
- Lifecycle, ud over fratrædelsesdatoen: hverken lifecycle-tabellen eller felterne status og lifecycle status. HiBob udleverer hele lifecycle-tabellen — inklusive orlovsstatusser og -årsager — og mTime får de datoer, den har brug for, fra startdatoen og fratrædelsesdatoen. Efter en genansættelse flytter HiBob startdatoen til den nye start.
- View history på nogen af tabellerne. mTime læser kun den nuværende post.
- Time off requests (oprette, redigere og annullere), saldi eller fraværsindstillinger. mTime læser godkendt fravær via See who’s out. De politiktyper, der skal angives under Fraværsaktiviteter pr. politiktype , finder du selv i Bobs fraværsindstillinger.
Opsætning i mTime
- Gå til , og vælg HiBob
- Udfyld Service user-ID og Service user-token
- Gennemgå indstillingerne nedenfor — som minimum Fraværsaktiviteter pr. politiktype
- Slå integrationen til, og gem
- Klik på Synkroniser nu for at køre den første synkronisering
Når du gemmer, læser mTime nogle få medarbejdere fra HiBob for at tjekke, at servicebrugeren kan se dem og deres e-mailadresser. Uden dem kan ingen medarbejder synkroniseres, så gem fejler.
Alt andet, servicebrugeren måske ikke kan se — navne, fødselsdatoer, lønnumre, startdatoer, fravær — stopper ikke synkroniseringen: mTime synkroniserer det, den kan, og viser det, den ikke kunne, under Ikke synkroniseret ved seneste kørsel på integrationssiden. Giv View på de nævnte felter i servicebrugerens rettighedsgruppe, så udfylder den næste synkronisering dem.
| Indstilling | Beskrivelse |
|---|---|
| Felt med lønnummer | Det felt i HiBob, der indeholder medarbejderens lønnummer (EE-nummer). Det synkroniseres til attributten Lønnummer. Standard: work.employeeIdInCompany. Ligger lønnummeret i et brugerdefineret felt, angiver du i stedet det felts id. |
| Felt med ansættelsestype | Det felt i HiBob, der indeholder ansættelsestypen. Det synkroniseres til ansættelsens attribut HiBob-ansættelsestype. Standard: payroll.employment.type. |
| Ansættelsesvilkår pr. type | Hvilke ansættelsesvilkår ansættelser af hver HiBob-ansættelsestype får — fx Permanent → jeres almindelige vilkår. Skriv typen, som HiBob viser den. Typer, der ikke står på listen, beholder de vilkår, de har i mTime. |
| Fraværsaktiviteter pr. politiktype | Hvilken fraværsaktivitet i mTime hver HiBob-politiktype registreres på — fx Holiday → Ferie og Sick → Sygdom. Skriv politiktypen, som HiBob viser den. Fravær på en politiktype, der ikke står på listen, importeres ikke og meldes efter hver synkronisering. |
| Importér fravær fra | Hvor langt tilbage den første synkronisering importerer fravær. Lad feltet stå tomt for at starte 1. januar i indeværende år. |
| API-adresse | HiBobs adresse. Behold standarden, medmindre du forbinder til en HiBob-sandbox (https://api.sandbox.hibob.com/v1). |
| Live-opdateringer | Overfører ændringer i HiBob, når de sker, via en webhook i Bob. Slået fra som standard. Se Live-opdateringer. |
| Webhook-signeringsnøgle | Den signeringsnøgle, Bob viser for webhooken. Skal kun bruges til live-opdateringer. |
Sådan matches medarbejdere
Hver HiBob-medarbejder matches med en medarbejder i mTime på HiBob-medarbejder-ID, når en tidligere synkronisering har koblet de to sammen, og ellers på e-mailadresse. Findes der intet match, oprettes en ny medarbejder i mTime.
Fravær fra HiBob
Kun godkendt fravær importeres. Alle slags HiBob-anmodninger kommer med: hele dage, halve dage (formiddag eller eftermiddag), timer på en dag — en anmodning på 6 timer bliver til 6 timers fravær den dag — klokkeslæt, procenter og fravær uden slutdato.
- Den første synkronisering importerer alt godkendt fravær fra datoen i Importér fravær fra og et år frem.
- Hver efterfølgende synkronisering importerer det, der er ændret i HiBob siden sidst: nye anmodninger, sygdom, der er registreret bagefter, og ændrede eller annullerede anmodninger — en anmodning, der annulleres i HiBob, fjernes også fra mTime.
- Saldi bliver i HiBob. Importeret fravær trækker ikke på nogen fraværskonto i mTime.
Styres af HiBob
Fravær fra HiBob er markeret med Styres af HiBob og kan kun ændres i HiBob. I mTime kan ingen — hverken medarbejder, leder eller administrator — ændre, annullere, afbryde eller godkende det, ændre dets timer i tidsregistreringen, registrere andet fravær oven i det eller overskrive det med en Excel-import. Foretag i stedet ændringen i HiBob; den næste synkronisering overfører den til mTime.
Fravær, der er registreret direkte i mTime, berøres ikke — det kan ændres som sædvanligt.
Attributter fra HiBob
Når integrationen er aktiv, tilføjer den skrivebeskyttede attributter til de synkroniserede poster. Attributterne styres af HiBob og kan ikke redigeres i mTime.
| Attribut | Beskrivelse |
|---|---|
| HiBob-medarbejder-ID | Medarbejderens entydige id i HiBob |
| Lønnummer | Medarbejderens lønnummer, læst fra Felt med lønnummer |
| HiBob-ansættelsestype | Ansættelsestypen, læst fra Felt med ansættelsestype |
| HiBob-enheds-ID | Den afdeling, organisationsenheden kommer fra |
Attributterne vises i deres egen sektion på hver post, opkaldt efter integrationen. Se Brugerdefinerede attributter for mere om, hvordan integrationsattributter fungerer.
Hvad du kan forvente efter hver synkronisering
Integrationen synkroniserer én gang hver nat eller med det samme via Synkroniser nu . Efter hver synkronisering:
- Medarbejdere fra HiBob er koblet til deres poster i mTime, og manglende medarbejdere er oprettet — se
- Hver medarbejders ansættelse får leder, datoer, arbejdsmønster og ansættelsestype fra HiBob samt de ansættelsesvilkår, du har knyttet til typen
- Afdelinger er oprettet eller opdateret under . En afdeling, der arkiveres i HiBob, eller som ingen aktive længere hører til, fjernes fra mTime.
- Godkendt fravær er importeret, og fravær, der er annulleret i HiBob, er fjernet
- Alt, hvad synkroniseringen ikke kunne importere — et felt, servicebrugeren ikke kan se, eller fravær på en politiktype, der ikke er knyttet til en aktivitet — står i resultatet af synkroniseringskørslen under
Arbejdsmønstret hentes fra medarbejderens ugentlige, 14-dages eller fleksible mønster i HiBob. Findes der ikke et, bruger mTime de ugentlige timer eller arbejdsstedets arbejdsmønster ganget med medarbejderens FTE.
Hvad der ikke synkroniseres
- Kun den nuværende ansættelse synkroniseres — ikke tidligere ansættelsesperioder og heller ikke historikken over skift af afdeling og leder.
- Teams synkroniseres ikke — kun afdelinger. Teams er et brugerdefineret felt i HiBob, som er sat forskelligt op i hver virksomhed.
- HiBob har intet hierarki af afdelinger, så alle afdelinger står side om side i mTime.
- HiBob har ingen enhedsledere, så mTime vælger den leder, som mere end halvdelen af en afdelings aktive medlemmer refererer til, direkte eller længere oppe i linjen. En afdeling uden en sådan leder beholder den enhedsleder, den har i mTime.
- En afdeling, der slettes helt i HiBob (i stedet for at blive arkiveret), bliver i mTime.
Live-opdateringer
Når Live-opdateringer er slået til, giver HiBob mTime besked om hver ændring, så snart den er foretaget, og mTime overfører den kort efter — en nyansat eller en godkendt ferie skal ikke vente til natten. Den daglige synkronisering kører stadig og indhenter alt, hvad en live-opdatering ikke fik med, for eksempel mens mTime ikke kunne nås.
Live-opdateringer overfører:
- Medarbejdere — en ny, ændret eller fratrædende medarbejder med den nuværende ansættelse, læst på samme måde som ved den daglige synkronisering. En ny medarbejder oprettes i mTime med det samme.
- Fravær — fravær, der godkendes, ændres eller får en slutdato i HiBob, og fravær, der afvises, annulleres eller slettes dér.
Dette venter stadig på den næste daglige synkronisering eller på Synkroniser nu :
- Afdelinger. Nye, omdøbte eller arkiverede afdelinger og ændrede enhedsledere kommer til mTime med den næste synkronisering. En medarbejder, der flyttes til en afdeling, som endnu ikke findes i mTime, beholder sin hidtidige indtil da.
- Ændringer foretaget, mens live-opdateringer var slået fra, eller før webhooken blev tilføjet i Bob.
Hver opdatering, HiBob sender om en medarbejder, vises i med retningen Indgående, så du kan se, om den blev overført, og hvis ikke, hvorfor.
Opsætning af live-opdateringer
Det kræver en HiBob-administrator, der må tilføje webhooks i Bob. Servicebrugeren skal ikke ændres.
- Åbn HiBob under i mTime, slå Live-opdateringer
til, og gem. Siden viser derefter webhookens URL til jeres arbejdsområde — den ender på
/api/webhooks/hibob/efterfulgt af arbejdsområdets id. Du behøver ikke at udfylde servicebrugeren igen for at gemme. - Gå i Bob til Settings > Integrations > Webhooks, og tilføj en webhook:
- Version: 2
- URL: den URL, mTime viser
- Events: hændelserne for medarbejdere (employee), for tabelposter (table entry) og for fraværsanmodninger (time off request)
- Bob viser en signeringsnøgle (signing secret) for webhooken. Indtast den i Webhook-signeringsnøgle i mTime, og gem.
mTime kontrollerer hver opdatering mod signeringsnøglen og afviser dem, der ikke er signeret med den. Indtil nøglen er gemt i mTime, ignoreres opdateringer fra HiBob. Bobs test af webhooken lykkes alligevel, så du kan godt tilføje webhooken, før du indtaster nøglen.
Fejlfinding
Næste skridt
Når integrationen kører, kan du se under Integrationer, hvordan du tjekker synkroniseringsstatus, starter en synkronisering manuelt, justerer indstillinger og løser problemer.