Preskočiť na hlavný obsah

Beancount ťahák: syntax a direktívy

Jednostránkový prehľad syntaxe Beancount: typy účtov a znamienka, komodity, transakcie a záznamy, zostatok, metadáta, udalosti, značky a možnosti.

Štruktúra účtov​

Typy účtov a znamienka​

Typ           Znamienko    Príklad
------------------------------------------------
Assets        (+)     Assets:US:BofA:Checking
Liabilities   (-)     Liabilities:Credit:Amex
Income        (-)     Income:Salary:Gross
Expenses      (+)     Expenses:Food:Restaurant
Equity        (-)     Equity:Opening-Balances

Formát komodít​

Komodity sú symboly písané veľkými písmenami — meny, tickery a vlastné jednotky. Toto sú príklady pomenovania, nie direktívy:

Meny:             USD, EUR, CAD, AUD
Investície:       GOOG, AAPL, VTI
Kryptomeny:       BTC, ETH
Vlastné jednotky: HOURS, AIRMILES, HOME_MAYST

Syntax direktív​

Správa účtov​

; Otváranie účtov
2024-01-01 open Assets:Checking             ; Jednoduché
2024-01-01 open Assets:Investing USD,GOOG   ; S obmedzeniami
 
; Zatváranie účtov
2024-12-31 close Assets:Old:Account

Deklarácia komodít​

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

Zaznamenávanie transakcií​

; Základná transakcia
2024-01-15 * "Grocery Store" "Weekly shopping"
    Assets:Checking     -100.00 USD
    Expenses:Food:Groceries
 
; S metadátami a tagmi (#work je tag, ^invoice-123 je odkaz)
2024-01-15 * "Restaurant" "Business dinner" #work ^invoice-123
    id: "T-1234"
    receipt: "path/to/receipt.pdf"
    Expenses:Meals      80.00 USD
    Liabilities:Credit

Špecifikácia položiek (postingov)​

Toto sú riadky položiek — každý sa nachádza vnútri transakcie, odsadený pod riadkom s dátumom:

; Základná suma
Assets:Cash              100.00 USD
 
; Sledovanie nákladovej základne
Assets:Invest:VTSAX      10 VTSAX {100.00 USD}        ; Náklad na jednotku
Assets:Invest:VTSAX      10 VTSAX {{1000.00 USD}}     ; Celkové náklady
Assets:Invest:VTSAX      10 VTSAX {100.00 # 9.95 USD} ; Náklad na jednotku plus celkový poplatok
 
; Špecifikácie ceny
Assets:Forex            1000.00 USD @ 0.85 EUR        ; Za jednotku
Assets:Forex            1000.00 USD @@ 850.00 EUR     ; Celková cena
 
; Datované loty
Assets:Invest:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

Overenie zostatkov​

; Doplnenie zostatku: doplní Assets:Checking do Equity:Opening-Balances
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Overenie zostatku: kontroluje sa na začiatku svojho dátumu, preto ho datujte po pade
2024-02-01 balance Assets:Checking  1000.00 USD

Sledovanie metadát​

; Pripojenie poznámky
2024-01-15 note Assets:Checking "Called bank about fee"
 
; Prepojenie dokumentu
2024-01-15 document Assets:Checking "path/to/statement.pdf"
 
; Zaznamenanie ceny
2024-01-15 price VTSAX  100.00 USD

Pre hostované knihy môže Live Prices automaticky dodávať datované oceňovacie ceny. Vyberte podporované páry aktív v pickeri a potom skopírujte includes do svojej knihy. Transakčné ceny a nákladovú základňu udržujte explicitne.

Zaznamenávanie udalostí​

; Sledovanie lokality
2024-01-15 event "location" "New York, USA"
 
; Zmeny vlastností
2024-01-15 event "address" "123 Main Street"

Správa značiek (tagov)​

; Ovládanie rozsahu tagu: #vacation sa vzťahuje na každú transakciu medzi pushtag a poptag
pushtag #vacation
2024-01-15 * "Hotel"
    Expenses:Travel:Lodging   200.00 USD
    Assets:Credit
poptag #vacation

Možnosti konfigurácie​

; Základné nastavenia
option "title" "Personal Finance Ledger"
option "operating_currency" "USD"
 
; Pomenovanie účtov
option "name_assets" "Assets"
option "name_liabilities" "Liabilities"
option "name_income" "Income"
option "name_expenses" "Expenses"
option "name_equity" "Equity"
 
; Spracovanie dokumentov
option "documents" "/path/to/docs"

Komentáre a organizácia​

; Jednoriadkový komentár
 
* Nadpis sekcie
** Podsekcia
; Nasleduje blok transakcií...
 
; Zoskupenie účtov
; Assets
2024-01-15 ...
 
; Expenses
2024-01-16 ...

Tento prehľad poskytuje kompletný prehľad syntaktických prvkov Beancount s praktickými príkladmi.

Zdroj: https://beancount.io/sk/docs/Basics/cheatsheet