HiBob
L’integrazione HiBob collega mTime a HiBob (Bob), il sistema HR dell’azienda. Importa da HiBob dipendenti, rapporti di lavoro e reparti, oltre alle assenze approvate: i dati HR restano così in un unico posto, HiBob. L’integrazione legge soltanto da HiBob e non vi modifica mai nulla.
Cosa viene sincronizzato
L’integrazione importa in mTime da HiBob:
- Dipendenti — nome, e-mail, data di nascita e numero del libro paga
- Rapporti di lavoro — responsabile, date di inizio e fine, modello di orario e tipo di rapporto
- Unità organizzative — i reparti diventano unità organizzative, guidate dal responsabile a cui riporta la maggior parte dei membri del reparto. I reparti a cui non appartiene nessun dipendente attivo vengono tralasciati.
- Assenze — le richieste di assenza approvate, comprese le malattie registrate a posteriori, con le relative cancellazioni e modifiche
Le assenze importate da HiBob sono gestite da HiBob: non possono essere modificate né annullate in mTime. Vedere Assenze da HiBob.
Prima di iniziare: un service user in HiBob
mTime legge da HiBob come service user (utente di servizio). In Bob, aprire Settings > Integrations > Service users, crearne uno per mTime e annotarne l’ID e il token.
Assegnare poi al service user un gruppo di autorizzazioni. mTime chiede solo ciò che legge, e si limita a leggere: non modifica mai nulla in HiBob, quindi al service user serve solo View — mai Edit, e mai View history. Dove Bob consente di concedere un singolo campo anziché un’intera categoria, concedere solo i campi indicati sotto. HiBob non segnala un’autorizzazione mancante — si limita a omettere i dati — quindi mTime sincronizza ciò che vede ed elenca il resto in Non sincronizzato nell’ultima esecuzione nella pagina dell’integrazione.
| Autorizzazione | Cosa legge mTime | A cosa serve | Senza di essa |
|---|---|---|---|
| Access data for — tutti i dipendenti, compresi quelli cessati | Quali dipendenti esistono | Ogni dipendente sincronizzato; quelli cessati perché il loro rapporto di lavoro riceva la data di fine | I dipendenti esclusi non vengono sincronizzati. L’impostazione predefinita copre solo i dipendenti in forza, quindi chi è uscito mantiene un rapporto di lavoro aperto in mTime. |
| People’s data → Basic info — View | E-mail, nome, cognome | Abbinare i dipendenti a mTime e dar loro un nome | Senza e-mail: il salvataggio viene rifiutato, perché nessun dipendente può essere abbinato. Senza nome: sincronizzato vuoto. |
| People’s data → Personal → Date of birth — View. Facoltativo. | Data di nascita | I compleanni in mTime | Sincronizzata vuota. Bob mostra la data completa, con l’anno, solo a un utente che può anche modificarla, quindi con il solo View la data di nascita di solito resta vuota. mTime non ne ha bisogno per sincronizzare. |
| People’s data → Work — View su data di inizio, reparto, reports to e il campo del numero del libro paga | Data di inizio, reparto, responsabile (reports to) e, per impostazione predefinita, il numero del libro paga | L’inizio, l’unità organizzativa e il responsabile del rapporto di lavoro, e il numero del libro paga del dipendente | Senza data di inizio: il rapporto di lavoro non viene sincronizzato. Senza reparto o responsabile: restano come sono in mTime. Senza numero del libro paga: sincronizzato vuoto. |
People’s data → Lifecycle → Termination date — View solo su questo campo (internal.terminationDate) | Data di cessazione | La data di fine del rapporto di lavoro | Chi è uscito mantiene un rapporto di lavoro aperto in mTime. |
| People’s data → Employment — View su modello di orario, ore settimanali, FTE e tipo di rapporto | Modello di orario, ore settimanali, FTE, tipo di rapporto | La norma orario di lavoro del rapporto di lavoro, e le sue condizioni di impiego tramite Condizioni di impiego per tipo | La norma orario di lavoro e le condizioni di impiego restano come sono in mTime. |
| Time off → See who’s out, più See who’s out because of a private policy | Le assenze approvate e le loro modifiche | L’importazione delle assenze | Nessuna assenza viene importata; mTime segnala di non averne trovate per l’ultimo anno. Senza le policy private, le malattie vengono omesse. |
mTime non ha bisogno di quanto segue, e non va concesso:
- Lifecycle, oltre alla data di cessazione: né la tabella lifecycle, né i campi status o lifecycle status. HiBob fornisce l’intera tabella lifecycle — stati e motivi di aspettativa compresi — e mTime ricava le date che gli servono dalla data di inizio e dalla data di cessazione. Dopo una riassunzione, HiBob sposta la data di inizio al nuovo inizio.
- View history su qualsiasi tabella. mTime legge solo la voce attuale.
- Time off requests (creazione, modifica e annullamento), saldi o impostazioni delle assenze. mTime legge le assenze approvate tramite See who’s out. Per i tipi di policy da inserire in Attività di assenza per tipo di policy , consultare direttamente le impostazioni delle assenze in Bob.
Configurazione in mTime
- Aprire e selezionare HiBob
- Inserire l’ID del service user e il Token del service user
- Controllare le impostazioni qui sotto — almeno Attività di assenza per tipo di policy
- Attivare l’integrazione e salvare
- Fare clic su Sincronizza ora per eseguire la prima sincronizzazione
Al salvataggio, mTime legge alcuni dipendenti da HiBob per verificare che il service user veda loro e i loro indirizzi e-mail. Senza questi dati nessun dipendente può essere sincronizzato, quindi il salvataggio non riesce.
Tutto il resto che il service user potrebbe non vedere — nomi, date di nascita, numeri del libro paga, date di inizio, assenze — non blocca la sincronizzazione: mTime sincronizza ciò che può ed elenca ciò che non è riuscito a sincronizzare in Non sincronizzato nell’ultima esecuzione nella pagina dell’integrazione. Concedere View sui campi indicati nel gruppo di autorizzazioni del service user e la sincronizzazione successiva li compila.
| Impostazione | Descrizione |
|---|---|
| Campo della matricola paghe | Il campo HiBob che contiene il numero del libro paga (EE) del dipendente. Viene sincronizzato nell’attributo Numero del libro paga. Predefinito: work.employeeIdInCompany. Se il numero si trova in un campo personalizzato, inserire invece l’id di quel campo. |
| Campo del tipo di rapporto | Il campo HiBob che contiene il tipo di rapporto. Viene sincronizzato nell’attributo Tipo di rapporto HiBob del rapporto di lavoro. Predefinito: payroll.employment.type. |
| Condizioni di impiego per tipo | Le condizioni di impiego assegnate ai rapporti di lavoro di ciascun tipo HiBob — ad esempio Permanent → le condizioni standard. Inserire il tipo come lo mostra HiBob. I tipi non elencati mantengono le condizioni che hanno in mTime. |
| Attività di assenza per tipo di policy | L’attività di assenza di mTime su cui viene registrato ciascun tipo di policy HiBob — ad esempio Holiday → Ferie e Sick → Malattia. Inserire il tipo di policy come lo mostra HiBob. Le assenze su un tipo di policy non elencato non vengono importate e sono segnalate dopo ogni sincronizzazione. |
| Importa assenze dal | Da quale data la prima sincronizzazione importa le assenze. Lasciare vuoto per partire dal 1° gennaio dell’anno in corso. |
| URL di base dell'API | L’indirizzo di HiBob. Lasciare il valore predefinito, a meno di collegarsi a una sandbox HiBob (https://api.sandbox.hibob.com/v1). |
| Aggiornamenti in tempo reale | Applica le modifiche di HiBob appena avvengono, tramite un webhook in Bob. Disattivato per impostazione predefinita. Vedere Aggiornamenti in tempo reale. |
| Segreto di firma del webhook | Il segreto di firma che Bob mostra per il webhook. Serve solo per gli aggiornamenti in tempo reale. |
Come vengono abbinati i dipendenti
Ogni dipendente HiBob viene abbinato a un dipendente mTime tramite l’ID dipendente HiBob, una volta che una sincronizzazione precedente li ha collegati, e altrimenti tramite l’indirizzo e-mail. Se non viene trovata alcuna corrispondenza, in mTime viene creato un nuovo dipendente.
Assenze da HiBob
Vengono importate solo le assenze approvate. Sono gestiti tutti i tipi di richiesta HiBob: giornate intere, mezze giornate (mattina o pomeriggio), ore in un giorno — una richiesta di 6 ore diventa un’assenza di 6 ore in quel giorno —, orari, percentuali e assenze senza data di fine.
- La prima sincronizzazione importa tutte le assenze approvate dalla data indicata in Importa assenze dal fino a un anno avanti.
- Ogni sincronizzazione successiva importa ciò che è cambiato in HiBob dalla precedente: nuove richieste, malattie registrate a posteriori e richieste modificate o annullate — una richiesta annullata in HiBob viene rimossa anche da mTime.
- I saldi restano in HiBob. Le assenze importate non scalano alcun conto assenze in mTime.
Gestito da HiBob
Le assenze provenienti da HiBob riportano l’etichetta Gestito da HiBob e possono essere modificate solo in HiBob. In mTime nessuno — dipendente, responsabile o amministratore — può modificarle, annullarle, interromperle o approvarle, cambiarne le ore sul foglio presenze, registrarvi sopra un’altra assenza o sovrascriverle con un’importazione Excel. Apportare la modifica in HiBob: la sincronizzazione successiva la riporta in mTime.
Le assenze registrate direttamente in mTime non sono interessate e si modificano come di consueto.
Attributi aggiunti da HiBob
Quando l’integrazione è attiva, aggiunge attributi di sola lettura ai record sincronizzati. Questi attributi sono gestiti da HiBob e non possono essere modificati in mTime.
| Attributo | Descrizione |
|---|---|
| ID dipendente HiBob | L’identificativo univoco del dipendente in HiBob |
| Numero del libro paga | Il numero del libro paga del dipendente, letto dal Campo della matricola paghe |
| Tipo di rapporto HiBob | Il tipo di rapporto, letto dal Campo del tipo di rapporto |
| ID unità HiBob | Il reparto da cui proviene l’unità organizzativa |
Compaiono in una sezione a parte su ogni scheda, che porta il nome dell’integrazione. Per ulteriori informazioni sul funzionamento degli attributi di integrazione, consultare Attributi personalizzati.
Cosa aspettarsi dopo ogni sincronizzazione
L’integrazione si sincronizza una volta per notte, oppure subito con Sincronizza ora . Dopo ogni sincronizzazione:
- I dipendenti HiBob sono collegati alla rispettiva scheda in mTime e quelli mancanti sono stati creati — vedere
- Il rapporto di lavoro di ogni dipendente riceve da HiBob responsabile, date, modello di orario e tipo di rapporto, oltre alle condizioni di impiego associate a quel tipo
- I reparti sono creati o aggiornati in . Un reparto archiviato in HiBob, o a cui non appartiene più nessun dipendente attivo, viene rimosso da mTime.
- Le assenze approvate sono importate e quelle annullate in HiBob sono rimosse
- Tutto ciò che la sincronizzazione non è riuscita a importare — un campo che il service user non vede, un’assenza su un tipo di policy senza corrispondenza — compare nel risultato dell’esecuzione, in
Il modello di orario viene preso dal modello settimanale, bisettimanale o flessibile del dipendente in HiBob. In mancanza di questo, mTime usa le ore settimanali, oppure il modello di orario della sede moltiplicato per l’FTE del dipendente.
Cosa non viene sincronizzato
- Viene sincronizzato solo il rapporto di lavoro attuale: non i periodi precedenti, né lo storico dei cambi di reparto e di responsabile.
- I team non vengono sincronizzati, solo i reparti. In HiBob i team sono un campo personalizzato, configurato in modo diverso in ogni azienda.
- HiBob non ha una gerarchia di reparti, quindi in mTime tutti i reparti stanno allo stesso livello.
- HiBob non ha responsabili di unità, quindi mTime sceglie il responsabile a cui riporta più della metà dei membri attivi di un reparto, direttamente o più in alto nella linea gerarchica. Un reparto senza un responsabile di questo tipo mantiene quello che ha in mTime.
- Un reparto eliminato del tutto in HiBob (anziché archiviato) resta in mTime.
Aggiornamenti in tempo reale
Con Aggiornamenti in tempo reale attivato, HiBob avvisa mTime di ogni modifica appena viene fatta, e mTime la applica poco dopo: una nuova assunzione o delle ferie approvate non devono aspettare la notte. La sincronizzazione giornaliera continua a funzionare e recupera tutto ciò che un aggiornamento in tempo reale non ha portato, ad esempio mentre mTime non era raggiungibile.
Gli aggiornamenti in tempo reale trasferiscono:
- Dipendenti — un dipendente nuovo, modificato o in uscita, con il suo rapporto di lavoro attuale, letto come lo legge la sincronizzazione giornaliera. Un nuovo dipendente viene creato subito in mTime.
- Assenze — le assenze approvate, modificate o a cui viene data una data di fine in HiBob, e quelle rifiutate, annullate o eliminate lì.
Queste attendono ancora la prossima sincronizzazione giornaliera, oppure Sincronizza ora :
- Reparti. Reparti nuovi, rinominati o archiviati, e i cambi di responsabile, arrivano in mTime con la sincronizzazione successiva. Un dipendente spostato in un reparto non ancora presente in mTime mantiene quello precedente fino ad allora.
- Le modifiche fatte mentre gli aggiornamenti in tempo reale erano disattivati, o prima che il webhook fosse aggiunto in Bob.
Ogni aggiornamento che HiBob invia su un dipendente è elencato in con direzione In entrata, che indica se è stato applicato e, in caso contrario, perché.
Configurare gli aggiornamenti in tempo reale
Serve un amministratore HiBob che possa aggiungere webhook in Bob. Il service user non cambia.
- In mTime, aprire HiBob in , attivare Aggiornamenti in tempo reale
e salvare. La pagina mostra quindi l’URL del webhook della propria area di lavoro: termina con
/api/webhooks/hibob/seguito dall’id dell’area di lavoro. Per salvare non è necessario inserire di nuovo il service user. - In Bob, andare in Settings > Integrations > Webhooks e aggiungere un webhook:
- Version: 2
- URL: l’URL mostrato da mTime
- Events: gli eventi dei dipendenti (employee), delle voci di tabella (table entry) e delle richieste di assenza (time off request)
- Bob mostra un segreto di firma (signing secret) per il webhook. Inserirlo in Segreto di firma del webhook in mTime e salvare.
mTime verifica ogni aggiornamento con il segreto di firma e rifiuta quelli che non sono firmati con esso. Finché il segreto non è salvato in mTime, gli aggiornamenti da HiBob vengono ignorati. Il test del webhook in Bob riesce comunque, quindi è possibile aggiungere il webhook prima di inserire il segreto.
Risoluzione dei problemi
Passaggi successivi
Una volta attiva l’integrazione, consultare Integrazioni per informazioni su come verificare lo stato della sincronizzazione, avviare sincronizzazioni manuali, modificare le impostazioni e risolvere eventuali problemi.