04 - Beancount Basis voor Gebruikers¶
Beancount slaat boekhouding op als leesbare tekst. Elke transactie geeft aan wat er gebeurde, op welke datum, wie erbij betrokken was en welke rekeningen werden gewijzigd.
Basisstructuur van een transactie¶
2026-01-13 ! "Tragerwerk Soziale Dienste in Sachsen-Anhalt GmbH" "RgNr. T-2504"
Vermoegen:Bank:Sparkasse-Tohuwabohu:Freies-Geld 680.00 EUR
Einnahmen:Sonstiges
| Deel | Betekenis |
|---|---|
2026-01-13 |
Datum van de transactie. |
! |
Statusmarkering. In dit systeem wordt dit vaak gebruikt voor geïmporteerde of nog niet definitief beoordeelde posten. |
| Eerste geciteerde tekst | Ontvanger of afzender. |
| Tweede geciteerde tekst | Omschrijving of boekingskenmerk van de bank. |
| Eerste rekeningregel | Waar het geld naartoe ging of vandaan kwam. |
| Tweede rekeningregel | De tegenrekening. Als er geen bedrag wordt ingevuld, berekent Beancount dit automatisch. |
Rekeningnamen¶
Rekeningnamen worden gescheiden door dubbele punten:
Vermoegen:Bank:Sparkasse-NICA:Freies-Geld
Lees dit van links naar rechts: bezit, bankrekening, NICA Sparkasse, vrij beschikbaar saldo.
De vijf rekeningfamilies¶
| Familie | Betekenis | Voorbeeld |
|---|---|---|
Vermoegen |
Bezittingen: bank, PayPal, contant geld, voorraad. | Vermoegen:Bank:Sparkasse-NICA |
Verbindlichkeiten |
Schulden: geld verschuldigd aan personen of anderen. | Verbindlichkeiten:Person:Marc-Bielert |
Equity |
Openingssaldi en correctieboekingen. | Equity:Opening-Balances |
Einnahmen |
Inkomsten. | Einnahmen:Vereinsbeitrag |
Ausgaben |
Uitgaven. | Ausgaben:Buero:Miete |
Tekens voor inkomsten en uitgaven¶
In Beancount-rapporten verschijnen inkomsten intern vaak met een minteken en uitgaven met een plusteken. Fava en de dashboards presenteren deze waarden vaak op een gebruiksvriendelijkere manier. Wijzig transacties niet zomaar omdat een inkomstengetal negatief lijkt in een ruwe query.
Saldocontroles¶
Een saldocontrole stelt dat een rekening op een bepaalde datum een specifiek saldo moet hebben:
2026-03-13 balance Vermoegen:Bank:Sparkasse-NICA 1234.56 EUR
Als Beancount dat saldo niet kan matchen met de transacties van vóór die datum, geeft Fava een foutmelding. Saldocontroles zijn het belangrijkste kwaliteitscontrolemechanisme.
Rekeningen openen en sluiten¶
Voordat een rekening wordt gebruikt, wordt deze geopend:
2025-04-01 open Ausgaben:Projekt:25-ZGV:Honorar
Wanneer een project is afgerond en de projectrekening op nul staat, kan deze worden gesloten:
2026-02-27 close Ausgaben:Projekt:TOHUCON-25
Gesloten rekeningen mogen normaal gesproken geen nieuwe transacties meer ontvangen.
Opmerkingen en documenten¶
Regels die beginnen met ; zijn opmerkingen. Ze leggen beslissingen of onzekere situaties uit en hebben geen invloed op de cijfers.
Bonnen kunnen worden gekoppeld met document-regels:
2025-10-02 document Ausgaben:Projekt:TOHUCON-25:Essen "Belege Ausgaben/Quittung-Tohu25-001.pdf"