Finaciële koppelingen

Uit 21Wiki
Naar navigatie springen Naar zoeken springen

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)

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

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)


De redirect URI is minder belangrijk want deze sturen we ook direct mee met de aanroep naar de koppeling ||
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
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)

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)