Verklarende woordenlijst

Plain-text accounting leent woordenschat van het dubbel boekhouden en voegt daar een handvol Beancount-specifieke woorden aan toe. Deze woordenlijst definieert de termen die je tegenkomt bij het lezen van deze documentatie of je eigen grootboekbestand, elk met een kort voorbeeld waar dat helpt. Elk onderdeel heeft een eigen link, zodat je een collega direct naar een definitie kunt verwijzen.

Rekening​

Een rekening is een benoemde categorie die één waardestroom bijhoudt, geschreven als een hiërarchie met dubbele punten onder een van de vijf hoofdtypen: Assets, Liabilities, Equity, Income of Expenses. De hiërarchie is de hele organiserende structuur van je administratie — Assets:US:BofA:Checking en Expenses:Food:Restaurant sorteren en rollen automatisch op. Elke rekening moet worden gedeclareerd voordat deze wordt gebruikt. Zie Beancount Language Syntax voor de naamgevingsregels.

Toerekeningsgrondslag​

Bij toerekeningsgrondslag wordt inkomen geboekt wanneer het is verdiend en uitgaven wanneer ze zijn gemaakt, ongeacht wanneer het geld daadwerkelijk beweegt. Kasbasis doet het tegenovergestelde: beide worden alleen herkend wanneer geld van eigenaar wisselt. Toerekeningsgrondslag geeft een beter beeld van de prestaties van een periode, daarom hoort een factuur die je in maart verstuurt bij maart, zelfs als de klant in mei betaalt.

Amortisatie​

Amortisatie spreidt een enkele grote betaling over de periodes die deze daadwerkelijk dekt, zodat elke maand een eerlijk deel van de kosten draagt. Een jaarlijkse verzekeringspremie die in januari wordt betaald, is een uitgave van alle twaalf maanden, niet alleen januari. In Beancount schrijf je de gesplitste boekingen handmatig of genereer je ze met een plugin — zie Amortize.

Saldoverificatie​

Een saldoverificatie is een balance-richtlijn die aangeeft wat het saldo van een rekening moet zijn aan het begin van een bepaalde datum, zodat je bankafschrift een automatische controle op je administratie wordt. Als het berekende saldo meer afwijkt dan de tolerantie van de verificatie, faalt Beancount luidruchtig met de verwachte en werkelijke bedragen. Die tolerantie is één eenheid van het laatste decimaal dat je schrijft — 4.27 RGAGX accepteert alles van 4,26 tot 4,28 — en een ~ vóór de valuta stelt je eigen tolerantie in. 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 platte-tekstbestand is dat je in elke teksteditor bewerkt en met een commandoregelprogramma valideert. Het biedt een strikte, parseerbare syntaxis, een querytaal en een webinterface, zonder database of eigen bestandsformaat. Omdat het grootboek tekst is, leeft het gemakkelijk in Git naast je code. Begin met Inleiding tot Beancount.

Beancount-querytaal​

De Beancount-querytaal, meestal afgekort tot BQL, is de SQL-achtige taal waarmee je vragen aan je grootboek stelt. Deze draait over de geparseerde richtlijnen in plaats van een database, dus SELECT account, sum(position) WHERE year = 2026 antwoordt onmiddellijk vanuit hetzelfde bestand dat je bewerkt. Lees de handleiding voor de querytaal voor de volledige grammatica.

Boekingsmethode​

Een boekingsmethode is de regel die Beancount toepast wanneer een vermindering moet kiezen welke bestaande partijen worden afgeboekt. Beancount 3.2.3 accepteert zeven namen: STRICT (de standaard, waarbij je de partij zelf identificeert), STRICT_WITH_SIZE, NONE, FIFO, LIFO, HIFO en AVERAGE. Stel er één per rekening in op de open-richtlijn, of voor het hele bestand met option "booking_method". Zes van de zeven zijn geïmplementeerd: AVERAGE parseert, maar geeft AVERAGE method is not supported zodra het een vermindering moet boeken. De methode die je kiest verandert je gerealiseerde vermogenswinst, dus kies degene die je belastingjurisdictie verwacht en houd deze stabiel. Inventory Management draait alle zeven over dezelfde partijen en publiceert het grootboek dat faalt onder AVERAGE.

Rekeningschema​

Een rekeningschema is de volledige lijst van rekeningen die je grootboek gebruikt, samen met de structuur die ze organiseert. In Beancount is er geen apart schema-bestand — de set open-richtlijnen is je rekeningschema. Het vroeg goed ontwerpen ervan bespaart later veel hernoemen; zie Industry-Specific Setups voor startpunten.

Sluitrichtlijn​

Een close-richtlijn markeert de datum waarna een rekening niet meer mag worden gebruikt, zo trek je een bankrekening of afbetaalde lening terug zonder de geschiedenis te verwijderen. Eerdere transacties blijven geldig en rapporteerbaar; alleen nieuwe boekingen worden geweigerd. Het sluiten van ongebruikte rekeningen houdt rapporten leesbaar naarmate een grootboek ouder wordt.

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

Commodity​

Een commodity is elke eenheid van waarde die je grootboek volgt — een valuta zoals USD, een aandelenticker zoals AAPL, een crypto-activum zoals BTC, of iets dat je zelf bedenkt zoals VACATION-DAYS. Beancount converteert nooit stiekem tussen commodities, dus een bedrag is altijd een getal gekoppeld aan de commodity waarin het luidt. Een optionele commodity-richtlijn laat je metadata toevoegen zoals een naam of een activaklasse.

Kostprijs​

Kostprijs is wat je daadwerkelijk voor een bezit hebt betaald, vastgelegd in de valuta waarmee je betaalde en meegedragen naast het bezit zolang je het bezit. Beancount schrijft het tussen accolades — 10 AAPL {150.00 USD} betekent tien aandelen verworven tegen 150 dollar per stuk. Dubbele accolades maken van het getal het totaal in plaats van de eenheidsprijs, dus 10 AAPL {{1,500.00 USD}} registreert dezelfde partij. Omdat de kostprijs met de positie meereist, volgt vermogenswinst vanzelf uit de rekenkunde wanneer je verkoopt. Zie Inventory Management.

Richtlijn​

Een richtlijn is één instructie in een Beancount-bestand, meestal gedateerd, en richtlijnen vormen een grootboek. Twaalf soorten dragen een datum: open, close, balance, price, note, document, pad, event, commodity, custom, query, en de transactie zelf. Enkele dragen geen datum en werken op het bestand in plaats van op een dag — option, include, plugin en het paar pushtag/poptag. Beancount sorteert de gedateerde op datum vóór verwerking, zodat je ze in elke volgorde kunt zetten die het prettigst leest; een ongedateerde werkt waar deze is geschreven.

Dubbel boekhouden​

Dubbel boekhouden is de praktijk om elke economische gebeurtenis als minstens twee corresponderende boekingen vast te leggen, zodat hun gewichten altijd op nul uitkomen. Geld wordt nooit gecreëerd of vernietigd — het beweegt alleen tussen rekeningen, daarom vangt de techniek fouten op die een enkelvoudige lijst nooit zou ontdekken. Een gewicht is het eigen bedrag van een boeking, of de kost of prijs omgerekend naar één valuta, zodat twee kanten in verschillende commodities elkaar nog steeds opheffen. Beancount handhaaft de regel strikt: een transactie waarvan de boekingen niet in evenwicht zijn, is een fout, geen waarschuwing.

2026-03-02 * "Bank" "Buy euros"
  Assets:US:BofA:EUR       100.00 EUR @ 1.08 USD
  Assets:US:BofA:Checking -108.00 USD

Envelopebudgettering​

Envelopebudgettering 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 vroeger op betaaldag met contant geld vulden. In een platte-tekstgrootboek modelleer je enveloppen met speciale rekeningen of budgetrichtlijnen — zie Budgets.

Fava​

Fava is de webinterface voor Beancount: grafieken, balansen, resultatenrekeningen, een query-editor en een invoerformulier, geserveerd vanuit je grootboekbestand. Het is vooral-lezen en draait lokaal, dus het verandert hoe je je administratie ziet zonder te veranderen hoe je deze vastlegt. beancount.io host een beheerde versie naast zijn eigen tooling; de UI Features-gids behandelt wat je daar kunt doen.

Inventaris​

Een inventaris is de verzameling posities die een rekening momenteel heeft, elk met zijn eigen commodity en, waar relevant, zijn eigen kostprijs en aanschafdatum. Een brokerage-rekening die drie keer hetzelfde aandeel kocht, heeft drie afzonderlijke partijen in één inventaris, niet één gemengd getal. Het apart houden van partijen is wat nauwkeurige winstberekeningen mogelijk maakt.

Journaal​

Het journaal is de chronologische lijst van alles wat in je administratie is gebeurd — de ruwe stroom van transacties, in datavolgorde, vóór enige groepering of samenvatting. Het is de weergave die je scant wanneer je "wat heb ik in maart eigenlijk gedaan?" wilt beantwoorden. De journaalpagina van Fava is meestal de snelste plek om een verkeerd gecategoriseerde boeking te spotten.

Grootboek​

Een grootboek is de volledige verzameling boekhoudkundige gegevens voor één entiteit, wat in Beancount je platte-tekstbestand betekent (plus alles wat het opneemt). Het woord dient zowel als naam van het hele boek van rekeningen als de naam van het bestand zelf. Omdat het tekst is, kan een grootboek worden vergeleken, beoordeeld, geforkt en samengevoegd zoals broncode.

Partij​

Een partij is één specifieke aanschaf van een commodity, geïdentificeerd door de kostprijs en aanschafdatum. Het kopen van dezelfde ETF in januari en opnieuw in juni creëert twee partijen, en later verkopen betekent kiezen welke partij je verkoopt. Partijen zijn de reden dat Beancount gerealiseerde winst exact kan berekenen in plaats van 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

Narratief​

Het narratief is de vrije-tekstbeschrijving van waar een transactie voor diende, geschreven als de tweede geciteerde string op de transactieregel. Het is voor mensen: "Maandelijkse huur", "Boodschappen en huishouden". Beancount parseert het niet, maar het is wat je leest wanneer de boeking over zes maanden geen zin meer lijkt te hebben.

Open-richtlijn​

Een open-richtlijn declareert een rekening, de datum waarop deze bruikbaar wordt, en optioneel de commodities die deze mag bevatten en de boekingsmethode die deze 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 toegestane commodities maakt nog een hele klasse van fouten tot fouten.

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

Pad​

Een pad-richtlijn zegt Beancount om het bedrag in te voegen 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 geschiedenis te reconstrueren. Padding buiten die initiële opzet betekent meestal dat een echte fout wordt verdoezeld.

Betaler​

De betaler is met wie je transactie deed, geschreven als de eerste geciteerde string op een transactieregel. Het consistent houden van betalers — altijd "Whole Foods", nooit soms "WholeFoods" — is wat op betalers gebaseerde rapporten en geautomatiseerde importeurs laat werken. Beancount behandelt de betaler als optioneel; een transactie mag alleen een narratief dragen.

Plain-text accounting​

Plain-text accounting is de praktijk om je administratie bij te houden in een menselijk leesbaar tekstbestand onder versiebeheer, verwerkt door open-source commandoregelprogramma's. Het ruilt een klik-en-sleep-interface in voor duurzaamheid, controleerbaarheid en automatisering: je gegevens overleven elke leverancier, elke wijziging is een controleerbaar 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, waarmee 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 veranderen. Je schakelt er één in met een zelfstandige plugin-regel bovenaan je grootboek, nooit met een option — option "plugin" "…" wordt afgewezen met Option 'plugin' may not be set. De Forecast Plugin-gids loopt door een echt voorbeeld.

Boeking​

Een boeking is één kant van een transactie: een rekening, een bedrag en optioneel een kost of prijs. Wat over een transactie nul moet zijn, is niet de ruwe bedragen maar hun gewichten: een gewoon bedrag weegt zichzelf, 10 FUND @ 38.46 USD weegt 384.60 USD, en 10 FUND {384.61 USD} weegt 3,846.10 USD, omdat enkele accolades de kost van één eenheid bevatten. Ten hoogste één boeking mag het bedrag leeg laten, in welk geval Beancount het balanceringscijfer voor je berekent. Zie Precision & Tolerances voor de volledige gewichtsregels.

Prijsrichtlijn​

Een price-richtlijn registreert de wisselkoers tussen twee commodities op een datum, zo converteert Beancount een bezit naar marktwaarde in rapporten. Een price-richtlijn is puur referentiegegevens: het verplaatst geen geld en hoort bij geen transactie. Verwar het niet met de @-prijs in een boeking, die rekenkundig is — het geeft 10 FUND @ 38.46 USD een gewicht van 384.60 USD en beslist zo of de transactie in evenwicht is. Zonder prijsrichtlijnen blijft een portefeuille wel in evenwicht op kostprijs, maar kan niet op marktwaarde worden gewaardeerd.

2026-06-30 price VTI   271.40 USD

Reconciliatie​

Reconciliatie is het bewijzen dat je administratie overeenkomt met een externe registratie zoals een bank- of brokerage-afschrift. In plain-text accounting is dit grotendeels mechanisch: voeg een saldoverificatie toe voor elke afschriftdatum en laat het programma je vertellen of de getallen overeenkomen. Een grootboek dat elke maand netjes reconcileert, is er een waarop je zonder angst belasting kunt indienen.

Tags en links​

Tags en links zijn de twee labels die je aan transacties hangt om ze buiten de rekeningshiërarchie te groeperen: een tag met # markeert een thema zoals #trip-japan, en een link met ^ verbindt gerelateerde item zoals ^invoice-2026-014. Tags beantwoorden "toon me alles in deze categorie"; links beantwoorden "toon me de items die bij deze ene gebeurtenis horen". Beide zijn filterbaar in Fava en querybaar in BQL — zie Filtering and Searching.

Transactie​

Een transactie is een gedateerde economische gebeurtenis samen met de boekingen die deze vastleggen, en het is de richtlijn die je het vaakst schrijft. Het draagt een vlag (* voor bevestigd, ! voor moet-gecontroleerd), een optionele betaler, een narratief en twee of meer boekingen waarvan de gewichten nul zijn. 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

Nog vast op een woord? Het Helpcentrum indexeert elke gids op deze site, en de Spiekbrief zet de syntaxis van elke richtlijn naast elkaar.