Verbinding opzetten met AFAS Fiscaal

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

Vereisten

Inlezen van de FinWizer GetConnectoren. Voor elk type declaratie (VPB, IB, OB) wordt een aparte GetConnector gebruikt.
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 Fiscaal (in de categorie Fiscaal).
  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. Bij de eerste synchronisatie worden de beschikbare GetConnectoren opgehaald.

Stap 7: Selecteer een GetConnector

  1. Zodra de eerste synchronisatie is afgerond: Kies voor Voeg getconnector toe.
  2. Selecteer de getconnector die je wilt koppelen met FinWizer.
  3. Vul in op welk Declaratie type de getconnector betrekking heeft.
  4. Klik op Toevoegen.

Herhaal deze stappen voor alle GetConnectoren die je wilt toevoegen. Start daarna handmatig de synchronisatie of wacht de nachtelijke synchronisatie af om data op te halen.

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 Fiscaal Gemak

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

Vereisten

Voor het aanmaken van een API-koppeling heb je toegang nodig tot de beheeromgeving van Fiscaal Gemak.
Let op: De API-sleutel is maximaal één jaar geldig. Na het verlopen van de sleutel dient een nieuwe sleutel te worden aangemaakt en de verbinding in FinWizer te worden bijgewerkt.

Stap 1: API-koppeling aanmaken in Fiscaal Gemak

  1. Log in op Fiscaal Gemak en ga naar Uw account → Instellingen → Koppelingen → API-koppelingen.
  2. Klik op + API-koppeling toevoegen.
  3. Vul de volgende gegevens in:
    • Naam — kies een herkenbare naam, bijv. FinWizer
    • Omschrijving — bijv. Koppeling met FinWizer
    • Gekoppelde gebruiker — selecteer de gebruiker waaronder de koppeling wordt aangemaakt
  4. Klik op Opslaan.
  5. Ga naar het tabblad Sleutel en klik op Sleutel toevoegen.
  6. Kopieer het gegenereerde ID en de Sleutel en sla deze veilig op. Let op: De sleutel is na het sluiten van dit venster niet meer te bekijken. Vink Ik heb de sleutel bewaard aan voordat je op OK klikt.

Noteer ook de API-URL van jouw omgeving. Deze is afhankelijk van de omgeving waarmee je inlogt:

  • Inloggen via app.fiscaalgemak.nl → API-URL: https://api-app.fiscaalgemak.nl
  • Inloggen via app2.fiscaalgemak.nl → API-URL: https://api-app2.fiscaalgemak.nl
  • Inloggen via app3.fiscaalgemak.nl → API-URL: https://api-app3.fiscaalgemak.nl

Stap 2: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer Fiscaal Gemak (in de categorie Fiscaal).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Vul de volgende gegevens in:
    • API URL — de URL van jouw Fiscaal Gemak-omgeving (zie stap 1)
    • API Key — de sleutel 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 Mijn Kantoor

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

De Mijn Kantoor-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 een Mijn Kantoor-account nodig met toegang tot alle Mijn Kantoor-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 Mijn Kantoor (in de categorie CRM & Facturatie).
  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 Mijn Kantoor. Doorloop de verdere stappen van de Mijn Kantoor-inlogprocedure. Na een succesvolle login geef je FinWizer toestemming om toegang te krijgen tot je Mijn Kantoor-data.

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


Verbinding opzetten met Simplicate

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

De Simplicate-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 aanmaken van een API token heb je toegang nodig tot de Simplicate instellingen.
Let op: Een API token in Simplicate heeft een verplichte verloopdatum. Na het verlopen van de token dient een nieuwe token te worden aangemaakt en de verbinding in FinWizer te worden bijgewerkt.

Stap 1: API token aanmaken in Simplicate

  1. Log in op Simplicate en ga naar Settings → API.
  2. Klik op Add om een nieuw API token aan te maken.
  3. Selecteer bij Created by de gebruiker onder wiens naam de token wordt aangemaakt.
  4. Stel een Expiration date in.
  5. Klik op Add.
  6. Kopieer de gegenereerde API key en API secret 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 Simplicate (in de categorie CRM & Facturatie).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Vul de volgende gegevens in:
    • Subdomein — het subdomein van jouw Simplicate-omgeving (het deel tussen https:// en .simplicate.nl)
    • API Key — de key uit stap 1
    • API Geheim — het secret uit stap 1
    • Verloopt op — de verloopdatum van de token
  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 Tess

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

De Tess-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 een Client ID en Client Secret nodig die door Tess/Acuity worden verstrekt. Neem hiervoor contact op met Tess (support@acuity.nl) en vermeld dat je de koppeling met FinWizer in gebruik wil nemen.

Stap 1: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer Tess (in de categorie CRM & Facturatie).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Vul de volgende gegevens in:
    • Client ID
    • Client Secret
    • Salesforce-omgeving — het subdomein van jouw Tess-omgeving (het deel tussen https:// en .my.salesforce.com)
  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 Twinfield

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

Vereisten

Voor het autoriseren van de verbinding heb je een Twinfield-account nodig met toegang tot alle Twinfield-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 Twinfield (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 Twinfield. Doorloop de verdere stappen van de Twinfield-inlogprocedure. Na een succesvolle login geef je FinWizer toestemming om toegang te krijgen tot je Twinfield-data.

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

 


Verbinding opzetten met Zenvoices

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

Vereisten

Voor het autoriseren van de verbinding heb je een Zenvoices-gebruiker nodig met API-toegangsrechten. Het wordt aanbevolen hiervoor een aparte gebruiker aan te maken die uitsluitend voor API-toegang wordt gebruikt.

Stap 1: API-gebruiker aanmaken in Zenvoices

  1. Log in op het Zenvoices-portaal en ga naar Beheer → Organisatie → Gebruiker.
  2. Maak een nieuwe gebruiker aan (aanbevolen) of selecteer een bestaande gebruiker.
  3. Bewerk de rechten van de gebruiker en stel de gewenste API-toegangsrechten in.
  4. Noteer de omgevingsnaam, gebruikersnaam en het wachtwoord van deze gebruiker.

Stap 2: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer Zenvoices (in de categorie Pre-boekhouden).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Vul de volgende gegevens in:
    • Omgevingsnaam — de naam van jouw Zenvoices-omgeving
    • Gebruikersnaam — de gebruikersnaam van de API-gebruiker
    • Wachtwoord — het bijbehorende wachtwoord
  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 Blue10

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

Vereisten

Een API-key voor toegang tot de Blue10 omgeving via de Blue10 API.

Stap 1: API-key aanmaken in Blue10

Heb je een Blue10 Enterprise abonnement? Volg dan onderstaande stappen. Heb je geen Enterprise abonnement? Sla deze stap over en neem contact op met Blue10 support.

  1. Open Blue10 en ga naar Beheer → API Key Management.
  2. Klik op Nieuwe API key en vul de volgende gegevens in:
    • Naam — kies een herkenbare naam, bijv. FinWizer
    • Omschrijving — optioneel, bijv. Koppeling met FinWizer
    • Verloopdatum — de verloopdatum mag maximaal één jaar in de toekomst liggen
  3. Klik op Volgende.
  4. Kopieer de gegenereerde API-key en sla deze veilig op. Let op: De API-key verschijnt maar éénmalig in beeld. Sla deze op voordat je verder gaat.
  5. Klik op Bevestigen.

Stap 2: Verbinding aanmaken in FinWizer

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

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

Vereisten

Voor het autoriseren van de verbinding heb je een gebruikersnaam en wachtwoord nodig die door Lyanthe worden verstrekt. Neem hiervoor contact op met Lyanthe en vermeld dat je de koppeling met FinWizer in gebruik wil nemen.

Stap 1: Verbinding aanmaken in FinWizer

  1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
  2. Selecteer Lyanthe (in de categorie Pre-boekhouden).
  3. Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
  4. Vul het subdomein in van jouw Lyanthe-omgeving (het deel tussen https:// en .lyanthe.com).
  5. Vul de gebruikersnaam en het wachtwoord in die je van Lyanthe hebt ontvangen.
  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 Loket

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

Vereisten

Voor het autoriseren van de verbinding heb je een Loket-account nodig met toegang tot alle Loket-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 Loket (in de categorie Salaris).
  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 Loket. Doorloop de verdere stappen van de Loket-inlogprocedure. Na een succesvolle login geef je FinWizer toestemming om toegang te krijgen tot je Loket-data.

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