Váš prvý mesiac s bea

Zatvorte jeden mesiac účtov od začiatku do konca pomocou bea, príkazového riadku Beancount.io. Otvoríte hlavnú knihu, zaevidujete nákupy, importujete export z banku, zosúladujete s výpisom v hodnote 3206,81 USD a prečítate mesačný výkaz ziskov a strát a bilanciu.

Mesiac je august 2026 a hlavná kniha začína s 1 250 USD na čekovom účte. Nič tu nevyžaduje, aby ste písali Python alebo dotaz.

Najprv nainštalujte bea, ak ste to ešte neurobili: Rychlý start Beancount CLI pokrýva Homebrew a uv. Lokálne účtovníctvo nepotrebuje konto Beancount.io.

Pracujte v prázdnom priečinku. Pred začiatkom doňho prekopírujte dva vstupné súbory:

• first-month.csv — bankový export, ktorý importujete v týždni 3.
• rules.toml — pravidlá kategorizácie, ktoré tento export používa.

Každý príkaz označuje hlavnú knihu pomocou --file august/main.bean, takže ich môžete vykonávať z toho priečinka bez prechodu do hlavnej knihy.

Týždeň 1 — nastavte účtovné knihy​

Vytvorte hlavnú knihu, potom otvorte ten jeden účet, ktorý šablón pre tento mesiac nemá.

bea --no-input init august --currency USD --date 2026-08-01 \
  --opening-balance "Assets:Checking 1250"
bea --file august/main.bean add open --date 2026-08-01 --account Expenses:Transport:Fuel -c USD

init píše august/main.bean so štrnásť účtov, vrátane Expenses:Uncategorized. Importy parkujú riadky, ktoré nemôžu kategorizovať, tam.

Týždeň 2 — zaevidujte denné nákupy​

Zaevidujte nákupy tak, ako sa vyskytujú. Dátum sa prednastavuje na dnešný deň, takže pre staršie histórie preneste --date explicitne.

bea --file august/main.bean add transaction "Coffee" --date 2026-08-03 \
  --posting "Expenses:Dining 4.50" --posting "Assets:Checking"
bea --file august/main.bean add transaction "Weekly groceries" --date 2026-08-05 \
  --posting "Expenses:Groceries 62.30" --posting "Assets:Checking"
bea --file august/main.bean add transaction --date 2026-08-07 --payee "Employer" \
  --narration "August salary" --posting "Assets:Checking 2100" --posting "Income:Salary"

Každé dodanie sa kontroluje proti celej hlavnej knihe predtým, ako súbor sa nahradí. Druhá pozícia zostane prázdna, takže Beancount doplní vyrovnávajúcu sumu.

Týždeň 3 — importujte bankový export​

Export pre zvyšok augusta obsahuje tri riadky:

Date,Payee,Amount
2026-08-10,Whole Foods,-28.40
2026-08-12,Shell,-35.00
2026-08-20,Mystery Shop,-9.99

Súbor pravidiel porovnáva prijímateľa s účtom. Pravidlá sa vykonávajú v priečine, v ktorom sú zapísané, a prvé nájdené pravidlo zvíťaží.

[[rule]]
match = "whole foods|trader joe|corner market"
account = "Expenses:Groceries"
 
[[rule]]
match = "shell|chevron|exxon"
account = "Expenses:Transport:Fuel"
 
[[rule]]
match = "salary|payroll|employer"
account = "Income:Salary"

Mapujte stĺpce exportu pomocou --csv, prehliadnite výsledok, potom opakujte s --apply, aby to zapísali.

bea --file august/main.bean import first-month.csv \
  --csv date=Date,amount=Amount,payee=Payee --account Assets:Checking --rules rules.toml
bea --file august/main.bean import first-month.csv --apply

Predhliad tlačí jeden riadok na riadok s pravidlom, ktoré ho našlo, plus presné rozdiely, ktoré by zapísalo. Nič sa nezaPíše, kým nepožijete --apply.

Druhý príkaz nepotrebuje žiadné značky: mapovanie stĺpcov, účet a pravidlá sa zapamätajú pre ten súbor. Každá zapísaná pozícia nesie riadok import-id, takže pri opakovaní importu ten istý export preskočí to, čo už je v hlavnej knihe.

Dva riadky nájdu pravidlo. Tretí, Mystery Shop, nič nenajde, takže sa pošle na Expenses:Uncategorized so značkou ! — vaša fronta pre revíziu neskôr.

Pre formulár s debetnou a kreditovou stĺpcou, iné valuty a Python importéry, pozri Import bankových exportov s CLI.

Týždeň 4 — zosúladujte s výpisom​

Augustový výpis zatvára čekový účet na 3206,81 USD. Vaše knihy ukazujú 3209,81 USD. Rozdiel je banková poplatka 3,00 USD, ktorú export neobsadil.

Zaevidujte poplatku, potom potvrdte balančný výrok. Beancount kontroluje výrok na začiatku dňa, takže výrok z 1. septembra pokrýva všetky augustové transakcie.

bea --file august/main.bean add transaction "Bank fee" --date 2026-08-31 \
  --posting "Expenses:Fees 3.00" --posting "Assets:Checking"
bea --file august/main.bean add balance --date 2026-09-01 --account Assets:Checking \
  --amount "3206.81 USD"
bea --file august/main.bean list transaction --flag '!' --details

Fronta obsahuje jednu transakciu, riadok Mystery Shop. --details tlačí jej súbor a číslo riadka.

Otvorte ten riadok vo vašom editore. Zmeňte jej Expenses:Uncategorized pozíciu na účet, do ktorého patrí — tu Expenses:Dining — a zmeňte jej značku z ! na *, aby ju označili ako revidovanú. Održte riadok import-id, aby opakovaný import stále preskočil riadok.

Potom potvrdte, že hlavná kniha sa zaťažuje a fronta je prázdna:

bea --file august/main.bean check
bea --file august/main.bean list transaction --flag '!' --details

Čistá hlavná kniha vychádza s kódom 0. Nefunkčný balančný výrok alebo neznámy účet sa vypisuje s nenulovým kódom. Fronta teraz tlačí No transactions found.

Prečítajte mesiac​

bea --file august/main.bean report income-statement --time 2026-08
bea --file august/main.bean report balance-sheet
bea --file august/main.bean report income-statement --time month

Výkaz ziskov a strát sumuje výplatu 2 100,00 USD proti výdavkom 143,19 USD pre čistý zisk 1 956,81 USD. Saldá účtov sa tlačia v beancountových znakoch, takže riadky s výplatami sú negatívne. Bilancia ukazuje čekový účet na 3 206,81 USD, čo sa súladuje s výpisom, ku ktorému ste zosúladili.

--time 2026-08 púta mesiac tohto tutoriálu. --time month vždy znamená aktuálny mesiac, čo je to, čo budete používať, keď vaše knihy budú aktuálne.

Pokračujte odtiaľ​

• Import bankových exportov s CLI pre revíziu duplikátov, iné stĺpcové rádky a opakované importy.
• Automatizujte účtovníctvo s bea pre JSON envelope, výstupné kódy a nekontrolované behy.
• Beancount CLI referencie pre každý príkaz a možnosť.