Exact Online API-key aanmaken | Volledige uitleg

Exact Online API-sleutel aanmaken en gebruiken

Om Exact Online te koppelen aan externe software is een API-koppeling nodig. In tegenstelling tot sommige andere platforms werkt Exact Online niet met één vaste API-sleutel. In plaats daarvan maak je zelf een Exact Online app aan, waarmee je toegang verleent tot je administratie.

Deze app levert de gegevens op die nodig zijn om veilig met Exact Online te communiceren, zoals een Client ID en Client Secret.

Exact Online App Center

Het aanmaken van een API-koppeling begint in het Exact Online App Center. Dit is de plek waar je applicaties registreert die toegang mogen krijgen tot je Exact Online omgeving.

Let op: om een app aan te kunnen maken heb je de juiste rechten nodig binnen Exact Online. In de praktijk betekent dit dat je meestal eigenaar of beheerder van de administratie moet zijn. Gebruikers met beperkte rechten kunnen het App Center vaak wel bekijken, maar geen apps registreren of beheren.

Weet je niet zeker of je de juiste rechten hebt, controleer dit dan vooraf of vraag de eigenaar van de administratie om de app aan te maken of hierbij mee te kijken.

Je vindt het App Center via: apps.exactonline.com → App Center

Zorg dat je bent ingelogd met een account dat rechten heeft op de administratie die je wilt koppelen.

Een Exact Online app aanmaken

Na het inloggen klik je bovenin op Mijn apps beheren. Vervolgens kies je voor Een app voor productie registreren. Hiermee maak je een app aan die gebruikt kan worden voor een echte, live koppeling.

Je wordt gevraagd om een aantal gegevens in te vullen. De naam van de app mag je zelf kiezen en hoeft niet technisch te zijn. Deze naam gebruik je vooral om later te herkennen waarvoor de app is aangemaakt.

Daarnaast moet je een redirect URL instellen. Deze callback URL wordt aangeleverd door het platform waarmee je Exact Online wilt koppelen, zoals Konnekta. Exact Online gebruikt deze URL om na autorisatie veilig terug te koppelen.

Zonder correcte redirect URL kan de koppeling niet werken.

Client ID, Client Secret en webhook secret

Na het aanmaken van de app genereert Exact Online automatisch een aantal gegevens:

• Client ID
• Client Secret
• Webhook secret

Samen vormen deze gegevens de technische sleutel tot je Exact Online administratie. Met name de Client ID en Client Secret zijn essentieel om gegevens op te halen, zoals facturen, transacties en relaties.

De webhook secret wordt gebruikt wanneer Exact Online meldingen stuurt over wijzigingen, bijvoorbeeld bij nieuwe of aangepaste boekingen. Net als bij Stripe zijn webhooks optioneel, maar verhogen ze de betrouwbaarheid van real-time synchronisatie.

Gegevens gebruiken in Konnekta

Kopieer de Client ID, Client Secret en eventueel de webhook secret en plaats deze op de juiste plek binnen het Konnekta platform. De koppeling gebruikt deze gegevens uitsluitend om de afgesproken automatisering uit te voeren.

Deze gegevens zijn vertrouwelijk. Deel ze nooit via e-mail of openbare kanalen en gebruik ze alleen binnen het platform waarvoor de app is aangemaakt.

Veelgemaakte fouten

Bij Exact Online ontstaan problemen vaak doordat:

• De verkeerde redirect URL wordt ingesteld
• Een app per ongeluk in test of sandbox wordt aangemaakt
• Gegevens uit de verkeerde administratie worden gebruikt
• Client Secret wordt overschreven of kwijtgeraakt

Dit kan ertoe leiden dat een koppeling geen data ophaalt of geen toegang krijgt tot de administratie.

Tot slot

Het aanmaken van een Exact Online API-koppeling vraagt iets meer stappen dan bij sommige andere platforms, maar biedt veel controle en veiligheid. Door een eigen app aan te maken, bepaal je precies welke software toegang krijgt tot je administratie.

Neem de tijd om dit zorgvuldig in te richten. Dat voorkomt fouten en zorgt voor een stabiele koppeling op de lange termijn.