Collega SAP a Spark per usare anagrafiche, organigramma e dati operativi/finance già presenti in SuccessFactors e/o S/4HANA. Obiettivi e valutazioni restano allineati ai sistemi ufficiali.
Cosa sincronizziamo
Dipendenti (SuccessFactors → Spark, notturno)
Organigramma / manager chain (SuccessFactors → Spark, notturno)
Contratti, sedi, centri di costo (SuccessFactors/SAP HCM → Spark, notturno)
Presenze/assenze (se modulo attivo) (SuccessFactors → Spark, orario/notturno)
Dati finance/commesse (se S/4HANA): ricavi, DSO, margini base (S/4HANA → Spark, orario)
Campi custom chiave (SAP → Spark, notturno)
A cosa serve
Onboarding/Offboarding automatico (creazione/sospensione utenti/ruoli da movimenti HR).
MBO con dati reali (ricavi, DSO, assenze, centri di costo) senza export manuali.
Governance: permessi in Spark allineati a strutture, sedi e cost center SAP.
Reporting: avanzamento obiettivi e payout per reparto/commessa sempre aggiornati.
Come si configura (3 step)
Prerequisiti
Ruolo admin su SuccessFactors/SAP HCM (e su S/4HANA se integri i dati finance).
Permessi API (OData/REST) o job CSV/SFTP. Eventuale IP allowlist.
IdP per SSO (Google Workspace/Microsoft Entra/Okta), facoltativo.
Lato SAP
SuccessFactors: crea utente tecnico e OAuth2 client; abilita entità OData (PerPerson, EmpJob, FO_CostCenter, ecc.); configura job di export se scegli CSV/SFTP.
S/4HANA: esponi API (es. A2X/ODATA) per cost center, AR/aging, ordini/ricavi; definisci viste o CDS per i campi necessari.
Lato Spark
Inserisci endpoint/credenziali, mappa i campi (email, matricola, manager, cost center); esegui import pilota su un’OU di test; abilita sync notturno e, se serve, aggiornamenti orari su presenze/finance.
Sicurezza & controllo accessi
Autenticazione API: OAuth2 / credenziali tecniche (in base al modulo).
SSO: SAML/OIDC via IdP aziendale (sì, opzionale). SCIM: (opzionale / non disponibile nativo).
Cifratura in transito/a riposo, audit log, principio del least privilege (scopes minimi).
Mappature chiave
| Campo SAP (SF/S4) | Campo Spark | Tipo | Note |
|---|---|---|---|
| personEmail / workEmail | string | chiave primaria per login | |
| personIdExternal / pernr | employee_code | string | chiave tecnica secondaria |
| managerId / managerEmail | manager | reference | risolto su email/employee_code |
| costCenter / controllingArea | cost_center | string | usato per permessi e reporting |
| businessUnit / department | org_unit | string | gerarchia (fino a 6 livelli) |
| location / company | site | string | normalizzare denominazioni |
| employmentType | contract_type | enum | FT/PT/Apprendistato/Temp |
| startDate / endDate | hire/termination_date | date | ISO 8601, gestisce auto-deprovisioning |
| revenue/AR/DSO (S/4) | kpi_finance | number | per obiettivi Finance (read-only) |
Endpoints / API
SuccessFactors OData:
/odata/v2/(PerPerson, EmpEmployment, EmpJob, FO_CostCenter, FO_Department, ecc.)S/4HANA: API OData/REST (es. cost center, accounting documents, sales orders).
CSV/SFTP: job pianificati da SAP verso Spark per ambienti senza API.
(Inserisci link alla tua documentazione interna o ai cataloghi API aziendali.)
Direzione, frequenza, limiti
Direzione: Pull SAP → Spark (default). Push Spark → SAP (opzionale/non disponibile).
Frequenza: notturno (anagrafiche/organigramma); orario/15’ (presenze/finance, se richiesto).
Rate limits: rispettare limiti dell’ambiente (consigliato batch e backoff).
Limitazioni & note
Campi custom disponibili solo se esposti/whitelistati nelle API.
Presenze/assenze richiedono il relativo modulo attivo in SF.
Finance S/4HANA: esporre solo KPI necessari (read-only); nessuna scrittura da Spark.
Gerarchie supportate fino a 6 livelli per org unit/sedi.
Troubleshooting rapido
401/403: client OAuth o utente tecnico senza permessi → verifica scope/ruoli API e IP allowlist.
429 / rate limit: riduci dimensione batch, abilita retry con backoff.
Record scartati: email mancante/duplicata → definisci chiave primaria (email; fallback matricola).
Gerarchia interrotta: manager non risolto → importa prima i manager o mappa per email.
Mismatch cost center: codice non valido in S/4 → sincronizza la master data/FO_CostCenter prima del job.
FAQ
È bidirezionale? Di default solo lettura da SAP a Spark; scrittura non prevista salvo export controllati.
Quanto impiega il primo sync? 15–90 min per 1–10k dipendenti (dipende da campi/moduli).
Come gestite i duplicati? Chiave email con fallback matricola; regole di merge e dedup configurabili.
