BoekhouderKeesAI · API v1

API-documentatie

Een read-only API om financiële data uit te lezen en bestanden (waaronder het XAF-auditfile) op te halen. Ideaal voor je accountant. Er kan niets geschreven of geboekt worden.

1. Authenticatie (OAuth2 client-credentials)

Je krijgt van de beheerder een client_id en client_secret. Ruil die in voor een access token (1 uur geldig) en stuur dat als Bearer-token mee.

curl -X POST https://boekhouderkeesai.nl/api/v1/oauth/token \
  -d grant_type=client_credentials \
  -d client_id=JOUW_CLIENT_ID \
  -d client_secret=JOUW_CLIENT_SECRET

Antwoord:

{ "access_token": "eyJ...", "token_type": "Bearer", "expires_in": 3600, "scope": "read export" }

Gebruik het token vervolgens:

curl -H "Authorization: Bearer eyJ..." https://boekhouderkeesai.nl/api/v1/grootboek

2. Endpoints

Basis-URL: https://boekhouderkeesai.nl/api/v1. Alle data-endpoints zijn GET en gepagineerd met ?page= & ?per_page= (max 200). Datumfilters waar zinvol: ?van=YYYY-MM-DD&tot=YYYY-MM-DD.

Data lezen (scope read)

Endpoint	Beschrijving
/administratie	Bedrijfs- en administratiegegevens
/grootboek	Rekeningschema (met RGS-code)
/journaalposten /journaalposten/{id}	Boekingen; detail met regels
/verkoopfacturen /verkoopfacturen/{id}	Verkoopfacturen; detail met regels
/inkoopfacturen /inkoopfacturen/{id}	Inkoopfacturen; detail met regels
/relaties /relaties/{id}	Debiteuren/crediteuren
/banktransacties	Bankmutaties
/saldi	Saldibalans (alle rekeningen met saldo)
/btw?jaar=&kwartaal=	BTW-aangiftedata per kwartaal

Bestanden ophalen (scope export)

Endpoint	Beschrijving
/exports/xaf?jaar=	XAF 3.2 auditfile — complete administratie in één XML-bestand
/exports/balans?fmt=pdf|xlsx	Balans
/exports/resultaat?fmt=&year=	Winst- en verliesrekening
/exports/debiteuren?fmt=	Openstaande debiteuren
/exports/crediteuren?fmt=	Openstaande crediteuren
/exports/ohw?fmt=	Onderhanden werk
/exports/btw/xbrl?jaar=&kwartaal=	BTW-aangifte als XBRL (SBR)
/verkoopfacturen/{id}/pdf	Factuur-PDF

Aanleveren (scope write)

Endpoint	Beschrijving
POST /verkoopfacturen	Verkoopfactuur aanleveren of bijwerken. Idempotent op externe_referentie: dezelfde referentie nog eens sturen werkt de factuur bij en boekt nooit dubbel. Relatie wordt gematcht op KvK, e-mail of naam en anders aangemaakt. Status open boekt de factuur (debiteuren/omzet/BTW), betaald zet de betaaldatum.
/imports	Logboek van je eigen aanleveringen

POST https://boekhouderkeesai.nl/api/v1/verkoopfacturen
Authorization: Bearer eyJ...
Content-Type: application/json

{
  "bron": "mijn-facturatiesysteem",
  "externe_referentie": "F2026-0012",
  "factuurnummer": "F2026-0012",
  "factuurdatum": "2026-10-06",
  "vervaldatum": "2026-10-20",
  "status": "open",
  "omschrijving": "Advieswerkzaamheden oktober 2026",
  "relatie": {"naam": "Voorbeeld B.V.", "kvk": "12345678", "email": "info@voorbeeld.nl"},
  "regels": [{"omschrijving": "Advieswerkzaamheden", "aantal": 1, "prijs": 1250.00, "btw_pct": 21}],
  "pdf_base64": "JVBERi0xLjQK..."
}

3. XAF-auditfile ophalen

curl -H "Authorization: Bearer eyJ..." \
  "https://boekhouderkeesai.nl/api/v1/exports/xaf?jaar=2026" -o auditfile_2026.xaf