Beancount tutoriál: inštalácia a prvý ledger

Ste pripravení prevziať kontrolu nad svojimi financiami? Táto príručka vám pomôže spustiť Beancount v priebehu niekoľkých minút. Naučíte sa, ako vytvoriť svoje prvé účtovníctvo, nastaviť základné účty a zaznamenať svoje prvé transakcie.

Preskúmajte živé účtovníctvo →

Počiatočné nastavenie​

Vytvorenie vášho prvého účtovníctva​

; 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

Základná konfigurácia​

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

Organizácia súborov​

Odporúčaná štruktúra​

; 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

Organizácia sekcií​

1. Večné účty

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

2. Bankové účty

   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. Investičné účty

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

Validácia a reporty​

Základná validácia​

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

bea check je validátor: vracia kód 0, keď je účtovníctvo čisté, a v prípade chýb vypíše každú chybu a vráti nenulový kód. Nainštalujte ho pomocou rýchleho štartu CLI. Fava je webové rozhranie — spustite ho a otvorte vytlačenú adresu http://localhost:5000 pre súvahu, výkaz ziskov a strát a denníky účtov.

Bežné reporty​

Beancount 3 generuje reporty cez webové rozhranie Fava, jedným príkazom bea report alebo ad-hoc dotazmi pomocou bea query, ktorý spúšťa Beancount Query Language. Beancount 3 odstránil svoje staršie príkazy report a web; nahrádzajú ich bea report a Fava.

# Balance sheet, in one command
bea --file ledger.beancount report balance-sheet
 
# Income statement, in one command
bea --file ledger.beancount report income-statement
 
# Balance-sheet numbers: balances by asset, liability, and equity account
bea --file ledger.beancount query "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
bea --file ledger.beancount query "SELECT account, sum(position) AS total WHERE account ~ '^(Income|Expenses)' GROUP BY account ORDER BY account"
 
# One account's journal, with a running balance
bea --file ledger.beancount query "SELECT date, narration, position, balance WHERE account = 'Assets:Checking'"

Správa počiatočných zostatkov​

Príklad padu​

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

Kontrola balance overuje účet na začiatku svojho dátumu, preto musí byť datovaná po pad (alebo akejkoľvek transakcii), ktorú má zahrnúť. Datovanie pad a balance na rovnaký deň ponechá pad nepoužitý a kontrola bude krátka — Beancount hlási Unused Pad entry a Balance failed. Účet Equity:Opening-Balances musí byť otvorený predtým, ako sa proti nemu paduje.

Uzavretie účtu​

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

Deduplikácia transakcií​

Spracovanie prevodov​

; 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

Kontroly zostatkov​

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

Najlepšie postupy​

1. Organizácia súborov

   • Najprv si ponechajte jeden hlavný súbor
   • Používajte jasné nadpisy sekcií
   • Zoskupujte súvisiace účty

2. Názvy účtov

   • Používajte konzistentné konvencie pomenovania
   • Zahrňte predpony krajiny/inštitúcie
   • Udržujte logickú hierarchiu

3. Overovanie zostatkov

   • Pravidelné kontroly zostatkov
   • Primerané padovanie účtov
   • Sledovanie uzavretí účtov

4. Spracovanie mien

   • Deklarujte prevádzkové meny
   • Používajte konzistentné kódy komodít
   • Špecifikujte obmedzenia mien

Ďalšie kroky​

Teraz, keď máte nastavené základné účtovníctvo:

1. Zaznamenávajte pravidelné transakcie: Začnite so svojimi dennými výdavkami a príjmami
2. Nastavte importy bankových účtov: Použite CSV importy alebo bankové pripojenia na automatizáciu zadávania údajov. Vložte export výpisu do konvertora CSV do Beancount a získajte vyvážené záznamy v prehliadači, alebo použite OFX & QIF do Beancount pre súbory .ofx, .qfx a .qif.
3. Skopírujte overený layout: Stiahnite si spustiteľný štartovací súbor zo sekcií domácnosť, obálkové rozpočtovanie alebo freelancer v príkladoch pracovných účtovníctiev, potom prispôsobte vzory majetku a investovania z rovnakej galérie
4. Naučte sa pokročilú syntax: Preskúmajte referenciu syntaxe pre zložitejšie scenáre
5. Vygenerujte svoje prvé reporty: Použite funkcie UI na vytvorenie finančných reportov a analýzu svojich výdavkov
6. Pracujte z terminálu: Nainštalujte príkazový riadok bea pomocou rýchleho štartu CLI, potom uzavrite celý mesiac od začiatku do konca v Váš prvý mesiac s bea

Rýchla referencia​

Bežné typy účtov:

• Assets:Bank:Checking - Váš bežný účet
• Expenses:Food:Groceries - Výdavky na potraviny
• Income:Salary:Company - Príjem zo zamestnania
• Liabilities:CreditCard:Visa - Dlh na kreditnej karte

Základné príkazy:

• bea --file ledger.beancount check - Validuje vaše účtovníctvo (vracia nenulový kód pri chybách)
• bea --file ledger.beancount report balance-sheet - Vytlačí súvahu
• bea --file ledger.beancount query "SELECT ..." - Dotazuje zostatky a transakcie
• fava ledger.beancount - Spustí webové rozhranie pre reporty a grafy

Tieto pokyny vytvárajú solídny základ pre správu osobných financií s Beancount. Ste pripravení pridať svoju prvú transakciu? Pozrite si náš sprievodcu transakciami v UI.