Verklarende woordenlijst

Boekhouding in platte tekst leent terminologie van het dubbel boekhouden en voegt er een handvol Beancount-specifieke woorden aan toe. Deze woordenlijst definieert de termen die je tegenkomt bij het lezen van deze handleidingen of van je eigen grootboekbestand, elk met een kort voorbeeld waar dat nuttig is. Elke term heeft een eigen link, zodat je een collega direct naar een definitie kunt verwijzen.

Rekening (Account)​

Een rekening is een benoemde container die één geldstroom bijhoudt, geschreven als een door dubbele punten gescheiden hiërarchie onder een van vijf hoofdtypen: Assets (Activa), Liabilities (Passiva), Equity (Eigen vermogen), Income (Inkomsten) of Expenses (Uitgaven). De hiërarchie is de volledige organisatiestructuur van je administratie — Assets:US:BofA:Checking en Expenses:Food:Restaurant sorteren en rollen automatisch op. Elke rekening moet worden geopend voordat hij wordt gebruikt. Zie Beancount taalsyntax voor de naamgevingsregels.

Toerekeningsstelsel (Accrual basis)​

Bij het toerekeningsstelsel worden inkomsten geboekt wanneer ze worden verdiend en uitgaven wanneer ze worden gemaakt, ongeacht wanneer het geld daadwerkelijk beweegt. Bij het kasstelsel is het omgekeerd: beide worden pas geboekt wanneer het geld van eigenaar wisselt. Het toerekeningsstelsel geeft een getrouwer beeld van de prestaties over een periode, daarom behoort een factuur die je in maart hebt verstuurd tot maart, ook al betaalt de klant pas in mei.

Amortisatie (Amortization)​

Amortisatie spreidt een eenmalige grote betaling over de perioden waarop deze betrekking heeft, zodat elke maand zijn eigen aandeel in de kosten draagt. Een jaarlijkse verzekeringspremie die in januari wordt betaald, is een kost voor alle twaalf maanden, niet alleen voor januari. In Beancount schrijf je de gesplitste boekingen ofwel handmatig uit, ofwel genereer je ze met een plugin — zie Amortiseer.

Saldoverificatie (Balance assertion)​

Een saldoverificatie is een balance richtlijn die vastlegt wat het saldo van een rekening aan het begin van een bepaalde datum moet zijn, zodat je bankafschrift een automatische controle op je administratie wordt. Als het berekende saldo afwijkt, geeft Beancount een duidelijke foutmelding met de verwachte en werkelijke bedragen. Het toevoegen van één verificatie per rekening per afschrift is de goedkoopste manier om een grootboek betrouwbaar te houden.

2026-01-01 balance Assets:US:BofA:Checking   4,321.00 USD

Beancount​

Beancount is een open-source systeem voor dubbel boekhouden waarvan het grootboek een plat tekstbestand is dat je in elke willekeurige tekstverwerker bewerkt en met een commandoregel-tool valideert. Het biedt een strikte, parseerbare syntax, een querytaal en een webinterface, zonder database of eigen bestandsformaat. Omdat het grootboek uit tekst bestaat, leeft het vrolijk in Git naast je code. Begin met Inleiding tot Beancount.

Beancount Query Language (BQL)​

Beancount Query Language, meestal afgekort tot BQL, is de SQL-achtige taal die je gebruikt om vragen aan je grootboek te stellen. Het werkt op de geparseerde richtlijnen in plaats van een database, dus SELECT account, sum(position) WHERE year = 2026 geeft direct antwoord uit hetzelfde bestand dat je bewerkt. Lees de handleiding voor de querytaal voor de volledige grammatica.

Boekingsmethode (Booking method)​

Een boekingsmethode is de regel die Beancount toepast wanneer een vermindering moet bepalen welke bestaande partijen worden afgeboekt. De keuzes zijn STRICT (jij identificeert de partij zelf), FIFO, LIFO, AVERAGE en NONE, ingesteld per rekening op het bijbehorende open richtlijn. De methode die je kiest, verandert je gerealiseerde vermogenswinsten, dus kies degene die jouw fiscale wetgeving verwacht en blijf daarbij.

Rekeningschema (Chart of accounts)​

Een rekeningschema is de volledige lijst van rekeningen die jouw grootboek gebruikt, samen met de structuur die ze ordent. In Beancount is er geen apart rekeningschemabestand — de verzameling open richtlijnen is je rekeningschema. Een goed ontwerp aan het begin bespaart later veel hernoemwerk; zie Industriespecifieke opzetten voor startpunten.

Sluitrichtlijn (Close directive)​

Een close richtlijn markeert de datum waarna een rekening niet meer gebruikt mag worden. Zo sluit je een bankrekening of een afgeloste lening af zonder de geschiedenis te verwijderen. Oude transacties blijven geldig en rapporteerbaar; alleen nieuwe boekingen worden afgewezen. Het afsluiten van ongebruikte rekeningen houdt rapporten leesbaar naarmate een grootboek ouder wordt.

2026-03-31 close Assets:US:OldBank:Checking

Commodity​

Een commodity is elke waarde-eenheid die jouw grootboek bijhoudt — een valuta zoals USD, een aandelenkoers zoals AAPL, een crypto-activum zoals BTC, of iets wat je zelf bedenkt zoals VAKANTIEDAGEN. Beancount converteert nooit stiekem tussen commodities, dus een bedrag is altijd een getal gekoppeld aan de commodity waarin het luidt. Een optionele commodity richtlijn stelt je in staat metadata toe te voegen, zoals een naam of een activaklasse.

Kostprijs (Cost basis)​

De kostprijs is wat je werkelijk voor een bezitting hebt betaald, geregistreerd in de valuta waarmee je hebt betaald en meegevoerd zolang je de bezitting bezit. Beancount schrijft het tussen accolades — 10 AAPL {150.00 USD} betekent tien aandelen verworven voor 150 dollar per stuk. Omdat de basis meereist met de positie, rollen vermogenswinsten er vanzelf uit bij verkoop. Zie Voorraadbeheer.

Richtlijn (Directive)​

Een richtlijn is een gedateerde instructie in een Beancount-bestand, en richtlijnen zijn alles wat een grootboek bevat. Elke regel die met een datum begint, is er een: open, close, balance, price, note, document, pad, event, commodity, en de transactie zelf. Beancount sorteert richtlijnen op datum voordat het ze verwerkt, dus je kunt ze in de volgorde zetten die het beste leest.

Dubbel boekhouden (Double-entry bookkeeping)​

Dubbel boekhouden is de praktijk om elke economische gebeurtenis vast te leggen met ten minste twee corresponderende boekingen, zodat de bedragen altijd optellen tot nul. Geld wordt nooit gecreëerd of vernietigd — het verplaatst zich alleen tussen rekeningen. Daarom kan deze techniek fouten opsporen die een enkelvoudige lijst nooit zou ontdekken. Beancount handhaaft deze regel strikt: een transactie waarvan de boekingen niet in evenwicht zijn, is een fout, geen waarschuwing.

Envelopbegroting (Envelope budgeting)​

Envelopbegroting zet geld opzij voor een doel voordat je het uitgeeft, zodat elke categorie zijn eigen limiet heeft in plaats van te concurreren om één gedeeld saldo. De naam komt van de papieren enveloppen die mensen ooit op betaaldag met contant geld vulden. In een plattekst- grootboek modelleer je enveloppen met speciale rekeningen of budgetrichtlijnen — zie Budgetten.

Fava​

Fava is de webinterface voor Beancount: grafieken, balansen, winst-en-verliesrekeningen, een query-editor en een invoerformulier, allemaal bediend vanuit je grootboekbestand. Het is vooral-lezen en draait lokaal, dus het verandert hoe je ziet wat er in je boeken staat zonder ze te wijzigen. beancount.io host een beheerde versie naast eigen tools; de UI-functies handleiding legt uit wat je ermee kunt doen.

Voorraad (Inventory)​

Een voorraad is de verzameling posities die een rekening momenteel aanhoudt, elk met zijn eigen commodity en, waar relevant, zijn eigen kostprijs en aanschafdatum. Een beleggingsrekening die drie keer hetzelfde aandeel heeft gekocht, heeft drie aparte partijen in één voorraad, niet één gemengd getal. Het gescheiden houden van partijen maakt nauwkeurige winstberekeningen mogelijk.

Journaal (Journal)​

Het journaal is de chronologische lijst van alles wat er in je boeken is gebeurd — de ruwe stroom van transacties, in datumvolgorde, vóór enige groepering of samenvatting. Het is de weergave die je bekijkt als je wilt weten "wat heb ik in maart eigenlijk gedaan?". Fava's journaalpagina is meestal de snelste plek om een foutief gecategoriseerde boeking te ontdekken.

Grootboek (Ledger)​

Een grootboek is de volledige verzameling boekhoudkundige gegevens voor één entiteit, wat in Beancount neerkomt op je platte tekstbestand (plus alles wat het includeert). Het woord wordt zowel gebruikt voor het geheel van rekeningen als voor het bestand zelf. Omdat het tekst is, kan een grootboek worden gediffed, beoordeeld, geforkt en gemerged als broncode.

Partij (Lot)​

Een partij is één specifieke verwerving van een commodity, geïdentificeerd door zijn kostprijs en aanschafdatum. Hetzelfde ETF kopen in januari en nog eens in juni creëert twee partijen, en later verkopen betekent kiezen welke partij je verkoopt. Partijen zijn de reden waarom Beancount gerealiseerde winsten exact kan berekenen in plaats van ze te benaderen.

2026-06-15 * "Broker" "Buy VTI"
  Assets:US:Broker:VTI     5 VTI {260.00 USD, 2026-06-15}
  Assets:US:Broker:Cash            -1,300.00 USD

Omschrijving (Narration)​

De omschrijving is de vrije-tekstomschrijving van waar een transactie voor was, geschreven als het tweede aanhalingsteken op de transactieregel. Het is voor mensen: "Maandelijkse huur", "Boodschappen en huishoudartikelen". Beancount parseert het niet, maar het is wat je leest wanneer de boeking over zes maanden niet meer logisch is.

Openrichtlijn (Open directive)​

Een open richtlijn verklaart een rekening, de datum waarop deze bruikbaar wordt, en optioneel de commodities die hij mag bevatten en de boekingsmethode die hij gebruikt. Beancount vereist dat elke rekening wordt geopend vóór de eerste boeking, wat voorkomt dat een typfout stilletjes een gloednieuwe rekening creëert. Het beperken van de toegestane commodities verandert een hele andere klasse fouten in foutmeldingen.

2026-01-01 open Assets:US:Broker:VTI   VTI   "FIFO"

Pad​

Een pad richtlijn vertelt Beancount om het bedrag in te vullen dat nodig is om de volgende saldoverificatie op een rekening te laten slagen, waarbij het verschil naar een tweede rekening wordt geboekt. Het bestaat voor precies één taak: een grootboek halverwege het leven openen zonder jaren aan geschiedenis te reconstrueren. Padding na die initiële opzet duidt meestal op een echte fout die wordt verdoezeld.

Tegenpartij (Payee)​

De tegenpartij is met wie je de transactie hebt gedaan, geschreven als de eerste aanhalingstekenreeks op een transactieregel. Het consequent houden van tegenpartijen — altijd "Whole Foods", nooit soms "WholeFoods" — is wat op tegenpartij gebaseerde rapporten en geautomatiseerde importprogramma's laat werken. Beancount beschouwt de tegenpartij als optioneel; een transactie mag alleen een omschrijving hebben.

Boekhouding in platte tekst (Plain-text accounting)​

Boekhouding in platte tekst is de praktijk om je administratie bij te houden in een voor mensen leesbaar tekstbestand onder versiebeheer, verwerkt door open-source commandoregel-tools. Het ruilt een point-and-click-interface in voor duurzaamheid, controleerbaarheid en automatisering: je gegevens overleven elke leverancier, elke wijziging is een controleerbare diff en elk script kan het lezen. Beancount, Ledger en hledger zijn de drie bekendste implementaties.

Plugin​

Een plugin is een Python-module die Beancount laadt tijdens het verwerken van je bestand, waardoor het richtlijnen kan toevoegen, transformeren of valideren voordat rapporten worden gebouwd. Plugins zijn hoe prognoses, amortisatieschema's en aangepaste controles worden geïmplementeerd zonder de kerntaal te wijzigen. Je schakelt er een in met een plugin regel bovenaan je grootboek — de Prognoseplugin handleiding loopt door een echt voorbeeld.

Boeking (Posting)​

Een boeking is één been van een transactie: een rekening, een bedrag en optioneel een kost of prijs. Een transactie heeft minimaal twee boekingen nodig, en hun bedragen moeten optellen tot nul. Hooguit één boeking mag het bedrag leeg laten, in welk geval Beancount het salderingsbedrag voor je berekent.

Prijsrichtlijn (Price directive)​

Een price richtlijn registreert de wisselkoers tussen twee commodities op een datum. Zo kan Beancount een bezitting omrekenen naar de marktwaarde in rapporten. Prijzen zijn pure referentiegegevens — ze verplaatsen nooit geld en komen nooit voor in een transactie. Zonder prijzen is een portefeuille nog steeds in evenwicht tegen kostprijs, maar kan deze niet tegen marktwaarde worden gewaardeerd.

2026-06-30 price VTI   271.40 USD

Reconciliatie (Reconciliation)​

Reconciliatie is het bewijs dat je administratie overeenkomt met een externe registratie, zoals een bank- of brokerageafschrift. In boekhouding in platte tekst is het grotendeels mechanisch: voeg een saldoverificatie toe voor elke afschriftdatum en laat de tool je vertellen of de getallen overeenkomen. Een grootboek dat elke maand schoon reconcileert, is er een waarop je zonder angst belastingaangifte kunt doen.

Tags en links (Tags and links)​

Tags en links zijn de twee labels die je aan transacties toevoegt om ze te groeperen buiten de rekeninghiërarchie: een tag met # markeert een thema zoals #trip-japan, en een link met ^ verbindt gerelateerde boekingen zoals ^invoice-2026-014 met elkaar. Tags beantwoorden "laat me alles zien in deze categorie"; links beantwoorden "laat me de boekingen zien die bij deze ene gebeurtenis horen". Beide zijn filterbaar in Fava en opvraagbaar in BQL — zie Filteren en zoeken.

Transactie (Transaction)​

Een transactie is een gedateerde economische gebeurtenis samen met de boekingen die haar vastleggen, en het is de richtlijn die je het vaakst zult schrijven. Het heeft een vlag (* voor bevestigd, ! voor controle nodig), een optionele tegenpartij, een omschrijving, en twee of meer boekingen waarvan de bedragen optellen tot nul. Al het andere in een Beancount-bestand bestaat om transacties te declareren, controleren of annoteren.

2026-02-14 * "Blue Bottle" "Coffee with Dana"
  Expenses:Food:Coffee      9.50 USD
  Assets:US:BofA:Checking  -9.50 USD

Zit je nog steeds vast op een woord? Het Hulpcentrum indexeert elke handleiding op deze site, en het Spiekbriefje zet de syntax voor elke richtlijn naast elkaar.