Naar hoofdinhoud springen

Beancount cheat sheet: syntax en directives

Naslagwerk van één pagina voor Beancount-syntax: accounttypes en tekens, commodities, transacties en postings, balance, metadata, events, tags en options.

Rekeningstructuur​

Rekeningtypen en tekens​

Type          Teken   Voorbeeld
------------------------------------------------
Assets        (+)     Assets:US:BofA:Checking
Liabilities   (-)     Liabilities:Credit:Amex
Income        (-)     Income:Salary:Gross
Expenses      (+)     Expenses:Food:Restaurant
Equity        (-)     Equity:Opening-Balances

Valuta-indeling​

Grondstoffen zijn symbolen in hoofdletters — valuta's, tickers en aangepaste eenheden. Dit zijn voorbeelden van naamgeving, geen richtlijnen:

Valuta's:         USD, EUR, CAD, AUD
Beleggingen:      GOOG, AAPL, VTI
Cryptovaluta's:   BTC, ETH
Aangepaste eenheden: HOURS, AIRMILES, HOME_MAYST

Richtlijnsyntax​

Rekeningbeheer​

; Accounts openen
2024-01-01 open Assets:Checking             ; Eenvoudig
2024-01-01 open Assets:Investing USD,GOOG   ; Met beperkingen
 
; Accounts sluiten
2024-12-31 close Assets:Old:Account

Valutadeclaratie​

2024-01-01 commodity VTSAX
    name: "Vanguard Total Stock Market Index"
    asset-class: "equity"

Transactieregistratie​

; Eenvoudige transactie
2024-01-15 * "Grocery Store" "Weekly shopping"
    Assets:Checking     -100.00 USD
    Expenses:Food:Groceries
 
; Met metadata en tags (#work is een tag, ^invoice-123 is een link)
2024-01-15 * "Restaurant" "Business dinner" #work ^invoice-123
    id: "T-1234"
    receipt: "path/to/receipt.pdf"
    Expenses:Meals      80.00 USD
    Liabilities:Credit

Boekingenspecificaties​

Dit zijn boekingsregels — elk staat binnen een transactie, ingesprongen onder de datUMregel:

; Eenvoudig bedrag
Assets:Cash              100.00 USD
 
; Kostenbasis bijhouden
Assets:Invest:VTSAX      10 VTSAX {100.00 USD}        ; Kosten per eenheid
Assets:Invest:VTSAX      10 VTSAX {{1000.00 USD}}     ; Totale kosten
Assets:Invest:VTSAX      10 VTSAX {100.00 # 9.95 USD} ; Per eenheid plus totale kosten
 
; Prijsspecificaties
Assets:Forex            1000.00 USD @ 0.85 EUR        ; Per eenheid
Assets:Forex            1000.00 USD @@ 850.00 EUR     ; Totale prijs
 
; Gedateerde partijen
Assets:Invest:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

Saldoverificatie​

; Balansaanvulling: vult Assets:Checking aan tot Equity:Opening-Balances
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Balansbevestiging: gecontroleerd aan het begin van de datum, dus dateer na de pad
2024-02-01 balance Assets:Checking  1000.00 USD

Metadatatracking​

; Notitie toevoegen
2024-01-15 note Assets:Checking "Called bank about fee"
 
; Document koppelen
2024-01-15 document Assets:Checking "path/to/statement.pdf"
 
; Prijs vastleggen
2024-01-15 price VTSAX  100.00 USD

Voor gehoste grootboeken kan Live Prices automatisch gedateerde waarderingsprijzen leveren. Kies ondersteunde assetparen in de picker en kopieer de includes naar je grootboek. Houd transactieprijzen en kostenbasis expliciet.

Gebeurtenisregistratie​

; Locatie bijhouden
2024-01-15 event "location" "New York, USA"
 
; Eigendomswijzigingen
2024-01-15 event "address" "123 Main Street"

Tagbeheer​

; Tagbereik beheren: #vacation geldt voor elke transactie tussen pushtag en poptag
pushtag #vacation
2024-01-15 * "Hotel"
    Expenses:Travel:Lodging   200.00 USD
    Assets:Credit
poptag #vacation

Configuratie-opties​

; Basisinstellingen
option "title" "Personal Finance Ledger"
option "operating_currency" "USD"
 
; Accountnaamgeving
option "name_assets" "Assets"
option "name_liabilities" "Liabilities"
option "name_income" "Income"
option "name_expenses" "Expenses"
option "name_equity" "Equity"
 
; Documentverwerking
option "documents" "/path/to/docs"

Opmerkingen en organisatie​

; Opmerking op één regel
 
* Sectiekop
** Subsectie
; Transactieblok volgt...
 
; Accountgroepering
; Assets
2024-01-15 ...
 
; Expenses
2024-01-16 ...

Deze referentie biedt een compleet overzicht van Beancount's syntaxiselementen met praktische voorbeelden.

Bron: https://beancount.io/nl/docs/Basics/cheatsheet