Collega Cezanne HR a Spark per sincronizzare anagrafiche, organigramma, presenze/assenze e centri di costo: obiettivi e valutazioni usano i dati HR ufficiali senza export manuali.
Cosa sincronizziamo
Dipendenti (Cezanne → Spark, notturno)
Organigramma / manager chain (Cezanne → Spark, notturno)
Sedi, reparti, cost center (Cezanne → Spark, notturno)
Contratti, job title, employment type (Cezanne → Spark, notturno)
Presenze/Assenze / Time-off (se modulo attivo) (Cezanne → Spark, orario/notturno)
Campi custom (se esposti in API/report) (Cezanne → Spark, notturno)
A cosa serve
Onboarding/Offboarding automatico (creazione/sospensione utenti e ruoli da movimenti HR).
MBO con dati reali (strutture, cost center, assenze) allineati al giorno prima.
Governance: permessi in Spark agganciati a reparti/sedi/centri di costo.
Reporting: avanzamento obiettivi e payout coerenti con la master data HR.
Come si configura (3 step)
Prerequisiti
Utente admin Cezanne con permessi su API o report/export.
API key / OAuth2 client oppure export CSV/SFTP pianificati.
(Se richiesto) IP allowlist; IdP aziendale per SSO su Spark.
Lato Cezanne
Abilita accesso API o prepara report/export con i campi necessari (email, manager, cost center, location, time-off).
Raccogli endpoint/credenziali, schema dei campi, formato (JSON/CSV) e pianifica il job.
Lato Spark
Inserisci endpoint/credenziali, mappa i campi principali e avvia import pilota su un’OU di test.
Abilita job notturni (core HR) e orari per presenze/time-off se necessario.
Sicurezza & controllo accessi
Autenticazione: API Key / OAuth2 (in base al tuo setup).
SSO su Spark: SAML/OIDC (Google Workspace / Microsoft Entra / Okta). SCIM: (opzionale, via IdP).
Cifratura in transito/a riposo, audit log, principio del least privilege sugli scope.
Mappature chiave
| Campo Cezanne (API/Report) | Campo Spark | Tipo | Note |
|---|---|---|---|
| workEmail | string | chiave primaria per login | |
| employeeCode / personId | employee_code | string | chiave tecnica secondaria |
| managerEmail / managerId | manager | reference | risolto su email/employee_code |
| department / unit | org_unit | string | gerarchia (fino a 6 livelli) |
| location / site | site | string | normalizzare denominazioni |
| costCenter | cost_center | string | permessi e reporting |
| employmentType / status | contract_type | enum | FT/PT/Fixed/Intern |
| startDate | hire_date | date | ISO 8601 |
| endDate | termination_date | date | auto-deprovisioning |
| timeOffHours / absences | attendance_hours | number | se incluso nei permessi/report |
Endpoints / API
Cezanne HR API: profili, organizzazione, time-off (in base a piano/permessi).
CSV/SFTP: export pianificati da Cezanne verso Spark con schema concordato.
(Se non disponibili nel tuo ambiente: “opzionale / non disponibile”.)
Direzione, frequenza, limiti
Direzione: Pull Cezanne → Spark (default). Push Spark → Cezanne (opzionale / non disponibile).
Frequenza: notturno (core HR), orario/15’ (time-off/presenze).
Rate limits/quote: rispettare limiti API; usare paginazione, batch e retry/backoff su 429.
Limitazioni & note
Campi custom disponibili solo se esposti in API/report.
Time-off/presenze dipendono da moduli e permessi attivi.
Alias email: normalizza il dominio (email = chiave primaria in Spark).
Gerarchie multi-sede supportate fino a 6 livelli.
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/ordine import errato → importa prima i manager/mappa via employeeCode.
Record scartati: email duplicata/mancante → imposta chiave primaria su email, fallback employeeCode.
Disallineamento time-off: timezone/cut-off diversi → uniforma periodi e fusi nei report.
FAQ
È bidirezionale? Default solo lettura da Cezanne a Spark.
Quanto impiega il primo sync? 10–60 min per 1–5k dipendenti (in base a campi/report).
Come gestite i duplicati? Chiave email con fallback employeeCode; regole di merge configurabili.
Vuoi attivarla? Contattaci o segui la guida passo-passo con mappature ed esempi di job API/CSV.
