Payroll koppeling
BambooHR PayFit koppeling: nieuwe Franse medewerkers als collaborator met contract in PayFit
Met een koppeling tussen BambooHR en PayFit wordt een nieuwe medewerker van de Franse entiteit in BambooHR binnen enkele minuten een collaborator met contract in PayFit, met functietitel en startdatum. KoppelHet bouwt de koppeling op de publieke API van PayFit, die contracten voor Frankrijk aanmaakt.
Wat de koppeling doet
Organisaties met HR in BambooHR en een Franse entiteit die in PayFit wordt verloond, zetten nieuwe medewerkers met de hand van BambooHR over naar PayFit.
- KoppelHet maakt in BambooHR een webhook op nieuwe medewerkers en in PayFit een API-key.
- Een nieuwe Franse medewerker wordt een collaborator in PayFit, gevolgd door een contract met functietitel en startdatum.
- KoppelHet controleert na enkele minuten of het contract in PayFit staat.
- De payrollbeheerder maakt het contract in PayFit af.
Waar je op let bij BambooHR en PayFit
- De publieke API van PayFit kan een contract alleen voor Frankrijk aanmaken. Deze koppeling is daarom voor een Franse entiteit.
- Met de webhooks van BambooHR staat een nieuwe Franse medewerker binnen enkele minuten als collaborator in PayFit, zonder te wachten op een nachtelijke run.
- PayFit wil het adres in delen, met huisnummer, eerste adresregel, plaats, postcode en land, terwijl BambooHR straat en nummer samen in address1 bewaart. KoppelHet splitst het huisnummer af en meldt een adres dat niet eenduidig te splitsen is, in plaats van het te raden.
- Het Franse sociale-zekerheidsnummer telt bij PayFit vijftien tekens. BambooHR heeft daar geen eigen veld voor, alleen een algemeen nationalId; KoppelHet stuurt het nummer alleen mee als het vijftien tekens heeft, anders vult payroll het in PayFit in.
- Een contract via de API geeft PayFit terug zonder gegevens, en het staat er pas na twee tot vijf minuten. KoppelHet meldt een nieuwe medewerker pas als klaar wanneer het contract daarna in PayFit te vinden is.
- BambooHR ondertekent webhooks met een SHA-256 HMAC in de header X-BambooHR-Signature en probeert een mislukte levering tot vijf keer opnieuw. KoppelHet controleert elke handtekening en vergelijkt daarnaast elke dag de Franse medewerkers in beide systemen.
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
Kan KoppelHet ook salariswijzigingen naar PayFit in Frankrijk schrijven?
Niet in de eerste versie. De koppeling begint met nieuwe medewerkers en hun contract; wat de API daarna toelaat, toetsen we in jullie omgeving.
Komen loonstroken terug in BambooHR?
Niet in de eerste versie. Dat kan later als uitbreiding.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- KoppelHet leest BambooHR via ondertekende webhooks (X-BambooHR-Signature) en de employees-API, en schrijft naar PayFit met POST /companies/{companyId}/collaborators en POST /companies/{companyId}/collaborators/{collaboratorId}/contracts op partner-api.payfit.com.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in BambooHR | Veld in PayFit | Toelichting |
|---|---|---|
firstName, lastName | firstName, lastName | |
homeEmail | personalEmail | Verplicht in PayFit |
address1, city, zipcode, country | personalAddress (streetNumber, addressFirstLine, city, postCode, country) | Huisnummer apart in PayFit |
nationalId | socialSecurityNumber | Vijftien tekens voor Frankrijk |
jobTitle | jobTitle (contract) | |
hireDate | startDate (contract) |
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