Documentatie

Alles over de e-Boekhouden-koppeling voor Claude: wat het kan, hoe je het instelt en waar je op moet letten.

Wat kan Claude doen?

Je praat gewoon met Claude. Claude kiest zelf de juiste opdrachten. Een paar voorbeelden:

Opzoeken

  • “Welke debiteuren staan open en wie is het meest te laat?”
  • “Geef het saldo van alle grootboekrekeningen per 30 september.”
  • “Zoek alle boekingen met ‘huur’ in de omschrijving dit jaar.”

Aanmaken en wijzigen

  • “Maak een relatie aan voor Jansen Installatie in Breda.”
  • “Maak een verkoopfactuur voor Jansen Installatie, twee uur advies à €95, 21% btw.”
  • “Maak een kostenplaats ‘Project Zuid’ aan.”

Vraag Claude bij aanmaken altijd om eerst te laten zien wat het gaat doen. Dan kun je het controleren voordat het wordt opgeslagen.

Alleen-lezen modus

Wil je dat Claude niets kan aanmaken, wijzigen of verwijderen? Zet dan de alleen-lezen modus aan. De opdrachten die schrijven bestaan dan helemaal niet meer voor Claude, dus ze kunnen ook niet per ongeluk worden gebruikt.

Goed om te weten

Alle opdrachten

Deze lijst wordt automatisch uit de koppeling zelf gemaakt en loopt dus altijd gelijk. Een sterretje (*) betekent verplicht. De namen en omschrijvingen zijn Engels, want dat is wat Claude ziet.

Opzoeken

list_administrationsread

List the e-Boekhouden administrations (companies) available to this API token. Set linked=true for linked administrations.

linked limit offset

list_ledgersread

List ledger accounts (grootboekrekeningen). Optionally filter by exact code or category.

code category limit offset

get_ledger_balancesread

Get the balance of every ledger account (a trial balance). With only `to`, you get the balance at that date. With `from` too, you get the movement over that period. Optional cost center filter.

from to cost_center_id limit offset

get_ledger_balanceread

Get the balance of a single ledger account by its ledger id (see list_ledgers).

id* from to cost_center_id

list_mutationsread

List mutations (journal entries). Types: 1 invoice received, 2 invoice sent, 3 invoice payment received, 4 invoice payment sent, 5 money received, 6 money sent, 7 general journal entry. Filter by date range, invoice number or text in the description.

type date_from date_to invoice_number description_contains limit offset

get_mutationread

Get a single mutation (booking) with its lines, by id.

id*

list_outstanding_invoicesread

List unpaid invoices. kind=debtors for invoices customers still owe you (openstaande debiteuren), kind=creditors for bills you still have to pay (openstaande crediteuren).

kind* invoice_number limit offset

list_invoicesread

List sales invoices created in e-Boekhouden. Filter by invoice number, relation id or date range.

invoice_number relation_id date_from date_to limit offset

get_invoiceread

Get a single sales invoice by id.

id*

list_relationsread

List relations. Filter by name or city (partial match), exact code or email, or type (B business, P private).

name_contains city code email type limit offset

get_relationread

Get a single relation (customer or supplier) by id.

id*

list_productsread

List products. Filter by exact code or product group code.

code group_code limit offset

list_cost_centersread

List cost centers (kostenplaatsen). Optionally filter by text in the description.

description_contains limit offset

get_ledgerread

Get a single ledger account by id.

id*

get_productread

Get a single product by id.

id*

get_cost_centerread

Get a single cost center by id.

id*

list_membersread

List members (clubs and associations only). Filter by member number, name, email or city.

member_number name_contains email city limit offset

get_memberread

Get a single member by id.

id*

list_product_groupsread

List product groups.

limit offset

list_invoice_templatesread

List invoice templates. You need a template id to create an invoice.

limit offset

list_email_templatesread

List email templates (used when emailing an invoice).

limit offset

list_unitsread

List units of measure.

limit offset

Aanmaken, wijzigen en verwijderen (niet beschikbaar in alleen-lezen modus)

create_relationwrite

Create a relation (customer or supplier).

name* +43 optional

update_relationwrite

Update an existing relation. The API requires `name` (send the current name if it is unchanged) plus the fields to change.

id* name* +43 optional

create_mutationwrite

Create a booking (mutation). WARNING: the API cannot edit or delete a booking afterwards, so show the user the exact entry and get their confirmation first.

type* date* ledgerId* +9 optional

create_invoicewrite

Create a sales invoice. WARNING: if `email` is set the invoice is emailed to the customer immediately, and if `mutation` is set it is also booked. Neither can be undone through the API. Only set them when the user explicitly asked, and confirm the details first.

relationId* templateId* items* +11 optional

create_ledgerwrite

Create a ledger account.

code* description* category group

update_ledgerwrite

Update fields of a ledger account. Only send the fields you want to change.

id* code description category group

create_productwrite

Create a product.

code* description* vat* ledgerId* +8 optional

update_productwrite

Update fields of a product. Only send the fields you want to change.

id* +13 optional

delete_productdelete

Delete a product. Permanent.

id*

create_cost_centerwrite

Create a cost center.

description parentId active

update_cost_centerwrite

Update fields of a cost center. Only send the fields you want to change.

id* description active

delete_cost_centerdelete

Delete a cost center. Permanent.

id*

create_memberwrite

Create a member.

name* +33 optional

update_memberwrite

Update an existing member (clubs and associations only). The API requires `name` plus the fields to change.

id* name* +33 optional

Problemen oplossen

“e-Boekhouden rejected the API token”

Het token is fout, ingetrokken of verlopen. Maak in e-Boekhouden onder Koppelingen → API een nieuw token aan en werk het bij in de extensie-instellingen. Na een mislukte inlogpoging probeert de koppeling een minuut lang niet opnieuw, om een blokkade door e-Boekhouden te voorkomen.

De opdrachten verschijnen niet in Claude

Sluit Claude volledig af en open het opnieuw. Bij Claude Code start je een nieuwe sessie. Controleer in Claude Code met claude mcp list of de koppeling gezond is.

Claude Code zegt dat node niet gevonden wordt

De Claude Code-variant draait op Node.js 18 of nieuwer. Installeer Node.js, of gebruik Claude Desktop: die heeft Node.js al ingebouwd.

Updaten

Download het nieuwe bestand van de installatiepagina. Claude Desktop: dubbelklik en bevestig dat je de bestaande versie vervangt. Claude Code: vervang het .mjs-bestand door het nieuwe.

Verwijderen

Claude Desktop: Instellingen → Extensies → e-Boekhouden verwijderen. Claude Code: claude mcp remove eboekhouden. Trek daarna het token in bij e-Boekhouden onder Koppelingen → API.