Payroll koppeling
Oracle HCM Zenegy koppeling: Deense medewerkers, adreswijzigingen en vertrek uit Oracle HCM Cloud in Zenegy Payroll
Een koppeling tussen Oracle HCM Cloud en Zenegy maakt een aanname bij de Deense legal employer in Oracle aan als medewerker in Zenegy Payroll, met CPR-nummer, adres en anciënniteitsdatum, en zet persoonswijzigingen, vertrek en goedgekeurd verlof daarna door. Deense loonbegrippen zoals ATP-type en pensioen blijven in Zenegy, via de global value sets die payroll daar beheert.
Wat de koppeling doet
Organisaties die Oracle HCM Cloud als centraal HR-systeem gebruiken en hun Deense lonen in Zenegy draaien, voeren een Deense starter in beide systemen in. Verhuist een medewerker of vertrekt iemand, dan hoort payroll dat vaak pas als de loonstrook al klaarstaat.
- HR rondt in Oracle een aanname af bij de Deense legal employer.
- KoppelHet leest de newhire-feed, haalt CPR, adres en datums op en kiest de global value set die bij de functie hoort.
- KoppelHet maakt de medewerker aan in Zenegy met het Oracle PersonNumber als personeelsnummer.
- Adres- en naamwijzigingen gaan als JSON Patch; een vertrek wordt een ontslag met laatste werkdag.
- Na de loonrun controleert KoppelHet of het ontslag is verwerkt, en meldt afwijkingen aan payroll.
Waar je op let bij Oracle HCM Cloud en Zenegy
- Zenegy vraagt bij het aanmaken zowel een in-diensttredingsdatum als een anciënniteitsdatum. Oracle bewaart naast de startdatum van de work relationship ook anciënniteitsdatums. KoppelHet neemt die laatste als die is ingevuld, zodat een Deense medewerker die binnen de groep overstapt zijn opgebouwde anciënniteit houdt.
- Oracle stuurt een cancelworkrelship-gebeurtenis als een aanname wordt teruggedraaid. Zenegy staat verwijderen alleen toe zolang de medewerker nog in geen enkele loonrun zat. KoppelHet verwijdert het profiel dus alleen vóór de eerste Deense run; daarna wordt het een melding aan payroll.
- De empupdate-feed van Oracle meldt onder meer nieuwe adressen, naamcorrecties en gewijzigde nationale identificaties. Zenegy wil in een PATCH alleen de eigenschappen die echt veranderen; meesturen van andere velden geeft fouten in de medewerkerdata. KoppelHet zet per gebeurtenis alleen de gewijzigde velden in de patch.
- Velden die in Zenegy via een global value set lopen, veranderen niet met een PATCH, en Zenegy geeft dan ook geen fout. Leidt een functiewijziging uit de empassignment-feed tot een andere set, dan schrijft KoppelHet niets in die velden maar meldt de wijziging aan payroll.
- Een vertrek uit de termination-feed wordt in Zenegy een ontslag met laatste werkdag. Dat ontslag is pas verwerkt na een loonrun over die dag, waarna isProcessed op true staat. KoppelHet start zelf geen run en controleert na de eerstvolgende run of het vlagje is gezet.
- De newhire-feed meldt ook een herintreder. Zenegy heeft daarvoor een endpoint om een gedeactiveerd profiel te heractiveren, met een nieuwe global value set. KoppelHet gebruikt dat in plaats van een tweede profiel met hetzelfde CPR aan te maken.
- Zenegy telt afwezigheid alleen mee als de status Approved is, en op één dag past maar één registratie. Goedgekeurd verlof uit Oracle schrijft KoppelHet daarom als Approved; valt er al iets op die dag, dan komt de aanvraag op de verschillenlijst.
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 salarisbedragen uit Oracle ook naar Zenegy?
Niet in de eerste versie. Salarisinstellingen lopen in Zenegy deels via global value sets, en die beheert payroll. Een salarisstroom kan later als uitbreiding, na een test in de omgeving van de klant.
Wie geeft toestemming voor de API?
Een gebruiker met toegang tot het Zenegy-bedrijf logt in via OAuth en keurt de koppeling goed. Welke rol daarvoor nodig is, stemmen we af met payroll.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Oracle HCM Cloud via de employee Atom feeds (newhire, empupdate, empassignment, termination, cancelworkrelship) op /hcmRestApi/atomservlet/employee/, daarna de REST-resource workers voor nationalIdentifiers, addresses en workRelationships, gefilterd op de Deense legal employer.
- Zenegy Payroll-DK met OAuth 2.0 authorization code flow (token via /auth/token, refresh token voor langdurige toegang). Medewerker aanmaken, wijzigen met JSON Patch, ontslag registreren en controleren via employee resignations, heractiveren met globalValueSetUid, en afwezigheid aanmaken met status Approved.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Oracle HCM Cloud | Veld in Zenegy | Toelichting |
|---|---|---|
PersonNumber | employeeNumber | Anders bouwt Zenegy een nummer uit het CPR |
nationalIdentifiers (DNK) | CPR-nummer | Verplicht |
names (FirstName, LastName) | naam | |
addresses (thuisadres) | adres, postcode, plaats | Verplicht |
Start date van de work relationship | in-diensttredingsdatum | |
Termination date | lastWorkDay en dateOfResignation | |
Absence type | absence type-ID | Vertaaltabel naar de Zenegy-typen |
Gerelateerd
Ashby → Oracle HCM Cloud
Ashby Oracle HCM koppeling: geaccepteerd aanbod op een opening wordt een pending worker
Bullhorn → Oracle HCM Cloud
Bullhorn Oracle HCM koppeling: goedgekeurde plaatsing van een werknemer wordt een pending worker
Carerix → Oracle HCM Cloud
Carerix Oracle HCM koppeling: geslaagde plaatsing als pending worker in Oracle HCM Cloud
Greenhouse → Oracle HCM Cloud
Greenhouse Oracle HCM koppeling: geaccepteerd aanbod als pending worker in Oracle HCM Cloud