Snelstartgids

Klaar om de controle over je financiën te nemen? Deze handleiding helpt je binnen enkele minuten op weg met Beancount. Je leert hoe je je eerste grootboek maakt, essentiële accounts instelt en je eerste transacties registreert.

Verken het live grootboek →

Eerste installatie​

Je eerste grootboek maken​

; Basic structure for a new ledger
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances
 
2024-01-02 * "Initial Deposit"
  Assets:Checking           100.00 USD
  Equity:Opening-Balances

Essentiële configuratie​

option "title" "Personal Finance Ledger"
option "operating_currency" "USD"

Bestandsorganisatie​

Aanbevolen structuur​

; 1. Configuration Options
option "title" "Personal Ledger"
option "operating_currency" "USD"
 
; 2. Account Declarations
2024-01-01 open Assets:Checking    USD
2024-01-01 open Assets:Savings     USD
2024-01-01 open Expenses:Food      USD
2024-01-01 open Equity:Opening-Balances
 
; 3. Initial Balances
; Pad fills the gap up to Equity:Opening-Balances, so it must be dated
; before the assertion. Balance assertions are checked at the start of
; their day, so assert the next morning.
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-02 balance Assets:Checking 1000.00 USD
 
; 4. Transactions
2024-01-15 * "Grocery Store" "Weekly groceries"
  Expenses:Food            50.00 USD
  Assets:Checking

Sectie-organisatie​

1. Eeuwigdurende accounts

   2024-01-01 open Liabilities:Payables    USD
   2024-01-01 open Assets:Receivables      USD

2. Bankrekeningen

   2024-01-01 open Assets:Bank:Checking     USD
   2024-01-01 open Assets:Bank:Savings      USD
   2024-01-01 open Income:Bank:Interest     USD

3. Beleggingsrekeningen

   2024-01-01 open Assets:Investment:Cash    USD
   2024-01-01 open Assets:Investment:Stocks  VTSAX
   2024-01-01 open Income:Investment:Dividend USD

Validatie en rapportage​

Basisvalidatie​

# Check for errors (prints nothing and exits 0 when clean)
bean-check ledger.beancount
 
# Browse balances, reports, and charts in the web interface
fava ledger.beancount

bean-check is de validator: het print niets en sluit af met 0 wanneer het grootboek schoon is, en vermeldt elke fout en sluit af met een niet-nul status in het andere geval. Fava is de webinterface — start deze en open het getoonde http://localhost:5000-adres voor de balans, winst- en verliesrekening en accountjournalen.

Veelvoorkomende rapporten​

Beancount 3 genereert rapporten via de webinterface van Fava of ad-hocquery's met bean-query, die de Beancount-querytaal gebruikt. De oudere bean-report- en bean-web-opdrachten zijn in Beancount 3 verwijderd, dus de onderstaande opdrachten vervangen deze.

# Balance-sheet numbers: balances by asset, liability, and equity account
bean-query ledger.beancount "SELECT account, sum(position) AS balance WHERE account ~ '^(Assets|Liabilities|Equity)' GROUP BY account ORDER BY account"
 
# Income-statement numbers: totals by income and expense account
bean-query ledger.beancount "SELECT account, sum(position) AS total WHERE account ~ '^(Income|Expenses)' GROUP BY account ORDER BY account"
 
# One account's journal, with a running balance
bean-query ledger.beancount "SELECT date, narration, position, balance WHERE account = 'Assets:Checking'"

Beginstanden beheren​

Padding-voorbeeld​

2024-01-01 open Assets:Checking    USD
2024-01-01 open Equity:Opening-Balances
 
; Pad account to match a known balance
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Assert the known balance the next day: assertions are evaluated at the
; start of their date, and the pad transaction must fall before it
2024-01-02 balance Assets:Checking 1525.00 USD

Een balance-assertie controleert het account aan het begin van de datum, dus deze moet gedateerd zijn na de pad (of elke transactie) die het moet bevatten. Als de pad en de balance op dezelfde dag worden gedateerd, blijft de pad ongebruikt en is de assertie tekort — Beancount meldt Unused Pad entry en Balance failed. Het account Equity:Opening-Balances moet worden geopend voordat er tegenaan wordt gepadded.

Account afsluiten​

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking  ; Account closed

Deduplicatie van transacties​

Overboekingen afhandelen​

; Credit card payment - combined view
2024-01-15 * "Credit Card Payment"
  Assets:Checking            -500.00 USD
  Liabilities:CreditCard     500.00 USD
 
; Flag for pending match
2024-01-15 * "Pending CC Payment"
  ! Assets:Checking         -500.00 USD
  Liabilities:CreditCard    500.00 USD

Saldo-asserties​

; Regular balance checks prevent duplicates
2024-01-31 balance Assets:Checking    2150.25 USD
2024-01-31 balance Liabilities:CreditCard  -350.00 USD

Beste praktijken​

1. Bestandsorganisatie

   • Houd in eerste instantie één hoofdbestand aan
   • Gebruik duidelijke sectiekoppen
   • Groepeer gerelateerde accounts bij elkaar

2. Accountnamen

   • Gebruik consistente naamgevingsconventies
   • Neem land-/instellingsvoorvoegsels op
   • Handhaaf een logische hiërarchie

3. Saldo-verificatie

   • Regelmatige saldo-asserties
   • Pad-accounts op de juiste manier gebruiken
   • Volg accountafsluitingen bij

4. Valutabeheer

   • Declareer operationele valuta's
   • Gebruik consistente commodity-codes
   • Specificeer valutabeperkingen

Volgende stappen​

Nu je een basisgrootboek hebt ingesteld:

1. Registreer regelmatige transacties: Begin met je dagelijkse uitgaven en inkomsten
2. Stel bankimport in: Gebruik CSV-imports of bankverbindingen om gegevensinvoer te automatiseren. Plak een statement-export in de CSV naar Beancount-converter om gebalanceerde invoer in je browser te krijgen, of gebruik OFX & QIF naar Beancount voor .ofx, .qfx- en .qif-downloads.
3. Kopieer een bewezen lay-out: Download een uitvoerbaar startbestand uit de secties huishouden, envelopbudgettering of freelance van de werkende grootboekvoorbeelden en pas vervolgens de eigendoms- en investeringspatronen uit dezelfde galerij aan
4. Leer geavanceerde syntaxis: Verken de syntaxreferentie voor complexere scenario's
5. Genereer je eerste rapporten: Gebruik de UI-functies om financiële rapporten te maken en je uitgaven te analyseren

Snelle referentie​

Veelvoorkomende accounttypen:

• Assets:Bank:Checking - Je betaalrekening
• Expenses:Food:Groceries - Uitgaven aan boodschappen
• Income:Salary:Company - Inkomsten uit dienstverband
• Liabilities:CreditCard:Visa - Creditcardschuld

Essentiële opdrachten:

• bean-check ledger.beancount - Valideer je grootboek (sluit af met niet-nul bij fouten)
• fava ledger.beancount - Start de webinterface voor rapporten en grafieken
• bean-query ledger.beancount "SELECT ..." - Query saldi en transacties

Deze richtlijnen leggen een solide basis voor het beheren van persoonlijke financiën met Beancount. Klaar om je eerste transactie toe te voegen? Bekijk onze UI-transactiehandleiding.