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örighet | Vad mTime läser | Vad det används till | Utan den |
|---|---|---|---|
| Access data for — alla anställda, även de som har slutat | Vilka anställda som finns | Varje anställd synkroniseras; de som har slutat för att deras anställning ska få sitt slutdatum | Anstä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 — View | E-post, förnamn, efternamn | Att matcha anställda mot mTime och ge dem namn | Ingen 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ödelsedatum | Födelsedagar i mTime | Synkroniseras 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önenummer | Startdatum, avdelning, chef (reports to) och som standard lönenumret | Anställningens start, organisationsenhet och chef, och den anställdas lönenummer | Inget 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) | Slutdatum | Anställningens slutdatum | De som har slutat behåller en öppen anställning i mTime. |
| People’s data → Employment — View på arbetsmönster, veckotimmar, FTE och anställningstyp | Arbetsmönster, veckotimmar, FTE, anställningstyp | Anställningens arbetstidsnorm och dess anställningsvillkor via Anställningsvillkor per typ | Arbetstidsnormen 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 policy | Godkänd frånvaro och ändringar av den | Import av frånvaro | Ingen 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
- Gå till och välj HiBob
- Fyll i Service user-ID och Service user-token
- Gå igenom inställningarna nedan — åtminstone Frånvaroaktiviteter per policytyp
- Slå på integrationen och spara
- 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ällning | Beskrivning |
|---|---|
| Fält med lönenummer | Fä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ällningstyp | Fältet i HiBob som innehåller anställningstypen. Det synkroniseras till anställningens attribut HiBob-anställningstyp. Standard: payroll.employment.type. |
| Anställningsvillkor per typ | Vilka 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 policytyp | Vilken 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ån | Hur 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-adress | HiBobs adress. Behåll standardvärdet, om du inte ansluter till en HiBob-sandlåda (https://api.sandbox.hibob.com/v1). |
| Liveuppdateringar | För över ändringar i HiBob när de sker, via en webhook i Bob. Avstängt som standard. Se Liveuppdateringar. |
| Signeringsnyckel för webhook | Signeringsnyckeln 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.
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.
| Attribut | Beskrivning |
|---|---|
| HiBob-medarbetar-ID | Den anställdas unika id i HiBob |
| Lönenummer | Den anställdas lönenummer, hämtat från Fält med lönenummer |
| HiBob-anställningstyp | Anställningstypen, hämtad från Fält med anställningstyp |
| HiBob-enhets-ID | Den 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
- 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 . 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
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 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.
- Öppna HiBob under 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. - 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)
- 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
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.