Payroll koppeling
Cezanne HR Nmbrs koppeling: Nederlandse dienstverbanden uit Cezanne in de salarisadministratie
Met een koppeling tussen Cezanne HR en Nmbrs komen dienstverbanden van de Nederlandse werkgever uit Cezanne in het juiste Nmbrs-bedrijf, met werktijdpatroon, salaris en bankrekening. Elke wijziging gaat met de ingangsdatum uit Cezanne mee, zodat Nmbrs per periode de goede stand heeft.
Wat de koppeling doet
Organisaties die Cezanne HR internationaal inzetten en de Nederlandse salarissen bij een salarisbureau in Nmbrs laten draaien, mailen wijzigingen nu met de ingangsdatum erbij. Een gemiste regel, zoals minder uren vanaf de volgende maand, merkt iemand pas op de loonstrook.
- HR maakt in Cezanne een dienstverband bij de Nederlandse werkgever, met werktijdpatroon en salaris.
- KoppelHet leest de tabellen van die persoon met een filter op de Nederlandse werkgever.
- In het Nmbrs-bedrijf van die werkgever komen medewerker, dienstverband, rooster, salaris en IBAN.
- Het salarisbureau vult de fiscale gegevens, pensioen en cao aan in Nmbrs.
- Een nieuwe regel met ingangsdatum in Cezanne wordt een wijziging per die datum in Nmbrs.
Waar je op let bij Cezanne HR en Nmbrs
- Heeft een groep meer Nederlandse werkgevers in Cezanne, dan horen die elk bij een eigen CompanyCode. KoppelHet koppelt elke code aan één Nmbrs-bedrijf, zodat een overplaatsing tussen bv's een uitdienst en een nieuwe indienst in Nmbrs wordt.
- Bijna alles in Cezanne heeft een EffectiveFrom en EffectiveTo, ook adres en bankrekening. KoppelHet stuurt een nieuwe regel pas naar Nmbrs als de bijbehorende Nmbrs-periode bestaat, en zet de ingangsdatum mee.
- Een werktijdpatroon in Cezanne hangt samen met de verlofregeling; volgens de API-documentatie kan een patroon niet overlappen met een inschrijving op zo'n regeling. KoppelHet leest het patroon daarom alleen en past het nooit aan vanuit Nmbrs; het rooster in Nmbrs volgt Cezanne.
- Toegang tot de Cezanne API loopt via een gebruiker die inlogt en toestemming geeft, met dezelfde zichtbaarheid als in het scherm. Een koppelgebruiker die alleen Nederland ziet, voorkomt dat salarissen uit andere landen ooit de koppeling passeren.
- Een compensatie-item in Cezanne kan pro rata op de FTE worden berekend. KoppelHet stuurt het salaris dat Cezanne voor de medewerker vastlegt en meldt het als het FTE-percentage niet past bij het rooster in Nmbrs.
- Cezanne heeft ook eigen Britse salaristabellen, zoals Tax & NI. Die laat de koppeling met rust; voor Nmbrs telt alleen het HR-deel van het dossier.
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
Wat gebeurt er met medewerkers in andere landen?
Niets. De koppelgebruiker ziet ze niet en KoppelHet filtert op de Nederlandse werkgever.
Werkt dit met een salarisbureau?
Ja. Het bureau geeft KoppelHet toegang tot het Nmbrs-bedrijf en houdt zelf loonheffingskorting, pensioen en cao bij.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Cezanne HR via OData (v7 dataservice.svc, JSON) met OAuth 2.0 - People, Addresses, Employments, EmploymentContracts, EmployeeWorkingTimePatternDetails, EmployeeWorkingTimePatternFTE, Compensation en BankDetails. Webhooks per trigger bij People PLUS+, anders een filter op gewijzigde regels per uur.
- Nmbrs via de REST API met OAuth 2.0; authenticatie op klantniveau, niet via een accountantslogin. SOAP stopt per 1 maart 2027.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Cezanne HR | Veld in Nmbrs | Toelichting |
|---|---|---|
PersonCode | Vrij veld in Nmbrs | Sleutel |
Employments.CompanyCode | Nmbrs-bedrijf | Eén Nmbrs-bedrijf per CompanyCode |
People (FirstName, FamilyName, DateOfBirth) | Persoonsgegevens | |
Addresses (EffectiveFrom) | Adres | |
Employments.HireDate | Startdatum dienstverband | |
EmployeeWorkingTimePatternDetails | Rooster per dag | |
Compensation (CompItemCode BASE, EffectiveFrom) | Salaris met ingangsdatum | |
BankDetails.AccountNumber | IBAN | |
Employments.TerminationDate | Datum uit dienst |
Gerelateerd
Cezanne HR → Active Directory
Cezanne HR koppelen met Active Directory: domeinaccounts per werkgever en locatie
Cezanne HR → ADP iHCM
Cezanne HR ADP iHCM koppeling: compensatie, eenmalige betalingen en vertrek naar de Nederlandse ADP-payroll
Cezanne HR → AFAS Profit
Cezanne HR koppelen met AFAS: de Nederlandse werkgever uit Cezanne in AFAS Profit Payroll
ASCezanne HR → Arbodienst (SIVI)
Cezanne HR koppelen met de arbodienst via SIVI: absence events voor ziekte als verzuimmelding