
Payroll koppeling
SAP SuccessFactors Paylocity koppeling: Amerikaanse medewerkers, loon en vertrek uit Employee Central in Paylocity
Een koppeling tussen SAP SuccessFactors en Paylocity maakt Amerikaanse medewerkers uit Employee Central aan in de Paylocity-company van hun rechtspersoon, met kostenplaats, functie en primaire loonsom, en zet loonwijzigingen en beëindigingen met hun ingangsdatum door. Mist een veld dat de klant in Paylocity verplicht heeft gesteld, dan komt de medewerker klaar te staan in Web Link in plaats van te worden geweigerd.
Wat de koppeling doet
Organisaties die Employee Central als globaal HR-systeem gebruiken en de Amerikaanse lonen in Paylocity verwerken, houden starters, loonsverhogingen en vertrek in beide systemen bij. Een loonsverhoging met een ingangsdatum in SuccessFactors komt in Paylocity vaak pas een run later binnen, met een nabetaling als gevolg.
- HR legt in Employee Central een hire, wijziging of beëindiging vast bij een Amerikaanse rechtspersoon.
- KoppelHet leest de gewijzigde regels via OData en bepaalt de Paylocity-company bij de rechtspersoon.
- Een starter met alle verplichte velden maakt KoppelHet direct aan; anders gaat hij naar Web Link.
- Loonwijzigingen gaan als update met de ingangsdatum uit SuccessFactors.
- Een beëindiging zet de status op T met datum en de Paylocity-reden die bij de event reason hoort.
Waar je op let bij SAP SuccessFactors en Paylocity
- In Employee Central hoort elke medewerker bij een company, en Paylocity werkt met één Company ID per payrollentiteit. Een organisatie met meerdere Amerikaanse rechtspersonen krijgt daarom een vertaaltabel van SuccessFactors-company naar Paylocity Company ID, en elke aanroep gaat naar die company.
- Een overstap naar een andere Amerikaanse rechtspersoon is in Employee Central een nieuwe functieregel met een andere company. In Paylocity is dat een Copy and Transfer binnen dezelfde company set, waarbij het oude record status XT krijgt. KoppelHet laat die transfer in Paylocity uitvoeren en schrijft daarna alleen naar het actieve record.
- Terugkerende looncomponenten in Employee Central hebben een startDate per regel. Paylocity kent bij een loonwijziging een effectiveDate en een beginCheckDate. KoppelHet vult de startDate uit SuccessFactors als effectiveDate, ook als die in het verleden ligt, en laat beginCheckDate aan payroll.
- Een hireDate kan in Paylocity niet via de API worden gewijzigd. Corrigeert HR in Employee Central de startdatum van een Amerikaanse starter die al in Paylocity staat, dan meldt KoppelHet dat aan payroll om in Paylocity aan te passen.
- Het Employee ID mag in Paylocity maximaal tien tekens hebben, terwijl personIdExternal in SuccessFactors langer kan zijn. KoppelHet bewaart in dat geval een vaste vertaling, zodat een loonwijziging en de beëindiging bij hetzelfde Paylocity-record landen.
- Event reasons voor een beëindiging zijn in Employee Central per klant ingericht, en Paylocity accepteert alleen redenen die in de eigen inrichting staan. KoppelHet legt per event reason de Paylocity-reden vast en meldt een reden zonder tegenhanger, in plaats van de hele beëindiging te laten mislukken.
- Aanmaken en bijwerken mag in Paylocity met maximaal drie aanroepen per seconde. Een herschikking van kostenplaatsen in Employee Central kan honderden regels tegelijk wijzigen; KoppelHet spreidt die updates over de tijd.
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
Gaan eenmalige betalingen ook naar Paylocity?
Niet in de eerste versie. Bonussen uit EmpPayCompNonRecurring kunnen later als uitbreiding.
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 (company, costCenter, jobTitle, managerId; filter op lastModifiedDateTime met fromDate/toDate), EmpPayCompRecurring en EmpEmploymentTermination. OAuth 2.0 met SAML bearer assertion.
- Paylocity WebLink API v2 met OAuth 2.0. POST /v2/companies/{companyId}/employees, onvolledig klaarzetten met POST /v2/weblinkstaging/companies/{companyId}/employees/newemployees, bijwerken met PATCH /v2/companies/{companyId}/employees/{employeeId}. Limiet 25 aanroepen per seconde, voor aanmaken en bijwerken 3 per seconde.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in SAP SuccessFactors | Veld in Paylocity | Toelichting |
|---|---|---|
PerPerson.personIdExternal | employeeId | Maximaal tien tekens |
PerPersonal.firstName, lastName | firstName, lastName | |
PerNationalId (country USA) | ssn | |
EmpJob.company | companyId | Eén Paylocity-company per rechtspersoon |
EmpJob.costCenter | departmentPosition.costCenter1 | Code moet in Paylocity bestaan |
EmpJob.jobTitle | departmentPosition.jobTitle | |
EmpJob.managerId | departmentPosition.supervisorEmployeeId | |
EmpPayCompRecurring (paycompvalue, frequency, startDate) | primaryPayRate (payType, annualSalary of baseRate, effectiveDate) | |
EmpEmploymentTermination (endDate, eventReason) | status.employeeStatus T, effectiveDate, changeReason |
- Paylocity – Create New Employee
- Paylocity – Create New Employee in Web Link
- Paylocity – Update Employee
- Paylocity – Company & Company Sets
- Paylocity – Employee Transfers
- Paylocity – Weblink rate limits
- SAP Help – EmpPayCompRecurring
- SAP Help – EmpEmploymentTermination
- SAP Store – Third-party payroll sync for SAP SuccessFactors by Aquera
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