Menu

Verbinding opzetten met Hix

Met de Hix-verbinding in FinWizer wordt data (Administraties, Gebruikers, Toegang) automatisch uitgelezen via de Hix API.

Vereisten

Voor het autoriseren van de verbinding heb je de volgende gegevens uit Hix nodig:

  • Tenant — het unieke deel van de URL wanneer je bent ingelogd in Hix (bijv. https://[tenant].securelogin.nu)
  • API-key — een API-token aangemaakt in Hix

Stap 1: API-token aanmaken in Hix

  1. Ga naar jouw Hix-omgeving via https://[tenant].securelogin.nu/start en klik op Beheerdersportaal.
  2. Ga naar Instellingen → Toegang → API.
  3. Klik op het + icoon om een nieuw API-token aan te maken.
  4. Klik op Copy token om de token te kopiëren en sla deze veilig op. Let op: De token wordt maar éénmalig getoond. Sla deze op voordat je het venster sluit.

Stap 2: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer Hix (in de categorie Overig).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Vul bij de URL-veld je tenant in (het deel tussen https:// en .securelogin.nu).
  5. Vul de API-key in.
  6. 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.


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.


Verbinding opzetten met Fortes Milestones

Met de Fortes Milestones-verbinding in FinWizer wordt data (Administraties, Gebruikers, Toegang, Verbruik) automatisch uitgelezen via de Fortes Milestones API.

De Fortes Milestones-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

Voor het autoriseren van de verbinding heb je beheerderstoegang nodig tot Fortes Milestones om een OAuth-applicatie aan te kunnen maken.

Stap 1: OAuth-applicatie aanmaken in Fortes Milestones

  1. Log in op Fortes Milestones en ga naar Beveiliging → OAuth applicaties.
  2. Klik op Nieuw om een nieuwe OAuth-applicatie aan te maken.
  3. Vul de volgende gegevens in:
    • Naam: kies een herkenbare naam, bijv. FinWizer
    • Redirect URI: https://app.finwizer.nl
  4. Kopieer het gegenereerde Client ID en Secret en sla deze veilig op.
  5. Klik op Ok.

Stap 2: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer Fortes Milestones (Qics) (in de categorie CRM & Facturatie).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Vul de Client ID en het Client Secret in 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.


Verbinding opzetten met Yuki

Met de Yuki-verbinding in FinWizer wordt data (Administraties, Gebruikers, Toegang) automatisch uitgelezen via de Yuki API. De verbinding wordt per Yuki-portaal opgezet. Heb je meerdere portalen? Dan maak je voor elk portaal een aparte verbinding aan in FinWizer. Daarbij geef je aan welk portaal het hoofdportaal is en welke portalen als subportaal hieraan gekoppeld zijn.

Voor het ophalen van verbruiksdata — zoals actieve licenties per administratie — kan een aanvullende upload van de Yuki-factuurspecificatie gedaan worden. Dit wordt toegelicht in stap 3.

Vereisten

Voor het aanmaken van een API-sleutel in Yuki heb je een account nodig met de rol Portaalbeheerder.

De API-sleutel moet minimaal toegang hebben tot de webservices

  • Financieel
  • Archief
  • Domeinen

Stap 1: API-sleutel aanmaken in Yuki

  1. Log in op het Yuki portaal en klik rechtsboven op het Instellingen-icoon.
  2. Ga naar Webservices.
  3. Klik op Voeg nieuwe API-sleutel toe en volg de stappen om de sleutel aan te maken.
  4. Kopieer de gegenereerde API-sleutel en sla deze veilig op.

Stap 2: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer Yuki (in de categorie Boekhouden).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Is dit portaal een subportaal? Vink dan Subportaal aan en selecteer het bijbehorende hoofdportaal uit de lijst.
  5. Vul de portaalnaam en de API-sleutel in.
  6. 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. Herhaal deze stappen voor elk Yuki-portaal dat je wil koppelen.

Stap 3: Verbruiksdata uploaden via factuurspecificatie

De Yuki API geeft geen details over actieve licenties per administratie. Om deze verbruiksdata toch beschikbaar te maken in FinWizer, upload je de Yuki-factuurspecificatie als CSV-bestand.

  1. Download de factuurspecificatie als CSV-bestand vanuit Yuki.
  2. Ga in FinWizer naar Verbindingen en open de Yuki-verbinding van het hoofdportaal.
  3. Ga naar het tabblad Facturen.
  4. Zoek de juiste periode op en klik op het upload-icoon naast het bestandstype CSV.
  5. Selecteer het CSV-bestand en upload het.

De verbruiksdata uit de factuurspecificatie wordt verwerkt voor zowel het hoofdportaal als alle gekoppelde subportalen.


Verbinding opzetten met AFAS (CRM)

Met de AFAS-verbinding in FinWizer wordt data (Administraties) automatisch uitgelezen via de AFAS GetConnectoren.

De AFAS CRM-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

Inlezen van de FinWizer GetConnectoren.
Daarnaast moet de gebruiker waarmee de verbinding wordt geautoriseerd beschikken over:

  • Voldoende rechten voor het uitlezen van stamgegevens (debiteuren)
  • Rechten voor het genereren van een gebruikerstoken

Let op: Is deze gebruiker lid van één of meer groepen? Dan moeten deze groepen dezelfde rechten hebben.

Stap 1: Verbinding aanmaken in FinWizer (deel 1)

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer AFAS (in de categorie CRM & Faturatie).
  3. Klik op Download AFAS getconnector om de default getconnector te downloaden (.zip bestand).

Vervolg nu eerst de stappen in AFAS.

Stap 2: Gebruikersrechten instellen in AFAS

  1. Open AFAS ERP en ga naar Algemeen → Beheer → Autorisatie tool.
  2. Open het tabblad Onderhoud gebruikers en selecteer de gebruiker waarmee je de koppeling wil autoriseren.
  3. Noteer via het tabblad Lid van groep tot welke groepen deze gebruiker behoort — je hebt dit later nodig.
  4. Open het tabblad Autorisatie en zet alle onderdelen onder Algemeen → Beheer → App connector → Tabbladen op Onderhouden.

Is de gebruiker lid van meerdere groepen? Voer dan dezelfde stappen uit voor elke groep:

  1. Ga naar Onderhoud groepen, selecteer de betreffende groep en open het tabblad Autorisatie.
  2. Zet ook hier alle onderdelen onder Algemeen → Beheer → App connector → Tabbladen op Onderhouden.

Als AFAS vraagt om de omgeving opnieuw te openen, kies dan voor Ja.

Stap 3: GetConnectoren importeren

  1. Klik met de rechtermuisknop op het .zip bestand met de FinWizer getconnector en kies Alles uitpakken.
  2. Ga in AFAS naar Algemeen → Uitvoer → Beheer → GetConnector.
  3. Klik op 4. Importeren (staat dit er niet? Voeg dan eerst de autorisatie Importeren GetConnectoren toe via de AFAS-helppagina. Het kan ook onder Meer acties → Importeren staan).
  4. Er opent een venster Importeren definities. Kies Bestand, selecteer alle uitgepakte bestanden en klik op Open.
  5. Klik op Voltooien.

Stap 4: App connector inrichten

  1. Ga in AFAS naar Algemeen → Beheer → App connector en klik op Nieuw.
  2. Vul bij Omschrijving een herkenbare naam in, bijvoorbeeld FinWizer.
  3. Kies bij Gebruikersgroep de groep waarvoor je de rechten hebt ingesteld in stap 2.
  4. Klik op Voltooien.
  5. Vink in het volgende venster Geblokkeerd uit.
  6. Kies in de linkerkolom GetConnectoren en klik op Nieuw.
  7. Zoek in de lijst op FinWizer en selecteer alle FinWizer GetConnectoren.
  8. Klik op Voltooien.

Stap 5: Gebruikerstoken aanmaken

  1. Kies in de linkerkolom van de App connector Gebruikerstokens en klik op Nieuw.
  2. Selecteer bij Gebruiker de gebruiker waarvoor je de rechten hebt ingesteld in stap 2.
  3. Vul een duidelijke Omschrijving in zodat de koppeling herkenbaar is, bijv. FinWizer koppeling.
  4. Klik op Volgende. Er verschijnt een venster met de gegenereerde token.
  5. Kopieer de volledige token, inclusief <token> en </token>, en sla deze veilig op. Let op: De token wordt maar éénmalig getoond door AFAS. Sla deze op voordat je verder gaat.
  6. Klik op Voltooien.

Vervolg nu de stappen in FinWizer.

Stap 6: Verbinding aanmaken in FinWizer (deel 2)

  1. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  2. Vul het AFAS Online member nummer in (5 cijfers uit de omgevingsnaam).
  3. Plak de gegenereerde token in het tokenveld.
  4. Klik op Bevestig.

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

Mapping aanpassen

Afhankelijk van de inrichting van jouw AFAS-omgeving kan het nodig zijn om de mapping in de GetConnector aan te passen. Neem bij twijfel contact op met je AFAS-beheerder of met FinWizer-support.


Verbinding opzetten met Exact Online

Met de Exact Online-verbinding in FinWizer wordt data (Administraties, Gebruikers, Toegang, Verbruik) automatisch uitgelezen via de Exact Online API.

Vereisten

Voor het autoriseren van de verbinding heb je een Exact Online-account nodig met toegang tot alle Exact Online-data die je in FinWizer wil bijhouden.

Stap 1: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer Exact Online (in de categorie Boekhouden).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Klik op Bevestig.

Stap 2: Verbinding autoriseren

Na het aanmaken van de verbinding word je automatisch doorgeleid naar de inlogpagina van Exact Online. Doorloop de verdere stappen van de Exact Online-inlogprocedure. Na een succesvolle login geef je FinWizer toestemming om toegang te krijgen tot je Exact Online-data.

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

 


Verbinding opzetten met WeFact

Met de WeFact-verbinding in FinWizer kun je de verbruiksdata uit WeFact bijhouden per klant. De data wordt aangeleverd door periodiek de XML-factuurspecificatie te uploaden van WeFact.

Stap 1: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer WeFact (in de categorie Overig).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Klik op Bevestig. De verbinding is nu aangemaakt.

Stap 2: XML ophalen uit WeFact

WeFact stuurt bij elke factuur een e-mail met als bijlage een XML-bestand met de factuurdetails. Sla dit XML-bestand op vanuit de betreffende factuur-e-mail.

Stap 3: XML uploaden in FinWizer

  1. Ga in FinWizer naar Verbindingen en open de WeFact-verbinding.
  2. Ga naar het tabblad Facturen.
  3. Zoek de juiste periode op en klik op het upload-icoon naast de betreffende periode.
  4. Selecteer het opgeslagen XML-bestand en upload het. De bijbehorende PDF wordt automatisch uit het XML-bestand uitgelezen.

De data wordt verwerkt en is na de upload beschikbaar in FinWizer.


Verbinding opzetten met Basecone

Met de Basecone-verbinding in FinWizer wordt data (Administraties, Gebruikers, Toegang, Verbruik) automatisch uitgelezen via de Basecone API.

Vereisten

Voor het autoriseren van de verbinding heb je de volgende Basecone-gegevens nodig:

  • Kantoorcode — de unieke code van jouw kantooromgeving in Basecone
  • Gebruikersnaam — het e-mailadres van de Basecone-gebruiker waarmee de verbinding wordt opgezet
  • Wachtwoord — het bijbehorende wachtwoord

Stap 1: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer Basecone (in de categorie Pre-boekhouden).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Vul de Kantoorcode, gebruikersnaam en het wachtwoord in.
  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.


Verbinding opzetten met Visionplanner

Met de Visionplanner-verbinding in FinWizer kun je de verbruiksdata uit Visionplanner bijhouden per klant. De data wordt aangeleverd door periodiek een CSV-factuurspecificatie te uploaden uit Visionplanner.

Stap 1: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer Visionplanner (in de categorie Overig).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Klik op Bevestig. De verbinding is nu aangemaakt.

Stap 2: CSV downloaden uit Visionplanner

  1. Log in op Visionplanner en ga naar Facturen.
  2. Klik op Download factuurdetails om de CSV-factuurspecificatie te downloaden.

Stap 3: CSV uploaden in FinWizer

  1. Ga in FinWizer naar Verbindingen en open de Visionplanner-verbinding.
  2. Ga naar het tabblad Facturen.
  3. Zoek de juiste periode op en klik op het upload-icoon naast de betreffende periode.
  4. Selecteer het gedownloade CSV-bestand en upload het. Naast het CSV-bestand kun je ook een PDF uploaden, bijvoorbeeld de bijbehorende factuur.

De data wordt verwerkt en is na de upload beschikbaar in FinWizer.


Data importeren zonder automatische verbinding

Heeft jouw applicatie nog geen automatische koppeling met FinWizer? Dan zijn er drie manieren om data te importeren: Manual Import, Manual Import CRM en Custom API. In dit artikel lees je wanneer je welke optie gebruikt en hoe je ermee aan de slag gaat.

Optie   Geschikt voor Methode
Manual Import Administraties, gebruikers en verbruik Excel-upload per periode
Manual Import CRM CRM-data als basis voor combinaties Excel-upload, niet periodegebonden
Custom API Geautomatiseerde import van administraties en gebruikers API-koppeling

 

Verbinding aanmaken

Voor alle drie de opties maak je eerst een verbinding aan in FinWizer:

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer de gewenste optie: Manual Import, Manual Import CRM of Custom API.
  3. Vul een herkenbare applicatienaam en optioneel een omschrijving in en klik op Bevestig.

Manual Import

Met de Manual Import laad je via een Excel-template periodieke data in voor een applicatie. Per periode kunnen administraties, gebruikers en verbruiksdata worden geïmporteerd.

  1. Open de aangemaakte verbinding en ga naar het tabblad Verbinding.
  2. Klik op Download template om de Excel-template op te halen.
  3. Vul de template in met de juiste gegevens.
      • Id en Name zijn verplichte velden; het Id moet een unieke waarde zijn.
      • Het veld Amount in de verbruikstabel geeft de producttelling aan en moet een geheel getal zijn.
  4. Ga naar het tabblad Facturen, zoek de juiste periode op en upload het ingevulde bestand via het upload-icoon naast de betreffende periode.

De Manual Import past de volgende logica toe: zolang er geen nieuwe data wordt geïmporteerd, blijven de beschikbare administraties en gebruikers onveranderd in de daaropvolgende perioden. Wordt er wél data geïmporteerd voor een nieuwe periode, dan wordt elke administratie of gebruiker die niet voorkomt in de nieuwe import als verwijderd beschouwd vanaf die periode. Verbruiksdata is periode specifiek en moet per periode opnieuw worden aangeleverd.

Manual Import CRM

De Manual Import CRM is specifiek bedoeld voor het importeren van CRM-data die als basis dient voor FinWizer-combinaties. De geïmporteerde data is niet gebonden aan een specifieke periode. De template heeft een iets andere opzet dan de reguliere Manual Import: naast administratiegegevens kunnen ook extra velden worden meegegeven, zoals tags en referenties.

  1. Open de aangemaakte verbinding en ga naar het tabblad Verbinding.
  2. Klik op Download template om de Excel-template op te halen.
  3. Vul de template in met de gewenste administraties, inclusief eventuele tags en referenties.
  4. Klik op Gegevens uploaden om het bestand te importeren.

Custom API

Met de Custom API stel je een geautomatiseerde verbinding in waarmee administraties en gebruikers kunnen worden aangeleverd. Dit is de aangewezen optie als je de import wilt automatiseren vanuit een eigen systeem of script.

  1. Open de aangemaakte verbinding. Onder Verbinding autorisatie vind je de gegenereerde API key.
  2. Kopieer de API key en sla deze veilig op.
    Let op: De API key wordt maar eenmalig getoond. Is de key kwijtgeraakt? Klik dan op Maak nieuwe API key aan om een nieuwe te genereren. De oude key komt daarmee te vervallen.
  3. Gebruik de API key voor de authenticatie in jouw integratie.

De beschikbare endpoints en technische documentatie zijn te vinden op: Custom API documentatie


Blogs

Verbinding opzetten met Fiscaal Gemak

Verbinding opzetten met Fiscaal Gemak
Verbinding opzetten met Mijn Kantoor

Verbinding opzetten met Mijn Kantoor
Verbinding opzetten met Simplicate

Verbinding opzetten met Simplicate

Bekijk alle
blogartikelen