Payroll koppeling
SAP SuccessFactors Silae koppeling: de Franse rechtspersoon uit Employee Central als salarié en emploi in Silae
Een koppeling tussen SAP SuccessFactors en Silae maakt van een indiensttreding bij de Franse rechtspersoon in Employee Central een salarié met emploi in het Silae-dossier, met contracttype, statut en basissalaris, en sluit het emploi af bij een beëindiging. KoppelHet schrijft daarvoor op het API-account van de Silae-partner die de Franse lonen verwerkt, omdat alleen partners schrijfrechten op medewerkers krijgen.
Wat de koppeling doet
Organisaties die Employee Central als globaal HR-systeem gebruiken en de Franse lonen door een cabinet in Silae laten verwerken, sturen elke Franse indiensttreding als formulier naar dat kantoor. Daar komen contracttype en statut cadre of non cadre opnieuw in Silae, en een vertrek in SuccessFactors bereikt het kantoor soms pas na de DSN.
- HR legt in Employee Central een indiensttreding vast bij de Franse rechtspersoon.
- KoppelHet leest persoon, nationaal nummer, functie- en compensatiegegevens via OData, ook regels met een toekomstige ingangsdatum.
- KoppelHet maakt de salarié met één emploi aan in het Silae-dossier van de Franse rechtspersoon, op basis van de modelmedewerker van het cabinet.
- Salariswijzigingen gaan naar hetzelfde emploi; een beëindiging zet einddatum en motif op het emploi.
- Wat Silae weigert, komt met de foutmelding op een lijst voor het cabinet en HR.
Waar je op let bij SAP SuccessFactors en Silae
- Silae schrijft medewerkers alleen via het API-model Usage interne RH (1B), en dat is voorbehouden aan Silae-partners. Een SuccessFactors-klant krijgt dus geen eigen schrijfaccount; KoppelHet werkt op het account van het cabinet, dat per Silae-dossier de API-toegang aanzet.
- Employee Central kent het Franse contracttype als picklist op de functiegegevens, Silae als code, zoals 01 voor een CDI en 02 voor een CDD. Bij een CDD vraagt Silae ook een motif en de duur in maanden. KoppelHet vertaalt de picklist van de klant naar die codes en houdt een CDD tegen als het motif ontbreekt.
- In Silae moet de contractbegindatum op of vóór de begindatum van het emploi liggen, anders maakt Silae de salarié aan zonder emploi. Employee Central levert bij een hire één startdatum; KoppelHet vult die in beide velden, zodat er nooit een salarié zonder emploi in het dossier staat.
- Een beëindiging uit SuccessFactors landt in Silae als dateFin met een motifFinEmploi, zoals 010 voor ontslag door de werknemer of 138 voor een rupture conventionnelle. De event reasons in Employee Central zijn per klant ingericht; KoppelHet legt per reason de Silae-code vast en meldt een onbekende reason bij het cabinet.
- PerNationalId kan per persoon nummers uit meerdere landen bevatten, en Silae wil een NIR van vijftien tekens met kloppende sleutel. KoppelHet stuurt alleen het nummer met land FRA en kan Silae met calculerElementsNaissance aanspreektitel en geboorteplaats uit dat nummer laten afleiden.
- Employee Central geeft standaard alleen de regel die vandaag geldt. Een Franse indiensttreding per volgende maand vraagt KoppelHet met fromDate en toDate op, zodat de salarié al in Silae staat en het cabinet de DPAE op tijd kan versturen.
- Silae werkt een veld alleen bij als de bijbehorende b-vlag op true staat. Bij een salariswijziging in SuccessFactors zet KoppelHet alleen de vlaggen van salaris en ingangsdatum, zodat statut, conventie en andere instellingen die het cabinet in Silae beheert blijven staan.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Gaat verlof uit SuccessFactors ook naar Silae?
Niet in de eerste versie. Silae heeft een API voor afwezigheden, maar de telling hangt af van de dossierinstellingen. Dat kan later als uitbreiding.
Wie verstuurt de DPAE?
Standaard het cabinet. Silae kan een DUE ook vanuit de aanmaakcall versturen, maar dat spreken we alleen af als het kantoor dat wil.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- SuccessFactors via OData v2: PerPerson, PerPersonal, PerNationalId, EmpEmployment, EmpJob (filter op company en lastModifiedDateTime, fromDate/toDate voor toekomstige regels), EmpPayCompRecurring en EmpEmploymentTermination. OAuth 2.0 met SAML bearer assertion en een technische gebruiker die alleen de Franse rechtspersoon leest.
- Silae via https://payroll-api.silae.fr/payroll met OAuth 2.0 client credentials van de partner. Eerst ListeSalarieEmplois voor bestaande emploi-ID's, dan POST /v1/SalarieEmplois/CreationSalarieEmplois met numeroDossier, matriculeSalarieModele en identifiantEmploi 0 voor een nieuw emploi of het bestaande ID bij een wijziging. Datums als JJJJ-MM-DD.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in SAP SuccessFactors | Veld in Silae | Toelichting |
|---|---|---|
PerPerson.personIdExternal | matriculeSalarie | Sleutel; zonder matricule is de salarié niet via de API te bereiken |
PerPersonal.lastName | nomNaissance | Verplicht in Silae |
PerPersonal.firstName | prenom | |
PerNationalId (country FRA) | numeroSecuriteSociale | Vijftien tekens met geldige sleutel |
EmpJob.contractType | codeContratTravail (01 CDI, 02 CDD) | Vertaaltabel per klant |
EmpJob.employeeClass of eigen veld | codeStatutCategoriel (cadre of non cadre) | |
EmpJob.startDate bij hire | dateDebutContrat en dateDebut | |
EmpPayCompRecurring (basissalaris) | salaireDeBase met salaireDeBaseEstHoraire | |
EmpEmploymentTermination.endDate en eventReason | dateFin en motifFinEmploi |
Gerelateerd
Ashby → SAP SuccessFactors
Ashby SAP SuccessFactors koppeling: aanname als nieuwe medewerker in Employee Central
Bullhorn → SAP SuccessFactors
Bullhorn SAP SuccessFactors koppeling: plaatsingen als medewerker of contingent worker in Employee Central
Carerix → SAP SuccessFactors
Carerix SAP SuccessFactors koppeling: geslaagde plaatsing als nieuwe medewerker in Employee Central
Greenhouse → SAP SuccessFactors
Greenhouse SAP SuccessFactors koppeling: aanname als nieuwe medewerker in Employee Central