Gebruik AI met Beancount: importeer, beoordeel en doorzoek uw grootboek

Gebruik AI om rekeningen voor te stellen en transacties te verklaren, controleer vervolgens de boekingen tegen uw brondocumenten voordat u ze opslaat. Deze handleiding doorloopt een klein fictief afschrift met categorisatie, beoordeling, validatie en een query die u kunt verifiëren.

Kies hieronder een gehoste of lokale workflow. Het uitgewerkte voorbeeld gebruikt een lokaal voorbeeldbestand, zodat u elke stap kunt reproduceren voordat u AI aan uw eigen grootboek koppelt.

Kies uw workflow​

De gehoste assistent en MCP zijn Beancount.io-integraties. Het installeren van de open-source Beancount-boekhoudengine voegt die services niet toe aan een lokaal grootboek.

Voordat u begint​

Zorg dat u uw afschrift, de rekening waartoe het behoort en een lijst met toegestane bestemmingsrekeningen bij de hand hebt. Bewaar het originele afschrift om resultaten mee te vergelijken.

Voor de lokale doorloop installeert u Beancount met de installatiehandleiding. U hebt ook Beanquery nodig om de uiteindelijke query vanuit een terminal uit te voeren. Het voorbeeld gaat uit van USD en van een leeg voorbeeldbestand.

Voor echte gegevens beslist u welke informatie uw AI-tool mag ontvangen. Verwijder onnodige identificerende gegevens voordat u een afschrift deelt. Een lokaal grootboek kan gegevens nog steeds naar een cloudmodel sturen via een editor of MCP-client. Controleer het gegevensbeleid van uw client en modelprovider; het lokaal bewaren van een bestand betekent niet automatisch dat de inhoud lokaal blijft.

1. Begin met de brontransacties​

Onze fictieve betaalrekening begint augustus met 1.000,00 USD. Het afschrift bevat drie opnames en eindigt met 805,10 USD na die opnames:

date,payee,description,amount
2026-08-03,Office Depot,Printer paper,-45.00
2026-08-04,Cloud Hosting Inc,Monthly hosting,-120.00
2026-08-05,Amazon,Online purchase,-29.90

Negatieve bedragen betekenen hier dat geld de betaalrekening verlaat. Bevestig de tekenconventie van uw bank vóór het importeren; andere exporteurs en importeurs kunnen een andere conventie gebruiken.

In de CSV-converter wijst u deze vier kolommen toe en stelt u de bronrekening in op Assets:Bank:Checking met valuta USD. Laat Elk teken omdraaien uit staan voor dit voorbeeld. Controleer of de brontransacties negatief zijn. Een voorlopige bestemmingsrekening is slechts een tijdelijke aanduiding totdat u de categorieën hebt beoordeeld.

Als u begint met een afbeelding van een bon of een PDF, vergelijk dan de geëxtraheerde datums, bedragen, valuta en het aantal transacties met het originele document voordat u iets categoriseert. Behoud de bronwaarden terwijl u de rekeningen bepaalt.

2. Vraag om categorieën met duidelijke beperkingen​

Gebruik een prompt die de toegestane rekeningen benoemt en ruimte laat voor onzekerheid:

Stel voor elke rij in dit voorbeeldafschrift een bestemmingsrekening voor. De bronrekening is Assets:Bank:Checking. Gebruik alleen Expenses:Office:Supplies of Expenses:Business:Hosting. Geef de originele datum, begunstigde, bedrag, voorgestelde rekening en een korte reden terug. Als de omschrijving onvoldoende is, geef dan NEEDS_REVIEW terug en leg uit welke informatie ontbreekt. Verzin geen rekeningen, wijzig geen bedragen en schrijf niet naar het grootboek.

Geef de drie CSV-rijen met de prompt mee. Een bruikbaar resultaat ziet er zo uit; de formulering en suggesties van het model kunnen variëren:

De prompt drukt uw bedoeling uit. Het handhaaft geen machtigingen op een tool die bestanden kan schrijven. Configureer de goedkeuringscontroles van uw client voordat u deze toegang geeft tot een echt grootboek.

3. Los onzekerheid op en beoordeel de boekingen​

Controleer het aankoopbewijs voor de Amazon-aankoop. In dit voorbeeld identificeert het een USB-C-kabel voor kantoor en kent de beoordelaar Expenses:Office:Supplies toe. Zonder dat bewijs laat u de rij op NEEDS_REVIEW staan in plaats van een gok te accepteren.

Maak een nieuw bestand met de naam review.beancount met het volgende volledige voorbeeld. Het bevat de rekeningdeclaraties en openingsbalans die de CSV niet heeft. Als u de converter hebt gebruikt, vergelijk dan de transacties met deze beoordeelde boekingen; voeg geen dubbele kopieën toe aan hetzelfde grootboek.

option "title" "AI bookkeeping review example"
option "operating_currency" "USD"
 
2026-08-01 open Assets:Bank:Checking USD
2026-08-01 open Equity:Opening-Balances USD
2026-08-01 open Expenses:Office:Supplies USD
2026-08-01 open Expenses:Business:Hosting USD
 
2026-08-01 * "Opening balance"
  Assets:Bank:Checking       1000.00 USD
  Equity:Opening-Balances   -1000.00 USD
 
2026-08-03 * "Office Depot" "Printer paper"
  Assets:Bank:Checking        -45.00 USD
  Expenses:Office:Supplies     45.00 USD
 
2026-08-04 * "Cloud Hosting Inc" "Monthly hosting"
  Assets:Bank:Checking          -120.00 USD
  Expenses:Business:Hosting      120.00 USD
 
2026-08-05 * "Amazon" "Online purchase; receipt: office USB-C cable"
  Assets:Bank:Checking        -29.90 USD
  Expenses:Office:Supplies     29.90 USD
 
2026-08-06 balance Assets:Bank:Checking 805.10 USD

De openingsbalans-transactie hoort bij dit lege oefengrootboek. In een bestaand grootboek gebruikt u de bestaande balans en rekeningdeclaraties in plaats van een nieuwe openingsbalans toe te voegen.

Voordat u een voorgestelde wijziging accepteert, vergelijkt u elke transactie met de brondocumenten. Bevestig de tekens, valuta, rekeningen en het bijbehorende bewijs. Een bekende handelsnaam alleen bewijst niet het doel van een aankoop.

4. Valideer en stem af​

Voer de validator van Beancount uit op het lokale voorbeeld:

bean-check review.beancount

Het volledige voorbeeld moet zonder fouten doorlopen. De saldoassertie controleert het bedrag op de betaalrekening aan het begin van 6 augustus, na de drie voorgaande opnames.

Bevestig het resultaat tegen het afschrift:

• Drie afschrifttransacties verschijnen elk één keer, naast de openingsbalans.
• Opnames totaliseren 194,90 USD.
• De betaalrekening bevat 805,10 USD: de opening van 1.000,00 USD minus die opnames.
• Kantoorbenodigdheden totaliseren 74,90 USD en hosting 120,00 USD.

Als u de Amazon-transactie op NEEDS_REVIEW laat staan, blijft de betaalrekening op 835,00 USD en faalt de assertie met 29,90 USD. Onderzoek dat verschil; voeg geen onverklaarbare correctie toe alleen om de check te laten slagen.

bean-check vangt syntax-, rekening-, balancerings- en saldoassertiefouten. Het kan niet vaststellen dat een bon echt is, dat u de juiste kostenrekening hebt gekozen of dat elke afschriftregel aanwezig is. Een transactie die naar de verkeerde kostenrekening is geboekt, kan nog steeds perfect in balans zijn.

Wanneer iets niet overeenkomt​

Vraag AI om verschillen te verklaren en naar de betreffende rijen te wijzen. Bevestig het bewijs voordat u een vermeend duplicaat verwijdert of een bedrag wijzigt.

5. Sla het beoordeelde resultaat op en doorzoek het​

Wanneer u deze workflow met uw eigen afschrift herhaalt, voeg dan alleen uw beoordeelde transacties samen in uw echte grootboek en valideer vervolgens het gecombineerde bestand. Houd de fictieve boekingen in het voorbeeldbestand. Als u Git gebruikt, inspecteer dan de diff en committeer via uw gebruikelijke workflow. Bewaar het bronafschrift voor latere reconciliatie. De handleiding voor scriptbare workflows behandelt herhaalbare lokale automatisering.

U kunt de totalen van het voorbeeld verifiëren met Beancount-querytaal. Met Beanquery geïnstalleerd, voert u uit:

bean-query review.beancount "SELECT account, sum(position) WHERE account ~ '^Expenses:' AND date >= 2026-08-01 AND date < 2026-09-01 GROUP BY account"

De twee kostentotalen moeten 74,90 USD voor kantoorbenodigdheden en 120,00 USD voor hosting zijn. Inspecteer ook het datumbereik en de rekeningfilter van de query, evenals de uitvoer.

Met een AI-client die is verbonden met een grootboek dat het voorbeeld bevat, kunt u vragen:

Doorzoek het voorbeeldgrootboek voor uitgaven van augustus 2026, gegroepeerd per rekening. Toon de query en de resultaten. Wijzig geen bestanden.

Vergelijk het antwoord met dezelfde totalen. Een vloeiend antwoord is alleen nuttig als de cijfers herleidbaar zijn tot het grootboek.

Pas het beoordelingsproces toe in Beancount.io​

Voor afschriftbestanden opent u Importeren → Slim Importeren in de zijbalk van uw grootboek. Beoordeel de geëxtraheerde rijen, kies Bronrekening en Valuta en gebruik AI-invullen voor suggesties van bestemmingsrekeningen. Corrigeer de categorieën vóór Importeren indienen, waarvan de knop het transactietotaal toont. Controleer het resulterende journaal en de saldi in een voorbeeldgrootboek voordat u een echt afschrift verwerkt. Verifieer dat opnames de bronrekening verminderen; de bovenstaande CSV is voorbereid voor de lokale converter en importeurs kunnen tekens anders interpreteren.

Voor de gehoste assistent opent u Vraag Beancount.io in uw grootboek. Begin met een vraag over bestaande boekingen. Wanneer het een bestandsbewerking voorstelt, beoordeel dan de diff voordat u goedkeurt. Geaccepteerde importen en assistent-bewerkingen worden in Git vastgelegd, zodat u wijzigingen kunt inspecteren of terugdraaien.

Voor MCP volgt u de clientspecifieke installatie-instructies hierboven en autoriseert u het beoogde grootboek. Vraag om editLedgerFiles met dry_run: true voordat u een bewerking toestaat. Inspecteer de voorgestelde inhoud en bewerkingssamenvatting en sta daarna pas een aparte schrijfaanroep toe na beoordeling. De proefrun toont geen boekhoudkundige correctheid en garandeert niet dat uw client later om toestemming vraagt vóór een schrijfoperatie.

Behoud het beoordelingsproces terwijl u automatiseert​

Begin met een kleine batch en noteer welke suggesties u wijzigt. Zet herhaalde, bevestigde toewijzingen om in expliciete importregels of geef beoordeelde voorbeelden als context. Ga er niet vanuit dat een model permanent leert van een correctie in een gesprek.

Houd extractiecontroles, categoriebeoordeling en afschriftreconciliatie gescheiden. Elk vangt een ander type fout. Controleer bij terugkerende importen ook dat het twee keer importeren van dezelfde bron niet stilletjes duplicaten oplevert.

Onderzoek ondersteunt dit onderscheid tussen geldige syntax en correcte boekhouding. Figueroa Rosero en collega's' studie van januari 2025 evalueerde kleine open-weight-modellen op financiële-ratio-scenario's en transactiegeneratie met gestructureerde prompts. De resultaten beschrijven die modellen en taken, niet een nauwkeurigheidspercentage voor de assistenten van vandaag of uw importworkflow. Beoordeel uw eigen workflow met gecontroleerde brontransacties en de correcties die ze vereisen.

Tools voor een herhaalbare lokale workflow​

Kies een tool voor het deel van het proces dat u wilt herhalen:

• Beangulp biedt een importeurraamwerk. Het vervangt het oudere beancount.ingest-raamwerk in Beancount 3.
• smart_importer is een apart geïnstalleerd pakket dat machine-learning-suggesties aan importeurs toevoegt. Het is geen ingebouwde LLM-functie.
• Beanborg documenteert regelgebaseerde categorisatie, machine-learning-suggesties en optionele ChatGPT-voorspellingen. Controleer de huidige installatie en compatibiliteit voordat u het adopteert.

Voor bredere context, zie de gids voor boekhoudautomatisering en de handleiding voor maandelijkse boekhoudworkflows.

Verken een groter voorbeeld​

Het openbare grootboek hieronder is gescheiden van de drie-transactie-oefening. Gebruik het om te verkennen hoe rekeningen, transacties en rapporten samenpassen voordat u AI aan uw eigen grootboek koppelt.