Nmbrs koppelen met je HR-systeem, planning en boekhouding

Wat je met Nmbrs koppelt

• Nieuwe medewerkers uit je HR-systeem of onboarding aanmaken in Nmbrs
• Verlof en verzuim doorzetten naar planning of HR
• Gewerkte uren en declaraties aanleveren voor de loonrun
• Looncomponenten en salariswijzigingen uit één bron doorzetten
• Journaalposten van de loonrun naar je boekhouding

Hoe de koppeling werkt

De koppeling gebruikt OAuth 2.0 met een client die je in het Nmbrs developer portal aanmaakt; een Nmbrs-gebruiker geeft eenmalig toestemming. Elke aanroep gaat met een toegangstoken en een abonnementssleutel naar de REST API. Nmbrs telt aanroepen per minuut en per maand, dus de koppeling werkt in porties. Voor persoonsgegevens gelden strikte afspraken: alleen de velden die de koppeling nodig heeft, met logging per actie.

Feiten over de API van Nmbrs

Gecontroleerd op 2 november 2026 tegen de officiële documentatie. Limieten, prijzen en versies veranderen; de bron staat per regel erbij.

Feit	Wat de documentatie zegt	Bron
Authenticatie	OAuth 2.0 authorization-code-flow, de enige toegangsvorm voor de REST API. Elke aanroep draagt een Bearer-token en een abonnementssleutel (X-Subscription-Key) uit het developer portal.	Nmbrs: Authentication
Geldigheid token	Toegangstoken 1 uur. Refresh-token 30 dagen en eenmalig; bij elke vernieuwing krijg je een nieuw refresh-token (scope offline_access).	Nmbrs: Authentication
Limieten	Per product: Starter en Private 500 aanroepen per minuut (50.000 respectievelijk 200.000 per maand), Verified Partners 1.000 per minuut (500.000 per maand). Bij overschrijding 429.	Nmbrs: Developer portal
Webhooks	Nmbrs noemt webhooks op de partnerpagina; de details staan achter een login en niet in de REST-documentatie.	Nmbrs: Building an integration
Testomgeving	Geen aparte sandbox-URL; wel een demo-omgeving voor ontwikkelaars die niet verloopt.	Nmbrs: Current state of the REST API
Versie en afschaffingen	De REST API heeft geen versie in de URL; wijzigingen gaan via nieuwe velden en een changelog. De SOAP API wordt per 1 maart 2027 niet meer ondersteund.	Nmbrs: API for developers
Objecten	Medewerkers, dienstverbanden, contracten, salaris, looncomponenten, uren, verlof en verzuim, afdelingen, kostenplaatsen, loonruns, documenten en meer.	Nmbrs: Public REST API
Kosten API	Producten in het developer portal zonder prijs: Starter (direct), Private (op aanvraag), Verified Partners (na demo).	Nmbrs: Developer portal
n8n	Geen ingebouwde node en geen community-node gevonden; de koppeling loopt via een HTTP-stap in n8n.	n8n-documentatie

Wat jij nodig hebt

• Een Nmbrs-gebruiker met rechten op de bedrijven waar de koppeling in werkt, die eenmalig toestemming geeft
• Een client in het developer portal van Nmbrs (Starter kan direct, Private op aanvraag)
• Een verwerkersovereenkomst en een lijst van precies de velden die de koppeling mag lezen of schrijven
• Een demo-omgeving om tegen te bouwen voordat je echte loongegevens worden geraakt

Waar het vaak misgaat, en hoe ik dat voorkom

• Persoonsgegevens: loon- en verzuimgegevens zijn gevoelig. De koppeling leest alleen de velden die nodig zijn en logt elke actie; de verwerkersovereenkomst regelt de rest.
• Toegang per bedrijf: een gebruiker ziet alleen de bedrijven waar hij rechten op heeft. Ontbreken die, dan geeft Nmbrs een 403. Dat leg ik vooraf vast.
• Maandplafond: naast een limiet per minuut heeft Nmbrs een plafond per maand. De koppeling telt mee en meldt het als het plafond in zicht komt.
• SOAP-einde: de SOAP API stopt per 1 maart 2027. Een bestaande SOAP-koppeling moet voor die datum over naar REST.

Uit de praktijk

Een Nmbrs-koppeling staat bij mij nog niet als In productie. De aanpak is dezelfde als bij AFAS: één bron per gegeven, een vaste sleutel per medewerker, en een melding in gewone taal als iets niet aankomt. Voor loon- en verzuimgegevens bouw ik standaard een menselijke controle in voordat er iets wordt geschreven.

Wat het kost

Een koppeling met Nmbrs bouw ik als één afgebakend proces voor een vaste prijs, vanaf €750. Onderhoud en bewaking zijn een maandbedrag: n8n-beheer vanaf €250 per maand, serverbeheer €145 per server. In de gratis scan rekenen we jouw proces door. Alle prijzen en wat erin zit →

Wat ik niet doe

• Ik bouw geen nieuwe koppelingen op de SOAP API die Nmbrs per 1 maart 2027 stopt.
• Ik laat een koppeling geen loon- of verzuimgegevens schrijven zonder een menselijke controle, tenzij we dat uitdrukkelijk anders afspreken.
• Ik doe geen salarisadministratie; de koppeling zet gegevens door, jouw administrateur blijft verantwoordelijk.

Veelgestelde vragen over Nmbrs koppelen

Heeft n8n een Nmbrs-node?

Nee, en er is ook geen community-node gevonden. Ik koppel Nmbrs via de REST API met een HTTP-stap in n8n.

Wat betekent het stoppen van de SOAP API?

Nmbrs stopt per 1 maart 2027 met de SOAP API; daarna is alleen de REST API over. Heb je nu een SOAP-koppeling, dan moet die voor die datum worden omgebouwd. Nieuwe koppelingen bouw ik alleen op REST.

Hoeveel aanroepen staat Nmbrs toe?

Dat hangt af van het product in het developer portal: Starter en Private 500 per minuut, met een plafond van 50.000 of 200.000 per maand; Verified Partners 1.000 per minuut. Daarboven geeft Nmbrs een 429.

Kan ik testen zonder echte loongegevens?

Nmbrs biedt geen aparte sandbox-URL, maar wel een demo-omgeving voor ontwikkelaars die niet verloopt. Daar bouw ik tegen voordat de koppeling je echte omgeving raakt.

Mag een koppeling zomaar salarisgegevens lezen?

Alleen binnen de rechten van de gebruiker die toestemming gaf en binnen de afspraken in de verwerkersovereenkomst. De koppeling krijgt niet meer velden dan de taak vraagt, en elke actie wordt gelogd.