Payroll koppeling
Yoobi Nmbrs koppeling: uren, verlof en kilometers per salarisperiode naar Nmbrs
Met een koppeling tussen Yoobi en Visma Nmbrs gaan per salarisperiode uren, verlof, kilometers en privé betaalde declaraties uit Yoobi als loon- en urencomponenten naar Nmbrs, en komen medewerkers uit Nmbrs in Yoobi. Een tweede aanlevering in dezelfde periode stuurt alleen wat is gewijzigd.
Wat de koppeling doet
Organisaties die uren en verlof in Yoobi registreren en de salarissen in Nmbrs verwerken, tikken zonder koppeling elke maand overuren, kilometers en opgenomen vakantie-uren over in Nmbrs.
- Payroll koppelt in Yoobi een Nmbrs-gebruiker met de juiste rechten en kiest het primaire Nmbrs-bedrijf.
- Medewerkers uit Nmbrs worden in Yoobi gematcht op personeelsnummer en achternaam.
- Per contractsoort legt payroll in Yoobi vast welke Yoobi-onderdelen naar welke loon- of urencode in Nmbrs gaan.
- Na goedkeuring van timesheets en declaraties gaat de periode naar Nmbrs; een tweede aanlevering stuurt alleen wat is gewijzigd.
- Payroll draait de run in Nmbrs; medewerkers openen hun loonstrook daarna vanuit Yoobi.
Terug: Medewerkergegevens, contract en werkrooster uit Nmbrs · Loonstroken en jaaropgaven, opgehaald op het moment dat de medewerker ze opent
Waar je op let bij Yoobi en Nmbrs
- De koppeling werkt in twee richtingen. Medewerkers, contract en werkrooster komen uit Nmbrs naar Yoobi; uren, verlof, kilometers en declaraties gaan per salarisperiode van Yoobi naar Nmbrs.
- Yoobi haalt alle loon- en urencomponenten op uit loonmodel 1 in Nmbrs. Een component die in een ander loonmodel staat, kan payroll in de mapping niet kiezen.
- Opgenomen vakantie-uren gaan naar looncomponent 9981, die in Nmbrs aan verloftype 1 hangt. Wie in Nmbrs met meer verloftypes werkt, moet vooraf bepalen welke Yoobi-uren daar wel en niet onder vallen.
- Elke volgende aanlevering in dezelfde periode stuurt alleen gewijzigde regels. Wat payroll in Nmbrs via Snelinvoer op dezelfde loon- of urencode invoert, kan die regels overschrijven, dus die codes horen niet in het Snelinvoer-sjabloon.
- Automatisch aanleveren bij het goedkeuren van een timesheet werkt alleen voor de lopende loonperiode. Een timesheet die na de afsluiting wordt goedgekeurd, moet payroll zelf aanleveren.
- Een privé betaalde declaratie gaat in de eerstvolgende periode mee en staat daarna op Betaald, met de loonperiode erbij. Zo komt dezelfde declaratie nooit in een tweede run.
- Yoobi kiest het werk-e-mailadres uit Nmbrs en valt terug op het privéadres. Zonder e-mailadres in Nmbrs maakt Yoobi geen gebruikersaccount aan voor die medewerker.
- Bij meerdere Nmbrs-bedrijven bepaalt Yoobi het bedrijf per medewerker, dan per afdeling en dan voor de hele organisatie. Synchronisatie, mapping en aanlevering lopen per bedrijf apart.
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
Welke rechten heeft de Nmbrs-gebruiker nodig?
Een functioneel account op debiteurniveau dat bedrijfsgegevens, medewerkergegevens en loonaangifte-instellingen mag inzien, loonmutaties mag aanleveren en verwijderen en loonstroken mag downloaden. Wordt die gebruiker gedeactiveerd, dan stopt de koppeling.
Kunnen we na de eerste aanlevering nog uren aanpassen?
Ja. Een volgende aanlevering in dezelfde periode stuurt alleen de gewijzigde regels. Let op dat Snelinvoer in Nmbrs op dezelfde codes die regels kan overschrijven.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Naar Nmbrs met OAuth op de REST API; de Nmbrs-gebruiker moet op debiteurniveau werken, toegang hebben tot alle gekoppelde bedrijven en loonmutaties mogen aanleveren en verwijderen. De SOAP API van Nmbrs stopt per 1 maart 2027.
- KoppelHet leest Yoobi via de Yoobi REST API met een API-gebruiker die alleen registraties over een periode mag opvragen, en schrijft naar Nmbrs via de REST API op dezelfde codes als de mapping in Yoobi.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Yoobi | Veld in Nmbrs | Toelichting |
|---|---|---|
Personeelsnummer | Personeelsnummer | Belangrijkste matchkenmerk; moet in beide systemen gelijk zijn |
Uren op activiteit (registratietype uren) | Urencode uit loonmodel 1 | |
Opgenomen vakantie-uren | Looncomponent 9981 Opname verlofuren | Gekoppeld aan verloftype 1 in Nmbrs |
Trefwoord KM zakelijk / KM woon-werk | Looncomponent voor kilometervergoeding | |
Goedgekeurde declaratie, privé betaald | Looncomponent voor onkostenvergoeding | Daarna op Betaald met de loonperiode erbij |
Trefwoord ziekte-uren | Urencode voor ziekte |
Gerelateerd
Recruitee → Yoobi
Recruitee Yoobi koppeling: nieuwe collega's direct inplanbaar in Yoobi
Teamtailor → Yoobi
Teamtailor Yoobi koppeling: aangenomen kandidaten als medewerker in Yoobi, klaar voor planning en uren
Yoobi → AFAS Profit
Yoobi AFAS koppeling: overuren, kilometers en declaraties uit Yoobi in de AFAS-salarisrun
Yoobi → Microsoft Entra ID
Yoobi Entra ID koppeling: Microsoft-accounts op basis van medewerkers en contracten in Yoobi