Ťahák Beancount - Rýchly referenčný sprievodca

Štruktúra účtu

Typy účtov a znamienka

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

Formát komodity

# Financial
USD, EUR, CAD, AUD     # Štandardné meny
GOOG, AAPL, VTI       # Investičné nástroje
BTC, ETH              # Kryptomeny

# Vlastné sledovanie
HOURS                 # Sledovanie času
AIRMILES             # Vernostné body
HOME_MAYST           # Nehnuteľnosť

Syntax direktív

Správa účtov

# Otvorenie účtov
2024-01-01 open Assets:Checking            # Jednoduché
2024-01-01 open Assets:Investing USD,GOOG  # S obmedzeniami

# Zatvorenie účtov
2024-12-31 close Assets:Old:Account

Deklarácia komodity

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" "Týždenný nákup"
    Assets:Checking     -100.00 USD
    Expenses:Food:Groceries

# S metadátami a značkami
2024-01-15 * "Restaurant" "Pracovná večera" #work ^invoice-123
    id: "T-1234"
    receipt: "path/to/receipt.pdf"
    Expenses:Meals      80.00 USD
    Liabilities:Credit

Špecifikácie zápisov

# Základná suma
Assets:Cash              100.00 USD

# Sledovanie nákladovej bázy
Assets:Invest:VTSAX      10 VTSAX {100.00 USD}        # Na jednotku
Assets:Invest:VTSAX      10 VTSAX {{1000.00 USD}}     # Celkové náklady
Assets:Invest:VTSAX      10 VTSAX {100.00 # 9.95 USD} # S poplatkami

# Cenové špecifikácie
Assets:Forex            1000.00 USD @ 0.85 EUR        # Na jednotku
Assets:Forex            1000.00 USD @@ 850.00 EUR     # Celková cena

# Dátumovo určené šarže
Assets:Invest:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

Overenie zostatku

# Asertácia zostatku
2024-01-31 balance Assets:Checking  1000.00 USD

# Vyrovnávací zápis zostatku
2024-01-01 pad Assets:Checking Equity:Opening-Balances

Sledovanie metadát

# Príloha poznámky
2024-01-15 note Assets:Checking "Volal som do banky ohľadom poplatku"

# Prepojenie dokumentu
2024-01-15 document Assets:Checking "path/to/statement.pdf"

# Zaznamenávanie ceny
2024-01-15 price VTSAX  100.00 USD

Zaznamenávanie udalostí

# Sledovanie polohy
2024-01-15 event "location" "New York, USA"

# Zmeny vlastností
2024-01-15 event "address" "123 Main Street"

Správa značiek

# Kontrola rozsahu značiek
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" "Osobná finančná kniha"
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

* Hlava sekcie
** Podsekcia
; Nasleduje blok transakcií...

; Zoskupovanie účtov
; Assets
2024-01-15 ...

; Expenses
2024-01-16 ...

Táto referencia poskytuje kompletný prehľad o syntaxi Beancountu s praktickými príkladmi.