Collega Zucchetti a Spark per sincronizzare anagrafiche, organigramma, presenze/assenze e centri di costo: obiettivi e valutazioni si appoggiano a dati già validati dall’HR.
Cosa sincronizziamo
Dipendenti (Zucchetti → Spark, notturno)
Organigramma / manager chain (Zucchetti → Spark, notturno)
Contratti & inquadramenti (Zucchetti → Spark, notturno)
Presenze/Assenze (Zucchetti → Spark, ogni 15’/orario, se modulo presente)
Centri di costo / sedi (Zucchetti → Spark, notturno)
Campi custom chiave (Zucchetti → Spark, notturno)
A cosa serve
Onboarding automatico: utenti e ruoli creati/sospesi in base ai movimenti HR.
MBO/Valutazioni con dati reali: presenze, ruoli, costi e strutture aggiornate.
Governance: permessi in Spark allineati a centri di costo, sedi e linee.
Reporting: KPI e payout per reparto/centro di costo senza export manuali.
Come si configura (3 step)
Prerequisiti: utente admin Zucchetti con permessi API/esportazioni; IP allowlist (se richiesta); modulo Presenze se vuoi sincronizzare assenze.
Lato Zucchetti: abilita API/esport (CSV/SFTP o REST a seconda del contratto); seleziona campi e pianifica job notturno; recupera endpoint/credenziali.
Lato Spark: inserisci endpoint/credenziali, mappa i campi (email, codice dip., manager, cost center), esegui import pilota su un’OU di test.
Sicurezza & accessi
Autenticazione: API Key / credenziali tecniche (in base al modulo).
SSO/SCIM: gestiti dall’IdP (Google/Microsoft/Okta), opzionali; Spark eredita MFA e policy.
Dati: cifratura in transito/a riposo, audit log accessi ed errori.
Data residency: (su richiesta / non disponibile).
Mappature chiave
| Campo Zucchetti | Campo Spark | Tipo | Note |
|---|---|---|---|
| workEmail / email aziendale | string | univoco; usato per login | |
| employeeCode / matricola | employee_code | string | chiave tecnica secondaria |
| managerCode / id responsabile | manager | reference | risolto su email/employee_code |
| costCenter | cost_center | string | usato per permessi e reporting |
| orgUnit / reparto | org_unit | string | gerarchia fino a 6 livelli |
| location / sede | site | string | normalizzare denominazioni |
| employmentType | contract_type | enum | FT/PT/Apprendistato/Interim |
| hireDate | hire_date | date | ISO 8601 |
| termDate | termination_date | date | gestisce auto-deprovisioning |
Limitazioni & note
Modalità API vs CSV/SFTP dipende dal contratto/moduli attivi.
Rate limit: consigliato batch e job notturni (max ~10 chiamate/s).
Campi custom: in sola lettura se non esposti via API.
Presenze/Assenze: disponibili solo con relativo modulo.
Troubleshooting rapido
401/403: credenziali errate o IP non in allowlist → verifica utente tecnico e IP.
429 rate limit: riduci batch o aumenta intervallo job.
Record scartati: email duplicata o mancante → definisci chiave primaria (email o matricola).
Gerarchia non valida: manager non risolto → importa prima i manager o mappa per email.
FAQ
È bidirezionale? Di default solo lettura da Zucchetti a Spark; scrittura opzionale via export controllati.
Quanto impiega il primo sync? Tra 10–60 min per 1–5k dipendenti (dipende da campi/moduli).
Come gestite i duplicati? Chiave primaria su email (fallback matricola); regole di merge configurabili.
