Externe applicaties die een integratie op basis van de Nmbrs REST API hebben gebouwd, geven de mogelijkheid om toegang te geven tot Nmbrs gegevens via een consent flow. De consent flow wordt doorlopen om toestemming te geven tot de gegevens in jouw Nmbrs administratie, vergelijkbaar met 'login met Google'. Deze flow wordt doorlopen om een koppeling te leggen.

Zodra je vanuit de externe applicatie kiest voor 'koppelen met Nmbrs', wordt gevraagd om in te loggen bij Nmbrs. Het is van belang dat je hier inlogt met een klantlogin/bedrijfslogin zodat je toestemming kan geven tot de data binnen het bedrijf.

De juiste omgeving kiezen

Als je toegang hebt tot meerdere Nmbrs omgevingen, zul je de juiste moeten kiezen in de lijst met beschikbare omgevingen. Weet je niet wat je domein is, dan kan je dat hier op zoeken bij 'ik ben mijn subdomein vergeten' Daar vul je het mailadres in waarmee je inlogt.  

Wanneer je succesvol bent ingelogd, wordt het scherm om te koppelen getoond. De uitgevraagde gegevens van de externe applicatie worden getoond, samen met de profielen waarmee je toestemming kan geven. Zodra minimaal één profiel geselecteerd is, wordt de knop 'allow' groen en kan de koppeling gelegd worden.

Toegang geven tot meerdere administraties met hetzelfde e-mailadres

Toegang (consent) kan voor meerdere bedrijven tegelijk gegeven worden zolang deze in hetzelfde Nmbrs domein verwerkt worden. Hier is de vereiste dat er bij al deze debiteuren hetzelfde e-mailadres actief is en dat er minimaal één keer is ingelogd in de UI van Nmbrs met het profiel.

Nmbrs consent flow Troubleshoot

Errors anders dan invalid login

Het kan voorkomen dat er een 403 pagina naar voren komt. Vaak komt dit door cookies. Het makkelijkste is om het dan even in de incognito browser te proberen. Daar gaat het wel goed.