# Woordenlijst voor Beancount en plain-text boekhouden

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 zult tegenkomen bij het lezen van deze documentatie of je eigen grootboekbestand,
elk met een kort voorbeeld waar dat helpt. Elke vermelding heeft een eigen link, zodat
je een collega direct naar een definitie kunt verwijzen.

## Rekening

Een account is een benoemde bucket die één waardestroom bijhoudt, geschreven als een
door dubbele punten gescheiden hiërarchie onder een van de vijf hoofdtypen: `Assets`,
`Liabilities`, `Equity`, `Income` of `Expenses`. De hiërarchie vormt de volledige
organisatiestructuur van je boekhouding — `Assets:US:BofA:Checking` en
`Expenses:Food:Restaurant` sorteren en rollen automatisch op. Elk account moet worden
gedeclareerd voordat het wordt gebruikt. Zie
[Beancount Language Syntax](https://beancount.io/nl/docs/Basics/syntax) voor de naamgevingsregels.

## Toerekeningsgrondslag

Accrual-basis boekhouden registreert inkomsten wanneer ze worden verdiend en uitgaven
wanneer ze worden gemaakt, ongeacht wanneer het geld daadwerkelijk beweegt.
Cash-basis boekhouden doet het omgekeerde: het erkent beide alleen wanneer geld van
hand tot hand gaat. Accrual geeft een getrouwer beeld van de prestaties van een
periode, daarom hoort een factuur die je in maart hebt verstuurd bij maart, zelfs als
de klant in mei betaalt.

## Amortisatie

Amortisatie spreidt een enkele grote betaling uit over de perioden die deze
daadwerkelijk dekt, zodat elke maand zijn eerlijke deel van de kosten draagt. Een
jaarlijkse verzekeringspremie die in januari wordt betaald, is een uitgave van alle
twaalf maanden, niet alleen van januari. In Beancount schrijf je de gesplitste
postings ofwel met de hand, ofwel genereer je ze met een plugin — zie
[Amortize](https://beancount.io/nl/docs/Tips/amortize).

## Saldoverificatie

Een balance assertion is een `balance`-directive die aangeeft wat het saldo van een
account moet zijn aan het begin van een gegeven datum, zodat je bankafschrift een
automatische controle op je boekhouding wordt. Als het berekende saldo meer dan de
tolerantie van de assertion afwijkt, faalt Beancount luidruchtig met de verwachte en
werkelijke bedragen. Die tolerantie is één eenheid van de laatste decimaal die je hebt
geschreven — `4.27 RGAGX` accepteert alles van 4.26 tot 4.28 — en een `~` vóór de
valuta stelt je eigen tolerantie in. Af en toe één assertion per account per afschrift
toevoegen is de goedkoopste manier om een grootboek betrouwbaar te houden.

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

## Beancount

Beancount is een open-source dubbel-boekhoudsysteem waarvan het grootboek een
plain-text bestand is dat je in elke teksteditor bewerkt en met een
opdrachtregelprogramma valideert. Het geeft je een strikte, parseerbare syntaxis, een
querytaal en een webinterface, zonder database of eigen bestandsformaat. Omdat het
grootboek tekst is, leeft het prima in Git naast je code. Begin met
[Introduction to Beancount](https://beancount.io/nl/docs/introduction-to-beancount).

## Beancount-querytaal

Beancount Query Language, meestal afgekort tot BQL, is de SQL-achtige taal waarmee je
vragen stelt aan je grootboek. Het werkt op de geparseerde directives in plaats van op
een database, dus `SELECT account, sum(position) WHERE year = 2026` antwoordt
onmiddellijk vanuit hetzelfde bestand dat je bewerkt. Lees de
[query language guide](https://beancount.io/nl/docs/Basics/beancount-query-language) voor de volledige grammatica.

## Boekingsmethode

Een booking method is de regel die Beancount toepast wanneer een vermindering moet
bepalen welke bestaande lots worden aangesproken. Beancount 3.2.3 accepteert zeven
namen: `STRICT` (de standaard, waarbij je het lot zelf aanwijst), `STRICT_WITH_SIZE`,
`NONE`, `FIFO`, `LIFO`, `HIFO` en `AVERAGE`. Stel er één per account in op zijn
`open`-directive, 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 vermogenswinsten, dus kies degene die jouw belastingjurisdictie verwacht
en houd die stabiel. [Inventory Management](https://beancount.io/nl/docs/Basics/inventories) laat alle zeven
los op dezelfde lots, en publiceert het grootboek dat faalt onder `AVERAGE`.

## Rekeningschema

Een chart of accounts is de volledige lijst van accounts die je grootboek gebruikt,
samen met de structuur die ze organiseert. In Beancount is er geen apart chart-bestand
— de verzameling `open`-directives *is* je chart of accounts. Het vroeg goed ontwerpen
bespaart later veel hernoemen; zie
[Industry-Specific Setups](https://beancount.io/nl/docs/industry-specific-setups) voor uitgangspunten.

## Sluitrichtlijn

Een `close`-directive markeert de datum waarna een account niet meer mag worden
gebruikt, wat de manier is om een bankrekening of een afbetaalde lening te beëindigen
zonder de geschiedenis te verwijderen. Eerdere transacties blijven geldig en
rapporteerbaar; alleen nieuwe postings worden geweigerd. Het sluiten van ongebruikte
accounts houdt rapporten leesbaar naarmate een grootboek ouder wordt.

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

## Commodity

Een commodity is elke waarde-eenheid die je grootboek bijhoudt — een valuta zoals
`USD`, een aandagenticker zoals `AAPL`, een crypto-asset zoals `BTC`, of iets dat je
zelf verzint zoals `VACATION-DAYS`. Beancount converteert nooit achter je rug om tussen
commodities, dus een bedrag is altijd een getal met de commodity waarin het is
gedenomineerd. Een optionele `commodity`-directive laat je metadata toevoegen zoals een
naam of een assetklasse.

## Kostprijs

Cost basis is wat je daadwerkelijk hebt betaald voor een positie, vastgelegd in de
valuta waarmee je betaalde en meegedragen met de positie zolang je die bezit. Beancount
schrijft het tussen accolades — `10 AAPL {150.00 USD}` betekent tien aandelen
verworven tegen 150 dollar per stuk. Verdubbel de accolades en het getal wordt het
totaal in plaats van de stukprijs, dus `10 AAPL {{1,500.00 USD}}` registreert hetzelfde
lot. Omdat de basis met de positie meereist, volgen vermogenswinsten vanzelf uit de
berekening wanneer je verkoopt. Zie
[Inventory Management](https://beancount.io/nl/docs/Basics/inventories).

## Richtlijn

Een directive is één instructie in een Beancount-bestand, meestal gedateerd, en
directives vormen samen een grootboek. Twaalf soorten dragen een datum: `open`,
`close`, `balance`, `price`, `note`, `document`, `pad`, `event`, `commodity`, `custom`,
`query` en de transactie zelf. Enkele dragen er geen en werken op het bestand in plaats
van op een dag — `option`, `include`, `plugin` en het `pushtag`/`poptag`-paar.
Beancount sorteert de gedateerde directives op datum voordat het verwerkt, dus je kunt
die in willekeurige volgorde houden die het beste leest; een ongedateerde directive
geldt op de plek waar deze is geschreven.

## Dubbel boekhouden

Dubbel boekhouden is de praktijk van het vastleggen van elke economische gebeurtenis
als ten minste twee overeenkomende boekingen, zodat hun gewichten altijd optellen tot
nul. Geld wordt nooit gecreëerd of vernietigd — het beweegt alleen tussen accounts,
daarom vangt de techniek fouten die een enkelvoudige lijst nooit zou vangen. Een gewicht
is het eigen bedrag van een posting, of zijn kostprijs of prijs omgerekend naar één
valuta, zodat twee benen in verschillende commodities elkaar nog steeds opheffen.
Beancount handhaaft de regel strikt: een transactie waarvan de postings niet in balans
zijn is een fout, geen waarschuwing.

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

## Envelopebudgettering

Envelope budgeting zet geld opzij voor een doel voordat je het uitgeeft, zodat elke
categorie zijn eigen limiet heeft in plaats van te concurreren om één gepoold saldo.
De naam komt van de papieren enveloppen die mensen vroeger op betaaldag met contant
geld vulden. In een plain-text grootboek modelleer je enveloppen met speciale accounts
of budget-directives — zie [Budgets](https://beancount.io/nl/docs/Tips/budgets).

## Fava

Fava is de webinterface voor Beancount: grafieken, balansen, resultatenrekeningen, een
query-editor en een invoerformulier, geserveerd vanuit je grootboekbestand. Het is
overwegend alleen-lezen en draait lokaal, dus het verandert hoe je je boekhouding
*ziet* zonder te veranderen hoe je die vastlegt. beancount.io host een beheerde versie
naast zijn eigen tooling; de gids [UI Features](https://beancount.io/nl/docs/Tips/ui-features) behandelt wat je
daar kunt doen.

## Inventaris

Een inventory is de verzameling posities die een account momenteel aanhoudt, elk met
zijn eigen commodity en, waar relevant, zijn eigen cost basis en aanschafdatum. Een
effectenrekening die hetzelfde aandeel drie keer kocht, houdt drie afzonderlijke lots
in één inventory, niet één samengevoegd getal. Het onderscheiden van lots is wat
nauwkeurige winstberekeningen mogelijk maakt.

## Journaal

Het journal is de chronologische lijst van alles wat in je boekhouding is gebeurd — de
ruwe stroom transacties, op datum, vóór enige groepering of samenvatting. Het is de
weergave die je doorneemt wanneer je wilt antwoorden op "wat heb ik in maart
daadwerkelijk gedaan?". De journal-pagina van Fava is meestal de snelste plek om een
verkeerd gecategoriseerde boeking op te sporen.

## Grootboek

Een ledger is de volledige verzameling boekhoudkundige gegevens voor één entiteit, wat
in Beancount betekent: je plain-text bestand (plus alles wat het includeert). Het woord
is zowel de naam van het hele boek der rekeningen als de naam van het bestand zelf.
Omdat het tekst is, kan een ledger worden gediffd, gereviewd, gebrancht en gemerged
zoals broncode.

## Partij

Een lot is één specifieke aankoop van een commodity, geïdentificeerd door zijn cost
basis en aanschafdatum. Hetzelfde ETF in januari kopen en nogmaals in juni creëert
twee lots, en later verkopen betekent kiezen welk lot je verkoopt. Lots zijn de reden
dat Beancount gerealiseerde winsten exact kan berekenen in plaats van te benaderen.

```beancount
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

De narration is de vrije-tekstbeschrijving van waar een transactie voor was,
geschreven als de tweede geciteerde string op de transactieregel. Het is voor mensen:
"Monthly rent", "Groceries and household". Beancount parseert het niet, maar het is wat
je zult lezen wanneer de boeking zes maanden later geen zin meer heeft.

## Open-richtlijn

Een `open`-directive declareert een account, de datum waarop het bruikbaar wordt, en
optioneel de commodities die het mag aanhouden en de booking method die het gebruikt.
Beancount vereist dat elk account wordt geopend voordat de eerste posting plaatsvindt,
wat voorkomt dat een typefout stilzwijgend een gloednieuw account aanmaakt. Het
beperken van de toegestane commodities verandert nog een hele klasse fouten in fouten.

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

## Pad

Een `pad`-directive vertelt Beancount om het benodigde bedrag in te voegen om de
volgende balance assertion op een account te laten slagen, waarbij het verschil wordt
geboekt naar een tweede account. Het bestaat voor precies één taak: een grootboek
halverwege het bestaan beginnen zonder jaren geschiedenis te reconstrueren. Padding
voorbij die initiële opzet betekent meestal dat een echte fout wordt verdoezeld.

## Betaler

De payee is met wie je de transactie bent aangegaan, geschreven als de eerste
geciteerde string op een transactieregel. Payees consistent houden — altijd
`"Whole Foods"`, nooit soms `"WholeFoods"` — is wat rapporten op basis van payee en
geautomatiseerde importeurs laat werken. Beancount behandelt de payee als optioneel;
een transactie mag alleen een narration dragen.

## Plain-text accounting

Plain-text accounting is de praktijk van het bijhouden van je boekhouding in een
voor mensen leesbaar tekstbestand onder versiebeheer, verwerkt door open-source
opdrachtregelprogramma's. Het ruilt een point-and-click-interface in voor
duurzaamheid, controleerbaarheid en automatisering: je gegevens overleven elke
leverancier, elke wijziging is een reviewbare 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 directives kan toevoegen, transformeren of valideren voordat
rapporten worden opgebouwd. Plugins zijn de manier waarop forecasting,
amortisatieschema's en aangepaste controles worden geïmplementeerd zonder de kern van
de taal te veranderen. Je activeert er één met een losse `plugin`-regel bovenaan je
grootboek, nooit met een `option` — `option "plugin" "…"` wordt afgewezen met
`Option 'plugin' may not be set`. De gids [Forecast Plugin](https://beancount.io/nl/docs/Tips/forecast-plugin)
loopt door een echt voorbeeld.

## Boeking

Een posting is één been van een transactie: een account, een bedrag, en optioneel een
kostprijs of prijs. Wat over een transactie moet optellen tot nul 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 kostprijs van één eenheid bevatten. Ten hoogste één posting mag zijn
bedrag leeg laten, in welk geval Beancount het sluitende cijfer voor je berekent. Zie
[Precision & Tolerances](https://beancount.io/nl/docs/Basics/precision) voor de volledige gewichtsregels.

## Prijsrichtlijn

Een `price`-directive registreert de wisselkoers tussen twee commodities op een datum,
wat de manier is waarop Beancount een positie omzet naar zijn marktwaarde in rapporten.
Een `price`-directive is pure referentiedata: het verplaatst geen geld en hoort bij
geen enkele transactie. Verwar het niet met de `@`-prijs die binnen een posting wordt
geschreven, wat rekenkundig is — het geeft `10 FUND @ 38.46 USD` een gewicht van
`384.60 USD` en bepaalt dus of de transactie in balans is. Zonder price directives
balanceert een portefeuille nog steeds tegen kostprijs, maar kan deze niet tegen
marktwaarde worden gewaardeerd.

```beancount
2026-06-30 price VTI   271.40 USD
```

[Live Prices](https://beancount.io/nl/docs/live-prices) levert beheerde price directives voor ondersteunde
assets in gehoste grootboeken. Je eigen prijs wint voor dezelfde datum en hetzelfde
paar, inclusief het reciproke paar. Een beheerde prijs op een latere datum kan nog
steeds van toepassing zijn op een latere waardering.

## Reconciliatie

Reconciliation is de handeling van het aantonen dat je boekhouding overeenkomt met een
externe registratie zoals een bank- of effectenafschrift. In plain-text accounting is
het grotendeels mechanisch: voeg een balance assertion toe voor elke afschriftdatum en
laat het programma je vertellen of de cijfers overeenkomen. Een grootboek dat elke
maand schoon afstemt, is er een waaruit je zonder angst belasting kunt aangeven.

## Tags en links

Tags en links zijn de twee labels die je aan transacties hangt om ze buiten de
accounthiërarchie te groeperen: een tag met `#` markeert een thema zoals `#trip-japan`,
en een link met `^` verbindt gerelateerde boekingen zoals `^invoice-2026-014` met
elkaar. Tags beantwoorden "toon me alles in deze categorie"; links beantwoorden "toon
me de boekingen die bij dit ene evenement horen". Beide zijn filterbaar in Fava en
querybaar in BQL — zie
[Filtering and Searching](https://beancount.io/nl/docs/Tips/filtering-and-searching).

## Transactie

Een transactie is een gedateerde economische gebeurtenis samen met de postings die
deze vastleggen, en het is de directive die je het vaakst zult schrijven. Het draagt
een flag (`*` voor bevestigd, `!` voor moet worden nagekeken), een optionele payee, een
narration, en twee of meer postings waarvan de gewichten optellen tot nul. Al het
andere in een Beancount-bestand bestaat om transacties te declareren, te controleren
of te annoteren.

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

---

Nog steeds vastgelopen op een woord? Het [Help Center](https://beancount.io/nl/docs/help-center) indexeert elke
gids op deze site, en de [Cheatsheet](https://beancount.io/nl/docs/Basics/cheatsheet) zet de syntaxis voor elke
directive naast elkaar.
