Integratie · Beschikbaar

e-Boekhouden koppelen

Met deze integratie haalt Accountee boekhoudgegevens op uit e-Boekhouden — mutaties, saldi en relaties — zodat je agent context heeft bij vragen over dossiers en aangiftes.

Wat je nodig hebt

Een actief e-Boekhouden-account met API-toegang
Rechten om API-tokens aan te maken (Beheer)
Een Accountee workspace met rol eigenaar of beheerder

Stap 1 — API-token aanmaken in e-Boekhouden

Log in op e-Boekhouden
Ga naar Beheer → API-tokens
Klik op Nieuw API-token toevoegen
Geef het token een herkenbare naam, bijv. Accountee
Kopieer het token direct — het wordt maar één keer getoond

Let op: deel je API-token nooit in chat of e-mail. Accountee vraagt het token alleen in het beveiligde koppelvenster in je workspace.

Stap 2 — Koppelen in Accountee

Open je workspace: Connectoren
Zoek e-Boekhouden onder Boekhouding
Zet de schakelaar aan
Plak je API-token en klik op Koppelen

Accountee valideert het token direct bij e-Boekhouden. Bij succes zie je de status Gekoppeld en wordt het token per organisatie veilig opgeslagen.

Wat Accountee ophaalt

Via de e-Boekhouden REST API v1 kan Accountee (nu en in volgende releases) onder andere:

Mutaties en journaalposten opvragen
Grootboekrekeningen en saldi inzien
Relaties (debiteuren/crediteuren) raadplegen
Facturen en administraties benaderen

De agent gebruikt deze data als context bij boekhoud- en belastingvragen — niet als vervanging van je boekhoudpakket.

Technische referentie

e-Boekhouden biedt een moderne REST API op https://api.e-boekhouden.nl. Authenticatie verloopt via een sessietoken:

Sessie starten

POST /v1/session
Content-Type: application/json

{
  "accessToken": "JOUW_API_TOKEN",
  "source": "Accountee"
}

Het antwoord bevat een token (geldig ca. 1 uur) dat je als Authorization-header meestuurt bij vervolgrequests.

Belangrijke endpoints

Endpoint	Doel
`GET /v1/mutation`	Mutaties opvragen (met datumfilters)
`GET /v1/ledger`	Grootboekrekeningen
`GET /v1/relation`	Relaties
`GET /v1/invoice`	Facturen
`DELETE /v1/session`	Sessie beëindigen

Volledige specificatie: OpenAPI (Swagger) en officiële handleiding.

Veiligheid & privacy

API-tokens worden alleen server-side opgeslagen (nooit in de browser-bundle)
Toegang is beperkt tot je organisatie via Row Level Security
Alleen eigenaar/beheerder kan koppelen of ontkoppelen
Bij ontkoppelen wordt het token verwijderd uit je workspace

Problemen oplossen

Token wordt niet geaccepteerd

Controleer of je het volledige token hebt gekopieerd (geen spaties)
Maak zo nodig een nieuw token aan in e-Boekhouden
Controleer of API-toegang is ingeschakeld op je account

Schakelaar is uitgeschakeld

Alleen een eigenaar of beheerder van de workspace kan connectoren beheren. Vraag je beheerder om de koppeling te maken.

Status blijft op "Fout"

Ontkoppel e-Boekhouden, wacht een minuut en koppel opnieuw met een vers token. Blijft het probleem? Neem contact op via Contact.

Volgende stappen

Na een succesvolle koppeling kun je in Accountee vragen stellen over boekhouddata. In komende releases synchroniseren we automatisch mutaties en tonen we connector-activiteit in je dashboard.