Skip to content

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.

RettighedHvad mTime læserHvad det bruges tilUden den
Access data for — alle medarbejdere, også fratrådteHvilke medarbejdere der findesHver medarbejder synkroniseres; fratrådte, så deres ansættelse får sin slutdatoMedarbejdere 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 — ViewE-mail, fornavn, efternavnAt matche medarbejdere med mTime og give dem navnIngen e-mail: gem afvises, da ingen medarbejder kan matches. Intet navn: synkroniseres tomt.
People’s data → Personal → Date of birth — View. Valgfri.FødselsdatoFødselsdage i mTimeSynkroniseres 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ønnummerfeltetStartdato, afdeling, leder (reports to) og som standard lønnummeretAnsættelsens start, organisationsenhed og leder samt medarbejderens lønnummerIngen 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ædelsesdatoAnsættelsens slutdatoFratrådte beholder en åben ansættelse i mTime.
People’s data → Employment — View på arbejdsmønster, ugentlige timer, FTE og ansættelsestypeArbejdsmønster, ugentlige timer, FTE, ansættelsestypeAnsættelsens arbejdstidsnorm og dens ansættelsesvilkår via Ansættelsesvilkår pr. typeArbejdstidsnormen 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 policyGodkendt fravær og ændringer af detImport af fraværIntet 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

  1. Gå til Integrationer, og vælg HiBob
  2. Udfyld Service user-ID og Service user-token
  3. Gennemgå indstillingerne nedenfor — som minimum Fraværsaktiviteter pr. politiktype
  4. Slå integrationen til, og gem
  5. 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.

IndstillingBeskrivelse
Felt med lønnummerDet 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ættelsestypeDet felt i HiBob, der indeholder ansættelsestypen. Det synkroniseres til ansættelsens attribut HiBob-ansættelsestype. Standard: payroll.employment.type.
Ansættelsesvilkår pr. typeHvilke 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. politiktypeHvilken 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 fraHvor langt tilbage den første synkronisering importerer fravær. Lad feltet stå tomt for at starte 1. januar i indeværende år.
API-adresseHiBobs adresse. Behold standarden, medmindre du forbinder til en HiBob-sandbox (https://api.sandbox.hibob.com/v1).
Live-opdateringerOverfører ændringer i HiBob, når de sker, via en webhook i Bob. Slået fra som standard. Se Live-opdateringer.
Webhook-signeringsnøgleDen 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.

Sørg for, at medarbejderne har samme e-mailadresse i begge systemer før den første synkronisering — det er det, der forhindrer dubletter.

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.

AttributBeskrivelse
HiBob-medarbejder-IDMedarbejderens entydige id i HiBob
LønnummerMedarbejderens lønnummer, læst fra Felt med lønnummer
HiBob-ansættelsestypeAnsættelsestypen, læst fra Felt med ansættelsestype
HiBob-enheds-IDDen 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 Medarbejdere
  • 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 Indstillinger › Organisationsenheder. 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 Admin › Jobkørsler

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 Admin › Integrationslog 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.

  1. Åbn HiBob under Integrationer 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.
  2. 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)
  3. 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

ProblemLøsning
Gem fejler med “the HiBob service user may not see these fields: root.email”Giv View på medarbejdernes e-mail i servicebrugerens rettighedsgruppe i HiBob. Gem derefter igen.
Integrationssiden viser felter under Ikke synkroniseret ved seneste kørselGiv View på de nævnte felter og deres kategorier i servicebrugerens rettighedsgruppe i HiBob. Den næste synkronisering udfylder dem.
Gem fejler med “the HiBob service user can see no employees”Tilføj medarbejderne under Access data for i servicebrugerens rettighedsgruppe.
Medarbejdere eller slutdatoer manglerAccess data for skal omfatte fratrådte medarbejdere, og servicebrugeren skal have View på fratrædelsesdatoen.
Sygefravær importeres ikkeServicebrugeren skal have fraværsrettigheden til private politikker, og politiktypen for sygdom skal stå under Fraværsaktiviteter pr. politiktype .
Noget fravær importeres ikkeSe resultatet af synkroniseringskørslen under Admin › Jobkørsler — fravær på en politiktype, der ikke er knyttet til en aktivitet, står dér. Tilføj politiktypen under Fraværsaktiviteter pr. politiktype .
“Styres af HiBob”, når du ændrer fraværFraværet kommer fra HiBob. Ændr eller annullér det i HiBob; den næste synkronisering opdaterer mTime.
Lønnumrene er tommeTjek, at Felt med lønnummer er det felt, lønnummeret står i, og at servicebrugeren må se det.
Ændringer i HiBob når først mTime om nattenTjek, at Live-opdateringer er slået til, at webhooken i Bob er version 2 med den URL, mTime viser, og at Webhook-signeringsnøgle indeholder den nøgle, Bob viser. Admin › Integrationslog viser hver opdatering, mTime har modtaget. Nye afdelinger venter altid på den næste synkronisering.

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.