Lease and mobility
Nmbrs to Lease a Bike integration: participants from Nmbrs, taxable benefit and deduction per bike back as wage components
With an integration between Nmbrs and Lease a Bike, only employees who are employed in Nmbrs are in the bike plan, and a leaver is reported in time. The monthly taxable benefit and deduction from Lease a Bike come back into Nmbrs as wage components, because Nmbrs has no dashlet for the bike like the one for the company car.
What the integration does
Employers that let employees lease a bike through Lease a Bike and run payroll in Nmbrs take the export from the platform every month and type the taxable benefit and deduction per employee into Nmbrs. A second bike or a contract starting mid-month regularly goes wrong in the process.
- HR enters a new employee in Nmbrs; they can sign up for the bike plan.
- After approval and collecting the bike, the contract is in the Lease a Bike platform.
- Before the payroll run KoppelHet puts the taxable benefit and the deduction per employee into Nmbrs as wage components, in the period in which the contract runs.
- On an end of employment in Nmbrs, HR gets that employee's running bike contracts, and Lease a Bike the end date.
Back: Taxable benefit per bike · Deduction for lease, service and insurance
What to watch for with Nmbrs and Lease a Bike
- Nmbrs has no dashlet for the bike like the one for the company car; taxable benefit and deduction go through separate wage components. KoppelHet therefore puts the monthly amount from Lease a Bike on the right pay code itself, instead of a contract that Nmbrs calculates.
- Nmbrs has three variants of the deduction for the company bike, with or without reducing reservations such as holiday pay, or outside the sector scheme. Which variant applies is a choice in your policy. KoppelHet records that choice once and uses it for every participant.
- Lease a Bike adds up the lease amounts of several bikes into one deduction, while the taxable benefit applies per bike. In Nmbrs the deduction therefore arrives as one amount, and the taxable benefit as the sum of seven percent of the recommended retail price of each bike.
- A bike contract always starts on the first of the month, even if the bike was collected earlier. KoppelHet puts the first taxable benefit and deduction into the Nmbrs period of that start date, not the month in which the bike was collected.
- If the employer pays the whole lease, only the taxable benefit belongs in Nmbrs. If the employee contributes, the deduction goes in too. The integration reads the scheme from Lease a Bike per company, so two entities in Nmbrs can each have a different contribution.
- On dismissal, resignation or long-term illness an employee can return the bike with a buyout up to month twelve. On an end of employment in Nmbrs KoppelHet gives HR the running contracts, so any buyout can be deducted in the last period.
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 if the deduction does not fit in a period?
Then the period does not go through silently. KoppelHet alerts payroll, who decide in Nmbrs; the integration does not change the wage component on its own.
Can we keep a mileage allowance for the bike?
Lease a Bike provides a bike declaration for that. You process it once in Nmbrs; the integration does not touch the travel allowance.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- Nmbrs is read through the Nmbrs REST API with OAuth 2.0, per company; wage components go to Nmbrs per employee and period. The SOAP API stops on 1 March 2027.
- Nmbrs wage components used according to the Nmbrs article on the bike scheme include 3510 to 3515 for the deduction, 5111 for the untaxed allowance and 5355 for the taxable benefit.
- Lease a Bike publishes no API documentation. The platform delivers a monthly export of all bikes; the connection is agreed per customer.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Nmbrs | Field in Lease a Bike | Notes |
|---|---|---|
Bedrijf en personeelsnummer | Deelnemer in Lease a Bike | Together the key, because numbers are per company |
Roepnaam, tussenvoegsel en achternaam | Naam deelnemer | |
Zakelijk e-mailadres | E-mailadres deelnemer | |
Einde dienstverband | Einddatum deelnemer | |
5355 Fiscale bijtelling fiets van de zaak (terug) | 7% van de adviesprijs, per fiets opgeteld | |
3510 of 3511 Inhouding fiets van de zaak (terug) | Maandbedrag lease, service en verzekering | Choice follows the policy on reservations |
5111 Fiets van de zaak onbelast (terug) | Werkgeversbijdrage | Only if the scheme includes an allowance |
Related
ADP Workforce Now → Nmbrs
ADP Workforce Now to Nmbrs integration: the Dutch payroll group from ADP in the right Nmbrs company
AlexisHR → Nmbrs
AlexisHR (Simployer One) to Nmbrs integration: Dutch employees into payroll
BambooHR → Nmbrs
BambooHR to Nmbrs integration: Dutch payroll next to a global HR system
Bullhorn → Nmbrs
Bullhorn to Nmbrs integration: placements with hourly pay and end date in payroll