Verbinding opzetten met Nmbrs

Met de Nmbrs-verbinding in FinWizer wordt data (Administraties) automatisch uitgelezen via de Nmbrs SOAP API.

FinWizer maakt gebruik van de SOAP API (en niet de REST API), zodat nieuwe klanten automatisch worden opgehaald zonder dat de verbinding opnieuw geautoriseerd hoeft te worden. Met de REST API van Nmbrs is dit niet mogelijk.

Vereisten

Voor het aanmaken van een API-token heb je een Nmbrs-account nodig met een gebruikerstemplate gebaseerd op Master Accountant (in een accountantomgeving) of Master Client (in een business-omgeving).

Het API-token dient toegang te hebben tot de volgende services:

Company Services

• Company_GetCurrentPeriod
• List_GetByDebtor
• List_GetByOrganisation
• Run_GetList

Debtor Services

• Debtor_Get
• List_GetAll
• Tags_Get

Stap 1: API-token aanmaken in Nmbrs

1. Log in op Nmbrs en klik op het gebruikersicoon rechtsboven in het scherm.
2. Klik op Gebruiker profiel.
3. Open het tabblad API Token.
4. Klik op API account activeren.
5. Noteer het e-mailadres (dit is je gebruikersnaam) en kopieer de gegenereerde token.

Meer informatie over het aanmaken van een API-token vind je in de Nmbrs-documentatie.

Stap 2: Verbinding aanmaken in FinWizer

1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
2. Selecteer Nmbrs (in de categorie Salaris).
3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
4. Vul de volgende gegevens in:
   1. Gebruikersnaam — het e-mailadres waarmee je inlogt in Nmbrs
   2. Domein — het domein van jouw Nmbrs-omgeving
   3. API token — de token uit stap 1
5. Klik op Bevestig.

De verbinding is nu actief en FinWizer begint automatisch met het ophalen van de data. Controleer of de verbinding succesvol is geautoriseerd via de melding Verbinding succesvol geautoriseerd op de verbindingspagina.