Cezanne HR logoNmbrs logo

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.

  1. HR creates an employment at the Dutch employer in Cezanne, with working time pattern and salary.
  2. KoppelHet reads that person's tables with a filter on the Dutch employer.
  3. Employee, employment, schedule, salary and IBAN are created in that employer's Nmbrs company.
  4. The payroll bureau completes tax data, pension and collective agreement in Nmbrs.
  5. A new entry with an effective date in Cezanne becomes a change as of that date in Nmbrs.
Cezanne HR → KoppelHet → NmbrsSOURCECezanne HRTARGETNmbrsKoppelHetmapping · logging · monitoringCezanne HR → KoppelHet → NmbrsSOURCECezanne HRTARGETNmbrsKoppelHetmapping · logging · monitoring
Out: Employee and employment · Schedule from the working time pattern · Salary · IBAN · End date

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, architecture and compliance

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.

Price indication · Complex

Leave your work email and you see the price indication right away.

We only use your address to follow up on your question about this integration.

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 HRField in NmbrsNotes
PersonCodeVrij veld in NmbrsKey
Employments.CompanyCodeNmbrs-bedrijfOne Nmbrs company per CompanyCode
People (FirstName, FamilyName, DateOfBirth)Persoonsgegevens
Addresses (EffectiveFrom)Adres
Employments.HireDateStartdatum dienstverband
EmployeeWorkingTimePatternDetailsRooster per dag
Compensation (CompItemCode BASE, EffectiveFrom)Salaris met ingangsdatum
BankDetails.AccountNumberIBAN
Employments.TerminationDateDatum uit dienst

Related

Which systems do you want to connect?

Tell us which systems you use and what should happen automatically. Together we define the smallest working solution, with a clear design and a quote before building.