HiBob
L’intégration HiBob relie mTime à HiBob (Bob), votre système RH. Elle importe depuis HiBob les employés, les emplois, les départements, ainsi que les absences approuvées : les données RH sont ainsi tenues à un seul endroit, dans HiBob. L’intégration ne fait que lire HiBob et n’y modifie jamais rien.
Ce qu’elle synchronise
L’intégration importe dans mTime les éléments suivants depuis HiBob :
- Employés — nom, e-mail, date de naissance et numéro de paie
- Emplois — responsable, dates de début et de fin, rythme de travail et type de contrat
- Unités organisationnelles — les départements deviennent des unités organisationnelles, dirigées par le responsable dont relèvent la plupart des membres du département. Les départements auxquels aucun employé actif n’appartient sont laissés de côté.
- Absences — les demandes d’absence approuvées, y compris les arrêts maladie saisis après coup, ainsi que leurs annulations et modifications
Les absences importées depuis HiBob sont gérées par HiBob : elles ne peuvent être ni modifiées ni annulées dans mTime. Voir Absences venant de HiBob.
Avant de commencer : un service user dans HiBob
mTime lit HiBob en tant que service user (utilisateur de service). Dans Bob, allez dans Settings > Integrations > Service users, créez-en un pour mTime et notez son ID et son jeton (token).
Attribuez-lui ensuite un groupe d’autorisations. mTime ne demande que ce qu’il lit, et ne fait que lire : il ne modifie jamais rien dans HiBob, le service user n’a donc besoin que de View — jamais d’Edit, ni de View history. Là où Bob permet d’accorder un champ précis plutôt qu’une catégorie entière, n’accordez que les champs ci-dessous. HiBob ne signale pas une autorisation manquante — il omet simplement les données —, mTime synchronise donc ce qu’il peut voir et liste le reste sous Non synchronisé lors de la dernière exécution sur la page de l’intégration.
| Autorisation | Ce que mTime lit | À quoi cela sert | Sans elle |
|---|---|---|---|
| Access data for — tous les employés, y compris ceux qui ont quitté l’entreprise | Les employés qui existent | Chaque employé synchronisé ; ceux qui ont quitté l’entreprise pour que leur emploi reçoive sa date de fin | Les employés hors de ce périmètre ne sont pas synchronisés. Par défaut, seuls les employés en poste sont couverts : ceux qui sont partis gardent alors un emploi ouvert dans mTime. |
| People’s data → Basic info — View | E-mail, prénom, nom | Rapprocher les employés de mTime et les nommer | Sans e-mail : l’enregistrement est refusé, car aucun employé ne peut être rapproché. Sans nom : synchronisé vide. |
| People’s data → Personal → Date of birth — View. Facultatif. | Date de naissance | Les anniversaires dans mTime | Synchronisé vide. Bob n’affiche la date complète, avec l’année, qu’à un utilisateur qui peut aussi la modifier : avec View seul, la date de naissance reste donc généralement vide. mTime n’en a pas besoin pour synchroniser. |
| People’s data → Work — View sur la date de début, le département, reports to et le champ du numéro de paie | Date de début, département, responsable (reports to) et, par défaut, le numéro de paie | Le début, l’unité et le responsable de l’emploi, et le numéro de paie de l’employé | Sans date de début : l’emploi n’est pas synchronisé. Sans département ou responsable : conservés tels qu’ils sont dans mTime. Sans numéro de paie : synchronisé vide. |
People’s data → Lifecycle → Termination date — View sur ce seul champ (internal.terminationDate) | Date de fin de contrat | La date de fin de l’emploi | Ceux qui sont partis gardent un emploi ouvert dans mTime. |
| People’s data → Employment — View sur le rythme de travail, les heures hebdomadaires, l’ETP et le type de contrat | Rythme de travail, heures hebdomadaires, ETP, type de contrat | La norme de temps de travail de l’emploi, et ses conditions d’emploi via Conditions d'emploi par type | La norme de temps de travail et les conditions d’emploi sont conservées telles qu’elles sont dans mTime. |
| Time off → See who’s out, plus See who’s out because of a private policy | Les absences approuvées et leurs modifications | L’import des absences | Aucune absence n’est importée ; mTime signale qu’il n’en a trouvé aucune pour l’année écoulée. Sans les politiques privées, les arrêts maladie sont omis. |
mTime n’a pas besoin de ce qui suit, et vous ne devriez pas l’accorder :
- Lifecycle, au-delà de la date de fin de contrat : ni la table lifecycle, ni les champs status ou lifecycle status. HiBob fournit la table lifecycle entière — statuts et motifs de congé compris — et mTime obtient les dates dont il a besoin à partir de la date de début et de la date de fin de contrat. Après une réembauche, HiBob déplace la date de début au nouveau début.
- View history sur quelque table que ce soit. mTime ne lit que l’entrée actuelle.
- Time off requests (création, modification et annulation), les soldes ou les paramètres d’absence. mTime lit les absences approuvées via See who’s out. Pour les types de politique à saisir dans Activités d'absence par type de politique , consultez vous-même les paramètres d’absence de Bob.
Configuration dans mTime
- Allez dans et sélectionnez HiBob
- Saisissez l’ID du service user et le Jeton du service user
- Vérifiez les paramètres ci-dessous — au moins Activités d'absence par type de politique
- Activez l’intégration et enregistrez
- Cliquez sur Synchroniser maintenant pour lancer la première synchronisation
À l’enregistrement, mTime lit quelques employés dans HiBob pour vérifier que le service user les voit, ainsi que leurs adresses e-mail. Sans cela, aucun employé ne peut être synchronisé : l’enregistrement échoue donc.
Tout le reste que le service user ne verrait pas — noms, dates de naissance, numéros de paie, dates de début, absences — n’arrête pas la synchronisation : mTime synchronise ce qu’il peut et liste ce qu’il n’a pas pu sous Non synchronisé lors de la dernière exécution sur la page de l’intégration. Accordez View sur les champs cités dans le groupe d’autorisations du service user, et la synchronisation suivante les complète.
| Paramètre | Description |
|---|---|
| Champ du matricule de paie | Le champ HiBob qui contient le numéro de paie (EE) de l’employé. Il est synchronisé dans l’attribut Numéro de paie. Par défaut : work.employeeIdInCompany. Si votre numéro de paie se trouve dans un champ personnalisé, saisissez plutôt l’identifiant de ce champ. |
| Champ du type de contrat | Le champ HiBob qui contient le type de contrat. Il est synchronisé dans l’attribut Type de contrat HiBob de l’emploi. Par défaut : payroll.employment.type. |
| Conditions d'emploi par type | Les conditions d’emploi attribuées aux emplois de chaque type de contrat HiBob — par exemple Permanent → vos conditions habituelles. Saisissez le type tel que HiBob l’affiche. Les types absents de la liste gardent les conditions qu’ils ont dans mTime. |
| Activités d'absence par type de politique | L’activité d’absence mTime sur laquelle chaque type de politique HiBob est enregistré — par exemple Holiday → Vacances et Sick → Congé maladie. Saisissez le type de politique tel que HiBob l’affiche. Les absences d’un type de politique absent de la liste ne sont pas importées et sont signalées après chaque synchronisation. |
| Importer les absences à partir du | Jusqu’où remonte la première synchronisation pour importer les absences. Laissez vide pour commencer au 1er janvier de l’année en cours. |
| URL de base de l'API | L’adresse de HiBob. Gardez la valeur par défaut, sauf si vous vous connectez à un environnement sandbox HiBob (https://api.sandbox.hibob.com/v1). |
| Mises à jour en direct | Applique les changements de HiBob dès qu’ils ont lieu, via un webhook dans Bob. Désactivé par défaut. Voir Mises à jour en direct. |
| Secret de signature du webhook | Le secret de signature que Bob affiche pour le webhook. Nécessaire uniquement pour les mises à jour en direct. |
Rapprochement des employés
Chaque employé HiBob est rapproché d’un employé mTime par son ID salarié HiBob dès qu’une synchronisation précédente les a liés, et sinon par son adresse e-mail. Si aucune correspondance n’est trouvée, un nouvel employé est créé dans mTime.
Absences venant de HiBob
Seules les absences approuvées sont importées. Tous les types de demandes HiBob sont pris en charge : journées entières, demi-journées (matin ou après-midi), heures sur une journée — une demande de 6 heures devient une absence de 6 heures ce jour-là —, plages horaires, pourcentages et absences sans date de fin.
- La première synchronisation importe toutes les absences approuvées à partir de la date indiquée dans Importer les absences à partir du et jusqu’à un an à l’avance.
- Chaque synchronisation suivante importe ce qui a changé dans HiBob depuis la précédente : nouvelles demandes, arrêts maladie saisis après coup, demandes modifiées ou annulées — une demande annulée dans HiBob est aussi retirée de mTime.
- Les soldes restent dans HiBob. Les absences importées ne sont décomptées d’aucun compte d’absence dans mTime.
Géré par HiBob
Les absences venant de HiBob portent la mention Géré par HiBob et ne peuvent être modifiées que dans HiBob. Dans mTime, personne — employé, responsable ou administrateur — ne peut les modifier, les annuler, les interrompre ou les approuver, en changer les heures sur la feuille de temps, poser une autre absence par-dessus ou les écraser par un import Excel. Faites la modification dans HiBob : la synchronisation suivante la reporte dans mTime.
Les absences saisies directement dans mTime ne sont pas concernées : elles se modifient comme d’habitude.
Attributs ajoutés par HiBob
Lorsque l’intégration est active, elle ajoute des attributs en lecture seule aux fiches synchronisées. Ces attributs sont gérés par HiBob et ne peuvent pas être modifiés dans mTime.
| Attribut | Description |
|---|---|
| ID salarié HiBob | L’identifiant unique de l’employé dans HiBob |
| Numéro de paie | Le numéro de paie de l’employé, lu dans le Champ du matricule de paie |
| Type de contrat HiBob | Le type de contrat, lu dans le Champ du type de contrat |
| ID d’unité HiBob | Le département d’où vient l’unité organisationnelle |
Ils apparaissent dans une section à part sur chaque fiche, qui porte le nom de l’intégration. Voir Attributs personnalisés pour en savoir plus sur le fonctionnement des attributs d’intégration.
À quoi s’attendre après chaque synchronisation
L’intégration se synchronise une fois par nuit, ou immédiatement avec Synchroniser maintenant . Après chaque synchronisation :
- Les employés HiBob sont liés à leur fiche mTime, et ceux qui manquaient sont créés — voir
- L’emploi de chaque employé reçoit de HiBob son responsable, ses dates, son rythme de travail et son type de contrat, ainsi que les conditions d’emploi associées à ce type
- Les départements sont créés ou mis à jour dans . Un département archivé dans HiBob, ou auquel plus aucun employé actif n’appartient, est retiré de mTime.
- Les absences approuvées sont importées, et celles annulées dans HiBob sont retirées
- Tout ce que la synchronisation n’a pas pu importer — un champ que le service user ne voit pas, une absence d’un type de politique sans correspondance — figure dans le résultat de l’exécution, sous
Le rythme de travail provient du rythme hebdomadaire, bimensuel ou flexible de l’employé dans HiBob. À défaut, mTime utilise les heures hebdomadaires, ou le rythme de travail du site multiplié par le taux d’activité (ETP) de l’employé.
Ce qui n’est pas synchronisé
- Seul l’emploi actuel est synchronisé — ni les périodes d’emploi antérieures, ni l’historique des changements de département et de responsable.
- Les équipes ne sont pas synchronisées — seulement les départements. Dans HiBob, les équipes sont un champ personnalisé, configuré différemment dans chaque entreprise.
- HiBob n’a pas de hiérarchie de départements : tous les départements sont côte à côte dans mTime.
- HiBob n’a pas de responsables d’unité : mTime retient le responsable dont relèvent plus de la moitié des membres actifs d’un département, directement ou plus haut dans la hiérarchie. Un département sans un tel responsable garde celui qu’il a dans mTime.
- Un département supprimé purement et simplement dans HiBob (au lieu d’être archivé) reste dans mTime.
Mises à jour en direct
Lorsque Mises à jour en direct est activé, HiBob signale à mTime chaque changement dès qu’il est fait, et mTime l’applique peu après : une nouvelle embauche ou des congés approuvés n’attendent plus la nuit. La synchronisation quotidienne continue : elle rattrape tout ce qu’une mise à jour en direct a manqué, par exemple pendant que mTime était injoignable.
Les mises à jour en direct transmettent :
- Les employés — un employé nouveau, modifié ou sur le départ, avec son emploi actuel, lu de la même façon que par la synchronisation quotidienne. Un nouvel employé est créé tout de suite dans mTime.
- Les absences — les absences approuvées, modifiées ou dotées d’une date de fin dans HiBob, et celles qui y sont refusées, annulées ou supprimées.
Ceci attend toujours la prochaine synchronisation quotidienne, ou Synchroniser maintenant :
- Les départements. Les départements nouveaux, renommés ou archivés, et les changements de responsable, arrivent dans mTime avec la prochaine synchronisation. Un employé déplacé vers un département qui n’existe pas encore dans mTime garde l’ancien jusque-là.
- Les changements faits pendant que les mises à jour en direct étaient désactivées, ou avant l’ajout du webhook dans Bob.
Chaque mise à jour que HiBob envoie au sujet d’un employé figure dans avec le sens Entrant, qui indique si elle a été appliquée et, sinon, pourquoi.
Configurer les mises à jour en direct
Il faut pour cela un administrateur HiBob autorisé à ajouter des webhooks dans Bob. Le service user ne change pas.
- Dans mTime, ouvrez HiBob dans , activez Mises à jour en direct
et enregistrez. La page affiche alors l’URL du webhook de votre espace de travail ; elle se termine par
/api/webhooks/hibob/suivi de l’identifiant de l’espace de travail. Il n’est pas nécessaire de saisir à nouveau le service user pour enregistrer. - Dans Bob, allez dans Settings > Integrations > Webhooks et ajoutez un webhook :
- Version : 2
- URL : l’URL affichée par mTime
- Events : les événements des employés (employee), des entrées de table (table entry) et des demandes d’absence (time off request)
- Bob affiche un secret de signature (signing secret) pour le webhook. Saisissez-le dans Secret de signature du webhook dans mTime et enregistrez.
mTime vérifie chaque mise à jour avec le secret de signature et refuse celles qui ne sont pas signées avec lui. Tant que le secret n’est pas enregistré dans mTime, les mises à jour de HiBob sont ignorées. Le test du webhook dans Bob réussit malgré tout : vous pouvez donc ajouter le webhook avant de saisir le secret.
Dépannage
Prochaines étapes
Une fois l’intégration en cours d’exécution, voir Intégrations pour savoir comment vérifier le statut de la synchronisation, déclencher des synchronisations manuelles, ajuster les paramètres et résoudre les problèmes.