Collega HiBob (Bob) a Spark per usare anagrafiche, organigramma, sedi e (se previsto) presenze/assenti: obiettivi e valutazioni restano allineati al tuo HRIS.
Cosa sincronizziamo
Dipendenti (HiBob → Spark, notturno)
Organigramma / manager chain (HiBob → Spark, notturno)
Sedi, dipartimenti, cost center (HiBob → Spark, notturno)
Contratti, job title, employment type (HiBob → Spark, notturno)
PTO/Assenze (se disponibili in API/report) (HiBob → Spark, orario/notturno)
Campi custom (se esposti) (HiBob → Spark, notturno)
A cosa serve
Onboarding/Offboarding automatico da movimenti HR (creazione/sospensione utenti e ruoli).
MBO con dati reali (strutture, sedi, cost center, assenze) senza export manuali.
Governance: permessi in Spark agganciati a reparti/centri di costo di HiBob.
Reporting: avanzamento obiettivi e payout coerenti con la master data HR.
Come si configura (3 step)
Prerequisiti
Utente admin HiBob con permessi su API/Report.
API key/Client abilitati o export CSV/SFTP pianificati.
(Opz.) IdP aziendale per SSO su Spark; IP allowlist se richiesto.
Lato HiBob
Genera API key/credenziali o configura report/export con i campi necessari (email, manager, cost center, location…).
Se usi CSV/SFTP: pianifica job notturno e definisci schema/encoding/timezone.
Lato Spark
Inserisci endpoint/credenziali, mappa i campi, esegui import pilota su un’OU di test.
Attiva sync notturno (core) e orario per PTO/assenze se necessario.
Sicurezza & controllo accessi
Autenticazione: API Key / OAuth2 (in base al tuo tenant).
SSO: SAML/OIDC verso Spark tramite IdP (Google Workspace/Microsoft Entra/Okta) — sì, opzionale.
SCIM: (opzionale; tipicamente via IdP per il provisioning utenti).
Cifratura in transito/a riposo, audit log, principi least-privilege (scope minimi sulle API).
Mappature chiave
| Campo HiBob (API/Report) | Campo Spark | Tipo | Note |
|---|---|---|---|
| workEmail | string | chiave primaria per login | |
| employeeId | employee_code | string | chiave tecnica secondaria |
| manager.workEmail / id | manager | reference | risolto su email/employee_code |
| department / subDept | org_unit | string | gerarchia (fino a 6 livelli) |
| site / location | site | string | normalizzare denominazioni |
| costCenter | cost_center | string | permessi e reporting |
| employmentType | contract_type | enum | FT/PT/Fixed Term/Intern |
| startDate | hire_date | date | ISO 8601 |
| terminationDate | termination_date | date | auto-deprovisioning |
| timeOffHours / PTO | attendance_hours | number | se incluso nel report PTO |
Endpoints / API
HiBob API: profili, organizzazione, PTO (in base al piano e ai permessi).
CSV/SFTP: export pianificati da HiBob verso Spark (schema concordato).
(Inserisci link/doc del tuo tenant; in assenza: “opzionale / non disponibile”.)
Direzione, frequenza, limiti
Direzione: Pull HiBob → Spark (default). Push Spark → HiBob (opzionale / non disponibile).
Frequenza: notturno (core HR), orario/15’ (PTO/assenze, se richiesto).
Rate limits: rispettare limiti API; usare batch, paginazione e retry/backoff su 429.
Limitazioni & note
Campi custom solo se esposti nelle API/report.
PTO/assenze disponibili se abilitati e inclusi nei permessi/report.
Alias email: normalizza il dominio (chiave primaria è l’email).
Gerarchie multi-sede supportate fino a 6 livelli in Spark.
Troubleshooting rapido
401/403: API key/permessi insufficienti → rigenera credenziali, verifica scope e IP allowlist.
429 (rate limit): riduci dimensione batch, pianifica fuori orario di punta, abilita retry esponenziale.
Manager non risolto: email mancante o ordine import errato → importa prima i manager/mappa via employeeId.
Record scartati: email duplicata → imposta chiave primaria su email, fallback employeeId.
Disallineamento PTO: timezone/cut-off diversi → uniforma periodi e fusi nei report.
FAQ
È bidirezionale? Default solo lettura da HiBob a Spark.
Quanto impiega il primo sync? 10–60 min per 1–5k dipendenti (dipende da campi/report).
Come gestite i duplicati? Chiave email con fallback employeeId; regole di merge configurabili.
