Payroll integration
Cezanne HR to Nmbrs integration: Dutch employments from Cezanne into payroll
With an integration between Cezanne HR and Nmbrs, employments of the Dutch employer from Cezanne reach the right Nmbrs company, with working time pattern, salary and bank account. Every change carries the effective date from Cezanne, so Nmbrs has the right state per period.
What the integration does
Organisations that use Cezanne HR internationally and have Dutch payroll run in Nmbrs by a payroll bureau now email changes with the effective date attached. A missed entry, such as fewer hours from next month, is only noticed on the payslip.
- HR creates an employment at the Dutch employer in Cezanne, with working time pattern and salary.
- KoppelHet reads that person's tables with a filter on the Dutch employer.
- Employee, employment, schedule, salary and IBAN are created in that employer's Nmbrs company.
- The payroll bureau completes tax data, pension and collective agreement in Nmbrs.
- A new entry with an effective date in Cezanne becomes a change as of that date in Nmbrs.
What to watch for with Cezanne HR and Nmbrs
- If a group has several Dutch employers in Cezanne, each belongs to its own CompanyCode. KoppelHet links each code to one Nmbrs company, so a transfer between entities becomes a leaver and a new hire in Nmbrs.
- Almost everything in Cezanne has an EffectiveFrom and EffectiveTo, including address and bank account. KoppelHet only sends a new entry to Nmbrs once the matching Nmbrs period exists, and passes the effective date along.
- A working time pattern in Cezanne is tied to the absence plan; according to the API documentation a pattern cannot overlap an enrolment in such a plan. KoppelHet therefore only reads the pattern and never changes it from Nmbrs; the schedule in Nmbrs follows Cezanne.
- Access to the Cezanne API goes through a user who logs in and grants consent, with the same visibility as on screen. An integration user who only sees the Netherlands prevents salaries from other countries ever passing through the integration.
- A compensation item in Cezanne can be calculated pro rata using the FTE. KoppelHet sends the salary Cezanne records for the employee and reports it when the FTE percentage does not match the schedule in Nmbrs.
- Cezanne also has its own UK payroll tables, such as Tax & NI. The integration leaves those alone; for Nmbrs only the HR part of the record counts.
How we build and run it
- The integration runs on the KoppelHet platform, hosted in a data centre in the EU.
- Every sync and every error is visible in the functional log; on an error your administrator is notified.
- A change that cannot go through is not half-applied but queued for another attempt.
- KoppelHet is ISO 27001 certified. Data travels encrypted and stays on the platform no longer than needed.
- After go-live we manage the integration and adjust it when your process changes.
- The integration fits next to your existing integration layer. Only the fields in the design are transferred; the platform keeps no register of its own.
Implementation and price
This is not an app you switch on. We build the integration for your organisation on our platform, with building blocks we reuse on every project. So it is custom work that does not start from scratch.
A consultant prepares the intake and analyses both systems. We then record the mapping and exceptions field by field, test in the test or acceptance environment and go live at a moment you choose. Costs are a one-off amount for the setup and a monthly amount for platform, monitoring and support.
Frequently asked questions
What happens to employees in other countries?
Nothing. The integration user cannot see them and KoppelHet filters on the Dutch employer.
Does this work with a payroll bureau?
Yes. The bureau gives KoppelHet access to the Nmbrs company and keeps payroll tax credit, pension and collective agreement itself.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- Cezanne HR through OData (v7 dataservice.svc, JSON) with OAuth 2.0 - People, Addresses, Employments, EmploymentContracts, EmployeeWorkingTimePatternDetails, EmployeeWorkingTimePatternFTE, Compensation and BankDetails. Webhooks per trigger with People PLUS+, otherwise a filter on changed records every hour.
- Nmbrs through the REST API with OAuth 2.0; authentication at client level, not through an accountant login. SOAP stops on 1 March 2027.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Cezanne HR | Field in Nmbrs | Notes |
|---|---|---|
PersonCode | Vrij veld in Nmbrs | Key |
Employments.CompanyCode | Nmbrs-bedrijf | One Nmbrs company 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 |
Related
Cezanne HR → Active Directory
Cezanne HR to Active Directory integration: domain accounts per employer and location
Cezanne HR → ADP iHCM
Cezanne HR to ADP iHCM integration: compensation, single payments and leavers to Dutch ADP payroll
Cezanne HR → AFAS Profit
Cezanne HR to AFAS integration: the Dutch employer from Cezanne in AFAS Profit Payroll
Cezanne HR → Arbodienst (SIVI)
Cezanne HR to the occupational health service via SIVI: sickness absence events as absence reports