Nmbrs koppelen: uren, verlof en mutaties uit je salarissysteem
In Nmbrs staat wat er werkelijk is uitbetaald. Dat getal is nergens anders te vinden, en het staat zelden naast de systemen waar je het naast zou willen leggen. We koppelen Nmbrs op de REST API — inclusief het traject dat je bij Nmbrs zelf moet doorlopen.
Vertrouwd door
Wat betekent Nmbrs koppelen?
Technisch is het een REST API. Praktisch is het vooral een toestemmingsvraag.
Nmbrs, tegenwoordig onderdeel van Visma, is HR- en salarissoftware waar veel Nederlandse mkb-bedrijven hun loonadministratie in hebben staan. Een koppeling betekent dat gegevens niet meer met de hand van of naar Nmbrs gaan: uren uit je planning gaan de loonrun in, verlofaanvragen uit je eigen app landen in Nmbrs, saldi komen terug, en de journaalposten gaan na elke verloning naar je boekhouding.
De techniek daarvoor ligt klaar. Nmbrs heeft een REST API met OAuth 2.0 en een subscription key, webhooks op debiteurniveau zodat je niet hoeft te blijven vragen of er iets veranderd is, en een App Store met inmiddels ruim honderdvijftig bestaande integraties. Dat deel is zelden het probleem.
Het probleem zit bij de vraag wie er over de omgeving gaat. Nmbrs wordt vrijwel altijd geleverd via een accountant of een gecertificeerd loonservicekantoor, en dat kantoor beheert de omgeving — ook als het jouw personeel en jouw loonkosten zijn. Daar komt bij dat Nmbrs zelf voorwaarden stelt voordat een nieuwe koppeling naar productie mag. Beide punten staan hieronder, want ze bepalen je planning meer dan de code dat doet.
Vijf dingen die door een Nmbrs-koppeling gaan
Per stroom: wat er beweegt, en waar het in de praktijk misgaat.
Medewerkermutaties erin
Indiensttreding, contractwijziging, adreswijziging, uitdiensttreding. Deze beginnen zelden in Nmbrs: ze beginnen in je HR-systeem, je ATS of gewoon in een mail, en worden daarna overgetypt.
Twee waarheden over dezelfde medewerker. Wie geldt er als bron zodra HR en de salarisadministratie het oneens zijn over een ingangsdatum?
Uren naar de loonrun
Gewerkte uren, overwerk en toeslagen uit je planning- of urensysteem naar de juiste urencode in Nmbrs, op tijd voor de verwerking van die periode.
De deadline. Een loonrun is een moment, geen proces: uren die een dag te laat binnenkomen, landen in de volgende periode en verstoren elke rapportage die op maand rekent.
Verlof twee kanten op
Aanvragen gaan vanuit je eigen app of planning naar Nmbrs, saldi komen terug zodat een medewerker ziet wat hij nog heeft staan. Dit is de stroom waar tweerichting echt nodig is.
Een saldo dat je zelf berekent. Doe dat niet — laat Nmbrs de waarheid houden en toon die, anders leg je twee keer per jaar uit waarom je app er een dag naast zit.
Variabele looncomponenten
Kilometers, onkosten, bonussen, toeslagen. Ze komen uit declaratie-apps, ritregistratie of een projectsysteem en moeten periodiek naar de juiste looncomponent.
Achteraf corrigeren. Een teruggedraaide component in een al verwerkte periode is geen technische handeling maar een correctie op een loonstrook, en die ziet de medewerker.
Journaalposten eruit
Na elke verloning gaan de salarisjournaalposten naar je boekhouding. Voor een aantal pakketten zit dit al kosteloos in Nmbrs zelf, via de App Store.
Zelf bouwen wat er al is. Controleer eerst de App Store — dit is de stroom waar je het vaakst niets hoeft te laten maken.
Begin bij de laatste. De Nmbrs App Store telt ruim honderdvijftig bestaande integraties, en voor een aantal boekhoudpakketten zitten de journaalposten er kosteloos in. Wat er al bestaat tussen de pakketten die wij kennen, staat op de koppelingenindex. Een koppeling laten bouwen die je gratis kunt aanzetten, is de duurste vorm van maatwerk die er is.
Drie dingen die je planning bepalen
Geen van de drie is technisch, en alle drie kosten ze weken als je ze pas tegenkomt als de code al af is.
Niet iedereen mag autoriseren
Een koppeling wordt op debiteurniveau ingericht, en het API-token kan alleen worden aangevraagd door een gebruiker met een template op basis van Master Accountant in een accountantsomgeving, of Master Client in een bedrijfsomgeving.
Weet vóór de kickoff wie dat is. In de praktijk is het je accountant, en die staat niet in je projectplanning.
Productie vraagt een demo
Een development-subscription krijgt iedereen zonder goedkeuring. Een production-subscription geeft Nmbrs pas af na een geslaagde demo — met video en een ingevuld Ready-to-demo-formulier — en de integratie moet als generieke oplossing gebouwd zijn en in de App Store gepubliceerd worden.
Dat is geen technische stap maar een doorlooptijd waar je niets over te zeggen hebt. Plan hem in aan het begin, niet in de week van de oplevering.
SOAP stopt op 1 maart 2027
Nmbrs heeft een REST API met OAuth 2.0 en een subscription key, en daarnaast nog de oude SOAP-API. Die laatste wordt op 1 maart 2027 uitgezet, en alle nieuwe functionaliteit wordt alleen nog op REST gebouwd.
Bouw je nu iets nieuws, dan bouw je op REST. Draait er nog iets op SOAP, dan is dat een migratie die je beter dit jaar inplant dan in het laatste kwartaal van 2026.
Dat tweede feit verdient een eerlijke kanttekening, want het is het punt waarop een Nmbrs-project anders loopt dan een koppeling op een boekhoudpakket. Nmbrs beschrijft het traject naar productie als een route die eindigt in een App Store-listing, met een demo en de eis dat de integratie een generieke oplossing is. Wat wij in de openbare documentatie níét terugvinden, is een uitgewerkte route voor een koppeling die uitsluitend voor één organisatie bedoeld is.
Wij lezen dat als een vraag die je stelt en niet als een muur, en we stellen hem aan het begin van elk Nmbrs-traject: aan Nmbrs zelf of via het loonservicekantoor dat de omgeving beheert. Dat is een week werk aan de voorkant en het scheelt de situatie waarin een werkende koppeling op een demo-omgeving blijft staan. Zegt iemand je dat dit geen rol speelt, vraag dan hoe hij dat weet.
Veertig gepland, vijftig gemaakt
De rapportage waar bijna elk projectgedreven bedrijf naar zoekt, en die bijna niemand heeft.
Er is één Nmbrs-koppeling die er in ons werk bovenuit steekt, omdat hij een getal oplevert dat nergens anders bestaat. Je plant veertig uur op een opdracht. Er worden er vijftig gemaakt. Die tien uur zijn betaald aan de medewerker en niet doorberekend aan de klant, en op de balans zie je het niet: de loonkosten staan in Nmbrs, de opdracht staat in je planningssysteem, en niemand legt ze naast elkaar.
De koppeling die dat oplost is niet ingewikkeld — je haalt de planning op, je haalt de verloonde uren per periode op, en je zet ze per opdracht naast elkaar. Wat het lastig maakt zijn de afspraken eronder: welke urencode telt mee, wat doe je met iemand die op twee opdrachten tegelijk staat, en vanaf welk verschil wil je een melding in plaats van een regel in een rapport.
We hebben die uitwerking op een eigen pagina gezet, inclusief het verschil tussen gewerkte, geregistreerde, verloonde en gefactureerde uren — vier getallen die mensen door elkaar halen en die zelden gelijk zijn. Lees Nmbrs koppelen aan je urenregistratie als dit de vraag is waarvoor je hier bent.
Het misverstand, en wat wél klopt
Salarisgegevens zijn geen bijzondere persoonsgegevens. Dat betekent niet dat je ze zomaar over de lijn stuurt.
In veel offertes staat dat salarisgegevens bijzondere persoonsgegevens zijn. Dat klopt niet. Die categorie is in de AVG limitatief opgesomd en gaat over ras en etnische afkomst, politieke opvattingen, religie, vakbondslidmaatschap, genetische en biometrische gegevens, gezondheid en seksuele gerichtheid. Een brutoloon staat daar niet tussen.
Wat er wél toe doet, is dat een salarispakket die bijzondere gegevens gewoon bevat: verzuim- en gezondheidsgegevens, ingehouden vakbondscontributie, soms loonbeslag of alimentatie. Die staan in Nmbrs één klik naast de uren. Een koppeling die "alles ophaalt en later filtert" sleept ze mee naar een systeem waar ze niet thuishoren. Het BSN is een apart geval: geen bijzonder persoonsgegeven, wel een gegeven dat je alleen mag gebruiken waar de wet dat voorschrijft — en een koppelsleutel tussen twee systemen is dat niet. Gebruik daarvoor het interne medewerkersnummer of het employeeId van Nmbrs.
De volledige uitwerking — welke velden je wel en niet doorgeeft, met de overweging per veld — staat op de pagina over Nmbrs en urenregistratie. Voor de bredere vraag welke documentatie je als mkb-bedrijf moet bijhouden rond AVG en AI, is er onze checklist.
Nmbrs bouwt zelf al aan een AI-koppeling
Dat verandert de vraag: niet of een assistent erbij kan, maar welke vragen je wilt dat hij stelt.
Nmbrs werkt aan een AI Connector die op het Model Context Protocol draait — de open standaard waarmee AI-assistenten met systemen praten — en die samenwerkt met onder meer Microsoft Copilot, Google Gemini en Claude. Elke actie vraagt goedkeuring, en je gegevens blijven binnen de Nmbrs-omgeving tot je ze deelt. Op het moment van schrijven zit die connector in een early access-programma, met de Mutation Agent als eerste toepassing. Wat het Model Context Protocol is, leggen we uit op wat is een MCP-server.
Dat is goed nieuws en het maakt een deel van de vraag overbodig: wil je een assistent die mutaties in Nmbrs voorbereidt, houd dan in de gaten wat Nmbrs zelf oplevert voordat je het laat bouwen. Wij zeggen dat liever nu dan nadat je ervoor betaald hebt.
Waar het ophoudt, is bij vragen die Nmbrs én iets anders raken. "Welke opdrachten liepen vorige maand uit hun uren?" is geen salarisvraag en geen planningsvraag — het is een vraag over allebei, en een connector die alleen Nmbrs kent kan hem niet beantwoorden. Dan bouw je een eigen MCP-server die Nmbrs naast je andere systemen zet. Dat is meteen de plek waar je de begrenzing vastlegt: welke velden een assistent überhaupt mag opvragen, en welke — verzuim, bedragen, BSN — hij niet eens te zien krijgt. Bij een salarissysteem is dat geen detail maar het hele ontwerp.
Wat kost een Nmbrs-koppeling?
Eén maandbedrag, inclusief bouw, beheer en doorontwikkeling.
Een Nmbrs-koppeling kost bij DenkBot tussen €500 en €2.500 per maand, inclusief beheer en doorontwikkeling. Eén stroom in één richting — uren naar de loonrun, of journaalposten eruit — zit aan de onderkant. Verlof in twee richtingen met saldi terug, of een rapportage die verloonde uren naast een planningssysteem legt, zit hoger.
Twee kostenposten die niet van ons zijn en die je toch moet meenemen. De eerste is Nmbrs zelf: er is geen openbare prijslijst, want Nmbrs loopt via accountants en gecertificeerde loonservicekantoren, dus vraag het tarief op bij je eigen kantoor. De tweede is tijd, en die is bij Nmbrs reëler dan bij de meeste koppelingen: het traject naar een production-subscription loopt via een demo bij Nmbrs, en die doorlooptijd staat niet in jouw agenda.
Wat er in ons maandbedrag zit, en waarom een API-wijziging bij ons geen meerwerkfactuur oplevert, staat op wat kost een AI-medewerker. Wil je eerst weten of het uit kan? Plan 30 minuten met een bouwer — geen accountmanager, geen tussenlaag. Blijkt er in de App Store al iets te staan dat je probleem oplost, dan zeggen we dat gewoon.
Veelgestelde vragen over de Nmbrs-koppeling
De antwoorden op de vragen die we het vaakst krijgen. Staat jouw vraag er niet tussen? Stel hem in het gesprek.
Heeft Nmbrs een API?
Ja. Nmbrs heeft een REST API met OAuth 2.0 en een subscription key per request, gedocumenteerd via het developerportaal. Daarnaast bestaat de oudere SOAP-API nog, maar die wordt op 1 maart 2027 uitgezet en krijgt geen nieuwe functionaliteit meer. Voor gebeurtenissen zijn er webhooks op debiteurniveau, zodat je niet periodiek hoeft te vragen of er iets veranderd is.
Wie moet toestemming geven voor een Nmbrs-koppeling?
De beheerder van de Nmbrs-omgeving, en dat is bij het mkb bijna altijd je accountant of loonservicekantoor. Het API-token kan alleen aangevraagd worden door een gebruiker met een template op basis van Master Accountant in een accountantsomgeving of Master Client in een bedrijfsomgeving, en de koppeling wordt op debiteurniveau ingericht. Voer dat gesprek voordat het project start: accountants werken hier in de praktijk prima aan mee, zeker als je laat zien dat je aantallen ophaalt en geen bedragen.
Kan ik zomaar een eigen koppeling op Nmbrs bouwen?
Ontwikkelen kan zonder goedkeuring: een development-subscription is voor iedereen beschikbaar. Naar productie is een aparte stap. Nmbrs geeft een production-subscription pas af na een geslaagde demo, waarvoor je een video en een Ready-to-demo-formulier aanlevert, en Nmbrs schrijft daarbij dat de integratie als generieke oplossing gebouwd moet zijn en in de App Store gepubliceerd wordt. Ga je iets bouwen dat alleen voor jouw eigen organisatie bedoeld is, leg die route dan aan het begin voor aan Nmbrs of aan je accountant — het is de vraag die de planning van een Nmbrs-project het meest beïnvloedt.
Zijn salarisgegevens bijzondere persoonsgegevens?
Nee, en dat misverstand staat in veel offertes. De categorie bijzondere persoonsgegevens uit de AVG is limitatief en gaat over ras en etnische afkomst, politieke opvattingen, religie, vakbondslidmaatschap, genetische en biometrische gegevens, gezondheid en seksuele gerichtheid. Een brutoloon staat daar niet tussen. Wat wél bijzonder is en wel in Nmbrs staat: verzuim- en gezondheidsgegevens en ingehouden vakbondscontributie. Het BSN is een gewoon persoonsgegeven met een eigen regel: je mag het alleen gebruiken waar de wet dat voorschrijft, en een koppeling tussen twee systemen is zo’n wettelijke taak niet.
Kan een AI-assistent bij mijn Nmbrs-gegevens?
Nmbrs bouwt daar zelf aan met de AI Connector, die op het Model Context Protocol draait en samenwerkt met onder meer Microsoft Copilot, Google Gemini en Claude, waarbij elke actie goedkeuring vraagt. Die zit op het moment van schrijven in een early access-programma, met de Mutation Agent als eerste toepassing. Wil je vragen beantwoorden die Nmbrs én je eigen systemen raken — bijvoorbeeld verloonde uren naast je projectplanning — dan houd je een eigen MCP-server nodig, want die vraag valt buiten de scope van een connector die alleen Nmbrs kent.
Wat kost een Nmbrs-koppeling?
Een Nmbrs-koppeling kost bij DenkBot tussen €500 en €2.500 per maand, inclusief beheer en doorontwikkeling. Eén stroom in één richting — uren naar de loonrun, of journaalposten eruit — zit aan de onderkant. Verlof in twee richtingen met saldi terug, of een rapportage die Nmbrs naast een planningssysteem legt, zit hoger. Nmbrs publiceert zelf geen openbare prijslijst en loopt via accountants en gecertificeerde loonservicekantoren; wat je daar voor de omgeving betaalt, vraag je bij je eigen kantoor op.
Moet er naast Nmbrs nog een pakket meepraten? Op de integratie-index staat per systeem wat we ermee doen, en op de koppelingenindex per combinatie of er al iets bestaat.
Benieuwd wat een agent voor jouw team kan doen?
Leg je proces voor aan degene die het straks bouwt. In 30 minuten weet je of het kan, wat het kost en wat het oplevert — geen salespitch.
Plan 30 minuten met een bouwer→Wat een agent kan oppakken
