Verbinding opzetten met KantoorGemak

Met de KantoorGemak-verbinding in FinWizer wordt data (Administraties, Gebruikers) automatisch uitgelezen via de KantoorGemak API (Microsoft Dynamics 365 Sales). Voor de verbinding zijn eerst een aantal stappen nodig in Microsoft Azure en in KantoorGemak zelf.

De KantoorGemak-verbinding kan ingesteld worden als bron voor het automatisch aanmaken en beheren van combinaties. Meer hierover lees je in het artikel Combinaties aanmaken en beheren in FinWizer.

Vereisten

• Toegang tot Microsoft Azure om een app-registratie aan te maken
• Een account met Systeembeheerder-rechten in KantoorGemak (Dynamics 365 Sales) voor de eerste autorisatie

Stap 1: App-registratie aanmaken in Microsoft Azure

1. Open Microsoft Azure en ga naar App registrations.
2. Klik op New Registration.
3. Vul een herkenbare naam in, bijv. FinWizer Dynamics connection, en klik op Register.
4. Open het tabblad Authentication en kies bij Platform configurations voor Add a platform → Web.
5. Vul bij Redirect URIs het volgende in: https://app.finwizer.nl/kantoorgemak-callback en klik op Configure.
6. Open het tabblad API permissions en klik op Add a permission.
7. Selecteer Dynamics CRM, kies Delegated permissions, selecteer user_impersonation en klik op Add permissions.
8. Open het tabblad Certificates & secrets en klik op New Client Secret.
9. Vul een beschrijving in, kies een geldigheidsduur en klik op Add.
10. Kopieer de waarde onder Value — dit is de Client Secret die je in FinWizer nodig hebt. Let op: Kopieer de Value, niet de Secret ID. De waarde is maar éénmalig zichtbaar.
11. Open het tabblad Overview en noteer de volgende waarden:
    • Application (client) ID → dit is de Client ID voor FinWizer
    • Directory (tenant) ID → dit is de Tenant ID voor FinWizer

Stap 2: App-registratie in KantoorGemak

1. Open Dynamics 365 Sales en ga naar Advanced settings → System: Security → Users of application.
2. Klik op Add app user en selecteer de app-registratie die je in stap 1 hebt aangemaakt.
3. Klik op Add.
4. Selecteer een Business unit en voeg de beveiligingsrollen System Admin en Basic User toe.
5. Klik op Save.

Stap 3: Verbinding aanmaken in FinWizer

1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
2. Selecteer KantoorGemak (in de categorie CRM & Facturatie).
3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
4. Vul de volgende gegevens in:
   • Tenant ID
   • Client ID
   • Client Secret
   • API URL (bijv. https://[businessunit].api.crm4.dynamics.com)
5. Klik op Bevestig.

De eerste autorisatie dient te worden uitgevoerd door een gebruiker met Systeembeheerder-rechten in KantoorGemak. Via deze gebruiker worden de benodigde rechten voor de FinWizer-applicatie gedelegeerd.

De verbinding is nu actief en FinWizer begint automatisch met het ophalen van de data.