De loonadministratie koppelen

De koppeling met Nmbrs, veld voor veld. Wat er van Morris naar de loonadministratie gaat — inclusief burgerservicenummer en rekeningnummer — wat er terugkomt, en waar de koppeling per vestiging aan of uit staat.

Wanneer gebruik je dit

Je wilt dat een nieuwe medewerker en zijn loon niet twee keer ingetikt hoeven te worden: één keer in Morris en één keer in de loonadministratie. Met deze koppeling geeft Morris de dossiergegevens door aan Nmbrs.

Het blok staat onder Instellingen, links onder Systeem bij de ingang Koppelingen, direct onder DocuSeal.

De velden

Koppeling actief — de schakelaar bovenaan; rechtsboven staat hetzelfde als bolletje Actief of Uit. Staat hij uit, dan slaat Morris elke synchronisatie voor die vestiging over: de opdracht wordt overgeslagen, niet uitgevoerd.

Server — het adres van de dienst, met https://api.nmbrsapp.com/api als voorbeeld in het veld.

Abonnementssleutel — de sleutel van je Nmbrs-abonnement. Net als bij de handtekeningdienst geldt hier laat leeg om te behouden: het veld is altijd leeg, rechts ernaast staat of er al een sleutel bewaard is.

Client ID en Client secret — de gegevens waarmee Morris namens jou mag inloggen. De client secret werkt ook volgens laat leeg om te behouden; de client ID is gewoon zichtbaar.

Toegang — geen invoerveld maar een statusregel. Er staat Ingelogd of Niet ingelogd. Zonder geldige inlog haalt Morris niets op en stuurt hij niets door, hoe goed de rest ook ingevuld staat.

Onder het kopje OAuth staan de drie adressen die bij het inloggen horen: Redirect URI (waar je na het inloggen terugkomt), Auth URL (waar je inlogt) en Token URL (waar Morris zijn sleutel ophaalt).

Scope is de lijst rechten die Morris bij Nmbrs aanvraagt — gegevens over dienstverband, persoonsgegevens, betalingen, bankrekening en salarisinstellingen. Achter het vraagteken staat het duidelijk: alleen aanpassen in overleg met Nmbrs. Haal je er een recht uit, dan mislukt het onderdeel van de synchronisatie dat dat recht nodig heeft.

Inloggen

Onderaan het blok staan drie knoppen: Verbinding testen, Opnieuw inloggen en Opslaan.

1. Vul de velden in en klik op Opslaan.
2. Klik op Opnieuw inloggen. Er opent een nieuw tabblad naar de inlogpagina van Nmbrs.
3. Ben je terug, dan hoort Toegang op Ingelogd te staan.

Lukt dat automatisch niet, dan is er een uitweg. Onder het Nmbrs-blok staat een apart blok Nmbrs-code inwisselen met één veld: Code uit de callback-URL. Log met de hand in bij Nmbrs, kopieer de code uit de adresbalk, plak hem hier en klik op Inwisselen.

Morris vernieuwt de inlog daarna zelf: elke drie kwartier voor alle actieve koppelingen, en nog eens vlak voor een synchronisatie als de sleutel binnen vijf minuten verloopt.

Wat er naar de loonadministratie gaat

Bij een volledige synchronisatie van één medewerker stuurt Morris dit door:

• Persoonsgegevens — voornaam, achternaam, personeelsnummer, geboortedatum, geslacht, zakelijk e-mailadres en telefoonnummer.
• Het burgerservicenummer, als apart bericht na de persoonsgegevens.
• Het woonadres — straat, huisnummer met toevoeging, postcode en plaats.
• Het rekeningnummer, als hoofdrekening.
• Het dienstverband — begindatum, einddatum, proeftijd, uren per week en of het bepaalde tijd, onbepaalde tijd of een oproepcontract is.
• Het werkrooster, bij een fulltimer: de uren per week verdeeld over vijf dagen.
• De loonheffingskorting en de sociale-verzekeringsinstellingen.
• Het loon — het bruto maandloon bij een fulltimer, het basisuurloon bij de rest.
• De functie.

Bij een loonwijziging — bijvoorbeeld de verjaardagsautomatisering — gaat uitsluitend het loon mee, om de rest van de geschiedenis niet te vervuilen.

Morris kijkt eerst wat er al in de loonadministratie staat en slaat een onderdeel over als het daar al precies zo staat.

Wat er terugkomt

Vrijwel niets. Na afloop haalt Morris de zojuist weggeschreven gegevens terug om te controleren of ze goed zijn aangekomen, maar die controle verandert niets aan het dossier; ze wordt alleen vastgelegd.

Het enige dat Morris echt overneemt en bewaart, is het medewerkernummer dat de loonadministratie aan de nieuwe medewerker toekent. Daaraan herkent hij bij een volgende synchronisatie dat de persoon er al is.

Er komen dus geen lonen, contracten of persoonsgegevens uit de loonadministratie terug naar Morris. Het verkeer is één kant op.

Verbinding testen

De knop Verbinding testen probeert een reeks adressen bij de dienst tot er één antwoordt. Je komt terug op het instellingenscherm met een melding als:

Test nmbrs: {"provider":"nmbrs","ok":true,"status":200,"testedUrl":"…"}

Kijk ook hier naar status en niet naar ok: ok staat op waar zodra er antwoord komt, ook bij een 401. Is er voor de gekozen vestiging nog niets ingevuld, dan krijg je een foutpagina met Fout: integration_not_configured; ontbreekt het serveradres of de abonnementssleutel, dan Fout: nmbrs_missing_base_or_key.

Per vestiging of bedrijfsbreed

Deze koppeling staat per vestiging aan of uit, en wordt opgeslagen bij de vestiging die je bovenin gekozen hebt. Werk je met meerdere vestigingen die elk hun eigen administratie hebben, dan vul je hem dus meerdere keren in.

Dat is precies andersom dan bij de contractinstellingen onder Personeelsbeheer: die gelden juist voor je hele bedrijf tegelijk. Twee schermen naast elkaar, twee verschillende reikwijdtes — het is een van de makkelijkste dingen om in te struikelen.

Let op

• Een vestiging moet aan een bedrijf in de loonadministratie gekoppeld zijn, en die koppeling is niet in te stellen. Ze ligt vast in de code. Staat jouw vestiging er niet bij, dan mislukt elke synchronisatie met de melding unknown_branch achter de rode knop Fout bekijken bij de sync job. De velden op dit scherm veranderen daar niets aan; dit is werk voor de bouwer.
• Het veld Server stuurt de synchronisatie niet aan. Het wordt gebruikt bij Verbinding testen, maar de synchronisatie zelf gebruikt een vast adres. Een ander adres invullen verandert dus niets aan waar je gegevens heen gaan.
• Uit betekent alleen uit als de koppeling er al is. Heb je voor een vestiging nog nooit iets opgeslagen, dan is er geen rij om uit te zetten en mislukt een synchronisatie met een foutmelding in plaats van dat hij netjes wordt overgeslagen.
• Er gaan bijzondere persoonsgegevens over deze koppeling. Burgerservicenummer, rekeningnummer, geboortedatum en loon verlaten Morris zodra er een synchronisatie loopt. Zet de koppeling dus pas aan als je zeker weet dat hij naar de goede administratie wijst.
• Een mislukte synchronisatie is zichtbaar, geen stilte. Hij komt in de lijst met sync jobs te staan met een rode knop, en er verschijnt een melding in de Meldingen-lijst.

Bijgewerkt op 26 augustus 2026