Payroll koppeling
BambooHR Zenegy koppeling: Deense medewerkers uit BambooHR met CPR en anciënniteit in Zenegy
Een koppeling tussen BambooHR en Zenegy maakt een nieuwe Deense medewerker uit BambooHR aan in Zenegy, met CPR-nummer, adres, indiensttreding en anciënniteitsdatum, en zet loonwijzigingen en vertrek door. BambooHR heeft geen eigen CPR-veld, dus de koppeling leest het nationale nummer en controleert het voordat Zenegy het krijgt.
Wat de koppeling doet
Organisaties die BambooHR internationaal gebruiken en de Deense lonen in Zenegy laten verwerken, mailen het CPR-nummer van een starter naar de salarisadministratie. Een herintreder krijgt in Zenegy dan vaak een nieuwe anciënniteitsdatum, terwijl BambooHR de oorspronkelijke datum kent.
- HR legt in BambooHR een nieuwe medewerker vast met een Deense locatie.
- KoppelHet ontvangt de ondertekende webhook en controleert het nationale nummer als CPR.
- KoppelHet maakt de medewerker in Zenegy aan met het personeelsnummer uit BambooHR.
- Een nieuwe loonregel gaat als PATCH met alleen de gewijzigde velden, en KoppelHet leest het resultaat terug.
- Een beëindiging in de employmentStatus-tabel wordt een ontslag in Zenegy.
Waar je op let bij BambooHR en Zenegy
- Zenegy maakt geen medewerker aan zonder CPR-nummer. BambooHR heeft velden voor het Amerikaanse SSN, het Britse NIN en het Canadese SIN, maar niet voor het CPR; daarvoor gebruiken organisaties nationalId. KoppelHet leest dat veld alleen voor Deense medewerkers en controleert of het tien cijfers heeft.
- Zenegy vraagt naast de indiensttreding ook een anciënniteitsdatum. BambooHR kent hireDate en, vanaf API-versie 1.1, originalHireDate voor de eerste indiensttreding. KoppelHet vult de anciënniteit met originalHireDate, zodat een herintreder zijn opgebouwde rechten in de Deense payroll houdt.
- Stuurt de koppeling geen personeelsnummer mee, dan maakt Zenegy er zelf een op basis van het CPR. Dan lopen de nummers in beide systemen uiteen. KoppelHet stuurt daarom het employeeNumber uit BambooHR mee, en meldt een medewerker zonder nummer in plaats van hem aan te maken.
- Een PATCH in Zenegy mag alleen de te wijzigen velden bevatten, en een wijziging op een veld uit de global values doet niets zonder foutmelding. KoppelHet stuurt bij een nieuwe loonregel uit BambooHR alleen het bedrag en leest de medewerker daarna terug om te zien of Zenegy het echt heeft overgenomen.
- Zenegy betaalt maandelijks vooruit, maandelijks achteraf of per veertien dagen. In BambooHR hoort elke medewerker bij een paySchedule. KoppelHet legt per schema de Zenegy-periode vast, zodat een medewerker niet in de verkeerde run komt.
- Een medewerker die nog in geen salarisrun zat, kan in Zenegy worden verwijderd, en dat is definitief. Gaat een aanstelling in BambooHR niet door, dan verwijdert KoppelHet de medewerker alleen na akkoord van payroll; na de eerste run volgt een ontslag via de resign-functie.
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 BambooHR ook naar Zenegy?
Niet in de eerste versie. Deense vakantieregels lopen in Zenegy; verlof kan 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, originalHireDate en paySchedule; tabellen compensation en employmentStatus. API-key van een aparte gebruiker.
- Zenegy Payroll-API met OAuth 2.0: Post employee (cpr, name, address, postalNumber, city, employmentDate, seniorityDate), PATCH employee met value, path en op, Get employee details, Delete employee vóór de eerste run en Resign employee.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in BambooHR | Veld in Zenegy | Toelichting |
|---|---|---|
nationalId | cpr | Tien cijfers; controle vóór verzenden |
employeeNumber | Personeelsnummer in Zenegy | Anders maakt Zenegy er een uit het CPR |
firstName, lastName | name | |
address1, zipcode, city | address, postalNumber, city | |
hireDate | employmentDate | |
originalHireDate | seniorityDate | |
paySchedule | Uitbetalingsperiode (Monthly, Backward, FourteenDays) | |
employmentStatus-tabel (Terminated, date) | Resign employee |
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