Finaciële koppelingen: verschil tussen versies

Uit 21Wiki
Naar navigatie springen Naar zoeken springen
 
(24 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 3: Regel 3:
 
== AFAS ==
 
== AFAS ==
  
=== Voorbereiding ===
+
=== Benodigdheden ===
Voorbereiding
+
{| class="wikitable"
 +
|-
 +
! '''Benodigdheid''' !! '''Toelichting'''
 +
|-
 +
| '''App Connector token''' || Token om in te kunnen loggen op het AFAS endpoint
 +
|-
 +
| '''Endpoint''' || De locatie specifiek voor de benodigde adminstratie
 +
|}
 +
 
 +
=== Autoriseren ===
 +
{| class="wikitable"
 +
|-
 +
! '''Stap''' !! '''Omschrijving''' || '''Toelichting'''
 +
|-
 +
| '''1''' || Ga naar Beheer > Organisatie ||
 +
[[Bestand:ExactOnlineSettings1.png|omkaderd|gecentreerd]]
 +
|-
 +
| '''2''' || Ga naar Finance Koppeling ||
 +
[[Bestand:ExactOnlineSettings2.png|omkaderd|gecentreerd]]
 +
|-
 +
| '''3''' || Zet het Export Type op API based ||
 +
[[Bestand:AFASSetting1.png|omkaderd|gecentreerd]]
 +
|}
  
=== Werking ===
+
=== Extra instellingen ===
Werking
+
 
 +
In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden
 +
<br />
 +
 
 +
{| class="wikitable"
 +
|-
 +
! '''Instelling''' !! '''Toelichting'''
 +
 
 +
|-
 +
| ''Exporteer alleen actieve debiteuren'' || Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)
 +
|}
 +
 
 +
'''''[[#top|Terug naar de inhoudsopgave]] ''''' | [[hoofdpagina|Terug naar de hoofdpagina]]
  
 
== Accountview ==
 
== Accountview ==
Regel 64: Regel 98:
 
|-
 
|-
 
| '''3''' || Vul de gegevens voor Accountview in ||  
 
| '''3''' || Vul de gegevens voor Accountview in ||  
Zet het Export Type op API based
+
Zet het Export Type op '''API based'''
 
<br />
 
<br />
 +
Vul het veld '''API Key''' in
 +
<br />
 +
Vul het veld '''API secret''' in
 +
<br />
 +
Vul het veld '''Adminstratie No (administratienummer)''' in
 
[[Bestand:AccountviewSettingsStap1.png|omkaderd|gecentreerd]]
 
[[Bestand:AccountviewSettingsStap1.png|omkaderd|gecentreerd]]
 
|-
 
|-
Regel 74: Regel 113:
  
 
=== Extra instellingen ===
 
=== Extra instellingen ===
 +
 +
In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden
 +
<br />
 +
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
 
! '''Instelling''' !! '''Toelichting'''
 
! '''Instelling''' !! '''Toelichting'''
|-
+
 
|  || In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden
 
 
|-
 
|-
 
| ''Exporteer alleen actieve debiteuren'' || Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)  
 
| ''Exporteer alleen actieve debiteuren'' || Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)  
Regel 86: Regel 128:
 
| ''Relatieverantwoordelijke meesturen'' || Als deze instelling aanstaat wordt een personeelnummer meegestuurd naar Accountview o.b.v. de Relatie verantwoordelijke van de te exporteren debiteur  
 
| ''Relatieverantwoordelijke meesturen'' || Als deze instelling aanstaat wordt een personeelnummer meegestuurd naar Accountview o.b.v. de Relatie verantwoordelijke van de te exporteren debiteur  
 
|}
 
|}
 +
 +
'''''[[#top|Terug naar de inhoudsopgave]] ''''' | [[hoofdpagina|Terug naar de hoofdpagina]]
  
 
== Exact Online ==
 
== Exact Online ==
Regel 120: Regel 164:
 
| '''6''' || Geef de app een '''Naam''' en vul de '''Redirect URI''' (waar de app gegevens naar toe stuurt in, oftewel de 21QUBZ published REST locatie) || [[Bestand:ExactOnlineApps3.png|omkaderd|gecentreerd]]
 
| '''6''' || Geef de app een '''Naam''' en vul de '''Redirect URI''' (waar de app gegevens naar toe stuurt in, oftewel de 21QUBZ published REST locatie) || [[Bestand:ExactOnlineApps3.png|omkaderd|gecentreerd]]
 
|-
 
|-
| '''7''' || Controleer de '''Client ID''' en '''Client secret''' (deze zijn nodig om de koppeling tot stand te brengen vanuit 21QUBZ) || De redirect URI is minder belangrijk want deze sturen we ook direct mee met de aanroep naar de koppeling
+
| '''7''' || Controleer de '''Client ID''' en '''Client secret''' (deze zijn nodig om de koppeling tot stand te brengen vanuit 21QUBZ) || [[Bestand:ExactOnlineApps4.png|omkaderd|gecentreerd]]
[[Bestand:ExactOnlineApps4.png|omkaderd|gecentreerd]]
 
 
|}
 
|}
  
Regel 130: Regel 173:
 
! '''Stap''' !! '''Omschrijving''' !! '''Toelichting'''
 
! '''Stap''' !! '''Omschrijving''' !! '''Toelichting'''
 
|-
 
|-
| '''1''' || Ga naar Beheer > Organisatie ||  
+
| '''1''' || Ga naar '''Beheer > Organisatie''' ||  
 
[[Bestand:ExactOnlineSettings1.png|omkaderd|gecentreerd]]
 
[[Bestand:ExactOnlineSettings1.png|omkaderd|gecentreerd]]
 
|-
 
|-
| '''2''' || Ga naar Finance Koppeling ||  
+
| '''2''' || Ga naar '''Finance Koppeling''' ||  
 
[[Bestand:ExactOnlineSettings2.png|omkaderd|gecentreerd]]
 
[[Bestand:ExactOnlineSettings2.png|omkaderd|gecentreerd]]
 
|-
 
|-
 
| '''3''' || Vul de gegevens voor Exact Online in ||  
 
| '''3''' || Vul de gegevens voor Exact Online in ||  
Zet het Export Type op API based  
+
Zet het Export Type op '''API based'''
 
<br />
 
<br />
 
Kies de correcte nationaliteit voor het Exact Online account (op dit moment alleen Nederland en Belgie)
 
Kies de correcte nationaliteit voor het Exact Online account (op dit moment alleen Nederland en Belgie)
Regel 143: Regel 186:
 
[[Bestand:ExactOnlineSettings3.png|omkaderd|gecentreerd]]
 
[[Bestand:ExactOnlineSettings3.png|omkaderd|gecentreerd]]
 
|-
 
|-
| '''4''' || Klik op Autoriseer applicatie ||
+
| '''4''' || Klik op '''Autoriseer applicatie''' ||
 
|-
 
|-
 
| '''5''' || Log in met het account wat toegang kan verlenen aan de correcte adminstratie ||
 
| '''5''' || Log in met het account wat toegang kan verlenen aan de correcte adminstratie ||
 
|-
 
|-
| '''6''' || Ga akkoord met de voorwaarden en klik op Allow/Toestaan ||
+
| '''6''' || Ga akkoord met de voorwaarden en klik op '''Allow/Toestaan''' ||
 
Als je doorgestuurd wordt naar een blanco scherm, is de koppeling gelukt  
 
Als je doorgestuurd wordt naar een blanco scherm, is de koppeling gelukt  
<br />
 
Navigeer opnieuw naar Finance Koppeling d.m.v. Stap 1 en Stap 2 en bevestig dat er nu een access token is aangemaakt/aangepast
 
 
|}
 
|}
  
 
=== Extra instellingen ===
 
=== Extra instellingen ===
 +
 +
In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden
 +
<br />
 +
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
 
! '''Instelling''' !! '''Toelichting'''
 
! '''Instelling''' !! '''Toelichting'''
|-
 
|  || In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden
 
 
|-
 
|-
 
| ''Exporteer alleen actieve debiteuren'' || Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)  
 
| ''Exporteer alleen actieve debiteuren'' || Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)  
 
|-
 
|-
 
| ''Factuur PDF meesturen'' || Als deze instelling aanstaat wordt ook een PDF bestand meegestuurd naar Exact Online met de financiele mutatie gegevens  
 
| ''Factuur PDF meesturen'' || Als deze instelling aanstaat wordt ook een PDF bestand meegestuurd naar Exact Online met de financiele mutatie gegevens  
 +
|-
 +
| ''Geen datums op factuurregel'' || Als deze instelling aanstaat worden de datums van elke factuurregel niet meegestuurd naar Exact Online
 
|-
 
|-
 
| ''Debiteur update'' || Als deze instelling aanstaat wordt een debiteur die al bestaat in Exact Online geupdate met nieuwe informatie (anders wordt deze nooit meer bijgewerkt)  
 
| ''Debiteur update'' || Als deze instelling aanstaat wordt een debiteur die al bestaat in Exact Online geupdate met nieuwe informatie (anders wordt deze nooit meer bijgewerkt)  
Regel 168: Regel 213:
 
| ''Debiteur identificatie'' || Debiteurnummer gebruikt het debiteurnummer als unieke waarde om te kijken of een relatie al bestaat in Exact Online, BTW/Bedrijfsnaam gebruikt eerst het BTW nummer om te kijken of een relatie al bestaat en als die niet is gevuld wordt gezocht op bedrijfsnaam)
 
| ''Debiteur identificatie'' || Debiteurnummer gebruikt het debiteurnummer als unieke waarde om te kijken of een relatie al bestaat in Exact Online, BTW/Bedrijfsnaam gebruikt eerst het BTW nummer om te kijken of een relatie al bestaat en als die niet is gevuld wordt gezocht op bedrijfsnaam)
 
|}
 
|}
 +
 +
'''''[[#top|Terug naar de inhoudsopgave]] ''''' | [[hoofdpagina|Terug naar de hoofdpagina]]
  
 
== Twinfield ==
 
== Twinfield ==
Regel 173: Regel 220:
 
=== Benodigdheden ===
 
=== Benodigdheden ===
  
 +
{| class="wikitable"
 +
|-
 +
! '''Benodigdheid''' !! '''Toelichting'''
 +
|-
 +
| '''Client ID''' || Identifier van de Twinfield Client
 +
|-
 +
| '''Client secret''' || Secret van de Twinfield Client
 +
|-
 +
| '''Account''' || Inloggegevens van een account voor Twinfield voor de organisatie
 +
|}
 +
 +
=== Autoriseren ===
 +
{| class="wikitable"
 +
|-
 +
! '''Stap''' !! '''Omschrijving''' || '''Toelichting'''
 +
|-
 +
| '''1''' || Ga naar '''Beheer > Organisatie''' ||
 +
[[Bestand:ExactOnlineSettings1.png|omkaderd|gecentreerd]]
 +
|-
 +
| '''2''' || Ga naar '''Finance Koppeling''' ||
 +
[[Bestand:ExactOnlineSettings2.png|omkaderd|gecentreerd]]
 +
|-
 +
| '''3''' || Vul de gegevens voor Twinfield in <br/> Zet het Export Type op '''API based''' <br /> Vul het '''Administratie No (adminstratienummer)''' in ||
 +
[[Bestand:TwinfieldSetting1.png|omkaderd|gecentreerd]]
 +
|-
 +
| '''4''' || Klik op '''Autoriseer applicatie''' ||
 +
|-
 +
| '''5''' || Log in met het account wat toegang kan verlenen aan de correcte adminstratie om toegang te bevestigen || Als je doorgestuurd wordt naar een blanco scherm, is de koppeling gelukt
 +
<br />
 +
Navigeer opnieuw naar Finance Koppeling d.m.v. Stap 1 en Stap 2 en bevestig dat er nu een access token is aangemaakt/aangepast
 +
|}
 +
 +
=== Extra instellingen ===
 +
 +
In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden
 +
<br />
 +
 +
{| class="wikitable"
 +
|-
 +
! '''Instelling''' !! '''Toelichting'''
 +
 +
|-
 +
| ''Exporteer alleen actieve debiteuren'' || Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)
 +
|}
  
=== Werking ===
+
'''''[[#top|Terug naar de inhoudsopgave]] ''''' | [[hoofdpagina|Terug naar de hoofdpagina]]
Werking
 

Huidige versie van 9 feb 2021 om 08:15

Om 21QUBZ te koppelen aan een financieel pakket zijn een aantal stappen nodig. Op deze pagina lopen we door de benodigdheden per financiële koppeling (het aanmaken van een applicatie indien nodig) en de stappen om de koppeling te autoriseren.

AFAS

Benodigdheden

Benodigdheid Toelichting
App Connector token Token om in te kunnen loggen op het AFAS endpoint
Endpoint De locatie specifiek voor de benodigde adminstratie

Autoriseren

Stap Omschrijving Toelichting
1 Ga naar Beheer > Organisatie
ExactOnlineSettings1.png
2 Ga naar Finance Koppeling
ExactOnlineSettings2.png
3 Zet het Export Type op API based
AFASSetting1.png

Extra instellingen

In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden

Instelling Toelichting
Exporteer alleen actieve debiteuren Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)

Terug naar de inhoudsopgave | Terug naar de hoofdpagina

Accountview

Benodigdheden

Benodigdheid Toelichting
API Key Key/identifier van de Accountview applicatie
API Secret Secret van de Accountview applicatie
Administratie nummer Adminstratie nummer om te bepalen met welke administratie gekoppeld wordt
Account Inloggegevens van een account met toegang tot de opgegeven administratie

Accountview App

Stap Omschrijving Toelichting
1 Ga naar https://www.accountview.net/
2 Log in met de inloggegevens van de organisatie waar je de koppeling voor aan wilt maken
3 Hover met je cursor op Ontwikkelaar en klik in de nieuw geopende navigatie op Applicatie toevoegen (of Applicaties indien er al een applicatie is toegevoegd sla dan stap 4 over)
4 Vul de gegevens in
AccountviewAppsStap0.png
5 Open de bestaande of nieuw toegevoegde applicatie Let op dat de waarde voor In ontwikkeling op Nee staat en de waarde voor Actief op Ja


AccountviewAppsStap0.5.png
6 Controleer de API-sleutel en API-secret (deze zijn nodig om de koppeling tot stand te brengen vanuit 21QUBZ) De Naam is belangrijk binnen Accountview want daar kan op gezocht worden om deze toe te voegen en accounts daar rechten voor toe te kennen


AccountviewAppsStap1.png

Autoriseren

Stap Omschrijving Toelichting
1 Ga naar Beheer > Organisatie
ExactOnlineSettings1.png
2 Ga naar Finance Koppeling
ExactOnlineSettings2.png
3 Vul de gegevens voor Accountview in

Zet het Export Type op API based
Vul het veld API Key in
Vul het veld API secret in
Vul het veld Adminstratie No (administratienummer) in

AccountviewSettingsStap1.png
4 Klik op Autoriseer applicatie
5 Log in met het account wat toegang kan verlenen aan de correcte adminstratie

Extra instellingen

In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden

Instelling Toelichting
Exporteer alleen actieve debiteuren Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)
Kostenplaats meesturen Als deze instelling aanstaat wordt ook de kostenplaats opgehaald per factuurregel (o.b.v. artikel) en meegestuurd naar Accountview
Relatieverantwoordelijke meesturen Als deze instelling aanstaat wordt een personeelnummer meegestuurd naar Accountview o.b.v. de Relatie verantwoordelijke van de te exporteren debiteur

Terug naar de inhoudsopgave | Terug naar de hoofdpagina

Exact Online

Benodigdheden

Benodigdheid Toelichting
Client ID Identifier van de Exact Online App
Client secret Secret van de Exact Online App
Divisie code Adminstratie nummer om te bepalen met welke administratie gekoppeld wordt
Account Inloggegevens van een account met toegang tot de opgegeven administratie

Exact Online App

Stap Omschrijving Toelichting
1 Ga naar https://apps.exactonline.com/
2 Klik rechtsboven in het scherm op Inloggen
ExactOnlineApps1.png
3 Log in met de inloggegevens van de organisatie waar je de koppeling voor aan wilt maken
4 Klik op Manage my apps/Mijn apps beheren
ExactOnlineApps2.png
5 Maak een app aan door op de knop met de plus te klikken Of open een bestaande app (sla dan stap 6 over)
6 Geef de app een Naam en vul de Redirect URI (waar de app gegevens naar toe stuurt in, oftewel de 21QUBZ published REST locatie)
ExactOnlineApps3.png
7 Controleer de Client ID en Client secret (deze zijn nodig om de koppeling tot stand te brengen vanuit 21QUBZ)
ExactOnlineApps4.png

Autoriseren

Stap Omschrijving Toelichting
1 Ga naar Beheer > Organisatie
ExactOnlineSettings1.png
2 Ga naar Finance Koppeling
ExactOnlineSettings2.png
3 Vul de gegevens voor Exact Online in

Zet het Export Type op API based
Kies de correcte nationaliteit voor het Exact Online account (op dit moment alleen Nederland en Belgie)

ExactOnlineSettings3.png
4 Klik op Autoriseer applicatie
5 Log in met het account wat toegang kan verlenen aan de correcte adminstratie
6 Ga akkoord met de voorwaarden en klik op Allow/Toestaan

Als je doorgestuurd wordt naar een blanco scherm, is de koppeling gelukt

Extra instellingen

In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden

Instelling Toelichting
Exporteer alleen actieve debiteuren Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)
Factuur PDF meesturen Als deze instelling aanstaat wordt ook een PDF bestand meegestuurd naar Exact Online met de financiele mutatie gegevens
Geen datums op factuurregel Als deze instelling aanstaat worden de datums van elke factuurregel niet meegestuurd naar Exact Online
Debiteur update Als deze instelling aanstaat wordt een debiteur die al bestaat in Exact Online geupdate met nieuwe informatie (anders wordt deze nooit meer bijgewerkt)
Debiteur identificatie Debiteurnummer gebruikt het debiteurnummer als unieke waarde om te kijken of een relatie al bestaat in Exact Online, BTW/Bedrijfsnaam gebruikt eerst het BTW nummer om te kijken of een relatie al bestaat en als die niet is gevuld wordt gezocht op bedrijfsnaam)

Terug naar de inhoudsopgave | Terug naar de hoofdpagina

Twinfield

Benodigdheden

Benodigdheid Toelichting
Client ID Identifier van de Twinfield Client
Client secret Secret van de Twinfield Client
Account Inloggegevens van een account voor Twinfield voor de organisatie

Autoriseren

Stap Omschrijving Toelichting
1 Ga naar Beheer > Organisatie
ExactOnlineSettings1.png
2 Ga naar Finance Koppeling
ExactOnlineSettings2.png
3 Vul de gegevens voor Twinfield in
Zet het Export Type op API based
Vul het Administratie No (adminstratienummer) in
TwinfieldSetting1.png
4 Klik op Autoriseer applicatie
5 Log in met het account wat toegang kan verlenen aan de correcte adminstratie om toegang te bevestigen Als je doorgestuurd wordt naar een blanco scherm, is de koppeling gelukt


Navigeer opnieuw naar Finance Koppeling d.m.v. Stap 1 en Stap 2 en bevestig dat er nu een access token is aangemaakt/aangepast

Extra instellingen

In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden

Instelling Toelichting
Exporteer alleen actieve debiteuren Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)

Terug naar de inhoudsopgave | Terug naar de hoofdpagina