Opties Configuratie in Beancount

Het gedrag van Beancount kan worden aangepast met behulp van option directives die bovenaan je hoofd grootboekbestand worden geplaatst. Deze key-value paren beheren alles, van de namen van je root accounts tot de manier waarop valuta conversies worden afgehandeld. Het correct configureren van deze opties is essentieel om Beancount af te stemmen op je specifieke behoeften. ⚙️

Kern Configuratie Opties

Deze opties bepalen de fundamentele setup van je grootboek.

Basis Instellingen

Dit zijn enkele van de meest voorkomende opties die je zult instellen.

option "title" "Persoonlijk Grootboek"
option "render_commas" "TRUE"
option "plugin_processing_mode" "raw"

• title: Stelt de titel in voor rapporten en web interfaces.
• render_commas: Indien TRUE, worden getallen in rapporten geformatteerd met duizendtallen scheidingstekens (bijv. 1.000.000,00).
• plugin_processing_mode: Bepaalt hoe plugins worden geladen. raw laadt alleen de plugins die je expliciet specificeert, terwijl default een standaard set van handige plugins laadt.

Account Naam Aanpassing

Je kunt de vijf fundamentele account types van Beancount hernoemen. Dit is puur cosmetisch en verandert hoe ze in rapporten verschijnen.

option "name_assets" "Activa"
option "name_liabilities" "Passiva"
option "name_equity" "EigenVermogen"
option "name_income" "Inkomsten"
option "name_expenses" "Uitgaven"

Eigen Vermogen Account Configuratie

Beancount creëert automatisch een aantal speciale eigen vermogen accounts om openingssaldi en inkomstenberekeningen af te handelen. Je kunt aangepaste namen specificeren voor deze accounts.

option "account_previous_balances" "Openingsbalansen"
option "account_previous_earnings" "Winst:Voorgaand"
option "account_current_earnings" "Winst:Huidig"
option "account_previous_conversions" "Conversies:Voorgaand"
option "account_current_conversions" "Conversies:Huidig"
option "account_rounding" "Afronding"

• account_previous_balances: Het account dat wordt gebruikt om openingssaldi in je grootboek te injecteren.
• account_current_earnings: Het account dat alle inkomsten- en uitgaventotalen voor de huidige periode accumuleert, waardoor effectief je netto inkomen wordt berekend.
• account_rounding: Het account waar kleine afwijkingen van automatische afronding worden geboekt.

Precisie en Tolerantie Instellingen

Deze opties bepalen hoe Beancount afronding en kleine onevenwichtigheden in transacties afhandelt.

Standaard Tolerantie Configuratie

Beancount kan automatisch een tolerantie afleiden voor transacties met meerdere valuta's of kosten, waardoor kleine afrondingsverschillen mogelijk zijn zonder fouten te veroorzaken.

option "inferred_tolerance_default" "USD:0.01"
option "inferred_tolerance_multiplier" "1.1"
option "infer_tolerance_from_cost" "True"

• inferred_tolerance_default: Stelt de standaard tolerantie in voor een bepaalde valuta. Je kunt *:0.5 gebruiken om een standaard in te stellen voor alle valuta's.
• inferred_tolerance_multiplier: Een factor die wordt toegepast op de tolerantie om een iets grotere foutmarge te bieden.
• infer_tolerance_from_cost: Indien True, wordt de tolerantie afgeleid van het aantal cijfers in de kostprijs.

Boekingsmethode

Deze optie definieert hoe Beancount transacties afhandelt waarbij één been is afgeleid.

option "booking_method" "SIMPLE"

• SIMPLE: Staat toe dat slechts één commodity automatisch per transactie in evenwicht wordt gebracht. Dit is de aanbevolen en meest gebruikte methode.
• FULL: Staat toe dat meerdere commodities in evenwicht worden gebracht, wat een complexere en zelden benodigde methode is.

Valuta Beheer

Een correcte valuta configuratie is essentieel voor nauwkeurige rapportage.

Operationele Valuta

Je kunt één of meer "operationele valuta's" declareren. Dit zijn de belangrijkste valuta's waarin je transacties verricht en die je in rapporten wilt zien.

option "operating_currency" "USD"
option "operating_currency" "EUR"
option "conversion_currency" "NOTHING"

Het declareren van operationele valuta's vertelt Beancount om speciale kolommen voor hen te creëren in rapporten, waardoor het gemakkelijk is om je financiële positie in je meest gebruikte valuta's te zien. Het instellen van conversion_currency op NOTHING schakelt de automatische conversie kolom uit, wat vaak de voorkeur heeft voor schonere rapporten.

Document Beheer

Beancount kan transacties koppelen aan externe bestanden, zoals bonnen of facturen. De documents optie specificeert de root folder(s) waar deze bestanden zijn opgeslagen.

option "documents" "/pad/naar/documenten/archief"

Vereisten:

• Bestanden moeten worden genoemd in de notatie JJJJ-MM-DD.beschrijving.ext (bijv. 2025-07-28.amazon-bestelling.pdf).
• Je kunt meerdere documents opties specificeren voor verschillende folders.
• Paden kunnen absoluut of relatief zijn ten opzichte van het hoofd grootboekbestand.

Plugin Systeem

De functionaliteit van Beancount kan worden uitgebreid met plugins.

Plugin Configuratie

Je activeert een plugin door het modulepad te specificeren.

option "plugin" "beancount.plugins.module_name"

Zoals eerder vermeld, bepaalt de optie plugin_processing_mode of Beancount alleen je gespecificeerde plugins laadt (raw) of ook een standaard set (default).

Technische Limieten en Beperkingen

Deze opties bepalen technische aspecten van de Beancount parser.

String Afhandeling

Je kunt een limiet instellen voor het aantal regels dat is toegestaan in een multi-line string om parsing errors te voorkomen.

option "long_string_maxlines" "64"

Experimentele Functies

Beancount bevat soms experimentele functies die je kunt inschakelen met een optie. Bijvoorbeeld, om expliciete tolerantie syntax in te schakelen:

option "experiment_explicit_tolerances" "True"

Dit stelt je in staat om tolerantie direct in een transactie boeking te specificeren, zoals dit: 532.23 ~ 0.001 USD.

Systeem Gedragsregels

Deze opties zijn voor het behouden van compatibiliteit of specifieke systeemgedragingen.

Legacy Ondersteuning

Deze optie schakelt de oude, vaste tolerantie waarden in voor backward compatibility met oudere grootboeken.

option "use_legacy_fixed_tolerances" "True"

De vaste legacy toleranties waren:

• Balance/Pad directives: 0,015 eenheden
• Transacties: 0,005 eenheden

Aanbevolen Configuratie ✅

Voor de meeste gebruikers biedt de volgende configuratie een robuust en verstandig startpunt.

Basis Setup

option "title" "Persoonlijk Grootboek"
option "operating_currency" "USD"  // Wijzig naar je primaire valuta
option "documents" "/home/gebruiker/Documenten/beancount" // Wijzig naar je documenten pad
option "render_commas" "TRUE"

Precisie Controle

option "inferred_tolerance_default" "USD:0.01" // Wijzig naar je primaire valuta
option "inferred_tolerance_multiplier" "1.1"
option "infer_tolerance_from_cost" "True"

Account Structuur

option "account_previous_balances" "EigenVermogen:Openingsbalansen"
option "account_current_earnings" "EigenVermogen:Huidige-Winst"
option "account_rounding" "Uitgaven:Afronding"

Deze setup biedt een solide basis voor een nieuw Beancount grootboek, zorgt voor duidelijke rapportage, verstandige precisie controle en een logische eigen vermogen accountstructuur.