Payroll koppeling
SAP SuccessFactors Zenegy koppeling: Deense medewerkers uit Employee Central als loonprofiel in Zenegy
Met een koppeling tussen SAP SuccessFactors en Zenegy komen Deense medewerkers uit Employee Central als volledig loonprofiel in Zenegy, en gaat hun vertrek met de laatste werkdag mee. KoppelHet bepaalt daarbij salaristype en global value set per functie, zodat de salarisadministratie dat niet opnieuw hoeft te beslissen.
Wat de koppeling doet
Organisaties die Employee Central wereldwijd gebruiken en de Deense lonen in Zenegy verwerken, zetten Deense starters nu met de hand in Zenegy. Of iemand vast salaris of uurloon krijgt, en per maand vooruit of per veertien dagen wordt betaald, beslist de salarisadministratie dan opnieuw, los van wat in SuccessFactors staat.
- HR legt in Employee Central een indiensttreding vast bij de Deense rechtspersoon.
- KoppelHet leest persoon, CPR, adres en functiegegevens via OData en bepaalt salaristype en global value set uit de vertaaltabel.
- KoppelHet maakt het profiel aan in Zenegy met het SuccessFactors-ID als personeelsnummer.
- Bij een beëindiging zet KoppelHet het ontslag klaar en volgt tot Zenegy het na de run heeft verwerkt.
Waar je op let bij SAP SuccessFactors en Zenegy
- Zenegy kent als salaristype onder meer Fixed, TimePaidWithHoliday, TimePaidWithoutHoliday en CasualWorker, en als uitbetaling maandelijks vooruit, per veertien dagen of maandelijks achteraf. Employee Central legt dat niet in Deense begrippen vast. KoppelHet leidt het af uit employee class en paygroup van de Deense rechtspersoon.
- Zenegy eist bij aanmaken een anciënniteitsdatum. Employee Central heeft daarvoor een eigen datum op het dienstverband, die bij een overgenomen dienstverband afwijkt van de startdatum. KoppelHet stuurt die datum mee en gebruikt alleen bij een leeg veld de startdatum.
- PerNationalId kan nummers uit meerdere landen bevatten. Zenegy vraagt een CPR van tien tekens en bouwt zonder personeelsnummer zelf een nummer uit dat CPR. KoppelHet stuurt alleen het nummer met land DNK en altijd de personIdExternal als personeelsnummer.
- Een PATCH in Zenegy mag alleen de gewijzigde eigenschappen bevatten, en een eigenschap die via een global value loopt verandert niet, zonder foutmelding. Een functiewijziging in SuccessFactors die een andere set vraagt, gaat daarom niet als PATCH maar via de route die Zenegy voor sets beschrijft.
- Een medewerker die al in een Zenegy-run zat, kan niet meer worden verwijderd. Draait HR in Employee Central een hire terug na de eerste Deense run, dan meldt KoppelHet dat aan payroll; vóór die run mag KoppelHet het profiel nog verwijderen.
- Employee Central geeft standaard alleen wat vandaag geldt. Een beëindiging met een einddatum volgende maand vraagt KoppelHet met fromDate en toDate op, zodat het ontslag in Zenegy klaarstaat vóór de run over de laatste werkdag.
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 Zenegy?
Niet in de eerste versie. Zenegy telt alleen goedgekeurde afwezigheid en maar één per dag; dat kan later als uitbreiding.
Werkt dit ook voor Zweedse medewerkers?
Deze pagina gaat over de Deense payroll van Zenegy. Voor Zweden zoeken we bij de start uit welke API geldt.
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, PerAddressDEFLT, EmpEmployment, EmpJob (filter op company en lastModifiedDateTime, met fromDate/toDate) en EmpEmploymentTermination. OAuth 2.0 met SAML bearer assertion.
- Zenegy Payroll-API met OAuth 2.0 en refresh token, met rechten READ of FULL per resource. Aanmaken met Post employee inclusief GlobalValueSetUid en salaryType, wijzigen met PATCH employee (alleen gewijzigde eigenschappen), vertrek met Resign employee (dateOfResignation, lastWorkDay); set-UID's via Get global value sets.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in SAP SuccessFactors | Veld in Zenegy | Toelichting |
|---|---|---|
PerPerson.personIdExternal | employeeNumber | Anders maakt Zenegy een nummer uit het CPR |
PerNationalId (country DNK) | cpr | |
PerPersonal.firstName, lastName | name | |
PerAddressDEFLT | address, postalNumber, city | |
EmpEmployment.startDate | employmentDate | |
EmpEmployment.seniorityDate | seniorityDate | Valt terug op startDate als het leeg is |
EmpJob.employeeClass en payGroup | salaryType (Fixed, TimePaidWithHoliday) en salaryPayoutPeriod | Vertaaltabel |
EmpJob.jobCode | GlobalValueSetUid | UID's uit Zenegy |
EmpEmploymentTermination.endDate | lastWorkDay en dateOfResignation |
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