# Ledger Botje - Volledige documentatie MCP koppeling voor Exact Online

> Ledger Botje is een MCP-server (Model Context Protocol) waarmee AI-assistenten zoals ChatGPT, Microsoft Copilot, Claude, Gemini, Mistral, Perplexity, Grok, Cursor en OpenClaw direct kunnen communiceren met Exact Online ERP. Dit document bevat de volledige technische documentatie.

## Overzicht

Ledger Botje biedt een MCP-koppeling waarmee je Exact Online kunt bedienen vanuit je favoriete AI-assistent. De koppeling vertaalt natuurlijke taalverzoeken naar Exact Online API-calls en retourneert gestructureerde resultaten. Er zijn 146 tools en 42 prompts beschikbaar. Tools zijn georganiseerd in een hiërarchische dot-notatie structuur (bijv. sales.orders.search). Er zijn 59 read-only tools en 87 schrijfacties.

## Beschikbare MCP Tools (146 totaal)

Tools zijn georganiseerd in een hiërarchische dot-notatie structuur voor eenvoudige navigatie.

### items.* — Artikelen en voorraad (15 tools)

- **items.search**: Zoek artikelen op code, barcode, zoekcode of omschrijving
- **items.stock**: Voorraadinfo per artikel, per magazijn, inclusief batch- en serienummers
- **items.suppliers**: Leveranciersartikelen zoeken
- **items.batch.history**: Volledige transactiehistorie van een batchnummer
- **items.serial.history**: Volledige transactiehistorie van een serienummer
- **items.time.create**: Tijd registreren op een bewerkingsstap
- **items.units.list**: Overzicht van alle eenheden (stuks, kg, liter, uur, etc.)
- **items.update**: Werk een bestaand artikel bij
- **items.delete**: Verwijder een artikel
- **items.warehouses.create**: Koppel een artikel aan een magazijn
- **items.warehouses.update**: Werk artikelmagazijn-instellingen bij
- **items.warehouses.delete**: Ontkoppel een artikel van een magazijn
- **items.suppliers.create**: Koppel een leverancier aan een artikel
- **items.suppliers.update**: Werk leverancierartikel bij
- **items.suppliers.delete**: Ontkoppel een leverancier van een artikel

### sales.* — Verkooporders, retouren, facturen en prijzen (20 tools)

- **sales.orders.search**: Zoek en filter verkooporders op klant, status, datum, etc.
- **sales.orders.get**: Volledige orderdetails inclusief regels en leverstatus
- **sales.orders.create**: Nieuwe verkooporder aanmaken
- **sales.orders.add_line**: Orderregel toevoegen aan bestaande verkooporder
- **sales.orders.update**: Werk een verkooporder bij
- **sales.orders.delete**: Verwijder een verkooporder
- **sales.orders.update_line**: Werk een verkooporderregel bij
- **sales.orders.delete_line**: Verwijder een verkooporderregel
- **sales.returns.search**: Zoek geplande retourzendingen
- **sales.returns.get**: Details van een retourzending
- **sales.returns.create**: Geplande retourzending aanmaken
- **sales.returns.delete**: Verwijder een retourzending
- **sales.returns.add_line**: Voeg een regel toe aan een retourzending
- **sales.returns.update_line**: Werk een retourzendingregel bij
- **sales.invoices.search**: Zoek en filter verkoopfacturen op klant, status, datum, etc.
- **sales.invoices.get**: Volledige factuurdetails inclusief alle regels met artikelen en BTW
- **sales.prices.search**: Zoek verkoopprijzen per artikel, klantspecifieke prijzen en staffelprijzen
- **sales.prices.create**: Maak een verkoopprijs aan
- **sales.prices.update**: Werk een verkoopprijs bij
- **sales.prices.delete**: Verwijder een verkoopprijs

### purchasing.* — Inkooporders en inkoopfacturen (10 tools)

- **purchasing.orders.search**: Zoek en filter inkooporders op leverancier, status, datum, etc.
- **purchasing.orders.get**: Volledige orderdetails inclusief regels en ontvangststatus
- **purchasing.orders.create**: Nieuwe inkooporder aanmaken
- **purchasing.orders.add_line**: Orderregel toevoegen aan bestaande inkooporder
- **purchasing.orders.update**: Werk een inkooporder bij
- **purchasing.orders.delete**: Verwijder een inkooporder
- **purchasing.orders.update_line**: Werk een inkooporderregel bij
- **purchasing.orders.delete_line**: Verwijder een inkooporderregel
- **purchasing.invoices.search**: Zoek en filter inkoopfacturen op leverancier, status, datum, etc.
- **purchasing.invoices.get**: Volledige factuurdetails inclusief alle regels

### logistics.* — Goederenontvangst, -levering en retourverwerking (9 tools)

- **logistics.receipts.search**: Zoek inkomende ontvangsten
- **logistics.receipts.get**: Details van een goederenontvangst
- **logistics.receipts.create**: Goederenontvangst boeken op een inkooporder
- **logistics.receipts.update**: Werk een goederenontvangst bij
- **logistics.deliveries.search**: Zoek uitgaande leveringen
- **logistics.deliveries.get**: Details van een goederenlevering
- **logistics.deliveries.create**: Goederenlevering boeken op een verkooporder
- **logistics.deliveries.update**: Werk een goederenlevering bij
- **logistics.returns.process**: Retourzending definitief verwerken

### production.* — Productieorders, assemblage en materialen (13 tools)

- **production.orders.search**: Zoek en filter productieorders/werkorders
- **production.orders.get**: Volledige details inclusief materiaalplan
- **production.orders.create**: Nieuwe productieorder aanmaken
- **production.orders.update**: Werk een productieorder bij
- **production.orders.delete**: Verwijder een productieorder
- **production.orders.receipt**: Hoeveelheid gereedmelden
- **production.orders.routing**: Bewerkingsstappen opvragen
- **production.assembly.search**: Zoek en filter assemblageorders
- **production.assembly.finish**: Assemblageorder afronden met opgegeven hoeveelheid
- **production.materials.issue**: Materiaal uitgeven aan een werkorder
- **production.materials.reversal**: Materiaaluitgifte terugdraaien (destructief)
- **production.materials.by_product**: Bijproduct ontvangen bij een productieorder
- **production.materials.bom**: Stuklijst (BOM) opvragen voor een artikel

### warehouse.* — Magazijnbeheer (17 tools)

- **warehouse.list**: Overzicht van alle magazijnen met opslaglocaties
- **warehouse.current**: Huidig actief magazijn opvragen
- **warehouse.switch**: Wisselen naar een ander magazijn
- **warehouse.locations.list**: Opslaglocaties van een magazijn
- **warehouse.locations.stock**: Voorraad per opslaglocatie binnen een magazijn
- **warehouse.shipping.list**: Actieve leverwijzes
- **warehouse.transfers.search**: Zoek magazijnverplaatsingen
- **warehouse.transfers.get**: Details van een verplaatsing
- **warehouse.transfers.create**: Voorraadverplaatsing aanmaken
- **warehouse.transfers.update**: Werk een magazijnverplaatsing bij
- **warehouse.transfers.delete**: Verwijder een magazijnverplaatsing
- **warehouse.transfers.update_line**: Werk een verplaatsingsregel bij
- **warehouse.transfers.delete_line**: Verwijder een verplaatsingsregel
- **warehouse.transfers.process**: Verplaatsing definitief verwerken
- **warehouse.create**: Maak een nieuw magazijn aan
- **warehouse.update**: Werk een magazijn bij
- **warehouse.delete**: Verwijder een magazijn

### accounts.* — Klanten en leveranciers (10 tools)

- **accounts.search**: Zoek klanten en leveranciers op naam, code, stad of e-mail
- **accounts.create**: Nieuw account (klant of leverancier) aanmaken
- **accounts.update**: Werk een bestaand account bij
- **accounts.delete**: Verwijder een account
- **accounts.contacts.create**: Contactpersoon toevoegen aan een account
- **accounts.contacts.update**: Werk een contactpersoon bij
- **accounts.contacts.delete**: Verwijder een contactpersoon
- **accounts.addresses.search**: Zoek adressen van relaties op stad, postcode, straat of type
- **accounts.addresses.update**: Werk een adres bij
- **accounts.addresses.delete**: Verwijder een adres

### accounting.* — Financieel en boekhouding (9 tools)

- **accounting.glaccounts.search**: Zoek grootboekrekeningen op code, omschrijving of type
- **accounting.transactionlines.search**: Zoek financiële boekingsregels/journaalposten
- **accounting.bankentries.search**: Zoek bankboekingen op dagboek, boekjaar of status
- **accounting.bankentries.get**: Volledige bankboeking inclusief alle boekingsregels
- **accounting.currencies.list**: Overzicht van alle beschikbare valuta's
- **financial.outstanding.get**: Openstaande en vervallen facturen overzicht (debiteuren en crediteuren)
- **financial.bank.create**: Maak een nieuwe bankboeking aan
- **financial.bank.delete**: Verwijder een bankboeking
- **financial.bank.add_line**: Voeg een regel toe aan een bankboeking

### crm.* — Offertes en verkoopkansen (16 tools)

- **crm.quotations.search**: Zoek en filter offertes op klant, status, datum, verkoper, etc.
- **crm.quotations.get**: Volledige offertedetails inclusief alle regels met artikelen en prijzen
- **crm.quotations.create**: Maak een nieuwe offerte aan met regels
- **crm.quotations.update**: Werk een bestaande offerte bij
- **crm.quotations.delete**: Verwijder een offerte
- **crm.quotations.add_line**: Voeg een regel toe aan een offerte
- **crm.quotations.update_line**: Werk een offerteregel bij
- **crm.quotations.delete_line**: Verwijder een offerteregel
- **crm.quotations.add_charge_line**: Voeg een toeslagregel toe aan een offerte
- **crm.quotations.update_charge_line**: Werk een toeslagregel bij
- **crm.quotations.delete_charge_line**: Verwijder een toeslagregel
- **crm.opportunities.search**: Zoek verkoopkansen/leads op naam, status, fase of eigenaar
- **crm.opportunities.get**: Volledige opportunitydetails inclusief contactpersonen
- **crm.opportunities.create**: Maak een nieuwe opportunity aan
- **crm.opportunities.update**: Werk een bestaande opportunity bij
- **crm.opportunities.delete**: Verwijder een opportunity

### projects.* — Projecten en uren (5 tools)

- **projects.search**: Zoek projecten op code, omschrijving, klant, type of status
- **projects.get**: Volledige projectdetails inclusief WBS-structuur en planning
- **projects.timecosts.search**: Zoek uren- en kostenregistraties op project, medewerker of datum
- **projects.timecost.update**: Werk een urenregistratie bij
- **projects.timecost.delete**: Verwijder een urenregistratie

### subscriptions.* — Abonnementen (2 tools)

- **subscriptions.search**: Zoek abonnementen/contracten op nummer, klant of status
- **subscriptions.get**: Volledige abonnementsdetails inclusief alle regels

### cashflow.* — Cashflow (14 tools)

- **cashflow.conditions.search**: Zoek betalingscondities
- **cashflow.conditions.create**: Betalingsconditie aanmaken
- **cashflow.payments.search**: Zoek openstaande betalingen
- **cashflow.payments.get**: Details van een betaling
- **cashflow.payments.update**: Betaling bijwerken
- **cashflow.payments.process**: Betalingen verwerken
- **cashflow.receivables.search**: Zoek openstaande vorderingen
- **cashflow.receivables.get**: Details van een vordering
- **cashflow.receivables.update**: Vordering bijwerken
- **cashflow.mandates.search**: Zoek incassomandaten
- **cashflow.mandates.create**: Incassomandaat aanmaken
- **cashflow.mandates.update**: Incassomandaat bijwerken
- **cashflow.mandates.delete**: Incassomandaat verwijderen
- **cashflow.banks.list**: Overzicht beschikbare banken

### admin.* — Administratie en systeem (4 tools)

- **admin.list**: Beschikbare administraties (divisies)
- **admin.current**: Huidige actieve administratie opvragen
- **admin.switch**: Wisselen naar een andere administratie/divisie
- **admin.feedback**: Feedback of suggesties indienen over de applicatie

## Beschikbare MCP Prompts (42 totaal)

Prompts zijn voorgedefinieerde sjablonen die veelvoorkomende taken op gang helpen.

- **items.voorraad_controleren**: Controleer de actuele voorraad van een artikel per magazijn
- **items.batch_traceren**: Traceer een batch- of serienummer door de volledige keten
- **sales.order_aanmaken**: Maak stap voor stap een verkooporder aan voor een klant
- **sales.retour_verwerken**: Verwerk een retourzending voor een verkooporder
- **purchasing.order_aanmaken**: Maak een inkooporder aan bij een leverancier
- **logistics.levering_aanmaken**: Maak een goederenlevering aan voor een verkooporder
- **warehouse.overdracht_starten**: Start een magazijnoverdracht tussen magazijnen
- **production.order_starten**: Start een productieorder voor een artikel met stuklijst
- **accounts.klant_aanmaken**: Maak een nieuwe klant of leverancier aan in Exact Online
- **admin.dagoverzicht**: Geef een overzicht van openstaande orders en taken voor vandaag
- **financial.overzicht**: Financieel overzicht met bankboekingen, openstaande facturen en journaalposten
- **projects.status_overzicht**: Projectstatus met uren, kosten en planning
- **crm.sales_pipeline**: Sales pipeline met open opportunities en verwachte sluitdata
- **invoicing.overzicht**: Facturatie-overzicht met openstaande en vervallen facturen
- **logistics.ontvangst_aanmaken**: Goederenontvangst aanmaken voor een inkooporder
- **crm.offertes_overzicht**: Offerte-overzicht met status, waarde en bijbehorende opportunities
- **production.voortgang_bewaken**: Productievoortgang bekijken met routing, materiaaluitgifte en gereedmelding
- **projects.uren_registreren**: Uren registreren op een project of productieorder
- **production.assemblage_afronden**: Assemblageorder zoeken en afronden met stuklijstcontrole
- **sales.prijzen_controleren**: Verkoopprijzen controleren inclusief klantspecifieke prijsafspraken
- **purchasing.leverancier_analyseren**: Leveranciersanalyse met inkooporders, facturen en artikelkoppeling
- **financial.grootboek_zoeken**: Grootboekrekeningen zoeken met bijbehorende boekingen en saldi
- **sales.order_tot_betaling**: Doorloop het volledige order-tot-betaling proces (order, levering, factuur, betaling)
- **purchasing.inkoop_tot_betaling**: Doorloop het volledige inkoop-tot-betaling proces (bestelling, ontvangst, factuur, betaling)
- **financial.maandafsluiting**: Maandafsluiting checklist met openstaande posten, bankreconciliatie en afsluiting
- **financial.factuuranalyse**: Analyseer openstaande verkoopfacturen en betalingen
- **purchasing.factuurcontrole**: Controleer inkoopfacturen tegen orders en ontvangsten
- **purchasing.leverancier_opzetten**: Nieuwe leverancier opzetten met artikelen en prijzen
- **sales.klant_opzetten**: Nieuwe klant opzetten met adressen, contacten en prijsafspraken
- **warehouse.voorraad_aanvullen**: Voorraad controleren op minimumniveaus en inkooporders genereren
- **production.volledige_cyclus**: Volledige productiecyclus: werkorder, materiaaluitgifte, gereedmelding en voorraadupdate
- **items.traceerbaarheid**: Batch- of serienummer traceren door de volledige keten
- **crm.offerte_lifecycle**: Offerte levenscyclus: aanmaken, opvolgen en omzetten naar verkooporder
- **admin.data_opschonen**: Duplicaten en inactieve gegevens identificeren en opschonen
- **cashflow.betalingen_beheren**: Openstaande betalingen bekijken, bijwerken en verwerken
- **cashflow.vorderingen_beheren**: Openstaande vorderingen bekijken en incassomandaten beheren

## Voorbeeldvragen

Gebruikers kunnen in natuurlijke taal vragen stellen, zoals:

- "Wat is de voorraad van artikel A1001?"
- "Zoek alle open verkooporders van klant Bakkerij de Groot"
- "Maak een inkooporder aan bij leverancier Jansen BV voor 500 stuks van artikel A1001"
- "Hoeveel is er geproduceerd op werkorder 5023?"
- "Verplaats 100 stuks van artikel X van magazijn A naar magazijn B"
- "Welke leveranciers leveren artikel B2003?"
- "Wat is de batchhistorie van batch LOT-2024-001?"
- "Welke verkoopfacturen staan nog open?"
- "Wat is de totale omzet van Q4 2025?"
- "Welke klanten hebben facturen die langer dan 30 dagen openstaan?"
- "Hoeveel van artikel A1001 ligt er in magazijn Utrecht?"
- "Wat is de status van productieorder WO-2025-0042?"
- "Geef me een overzicht van alle openstaande offertes"
- "Zoek de verkoopfacturen van klant De Vries uit januari 2025"
- "Wat is de status van project P2025-001?"
- "Hoeveel uur is er deze maand geboekt op project X?"
- "Toon de sales pipeline met verwachte sluitdata"
- "Wat zijn de klantspecifieke prijzen voor artikel A1001?"

## Tips voor effectief gebruik

- Wees zo specifiek mogelijk: noem klantnamen, artikelcodes of datums
- Noem bij meerdere administraties altijd de naam van de administratie
- Splits complexe vragen op in stappen voor betere resultaten
- Vraag om factuurnummers of ordernummers zodat je kunt verifiëren in Exact Online
- Controleer altijd de AI-output voordat je beslissingen neemt

## Beperkingen

- Ledger Botje is geen financieel adviseur: vraag geen fiscaal advies of belastingberekeningen
- De AI-assistent bepaalt hoe data wordt gepresenteerd; Ledger Botje levert de datakoppeling
- Bedrijfskritische beslissingen blijven altijd de verantwoordelijkheid van de gebruiker
- Rate limits: 400 verzoeken/maand (Basic) of 800 verzoeken/maand (Advanced)

## Authenticatie en beveiliging

- Protocol: MCP via Streamable HTTP
- Authenticatie: OAuth 2.1 met PKCE via Exact Online
- Alle communicatie via HTTPS/TLS
- Data wordt gecachet in een beveiligde database in Europa voor snelle responstijden
- Data wordt automatisch gesynchroniseerd met Exact Online
- Koppeling op elk moment intrekbaar; na intrekking wordt alle opgeslagen data verwijderd

## Abonnementen

| Plan | Prijs | Administraties | Lezen | Schrijven | Verzoeken/maand |
|------|-------|----------------|-------|-----------|-----------------|
| Basic | €39/maand | Max 3 | Ja | Nee | 400 |
| Advanced | €59/maand | Max 10 | Ja | Ja | 800 |
| Enterprise | Op aanvraag | Onbeperkt | Ja | Ja | Onbeperkt |

Alle abonnementen beginnen met een gratis proefperiode van 14 dagen. Bij jaarabonnementen ontvang je 1 maand gratis: Basic €429/jaar, Advanced €649/jaar.

## Compatibele AI-platforms

- ChatGPT (OpenAI)
- Microsoft Copilot
- Claude (Anthropic)
- Google Gemini
- Mistral AI
- Perplexity
- Grok (xAI)
- Cursor (Anysphere)
- OpenClaw

Elke AI-assistent die het MCP-protocol ondersteunt is automatisch compatibel.

## Blog artikelen

### Wat is MCP en hoe werkt het met Exact Online?
URL: https://ledgerbotje.nl/blog/wat-is-mcp/
Het Model Context Protocol (MCP) is een open standaard van Anthropic waarmee AI-assistenten veilig communiceren met externe systemen. Ledger Botje fungeert als MCP-server tussen je AI-assistent en Exact Online. MCP gebruikt OAuth 2.1 met PKCE voor authenticatie. Alle communicatie verloopt via HTTPS.

### Voorraadbeheer met AI: zo vraag je voorraadstanden op
URL: https://ledgerbotje.nl/blog/voorraadbeheer-met-ai/
Voorraadstanden opvragen per magazijn en opslaglocatie via de get_stock_info en get_location_stock tools. Batch- en serienummertracking met volledige transactiehistorie. Magazijnverplaatsingen aanmaken via natuurlijke taal.

### Orders aanmaken via ChatGPT en Exact Online
URL: https://ledgerbotje.nl/blog/orders-aanmaken-met-ai/
Verkoop- en inkooporders aanmaken, orderregels toevoegen, goederenontvangsten boeken en goederenleveringen verwerken via je AI-assistent. Vereist het Advanced-abonnement voor schrijfacties.

### Productieorders beheren met AI: een complete gids
URL: https://ledgerbotje.nl/blog/productieorders-beheren-met-ai/
Werkorders opzoeken, stuklijsten bekijken, materiaal uitgeven en terugdraaien, gereedmeldingen doen, bewerkingsstappen en tijdregistratie, bijproducten ontvangen en assemblageorders afronden.

### 5 tips om effectiever te werken met AI en Exact Online
URL: https://ledgerbotje.nl/blog/5-tips-ai-en-exact-online/
Praktische tips: wees specifiek in vragen, noem altijd de administratie, splits complexe vragen op, controleer de AI-output, en gebruik vervolgvragen voor natuurlijke workflows.

### AI en boekhouding in Exact Online
URL: https://ledgerbotje.nl/blog/ai-boekhouding-exact-online/
AI-boekhouding met Exact Online: openstaande facturen opvragen, debiteurenoverzichten genereren en administratie automatiseren via je AI-assistent. Geen API-kennis nodig.

### Openstaande facturen opvragen via ChatGPT en Exact Online
URL: https://ledgerbotje.nl/blog/openstaande-facturen-opvragen-chatgpt/
Openstaande facturen, debiteurenoverzichten en betalingsachterstanden opvragen via ChatGPT en Exact Online. Praktische prompts en tips voor dagelijks gebruik.

### Hoeveel kost een AI-koppeling voor Exact Online?
URL: https://ledgerbotje.nl/blog/kosten-exact-online-ai-koppeling/
Transparant overzicht van de kosten: Basic vs. Advanced abonnement, vergelijking met traditionele maatwerkkoppelingen, en waarom geen API-kennis nodig is.

## Meer informatie

- Blog: https://ledgerbotje.nl/blog/ — Tips en handleidingen over AI en Exact Online
- Prompt bibliotheek: https://ledgerbotje.nl/prompts — 50+ kant-en-klare voorbeeldprompts per categorie
- FAQ: https://ledgerbotje.nl/faq — Veelgestelde vragen over Ledger Botje
- MCP koppelen: https://ledgerbotje.nl/mcp-koppelen — Installatiehandleiding per AI-assistent
- Volledige documentatie (dit bestand): https://ledgerbotje.nl/llms-full.txt
- Compacte versie: https://ledgerbotje.nl/llms.txt

## Contact

- Website: https://ledgerbotje.nl/
- E-mail: support@industrialit.nl
- Contact: https://www.barcodescan.nl/app/contactform.php?site=LedgerBotjeNL