Payroll koppeling
Oracle HCM Silae koppeling: Franse aannames, salaris en vertrek uit Oracle HCM Cloud in mySilae Paie
Een koppeling tussen Oracle HCM Cloud en Silae zet een aanname bij de Franse legal employer in Oracle om in een salarié met emploi in mySilae Paie, en stuurt latere salaris- en functiewijzigingen naar datzelfde emploi. Schrijven in Silae gaat via een API-account van een Silae-partner, meestal het cabinet dat de Franse lonen verwerkt.
Wat de koppeling doet
Organisaties die HR wereldwijd in Oracle HCM Cloud vastleggen en de Franse lonen bij een cabinet in Silae laten verwerken, mailen nieuwe Franse collega's en loonsverhogingen vaak als formulier naar dat kantoor. Een geannuleerde aanname in Oracle bereikt het kantoor dan soms pas na de eerste loonrun.
- HR legt in Oracle een aanname vast bij de Franse legal employer en kent de Franse payroll toe.
- KoppelHet leest de newhire-feed, haalt de worker op via de REST-API en controleert het NIR.
- KoppelHet maakt de salarié met emploi aan in het Silae-dossier van die legal employer, op basis van de modelmedewerker van het cabinet.
- Salariswijzigingen uit de assignment-feed gaan naar het bestaande emploi.
- Een geannuleerde aanname of een gewijzigde startdatum komt als taak bij het cabinet.
Waar je op let bij Oracle HCM Cloud en Silae
- Oracle stuurt al een newhire-gebeurtenis zodra een aanname met een toekomstige datum is opgeslagen. Silae weigert een emploi waarvan de contractdatum na de begindatum ligt en maakt dan een salarié zonder emploi aan. KoppelHet vult beide datums met de startdatum van de Oracle work relationship, zodat dat niet gebeurt.
- De newhire-feed meldt ook een herintreder. Omdat Silae een medewerker aan de matricule herkent, zoekt KoppelHet eerst op het PersonNumber uit Oracle. Bestaat de salarié al, dan krijgt hij een nieuw emploi in plaats van een tweede dossierregel.
- Silae maakt alleen zelf een matricule aan als die optie in het bedrijfsdossier aanstaat, en een salarié zonder matricule is via de API onbereikbaar. KoppelHet stuurt daarom altijd het Oracle PersonNumber mee, ongeacht de instelling van het cabinet.
- Een salariswijziging komt in Oracle via de empassignment-feed, samen met wijzigingen van manager en assignment. KoppelHet haalt eerst de bestaande emploi-ID's op uit Silae en schrijft alleen het salaris naar dat emploi; een ID 0 zou een nieuw emploi maken.
- Oracle heeft een aparte feed voor een geannuleerde work relationship, bijvoorbeeld bij een no-show of een afgewezen aanbod. KoppelHet verwijdert dan niets in Silae, maar zet de salarié met de reden uit Oracle op de lijst van het cabinet.
- Bij het aanmaken kopieert Silae instellingen van een modelmedewerker. KoppelHet zet copieIntegraleSalarieModele op false, zodat convention collective en statut uit het model komen maar naam en adres uit Oracle, en kiest het model per Franse legal employer.
- De Oracle-feeds melden alleen employees, contingent workers en pending workers. Een pending worker heeft nog geen definitieve aanname; KoppelHet maakt pas een salarié aan als het een employee is met de Franse payroll uit de payupdate-feed.
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 Oracle ook naar Silae?
Niet in de eerste versie. Silae telt afwezigheid volgens de instellingen van het dossier, dus dat vraagt afspraken per verlofsoort; het kan later als uitbreiding.
Wie regelt het API-account?
Silae reserveert de API-modellen met schrijfrechten voor Silae-partners. Meestal is dat het cabinet; zij zetten de toegang per dossier aan.
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 op /hcmRestApi/atomservlet/employee/ (newhire, empassignment, payupdate, termination, cancelworkrelship, workrelshipupdate) en daarna de REST-resource workers voor names, addresses, nationalIdentifiers, workRelationships en assignments.
- Silae via de payroll-API met OAuth 2.0 op een partneraccount. Aanmaken en wijzigen met POST /v1/SalarieEmplois/CreationSalarieEmplois (identifiantEmploi 0 voor nieuw, bestaand nummer voor wijzigen, eerst ListeSalarieEmplois), met matriculeSalarieModele en b-vlaggen per veld. Elke aanroep noemt het numeroDossier.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Oracle HCM Cloud | Veld in Silae | Toelichting |
|---|---|---|
PersonNumber | matriculeSalarie | Sleutel in Silae |
names (LastName) | nomNaissance | Verplicht |
names (FirstName) | prenom | |
nationalIdentifiers (FRA) | numeroSecuriteSociale | Vijftien tekens met sleutel |
addresses (postcode) | codePostal met calculerCommune | Silae vult de gemeente aan |
Start date van de work relationship | dateDebutContrat en dateDebut | |
Salary (assignment) | salaireDeBase |
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