HiBob
De HiBob-integratie koppelt mTime aan HiBob (Bob), uw HR-systeem. Ze importeert medewerkers, dienstverbanden, afdelingen en goedgekeurd verlof uit HiBob, zodat HR-gegevens op één plek worden bijgehouden: in HiBob. De integratie leest alleen uit HiBob en wijzigt daar nooit iets.
Wat er wordt gesynchroniseerd
De integratie importeert het volgende uit HiBob in mTime:
- Medewerkers — naam, e-mail, geboortedatum en personeelsnummer
- Dienstverbanden — manager, begin- en einddatum, werkpatroon en soort dienstverband
- Organisatie-eenheden — afdelingen worden organisatie-eenheden, met als leidinggevende de manager aan wie de meeste leden van de afdeling rapporteren. Afdelingen waartoe geen actieve medewerker behoort, worden weggelaten.
- Verlof — goedgekeurde verlofaanvragen, ook ziekte die achteraf wordt geregistreerd, en het annuleren of wijzigen ervan
Verlof dat uit HiBob is geïmporteerd, wordt beheerd door HiBob: het kan in mTime niet worden gewijzigd of geannuleerd. Zie Verlof uit HiBob.
Voordat u begint: een service user in HiBob
mTime leest uit HiBob als service user (servicegebruiker). Ga in Bob naar Settings > Integrations > Service users, maak er een aan voor mTime en noteer de ID en het token.
Geef de service user daarna een machtigingsgroep. mTime vraagt alleen om wat het leest, en leest alleen: het wijzigt nooit iets in HiBob, dus de service user heeft alleen View nodig — nooit Edit, en nooit View history. Waar Bob het toestaat om één veld toe te kennen in plaats van een hele categorie, kent u alleen de velden hieronder toe. HiBob meldt een ontbrekende machtiging niet — de gegevens worden gewoon weggelaten — dus synchroniseert mTime wat het kan zien en toont het de rest onder Niet gesynchroniseerd bij de laatste run op de integratiepagina.
| Machtiging | Wat mTime leest | Waarvoor het wordt gebruikt | Zonder deze machtiging |
|---|---|---|---|
| Access data for — alle medewerkers, ook uit dienst getreden medewerkers | Welke medewerkers er zijn | Elke medewerker gesynchroniseerd; uit dienst getreden medewerkers zodat hun dienstverband een einddatum krijgt | Medewerkers die er niet onder vallen, worden niet gesynchroniseerd. Standaard vallen alleen medewerkers in dienst eronder, dus vertrokken medewerkers houden een open dienstverband in mTime. |
| People’s data → Basic info — View | E-mail, voornaam, achternaam | Medewerkers aan mTime koppelen en een naam geven | Geen e-mail: opslaan wordt geweigerd, omdat geen medewerker kan worden gekoppeld. Geen naam: leeg gesynchroniseerd. |
| People’s data → Personal → Date of birth — View. Optioneel. | Geboortedatum | Verjaardagen in mTime | Leeg gesynchroniseerd. Bob toont de volledige datum, met het jaar, alleen aan een gebruiker die hem ook mag bewerken, dus met alleen View blijft de geboortedatum meestal leeg. mTime heeft hem niet nodig om te synchroniseren. |
| People’s data → Work — View op begindatum, afdeling, reports to en het veld voor het personeelsnummer | Begindatum, afdeling, manager (reports to) en standaard het personeelsnummer | Het begin, de organisatie-eenheid en de manager van het dienstverband, en het personeelsnummer van de medewerker | Geen begindatum: het dienstverband wordt niet gesynchroniseerd. Geen afdeling of manager: blijven zoals ze in mTime zijn. Geen personeelsnummer: leeg gesynchroniseerd. |
People’s data → Lifecycle → Termination date — View op alleen dit ene veld (internal.terminationDate) | Uitdiensttredingsdatum | De einddatum van het dienstverband | Vertrokken medewerkers houden een open dienstverband in mTime. |
| People’s data → Employment — View op werkpatroon, uren per week, FTE en soort dienstverband | Werkpatroon, uren per week, FTE, soort dienstverband | De werktijdnorm van het dienstverband, en de arbeidsvoorwaarden via Arbeidsvoorwaarden per type | De werktijdnorm en de arbeidsvoorwaarden blijven zoals ze in mTime zijn. |
| Time off → See who’s out, plus See who’s out because of a private policy | Goedgekeurd verlof en wijzigingen daarin | Verlof importeren | Er wordt geen verlof geïmporteerd; mTime meldt dat het voor het afgelopen jaar geen verlof heeft gevonden. Zonder privébeleid wordt ziekteverlof weggelaten. |
mTime heeft het volgende niet nodig, en u kent het beter niet toe:
- Lifecycle, behalve de uitdiensttredingsdatum: niet de lifecycle-tabel, en ook niet de velden status of lifecycle status. HiBob geeft de hele lifecycle-tabel vrij — inclusief verlofstatussen en -redenen — en mTime haalt de datums die het nodig heeft uit de begindatum en de uitdiensttredingsdatum. Na een herindiensttreding verschuift HiBob de begindatum naar het nieuwe begin.
- View history op welke tabel dan ook. mTime leest alleen het huidige item.
- Time off requests (aanmaken, bewerken en annuleren), saldi of verlofinstellingen. mTime leest goedgekeurd verlof via See who’s out. De beleidstypen die u onder Verlofactiviteiten per beleidstype invult, zoekt u zelf op in de verlofinstellingen van Bob.
Instellen in mTime
- Ga naar en kies HiBob
- Vul de Service user-ID en het Service user-token in
- Controleer de instellingen hieronder — in elk geval Verlofactiviteiten per beleidstype
- Schakel de integratie in en sla op
- Klik op Synchroniseer nu om de eerste synchronisatie uit te voeren
Bij het opslaan leest mTime een paar medewerkers uit HiBob om te controleren of de service user hen en hun e-mailadressen kan zien. Zonder die gegevens kan geen enkele medewerker worden gesynchroniseerd, dus mislukt het opslaan.
Al het andere dat de service user mogelijk niet ziet — namen, geboortedatums, personeelsnummers, begindatums, verlof — houdt de synchronisatie niet tegen: mTime synchroniseert wat het kan en toont wat niet lukte onder Niet gesynchroniseerd bij de laatste run op de integratiepagina. Geef View op de genoemde velden in de machtigingsgroep van de service user, en de volgende synchronisatie vult ze in.
| Instelling | Beschrijving |
|---|---|
| Veld met personeelsnummer | Het HiBob-veld met het personeelsnummer (EE-nummer) van de medewerker. Het wordt gesynchroniseerd naar het attribuut Salarisadministratienummer. Standaard: work.employeeIdInCompany. Staat het nummer in een aangepast veld, vul dan de id van dat veld in. |
| Veld met soort dienstverband | Het HiBob-veld met het soort dienstverband. Het wordt gesynchroniseerd naar het attribuut HiBob-dienstverbandtype van het dienstverband. Standaard: payroll.employment.type. |
| Arbeidsvoorwaarden per type | Welke arbeidsvoorwaarden dienstverbanden van elk HiBob-dienstverbandtype krijgen — bijvoorbeeld Permanent → uw standaardvoorwaarden. Vul het type in zoals HiBob het toont. Typen die niet in de lijst staan, houden de arbeidsvoorwaarden die ze in mTime hebben. |
| Verlofactiviteiten per beleidstype | Op welke verlofactiviteit in mTime elk HiBob-beleidstype wordt geregistreerd — bijvoorbeeld Holiday → Vakantie en Sick → Ziekte. Vul het beleidstype in zoals HiBob het toont. Verlof op een beleidstype dat niet in de lijst staat, wordt niet geïmporteerd en na elke synchronisatie gemeld. |
| Verlof importeren vanaf | Hoe ver terug de eerste synchronisatie verlof importeert. Laat leeg om te beginnen op 1 januari van het lopende jaar. |
| API-adres | Het adres van HiBob. Laat de standaardwaarde staan, tenzij u verbinding maakt met een HiBob-sandbox (https://api.sandbox.hibob.com/v1). |
| Live-updates | Voert wijzigingen in HiBob door zodra ze plaatsvinden, via een webhook in Bob. Standaard uit. Zie Live-updates. |
| Ondertekeningsgeheim van de webhook | Het ondertekeningsgeheim dat Bob voor de webhook toont. Alleen nodig voor live-updates. |
Hoe medewerkers worden gekoppeld
Elke HiBob-medewerker wordt aan een mTime-medewerker gekoppeld op HiBob-medewerker-ID zodra een eerdere synchronisatie de twee heeft verbonden, en anders op e-mailadres. Wordt er geen overeenkomst gevonden, dan wordt in mTime een nieuwe medewerker aangemaakt.
Verlof uit HiBob
Alleen goedgekeurd verlof wordt geïmporteerd. Elke soort HiBob-aanvraag komt mee: hele dagen, halve dagen (ochtend of middag), uren op een dag — een aanvraag van 6 uur wordt 6 uur verlof op die dag —, tijdstippen, percentages en verlof zonder einddatum.
- De eerste synchronisatie importeert al het goedgekeurde verlof vanaf de datum in Verlof importeren vanaf tot een jaar vooruit.
- Elke volgende synchronisatie importeert wat er sinds de vorige in HiBob is veranderd: nieuwe aanvragen, achteraf geregistreerde ziekte en gewijzigde of geannuleerde aanvragen — een aanvraag die in HiBob wordt geannuleerd, verdwijnt ook uit mTime.
- Saldi blijven in HiBob. Geïmporteerd verlof gaat niet af van een verlofaccount in mTime.
Beheerd door HiBob
Verlof uit HiBob staat aangeduid met Beheerd door HiBob en kan alleen in HiBob worden gewijzigd. In mTime kan niemand — medewerker, manager of beheerder — het wijzigen, annuleren, onderbreken of goedkeuren, de uren ervan op de urenstaat aanpassen, ander verlof eroverheen boeken of het overschrijven met een Excel-import. Breng de wijziging in HiBob aan; de volgende synchronisatie neemt ze over in mTime.
Verlof dat rechtstreeks in mTime is geregistreerd, valt hier niet onder — dat wijzigt u zoals gewoonlijk.
Attributen toegevoegd door HiBob
Als de integratie actief is, voegt ze alleen-lezen attributen toe aan gesynchroniseerde records. Deze attributen worden beheerd door HiBob en kunnen in mTime niet worden bewerkt.
| Attribuut | Beschrijving |
|---|---|
| HiBob-medewerker-ID | De unieke id van de medewerker in HiBob |
| Salarisadministratienummer | Het personeelsnummer van de medewerker, gelezen uit het Veld met personeelsnummer |
| HiBob-dienstverbandtype | Het soort dienstverband, gelezen uit het Veld met soort dienstverband |
| HiBob-eenheid-ID | De afdeling waar de organisatie-eenheid vandaan komt |
Ze verschijnen op elk record in een eigen gedeelte, met de naam van de integratie. Zie Aangepaste attributen voor meer informatie over hoe integratie-attributen werken.
Wat u kunt verwachten na elke synchronisatie
De integratie synchroniseert eenmaal per nacht, of direct met Synchroniseer nu . Na elke synchronisatie:
- Zijn medewerkers uit HiBob gekoppeld aan hun record in mTime, en zijn ontbrekende medewerkers aangemaakt — zie
- Krijgt het dienstverband van elke medewerker de manager, datums, het werkpatroon en het soort dienstverband uit HiBob, en de arbeidsvoorwaarden die u aan dat type hebt gekoppeld
- Zijn afdelingen aangemaakt of bijgewerkt in . Een afdeling die in HiBob wordt gearchiveerd, of waartoe geen actieve medewerker meer behoort, wordt uit mTime verwijderd.
- Is goedgekeurd verlof geïmporteerd en is verlof dat in HiBob is geannuleerd, verwijderd
- Staat alles wat de synchronisatie niet kon importeren — een veld dat de service user niet ziet, verlof op een beleidstype zonder koppeling — in het resultaat van de synchronisatierun onder
Het werkpatroon komt uit het wekelijkse, tweewekelijkse of flexibele patroon van de medewerker in HiBob. Is dat er niet, dan gebruikt mTime de uren per week, of het werkpatroon van de vestiging vermenigvuldigd met de FTE van de medewerker.
Wat niet wordt gesynchroniseerd
- Alleen het huidige dienstverband wordt gesynchroniseerd — geen eerdere dienstverbandperiodes en ook niet de geschiedenis van afdelings- en managerwissels.
- Teams worden niet gesynchroniseerd — alleen afdelingen. Teams zijn in HiBob een aangepast veld, dat in elk bedrijf anders is ingericht.
- HiBob kent geen hiërarchie van afdelingen, dus staan alle afdelingen in mTime naast elkaar.
- HiBob kent geen leidinggevenden van eenheden, dus kiest mTime de manager aan wie meer dan de helft van de actieve leden van een afdeling rapporteert, direct of hogerop in de lijn. Een afdeling zonder zo’n manager houdt de leidinggevende die ze in mTime heeft.
- Een afdeling die in HiBob helemaal wordt verwijderd (in plaats van gearchiveerd), blijft in mTime staan.
Live-updates
Als Live-updates aan staat, meldt HiBob elke wijziging aan mTime zodra die is gedaan, en mTime voert hem kort daarna door: een nieuwe medewerker of goedgekeurde vakantie hoeft niet op de nacht te wachten. De dagelijkse synchronisatie blijft lopen en haalt alles in wat een live-update heeft gemist, bijvoorbeeld terwijl mTime niet bereikbaar was.
Live-updates brengen over:
- Medewerkers — een nieuwe, gewijzigde of vertrekkende medewerker, met het huidige dienstverband, gelezen zoals de dagelijkse synchronisatie dat doet. Een nieuwe medewerker wordt meteen in mTime aangemaakt.
- Verlof — verlof dat in HiBob wordt goedgekeurd, gewijzigd of een einddatum krijgt, en verlof dat daar wordt afgewezen, geannuleerd of verwijderd.
Dit wacht nog steeds op de volgende dagelijkse synchronisatie, of op Synchroniseer nu :
- Afdelingen. Nieuwe, hernoemde of gearchiveerde afdelingen, en gewijzigde leidinggevenden, komen met de volgende synchronisatie in mTime. Een medewerker die naar een afdeling gaat die nog niet in mTime staat, houdt tot dan zijn vorige.
- Wijzigingen die zijn gedaan terwijl live-updates uit stonden, of voordat de webhook in Bob was toegevoegd.
Elke update die HiBob over een medewerker stuurt, staat in met de richting Inkomend, zodat u ziet of hij is doorgevoerd en zo niet, waarom.
Live-updates instellen
Hiervoor is een HiBob-beheerder nodig die webhooks in Bob mag toevoegen. De service user verandert niet.
- Open in mTime HiBob onder , zet Live-updates
aan en sla op. De pagina toont dan de URL van de webhook voor uw werkruimte: die eindigt op
/api/webhooks/hibob/gevolgd door de id van de werkruimte. U hoeft de service user niet opnieuw in te vullen om op te slaan. - Ga in Bob naar Settings > Integrations > Webhooks en voeg een webhook toe:
- Version: 2
- URL: de URL die mTime toont
- Events: de gebeurtenissen voor medewerkers (employee), voor tabelregels (table entry) en voor verlofaanvragen (time off request)
- Bob toont een ondertekeningsgeheim (signing secret) voor de webhook. Vul het in bij Ondertekeningsgeheim van de webhook in mTime en sla op.
mTime controleert elke update met het ondertekeningsgeheim en weigert updates die er niet mee zijn ondertekend. Zolang het geheim niet in mTime is opgeslagen, worden updates uit HiBob genegeerd. De test van de webhook in Bob slaagt wel, dus u kunt de webhook toevoegen voordat u het geheim invult.
Problemen oplossen
Vervolgstappen
Zodra de integratie actief is, raadpleegt u Integraties voor informatie over het controleren van de synchronisatiestatus, het handmatig starten van synchronisaties, het aanpassen van instellingen en het oplossen van problemen.