KOPPELINGENNMBRSNmbrs koppelen aan je andere systemen
Nmbrs rekent de salarissen uit, maar de gegevens daarvoor komen vaak van elders: medewerkers uit het HR-systeem, uren uit de planning. En na de verloning moeten de journaalposten naar de boekhouding. Koppel je dat, dan typt de salarisadministratie niets over en klopt de loonrun met wat er echt gewerkt is.
ISO 9001 & 27001
- Medewerkers en dienstverbanden gaat heen en weer met Je andere systemen
- Uren, toeslagen en verlof gaat heen en weer met Je andere systemen
- Journaalposten gaat heen en weer met Je andere systemen
- Status van de verloning gaat heen en weer met Je andere systemen
Onder meer gebouwd voor Tata Steel, M&G Investments, Digistore24, Toppers in Concert, Bar-le-Duc en Loogman
Dit zijn de gegevens die organisaties het vaakst tussen systemen laten lopen. Welke daarvan voor jou tellen, hangt af van waar het werk nu blijft liggen.
Medewerkers en dienstverbanden
Nieuwe medewerkers, adreswijzigingen, contracten en uitdiensttredingen. Nmbrs beschrijft voor bouwers van koppelingen zelf een basisscenario voor het synchroniseren van medewerkers en een uitgebreider HR-scenario.
Uren, toeslagen en verlof
Gewerkte uren, toeslagen en verlof uit een plannings- of tijdregistratiesysteem. Ook hiervoor heeft Nmbrs een eigen integratiescenario. De gegevens moeten in de juiste salarisperiode terechtkomen.
Journaalposten
Na de verloning gaan de loonjournaalposten naar de boekhouding, zodat de administratie ze niet met de hand hoeft te boeken.
Status van de verloning
Wanneer een run klaar is of een journaal is aangemaakt. Andere systemen kunnen daarop wachten, bijvoorbeeld om loonkosten per project of per kostenplaats bij te werken.
Afdelingen, functies en kostenplaatsen
De indeling waarop loonkosten worden verdeeld. Als die in Nmbrs, het HR-systeem en de boekhouding hetzelfde is, sluiten rapportages op elkaar aan.
Per combinatie: welke gegevens er heen en weer gaan, wat de standaardkoppeling doet en waar je op moet letten.
Niet altijd. Doet een bestaande koppeling voor Nmbrs precies wat je nodig hebt, dan zeggen we dat ook.
De Nmbrs App Store toont de gestandaardiseerde integraties met Nmbrs. Voor de boekhouding zijn er koppelingen die journaalposten direct versturen. De koppeling met Exact Online is gebouwd en wordt onderhouden door Exact Online zelf. Je activeert hem vanuit Nmbrs en de journaalposten worden gesplitst per periode en per kostenplaats of kostensoort.
Zo'n koppeling is genoeg als je alleen journaalposten naar de boekhouding wilt sturen, of als je HR-pakket een koppeling in de App Store heeft die precies de velden dekt die jij gebruikt. Nmbrs zegt zelf dat niet elke integratie voor elke werkgever geschikt is, en dat je voor een eigen, private koppeling de API mag gebruiken.
- Je koppeling draait nog op de SOAP API en moet vóór 1 maart 2027 over naar REST.
- Uren en toeslagen uit je eigen planning moeten als looncomponent in de juiste periode binnenkomen.
- Je verloont voor veel werkgevers en wilt toestemming en fouten per werkgever overzichtelijk beheren.
- Loonkosten moeten per project of kostenplaats terug naar een ander systeem dan de boekhouding.
REST API met OAuth 2.0
De REST API, versie 1.0, is de nieuwste API van Nmbrs. Authenticatie loopt via de OAuth 2.0 Authorization Code Flow: de Nmbrs-gebruiker geeft toestemming voor wat je koppeling vraagt. Je registreert je app in het developerportal en krijgt een client ID en secret. Bij elk verzoek stuur je daarnaast een subscription key mee.
Toestemming per werkgever
Inloggen via de REST API kan alleen op debiteurniveau, niet met een masterlogin in een accountantsomgeving van Nmbrs. Voor een accountantskantoor met veel werkgevers betekent dat: toestemming per werkgever regelen en bijhouden.
SOAP stopt op 1 maart 2027
Oudere koppelingen gebruiken de SOAP API, versie 3.0, met een gebruikersnaam en API-token. Nmbrs stopt per 1 maart 2027 met de ondersteuning daarvan en raadt de REST API aan. Draait jouw koppeling nog op SOAP, plan de overstap dan ruim voor die datum.
Limieten en testen
Hoeveel verzoeken je mag doen, hangt af van het abonnement dat je in het developerportal kiest. Tijdens de ontwikkeling is dat aantal lager. Een productieabonnement met hogere limieten keurt Nmbrs pas goed na een geslaagde demo. Om te testen heb je een Nmbrs-testaccount nodig.
Webhooks en periodes
Webhooks stel je in op debiteurniveau, bijvoorbeeld voor een afgeronde run of een aangemaakt journaal, en je kunt ze ook via de API beheren. Houd er rekening mee dat Nmbrs per periode werkt: januari is periode 1, en een werkgever verloont per maand, per vier weken of per week.
Een koppeling verplaatst gegevens. AI kan daartussen lezen, sorteren en een voorstel klaarzetten. Waar het ertoe doet, beslist een mens.
Afwijkingen vinden vóór de run
AI kan uren en toeslagen vergelijken met het rooster en met vorige periodes, en opvallende regels markeren: een verdubbeling, een toeslag zonder avonddienst. De salarisadministrateur kijkt ze na en beslist. De verloning zelf blijft mensenwerk.
Uitleg zonder salarisgegevens
Een assistent kan medewerkers uitleggen wat een looncomponent betekent, op basis van jullie eigen uitleg en de cao. Daarvoor hoeft hij niet bij individuele loonstroken te kunnen. Vragen over iemands eigen salaris gaan naar een mens.
Wat AI niet ziet
Salarisgegevens en BSN horen niet in een prompt. Koppel je toch een AI-stap aan Nmbrs, geef hem dan alleen de gegevens die nodig zijn, schrijf elke aanroep weg in een log en laat hem niets wijzigen.
Mutaties in de verkeerde periode
Een mutatie die in de verkeerde periode valt, levert een correctie op in een volgende run. Bepaal vooraf per stroom welke datum de periode bepaalt: de werkdatum, de datum van goedkeuring of de ingangsdatum.
De wekelijkse update
Nmbrs plant elke week een update, meestal op woensdag om 20.00 uur. Een batch die op dat moment draait, kan mislukken. Kijk op de statuspagina en plan grote synchronisaties op een ander moment.
Twee bronnen voor één medewerker
Werk je met een HR-systeem naast Nmbrs, leg dan vast welk systeem leidend is voor adres, contract en bankrekening. Anders overschrijven ze elkaar en weet niemand meer welke waarde klopt.
Eén werkgever valt stil
Omdat je per werkgever toestemming krijgt, kan de koppeling voor één werkgever stoppen terwijl de rest gewoon doorloopt. Monitor daarom per werkgever, niet alleen de koppeling als geheel.
Wat moet waarheen
Welke gegevens gaan over, in welke richting, en welk systeem leidend is als twee waarden verschillen. Dat staat op papier voordat er iets gebouwd wordt. Voor deze koppeling gaat het om: Medewerkers en dienstverbanden, Uren, toeslagen en verlof, Journaalposten, Status van de verloning, Afdelingen, functies en kostenplaatsen.
Velden en regels
Per veld de vertaling tussen de systemen: statussen, btw-codes, grootboekrekeningen, artikelnummers. En wat er gebeurt bij een dubbel of een ontbrekend gegeven. Voor deze koppeling gaat het om: REST API met OAuth 2.0, Toestemming per werkgever, SOAP stopt op 1 maart 2027, Limieten en testen, Webhooks en periodes.
Testen met echte gevallen
In een testomgeving of testadministratie, met de uitzonderingen die in de praktijk voorkomen: creditnota's, deelleveringen, gewijzigde klantgegevens.
Live, met logging en bewaking
Elke synchronisatie wordt gelogd en bij een fout krijgt iemand een melding. Verandert de API van een leverancier, dan passen wij de koppeling aan.
Geen accountmanager. Je spreekt iemand die zelf koppelingen bouwt, en die zegt het ook als een standaardkoppeling genoeg is.
- Kantoor aan de Duivendrechtsekade in Amsterdam
- ISO 9001 en ISO 27001, gecertificeerd door Kiwa
- 500 projecten opgeleverd
- 4,8 uit 127 reviews
Heeft Nmbrs een API?
Ja. Nmbrs heeft een REST API, versie 1.0, met OAuth 2.0, en een oudere SOAP API, versie 3.0. Voor de REST API meld je je aan in het developerportal, registreer je je app en neem je een abonnement dat een subscription key oplevert.
Wat gebeurt er met de SOAP API van Nmbrs?
Nmbrs stopt per 1 maart 2027 met de ondersteuning van de SOAP API en raadt aan over te stappen op de REST API. Koppelingen die nog SOAP gebruiken, moeten vóór die datum worden omgebouwd. Let op: bij REST loopt autorisatie per werkgever en niet via een masterlogin.
Heeft Nmbrs webhooks?
Ja. Je stelt ze in op debiteurniveau, onder Integraties, met een naam, een endpoint en de acties waarvoor je een melding wilt, zoals een afgeronde run of een aangemaakt journaal. Na de melding haal je de details op via de API.
Kan Nmbrs journaalposten automatisch naar de boekhouding sturen?
Ja, voor een aantal boekhoudpakketten. De koppeling met Exact Online wordt gebouwd en onderhouden door Exact Online en je activeert hem vanuit Nmbrs. De journaalposten worden dan gesplitst per periode en per kostenplaats of kostensoort.
Hoe test ik een koppeling met Nmbrs?
Je hebt een Nmbrs-testaccount nodig en een ontwikkelabonnement in het developerportal. Daarop gelden lagere limieten dan in productie. Het productieabonnement keurt Nmbrs pas goed na een geslaagde demo, dus neem dat mee in je planning.
Mag AI bij salarisgegevens in Nmbrs?
Wees daar terughoudend mee. Salarisgegevens en BSN zijn gevoelige persoonsgegevens onder de AVG. Laat AI liever werken met gegevens vóór de verloning, zoals uren en roosters, of met algemene uitleg, en geef hem geen schrijfrechten in Nmbrs.
Bronnen
De technische feiten op deze pagina komen uit de officiële documentatie van de leveranciers, gecontroleerd op 19 september 2026. Leveranciers passen hun API's en limieten aan; bij een koppeling kijken we altijd naar de actuele stand.