Payroll koppeling
BambooHR Silae koppeling: Franse medewerkers uit BambooHR als salarié in het Silae-dossier van het cabinet
Een koppeling tussen BambooHR en Silae maakt een nieuwe Franse medewerker uit BambooHR aan als salarié met emploi in het Silae-dossier van het cabinet, en zet loonregels met hun ingangsdatum en vertrek met motif door naar dat emploi. De koppeling schrijft met het API-account van het cabinet, omdat Silae schrijfrechten alleen aan partners geeft.
Wat de koppeling doet
Organisaties met BambooHR als HR-systeem en een cabinet dat de Franse lonen in Silae verwerkt, sturen het kantoor bij elke starter, verhoging en vertrek een bericht. De contractvorm staat in BambooHR in een eigen veld en komt bij het cabinet niet altijd goed aan.
- Het cabinet zet de API open voor het dossier van de Franse entiteit en kiest een modelmedewerker.
- HR legt in BambooHR een nieuwe medewerker met een Franse locatie vast.
- KoppelHet controleert NIR en contractvorm en maakt de salarié met één emploi aan.
- Nieuwe loonregels en beëindigingen gaan naar hetzelfde emploi.
- Wat Silae weigert, staat met de foutmelding op een lijst voor HR en het cabinet.
Waar je op let bij BambooHR en Silae
- Silae geeft alleen partners zoals accountants en payrollbureaus een API-account waarmee medewerkers kunnen worden geschreven. Een organisatie met BambooHR en een cabinet heeft dat account zelf niet. KoppelHet gebruikt de client credentials van het cabinet, en het cabinet bepaalt per dossier of de API openstaat.
- BambooHR kent geen veld voor het Franse NIR; organisaties gebruiken daarvoor het algemene nationalId. Silae weigert een salarié zonder geldig nummer van vijftien tekens. KoppelHet controleert lengte en sleutel al in BambooHR, zodat HR het nummer corrigeert voordat het cabinet een foutmelding ziet.
- In BambooHR zijn de waarden van employmentStatus per account vrij in te richten, en de contractvorm staat vaak in een eigen veld. Silae wil een vaste codeContratTravail. KoppelHet legt per klant vast welke BambooHR-waarde een CDI of CDD is, en houdt een onbekende waarde tegen.
- Een loonregel in BambooHR heeft een ingangsdatum en een bedrag per Hour, Month of Year. Silae neemt een salaireDeBase en een vlag voor uurloon, en houdt bij een wijziging hetzelfde emploi-ID aan. KoppelHet stuurt een uurloon met de vlag, een jaarloon gedeeld door twaalf, en altijd naar het bestaande emploi.
- Een vertrek is in BambooHR een nieuwe regel in de employmentStatus-tabel; terminationDate zelf is alleen-lezen. Silae vraagt bij dateFin een motifFinEmploi, zoals 010 bij ontslag door de werknemer of 138 bij een rupture conventionnelle. KoppelHet vertaalt de vertrekredenen van de klant naar die codes en meldt een reden zonder code.
- BambooHR stuurt geen webhooks voor eigen tabellen. Staat de contractvorm of een Franse premie in zo'n tabel, dan leest KoppelHet die dagelijks via het endpoint voor gewijzigde tabeldata, en vóór de afsluiting van de loonperiode nog een keer.
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 verlof en variabelen ook mee?
Niet in de eerste versie. Afwezigheid en premies als salarisvariabelen kunnen later als uitbreiding.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- BambooHR via ondertekende webhooks (HMAC in X-BambooHR-Signature) en de employees-API met nationalId, employeeNumber, hireDate en location; tabellen compensation en employmentStatus, eigen tabellen via het endpoint voor gewijzigde tabeldata.
- Silae via https://payroll-api.silae.fr/payroll met OAuth 2.0 client credentials van het cabinet: POST /v1/SalarieEmplois/CreationSalarieEmplois met numeroDossier en matriculeSalarieModele, ListeSalarieEmplois voor het emploi-ID, dateFin en motifFinEmploi bij vertrek.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in BambooHR | Veld in Silae | Toelichting |
|---|---|---|
employeeNumber | matriculeSalarie | |
lastName, firstName | nomNaissance, prenom | |
nationalId | numeroSecuriteSociale | Vijftien tekens |
employmentStatus of eigen veld voor contractvorm | codeContratTravail (01 CDI, 02 CDD) | Vertaaltabel per klant |
hireDate | dateDebutContrat en dateDebut | |
compensation-tabel (rate, paidPer, startDate) | salaireDeBase met salaireDeBaseEstHoraire | |
employmentStatus-tabel (Terminated, date, reden) | dateFin en motifFinEmploi |
Gerelateerd
Ashby → BambooHR
Ashby BambooHR koppeling: aanname, gewijzigde startdatum en dienstverbandstatus in BambooHR
BambooHR → 4PS Construct
BambooHR 4PS Construct koppeling: medewerkers uit BambooHR in de 4PS-administratie van hun vestiging
BambooHR → Active Directory
BambooHR koppelen met Active Directory: accounts in je eigen domein vanuit HR
BambooHR → ADP iHCM
BambooHR ADP iHCM koppeling: salaris, bonussen en commissies naar de Nederlandse payroll