Finaciële koppelingen: verschil tussen versies

Uit 21Wiki
Naar navigatie springen Naar zoeken springen
(Nieuwe pagina aangemaakt met '== AFAS == === Voorbereiding === Voorbereiding === Werking === Werking === Mapping === Mapping == Accountview == === Voorbereiding === Voorbereiding === Werki...')
 
 
(27 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 1: Regel 1:
 +
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 ==
 
== 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]]
 +
|}
 +
 
 +
=== Extra instellingen ===
 +
 
 +
In het Finance Koppeling scherm staan nog extra instellingen die gebruikt kunnen worden
 +
<br />
  
−
=== Werking ===
+
{| class="wikitable"
−
Werking
+
|-
 +
! '''Instelling''' !! '''Toelichting'''
 +
 
 +
|-
 +
| ''Exporteer alleen actieve debiteuren'' || Als deze instelling aanstaat worden alleen "Actieve" relaties geexporteerd naar Exact Online (dus geen verloren klanten of prospecten)
 +
|}
  
−
=== Mapping ===
+
'''''[[#top|Terug naar de inhoudsopgave]] ''''' | [[hoofdpagina|Terug naar de hoofdpagina]]
−
Mapping
 
  
 
== Accountview ==
 
== Accountview ==
  
−
=== Voorbereiding ===
+
=== Benodigdheden ===
−
Voorbereiding
+
{| class="wikitable"
 +
|-
 +
! '''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 ===
 +
{| class="wikitable"
 +
|-
 +
! '''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 || [[Bestand:AccountviewAppsStap0.png|omkaderd|gecentreerd]]
 +
|-
 +
| '''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'''
  
−
=== Werking ===
+
<br />
−
Werking
 
  
−
=== Mapping ===
+
[[Bestand:AccountviewAppsStap0.5.png|omkaderd|gecentreerd]]
−
Mapping
+
|-
 +
| '''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
 +
 
 +
<br />
 +
 
 +
[[Bestand:AccountviewAppsStap1.png|omkaderd|gecentreerd]]
 +
 
 +
|}
 +
 
 +
=== 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 Accountview in ||
 +
Zet het Export Type op '''API based'''
 +
<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]]
 +
|-
 +
| '''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
 +
<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)
 +
|-
 +
| ''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
 +
|}
 +
 
 +
'''''[[#top|Terug naar de inhoudsopgave]] ''''' | [[hoofdpagina|Terug naar de hoofdpagina]]
  
 
== Exact Online ==
 
== Exact Online ==
Regel 44: Regel 154:
 
| '''1''' || Ga naar https://apps.exactonline.com/ ||  
 
| '''1''' || Ga naar https://apps.exactonline.com/ ||  
 
|-
 
|-
−
| '''2''' || Klik rechtsboven in het scherm op Inloggen || [[Bestand:ExactOnlineApps1.png|omkaderd|gecentreerd]]
+
| '''2''' || Klik rechtsboven in het scherm op '''Inloggen''' || [[Bestand:ExactOnlineApps1.png|omkaderd|gecentreerd]]
 
|-
 
|-
 
| '''3''' || Log in met de inloggegevens van de organisatie waar je de koppeling voor aan wilt maken ||  
 
| '''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 || [[Bestand:ExactOnlineApps2.png|omkaderd|gecentreerd]]
+
| '''4''' || Klik op '''Manage my apps/Mijn apps beheren''' || [[Bestand:ExactOnlineApps2.png|omkaderd|gecentreerd]]
 
|-
 
|-
−
| '''5''' || Maak een app aan door op de knop met de plus te klikken || Of open een bestaande app (sla dan stap 6 over)
+
| '''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) || [[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]]
 
 
|}
 
|}
  
−
=== Werking ===
+
=== Autoriseren ===
−
Werking
+
 
 +
{| 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 Exact Online in ||
 +
Zet het Export Type op '''API based'''
 +
<br />
 +
Kies de correcte nationaliteit voor het Exact Online account (op dit moment alleen Nederland en Belgie)
 +
<br />
 +
[[Bestand:ExactOnlineSettings3.png|omkaderd|gecentreerd]]
 +
|-
 +
| '''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
 +
<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)
 +
|-
 +
| ''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)
 +
|}
  
−
=== Mapping ===
+
'''''[[#top|Terug naar de inhoudsopgave]] ''''' | [[hoofdpagina|Terug naar de hoofdpagina]]
−
Mapping
 
  
 
== Twinfield ==
 
== Twinfield ==
Regel 68: 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
 +
|}
  
−
=== Werking ===
+
=== Autoriseren ===
−
Werking
+
{| 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)
 +
|}
  
−
=== Mapping ===
+
'''''[[#top|Terug naar de inhoudsopgave]] ''''' | [[hoofdpagina|Terug naar de hoofdpagina]]
−
Mapping
 

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

Overgenomen van "http://wiki.21south.nl/index.php?title=Finaciële_koppelingen&oldid=2368"