Skip to content

HiBob

HiBob-integrationen kopplar ihop mTime med HiBob (Bob), ert HR-system. Den importerar anställda, anställningar, avdelningar samt godkänd frånvaro från HiBob, så att HR-data bara underhålls på ett ställe: i HiBob. Integrationen läser bara från HiBob och ändrar aldrig något där.

Vad den synkroniserar

Integrationen importerar följande från HiBob till mTime:

  • Anställda — namn, e-post, födelsedatum och lönenummer
  • Anställningar — chef, start- och slutdatum, arbetsmönster och anställningstyp
  • Organisationsenheter — avdelningar blir organisationsenheter, med den chef som enhetschef som de flesta av avdelningens medlemmar rapporterar till. Avdelningar som ingen aktiv tillhör utelämnas.
  • Frånvaro — godkända frånvaroansökningar, även sjukdom som registreras i efterhand, samt när de avbryts eller ändras

Frånvaro som importeras från HiBob hanteras av HiBob: den kan inte ändras eller avbrytas i mTime. Se Frånvaro från HiBob.

Innan du börjar: en tjänsteanvändare i HiBob

mTime läser från HiBob som en tjänsteanvändare (service user). Gå i Bob till Settings > Integrations > Service users, skapa en tjänsteanvändare för mTime och anteckna dess ID och token.

Ge sedan tjänsteanvändaren en behörighetsgrupp. mTime ber bara om det den läser, och den bara läser: den ändrar aldrig något i HiBob, så tjänsteanvändaren behöver bara View — aldrig Edit och aldrig View history. Där Bob låter dig ge behörighet till ett enskilt fält i stället för en hel kategori ger du bara behörighet till fälten nedan. HiBob säger inte till när en behörighet saknas — uppgifterna utelämnas bara — så mTime synkroniserar det den kan se och listar resten under Inte synkroniserat vid senaste körningen på integrationssidan.

BehörighetVad mTime läserVad det används tillUtan den
Access data for — alla anställda, även de som har slutatVilka anställda som finnsVarje anställd synkroniseras; de som har slutat för att deras anställning ska få sitt slutdatumAnställda utanför den synkroniseras inte. Standardinställningen omfattar bara anställda som är kvar, så de som har slutat behåller en öppen anställning i mTime.
People’s data → Basic info — ViewE-post, förnamn, efternamnAtt matcha anställda mot mTime och ge dem namnIngen e-post: det går inte att spara, eftersom ingen anställd kan matchas. Inget namn: synkroniseras tomt.
People’s data → Personal → Date of birth — View. Valfri.FödelsedatumFödelsedagar i mTimeSynkroniseras tomt. Bob visar hela datumet, med årtal, bara för en användare som också får redigera det, så med enbart View förblir födelsedatumet oftast tomt. mTime behöver det inte för att synkronisera.
People’s data → Work — View på startdatum, avdelning, reports to och fältet för lönenummerStartdatum, avdelning, chef (reports to) och som standard lönenumretAnställningens start, organisationsenhet och chef, och den anställdas lönenummerInget startdatum: anställningen synkroniseras inte. Ingen avdelning eller chef: behålls som de är i mTime. Inget lönenummer: synkroniseras tomt.
People’s data → Lifecycle → Termination date — View endast på just det fältet (internal.terminationDate)SlutdatumAnställningens slutdatumDe som har slutat behåller en öppen anställning i mTime.
People’s data → Employment — View på arbetsmönster, veckotimmar, FTE och anställningstypArbetsmönster, veckotimmar, FTE, anställningstypAnställningens arbetstidsnorm och dess anställningsvillkor via Anställningsvillkor per typArbetstidsnormen och anställningsvillkoren behålls som de är i mTime.
Time off → See who’s out, plus See who’s out because of a private policyGodkänd frånvaro och ändringar av denImport av frånvaroIngen frånvaro importeras; mTime meddelar att den inte hittade någon för det senaste året. Utan privata policyer utelämnas sjukfrånvaro.

mTime behöver inte, och du bör inte ge:

  • Lifecycle, utöver slutdatumet: varken lifecycle-tabellen eller fälten status och lifecycle status. HiBob lämnar ut hela lifecycle-tabellen — inklusive ledighetsstatusar och -orsaker — och mTime hämtar de datum den behöver från startdatumet och slutdatumet. Efter en återanställning flyttar HiBob startdatumet till den nya starten.
  • View history på någon tabell. mTime läser bara den nuvarande posten.
  • Time off requests (skapa, redigera och avbryta), saldon eller frånvaroinställningar. mTime läser godkänd frånvaro via See who’s out. De policytyper som ska anges under Frånvaroaktiviteter per policytyp hittar du själv i Bobs frånvaroinställningar.

Så ställer du in den i mTime

  1. Gå till Integrationer och välj HiBob
  2. Fyll i Service user-ID och Service user-token
  3. Gå igenom inställningarna nedan — åtminstone Frånvaroaktiviteter per policytyp
  4. Slå på integrationen och spara
  5. Klicka på Synkronisera nu för att köra den första synkroniseringen

När du sparar läser mTime in några anställda från HiBob för att kontrollera att tjänsteanvändaren ser dem och deras e-postadresser. Utan dem kan ingen anställd synkroniseras, så det går inte att spara.

Allt annat som tjänsteanvändaren kanske inte ser — namn, födelsedatum, lönenummer, startdatum, frånvaro — stoppar inte synkroniseringen: mTime synkroniserar det den kan och listar det den inte kunde under Inte synkroniserat vid senaste körningen på integrationssidan. Ge View på de nämnda fälten i tjänsteanvändarens behörighetsgrupp, så fyller nästa synkronisering i dem.

InställningBeskrivning
Fält med lönenummerFältet i HiBob som innehåller den anställdas lönenummer (EE-nummer). Det synkroniseras till attributet Lönenummer. Standard: work.employeeIdInCompany. Om lönenumret finns i ett eget fält anger du det fältets id i stället.
Fält med anställningstypFältet i HiBob som innehåller anställningstypen. Det synkroniseras till anställningens attribut HiBob-anställningstyp. Standard: payroll.employment.type.
Anställningsvillkor per typVilka anställningsvillkor anställningar av varje HiBob-anställningstyp får — till exempel Permanent → era vanliga villkor. Skriv typen så som HiBob visar den. Typer som inte finns i listan behåller de villkor de har i mTime.
Frånvaroaktiviteter per policytypVilken frånvaroaktivitet i mTime varje HiBob-policytyp registreras på — till exempel Holiday → Semester och Sick → Sjukdom. Skriv policytypen så som HiBob visar den. Frånvaro på en policytyp som inte finns i listan importeras inte och rapporteras efter varje synkronisering.
Importera frånvaro frånHur långt bakåt den första synkroniseringen importerar frånvaro. Lämna tomt för att börja den 1 januari innevarande år.
API-adressHiBobs adress. Behåll standardvärdet, om du inte ansluter till en HiBob-sandlåda (https://api.sandbox.hibob.com/v1).
LiveuppdateringarFör över ändringar i HiBob när de sker, via en webhook i Bob. Avstängt som standard. Se Liveuppdateringar.
Signeringsnyckel för webhookSigneringsnyckeln som Bob visar för webhooken. Behövs bara för liveuppdateringar.

Så matchas anställda

Varje anställd i HiBob matchas mot en anställd i mTime på HiBob-medarbetar-ID när en tidigare synkronisering har kopplat ihop dem, och annars på e-postadress. Om ingen matchning hittas skapas en ny anställd i mTime.

Se till att de anställda har samma e-postadress i båda systemen före den första synkroniseringen — det är det som förhindrar dubbletter.

Frånvaro från HiBob

Bara godkänd frånvaro importeras. Alla typer av ansökningar i HiBob följer med: hela dagar, halva dagar (förmiddag eller eftermiddag), timmar på en dag — en ansökan på 6 timmar blir 6 timmars frånvaro den dagen — klockslag, procentsatser och frånvaro utan slutdatum.

  • Den första synkroniseringen importerar all godkänd frånvaro från datumet i Importera frånvaro från och ett år framåt.
  • Varje följande synkronisering importerar det som har ändrats i HiBob sedan förra gången: nya ansökningar, sjukdom som registrerats i efterhand och ändrade eller avbrutna ansökningar — en ansökan som avbryts i HiBob tas också bort från mTime.
  • Saldona stannar i HiBob. Importerad frånvaro drar inte från något frånvarokonto i mTime.

Hanteras av HiBob

Frånvaro från HiBob visas med etiketten Hanteras av HiBob och kan bara ändras i HiBob. I mTime kan ingen — varken anställd, chef eller administratör — ändra, avbryta, avsluta i förtid eller godkänna den, ändra dess timmar i tidrapporten, boka annan frånvaro ovanpå den eller skriva över den med en Excel-import. Gör ändringen i HiBob i stället; nästa synkronisering för över den till mTime.

Frånvaro som registrerats direkt i mTime påverkas inte — den kan ändras som vanligt.

Attribut som HiBob lägger till

När integrationen är aktiv lägger den till skrivskyddade attribut på synkroniserade poster. Attributen hanteras av HiBob och kan inte redigeras i mTime.

AttributBeskrivning
HiBob-medarbetar-IDDen anställdas unika id i HiBob
LönenummerDen anställdas lönenummer, hämtat från Fält med lönenummer
HiBob-anställningstypAnställningstypen, hämtad från Fält med anställningstyp
HiBob-enhets-IDDen avdelning som organisationsenheten kommer från

De visas i ett eget avsnitt på varje post, med integrationens namn. Se Anpassade attribut för mer om hur integrationsattribut fungerar.

Vad du kan förvänta dig efter varje synkronisering

Integrationen synkroniserar en gång per natt, eller direkt med Synkronisera nu . Efter varje synkronisering:

  • Anställda från HiBob är kopplade till sina poster i mTime, och de som saknades har skapats — se Medarbetare
  • Varje anställds anställning får chef, datum, arbetsmönster och anställningstyp från HiBob, samt de anställningsvillkor du har kopplat till typen
  • Avdelningar har skapats eller uppdaterats under Inställningar › Enheter. En avdelning som arkiveras i HiBob, eller som ingen aktiv längre tillhör, tas bort från mTime.
  • Godkänd frånvaro har importerats, och frånvaro som avbrutits i HiBob har tagits bort
  • Allt som synkroniseringen inte kunde importera — ett fält som tjänsteanvändaren inte ser, eller frånvaro på en policytyp som inte är kopplad — visas i synkroniseringskörningens resultat under Admin › Jobbkörningar

Arbetsmönstret hämtas från den anställdas vecko-, tvåveckors- eller flexibla mönster i HiBob. Finns inget sådant använder mTime veckotimmarna, eller arbetsplatsens arbetsmönster gånger den anställdas tjänstgöringsgrad (FTE).

Vad som inte synkroniseras

  • Bara den nuvarande anställningen synkroniseras — inte tidigare anställningsperioder, och inte heller historiken över byten av avdelning och chef.
  • Team synkroniseras inte — bara avdelningar. Team är ett anpassat fält i HiBob, som är uppsatt olika i varje företag.
  • HiBob har ingen hierarki av avdelningar, så alla avdelningar ligger sida vid sida i mTime.
  • HiBob har inga enhetschefer, så mTime väljer den chef som mer än hälften av en avdelnings aktiva medlemmar rapporterar till, direkt eller längre upp i linjen. En avdelning utan en sådan chef behåller den enhetschef den har i mTime.
  • En avdelning som raderas helt i HiBob (i stället för att arkiveras) finns kvar i mTime.

Liveuppdateringar

När Liveuppdateringar är påslaget meddelar HiBob mTime om varje ändring när den görs, och mTime för över den strax efter — en nyanställning eller en godkänd semester behöver inte vänta till natten. Den dagliga synkroniseringen körs fortfarande och tar igen allt som en liveuppdatering missade, till exempel medan mTime inte gick att nå.

Liveuppdateringar för över:

  • Anställda — en ny, ändrad eller avgående anställd med den nuvarande anställningen, läst på samma sätt som vid den dagliga synkroniseringen. En ny anställd skapas i mTime direkt.
  • Frånvaro — frånvaro som godkänns, ändras eller får ett slutdatum i HiBob, och frånvaro som avslås, avbryts eller raderas där.

Det här väntar fortfarande på nästa dagliga synkronisering, eller på Synkronisera nu :

  • Avdelningar. Nya, omdöpta eller arkiverade avdelningar, och ändrade enhetschefer, kommer till mTime med nästa synkronisering. En anställd som flyttas till en avdelning som ännu inte finns i mTime behåller sin tidigare till dess.
  • Ändringar som gjordes medan liveuppdateringar var avstängda, eller innan webhooken lades till i Bob.

Varje uppdatering som HiBob skickar om en anställd visas i Admin › Integrationslogg med riktningen Inkommande, så att du ser om den tillämpades och i annat fall varför.

Så ställer du in liveuppdateringar

Det kräver en HiBob-administratör som får lägga till webhooks i Bob. Tjänsteanvändaren ändras inte.

  1. Öppna HiBob under Integrationer i mTime, slå på Liveuppdateringar och spara. Sidan visar sedan webhookens URL för er arbetsyta — den slutar på /api/webhooks/hibob/ följt av arbetsytans id. Du behöver inte fylla i tjänsteanvändaren igen för att spara.
  2. Gå i Bob till Settings > Integrations > Webhooks och lägg till en webhook:
    • Version: 2
    • URL: den URL som mTime visar
    • Events: händelserna för anställda (employee), för tabellposter (table entry) och för frånvaroansökningar (time off request)
  3. Bob visar en signeringsnyckel (signing secret) för webhooken. Ange den i Signeringsnyckel för webhook i mTime och spara.

mTime kontrollerar varje uppdatering mot signeringsnyckeln och avvisar de som inte är signerade med den. Tills nyckeln är sparad i mTime ignoreras uppdateringar från HiBob. Bobs test av webhooken lyckas ändå, så du kan lägga till webhooken innan du anger nyckeln.

Felsökning

ProblemLösning
Det går inte att spara: “the HiBob service user may not see these fields: root.email”Ge View på de anställdas e-post i tjänsteanvändarens behörighetsgrupp i HiBob. Spara sedan igen.
Integrationssidan listar fält under Inte synkroniserat vid senaste körningenGe View på de nämnda fälten och deras kategorier i tjänsteanvändarens behörighetsgrupp i HiBob. Nästa synkronisering fyller i dem.
Det går inte att spara: “the HiBob service user can see no employees”Lägg till de anställda under Access data for i tjänsteanvändarens behörighetsgrupp.
Anställda eller slutdatum saknasAccess data for måste omfatta anställda som har slutat, och tjänsteanvändaren behöver View på slutdatumet.
Sjukfrånvaro importeras inteTjänsteanvändaren behöver frånvarobehörigheten för privata policyer, och policytypen för sjukdom måste finnas under Frånvaroaktiviteter per policytyp .
En del frånvaro importeras inteSe synkroniseringskörningens resultat under Admin › Jobbkörningar — frånvaro på en policytyp som inte är kopplad listas där. Lägg till policytypen under Frånvaroaktiviteter per policytyp .
“Hanteras av HiBob” när du ändrar frånvaroFrånvaron kommer från HiBob. Ändra eller avbryt den i HiBob; nästa synkronisering uppdaterar mTime.
Lönenumren är tommaKontrollera att Fält med lönenummer är det fält där lönenumret finns, och att tjänsteanvändaren får se det.
Ändringar i HiBob når mTime först under nattenKontrollera att Liveuppdateringar är påslaget, att webhooken i Bob är version 2 med den URL som mTime visar, och att Signeringsnyckel för webhook innehåller nyckeln som Bob visar. Admin › Integrationslogg visar varje uppdatering som mTime har tagit emot. Nya avdelningar väntar alltid på nästa synkronisering.

Nästa steg

När integrationen är igång, se Integrationer för hur du kontrollerar synkroniseringsstatus, startar manuella synkroniseringar, justerar inställningar och felsöker problem.