Glosár Beancount a účtovníctva v čistom texte

Plain-text účtovníctvo si požičiava slovník z podvojného účtovníctva a pridáva hŕstku vlastných výrazov špecifických pre Beancount. Tento glosár definuje pojmy, s ktorými sa stretnete pri čítaní tejto dokumentácie alebo vlastného súboru knihy, pričom každý obsahuje krátky príklad, ak to pomôže. Každý záznam má vlastný odkaz, takže môžete kolegu nasmerovať priamo na definíciu.

Účet​

Účet je pomenovaná kategória, ktorá sleduje jeden tok hodnoty, zapísaná ako hierarchia oddelená dvojbodkami pod jedným z piatich koreňových typov: Assets, Liabilities, Equity, Income alebo Expenses. Hierarchia je celou organizačnou štruktúrou vašich kníh — Assets:US:BofA:Checking a Expenses:Food:Restaurant sa triedia a zoskupujú automaticky. Každý účet musí byť pred použitím deklarovaný. Pravidlá pomenovania nájdete v Beancount Language Syntax.

Akruálny princíp​

Akruálne účtovníctvo zaznamenáva príjmy vtedy, keď sú zarobené, a výdavky vtedy, keď vzniknú, bez ohľadu na to, kedy skutočne dôjde k pohybu hotovosti. Hotovostné účtovníctvo robí opak: obe uznáva len vtedy, keď dôjde k výmene peňazí. Akruálna báza poskytuje vernejší obraz o výkonnosti obdobia, a preto faktúra, ktorú ste poslali v marci, patrí do marca, aj keď ju klient zaplatí v máji.

Amortizácia​

Amortizácia rozdeľuje jednu veľkú platbu na obdobia, ktoré skutočne pokrýva, takže každý mesiac nesie svoj spravodlivý podiel nákladov. Ročné poistné zaplatené v januári je výdavkom všetkých dvanástich mesiacov, nielen januára. V Beancointe buď zapíšete rozdelené zaúčtovania ručne, alebo ich vygenerujete pomocou pluginu — pozrite Amortize.

Kontrola zostatku​

Kontrola zostatku je direktíva balance, ktorá stanovuje, aký musí byť zostatok účtu na začiatku daného dátumu, takže váš bankový výpis sa stáva automatickou kontrolou vašich kníh. Ak sa vypočítaný zostatok líši o viac než tolerancia kontroly, Beancount nahlas zlyhá s očakávanou a skutočnou sumou. Touto toleranciou je jedna jednotka posledného desatinného miesta, ktoré ste napísali — 4.27 RGAGX akceptuje čokoľvek od 4,26 do 4,28 — a ~ pred menou nastaví vašu vlastnú. Rozmiestnenie jednej kontroly na účet na výpis je najlacnejší spôsob, ako udržať knihu dôveryhodnú.

2026-01-01 balance Assets:US:BofA:Checking   4,321.00 USD

Beancount​

Beancount je open-source systém podvojného účtovníctva, ktorého kniha je súbor v čistom texte, ktorý upravujete v ľubovoľnom textovom editore a validujete nástrojom príkazového riadka. Poskytuje vám striktnú, parsovateľnú syntax, dopytovací jazyk a webové rozhranie bez databázy alebo proprietárneho formátu súboru. Keďže kniha je text, pokojne žije v Git-e vedľa vášho kódu. Začnite s Introduction to Beancount.

Beancount Query Language​

Beancount Query Language, zvyčajne skracovaný ako BQL, je jazyk podobný SQL, ktorý používate na kladenie otázok svojej knihe. Beží nad sparsovanými direktívami namiesto databázy, takže SELECT account, sum(position) WHERE year = 2026 odpovedá okamžite z toho istého súboru, ktorý upravujete. Úplnú gramatiku nájdete v príručke k dopytovaciemu jazyku.

Metóda účtovania​

Metóda bookingu je pravidlo, ktoré Beancount uplatňuje, keď zníženie musí vybrať, z ktorých existujúcich lotov sa má čerpať. Beancount 3.2.3 akceptuje sedem názvov: STRICT (predvolené, kedy lot identifikujete sami), STRICT_WITH_SIZE, NONE, FIFO, LIFO, HIFO a AVERAGE. Nastavte ju na účet v jeho direktíve open, alebo pre celý súbor pomocou option "booking_method". Šesť zo siedmich je implementovaných: AVERAGE sa sparsuje, ale vyvolá AVERAGE method is not supported v momente, keď musí zaúčtovať zníženie. Zvolená metóda mení vaše realizované kapitálové zisky, preto zvoľte tú, ktorú očakáva vaša daňová jurisdikcia, a udržte ju stabilnú. Inventory Management prechádza všetkých sedem na tých istých lotoch a zverejňuje knihu, ktorá zlyhá pri AVERAGE.

Účtovná osnova​

Účtová osnova je úplný zoznam účtov, ktoré vaša kniha používa, spolu so štruktúrou, ktorá ich organizuje. V Beancointe neexistuje samostatný súbor osnovy — množina direktív open je vaša účtová osnova. Jej dobrý návrh v ranom štádiu ušetrí veľa premenovávania neskôr; počiatočné body nájdete v Industry-Specific Setups.

Direktíva close​

Direktíva close označuje dátum, po ktorom už účet nesmie byť použitý, čím vyradíte bankový účet alebo splatený úver bez vymazania jeho histórie. Minulé transakcie zostávajú platné a reportovateľné; odmietnuté sú len nové zaúčtovania. Zatváranie nepoužívaných účtov udržiava reporty čitateľné, ako kniha starne.

2026-03-31 close Assets:US:OldBank:Checking

Komodita​

Komodita je akákoľvek jednotka hodnoty, ktorú vaša kniha sleduje — mena ako USD, ticker akcie ako AAPL, krypto aktívum ako BTC alebo niečo, čo si vymyslíte, napríklad VACATION-DAYS. Beancount nikdy nekonvertuje medzi komoditami za vašimi chrbtami, takže suma je vždy číslo spárované s komoditou, v ktorej je denominovaná. Voliteľná direktíva commodity vám umožňuje priradiť metadata, ako napríklad názov alebo triedu aktív.

Obstarávacia cena​

Nákladová základ je to, čo ste skutočne zaplatili za držbu, zaznamenané v mene, ktorou ste platili, a nesené spolu s držbou tak dlho, ako ju vlastníte. Beancount ho zapisuje do zložených zátvoriek — 10 AAPL {150.00 USD} znamená desať akcií nadobudnutých za 150 dolárov každá. Zdvojnásobte zátvorky a číslo sa stane celkovou sumou namiesto jednotkovej ceny, takže 10 AAPL {{1,500.00 USD}} zaznamenáva ten istý lot. Keďže základ cestuje s pozíciou, kapitálové zisky vypadnú z aritmetiky pri predaji. Pozrite Inventory Management.

Direktíva​

Direktíva je jedna inštrukcia v súbore Beancount, zvyčajne datovaná, a direktívy sú to, z čoho sa kniha skladá. Dvanásť druhov nesie dátum: open, close, balance, price, note, document, pad, event, commodity, custom, query a samotná transakcia. Niekoľko z nich nenesie žiadny dátum a pôsobí na súbor namiesto na deň — option, include, plugin a pár pushtag/poptag. Beancount triedi datované direktívy podľa dátumu pred spracovaním, takže tie môžete udržiavať v akomkoľvek poradí, ktoré sa číta najlepšie; nedatovaná direktíva nadobúda účinnosť tam, kde je zapísaná.

Podvojné účtovníctvo​

Podvojné účtovníctvo je prax zaznamenávania každej ekonomickej udalosti ako aspoň dvoch zodpovedajúcich záznamov, takže ich váhy vždy sčítajú na nulu. Peniaze sa nikdy nevytvárajú ani nezničujú — iba sa presúvajú medzi účtami, a preto táto technika odhaľuje chyby, ktoré by jedno-stĺpcový zoznam nikdy neodhalil. Váha je vlastná suma zaúčtovania alebo jeho náklad či cena prevedené späť do jednej meny, takže dve nohy v rôznych komoditách sa stále vyrušia. Beancount toto pravidlo striktne vynucuje: transakcia, ktorej zaúčtovania sa nevyrovnávajú, je chyba, nie upozornenie.

2026-03-02 * "Bank" "Buy euros"
  Assets:US:BofA:EUR       100.00 EUR @ 1.08 USD
  Assets:US:BofA:Checking -108.00 USD

Obálkové rozpočtovanie​

Obálkové rozpočtovanie odkladá peniaze na určitý účel skôr, než ich miniete, takže každá kategória má vlastný limit namiesto súťaže o jeden spoločný zostatok. Názov pochádza z papierových obálok, ktoré ľudia kedysi naplnili hotovosťou vo výplatný deň. V plain-text knihe modelujete obálky pomocou vyhradených účtov alebo rozpočtových direktív — pozrite Budgets.

Fava​

Fava je webové rozhranie pre Beancount: grafy, súvahy, výkazy ziskov a strát, editor dopytov a formulár na zadávanie, obsluhované z vášho súboru knihy. Je prevažne na čítanie a beží lokálne, takže mení to, ako vaše knihy vidíte, bez zmeny toho, ako ich zaznamenávate. beancount.io hostuje spravovanú verziu popri svojich vlastných nástrojoch; príručka UI Features pokrýva, čo tam môžete robiť.

Inventár​

Inventár je zbierka pozícií, ktoré účet aktuálne drží, každá s vlastnou komoditou a, ak je to relevantné, s vlastnou nákladovou základňou a dátumom nadobudnutia. Účet u brokera, ktorý kúpil tú istú akciu trikrát, drží tri samostatné loty v jednom inventári, nie jedno zmiešané číslo. Udržiavanie lotov oddelene je to, čo umožňuje presné výpočty ziskov.

Denník​

Žurnál je chronologický zoznam všetkého, čo sa stalo vo vašich knihách — surový tok transakcií, v poradí podľa dátumu, pred akýmkoľvek zoskupením alebo zhrnutím. Je to pohľad, ktorý prechádzate, keď chcete odpovedať na otázku „čo som vlastne v marci robil?". Žurnálová stránka v Fave je zvyčajne najrýchlejším miestom na odhalenie nesprávne zaradenej položky.

Účtovná kniha​

Kniha je úplná množina účtovných záznamov pre jeden subjekt, čo v Beancointe znamená váš súbor v čistom texte (plus všetko, čo zahŕňa). Slovo zároveň označuje celú knihu účtov aj samotný súbor. Keďže je to text, knihu možno diffovať, recenzovať, vetviť a zlúčiť ako zdrojový kód.

Lot​

Lot je jedno konkrétne nadobudnutie komodity, identifikované svojou nákladovou základňou a dátumom nadobudnutia. Kúpa toho istého ETF v januári a znova v júni vytvára dva loty a neskorší predaj znamená výber toho, ktorý lot predávate. Loty sú dôvodom, prečo Beancount dokáže vypočítať realizované zisky presne namiesto ich odhadu.

2026-06-15 * "Broker" "Buy VTI"
  Assets:US:Broker:VTI     5 VTI {260.00 USD, 2026-06-15}
  Assets:US:Broker:Cash            -1,300.00 USD

Popis​

Rozprávanie je voľný textový opis toho, na čo bola transakcia určená, zapísaný ako druhý reťazec v úvodzovkách na riadku transakcie. Je pre ľudí: „Mesačný nájom", „Potraviny a domácnosť". Beancount ho neparsuje, ale je to to, čo budete čítať, keď záznam o šesť mesiacov už nebude dávať zmysel.

Direktíva open​

Direktíva open deklaruje účet, dátum, od ktorého sa začína používať, a voliteľne komodity, ktoré môže držať, a metódu bookingu, ktorú používa. Beancount vyžaduje, aby každý účet bol otvorený pred svojím prvým zaúčtovaním, čo zabraňuje tomu, aby preklep ticho vytvoril úplne nový účet. Obmedzenie povolených komodít mení ďalšiu celú triedu chýb na chyby.

2026-01-01 open Assets:US:Broker:VTI   VTI   "FIFO"

Pad​

Direktíva pad hovorí Beancountu, aby vložil sumu potrebnú na to, aby nasledujúca kontrola zostatku na účte uspela, pričom rozdiel zaúčtuje na druhý účet. Existuje presne na jednu úlohu: otvorenie knihy v polovici života bez rekonštrukcie rokov histórie. Dopĺňanie nad rámec tohto počiatočného nastavenia zvyčajne znamená, že sa zakrýva skutočná chyba.

Príjemca​

Príjemca je ten, s kým ste uskutočnili transakciu, zapísaný ako prvý reťazec v úvodzovkách na riadku transakcie. Udržiavanie príjemcov konzistentných — vždy "Whole Foods", nikdy niekedy "WholeFoods" — je to, čo umožňuje fungovanie reportov podľa príjemcu a automatizovaných importérov. Beancount považuje príjemcu za voliteľného; transakcia môže niesť iba rozprávanie.

Plain-text účtovníctvo​

Plain-text účtovníctvo je prax vedenia svojich kníh v ľuďmi čitateľnom textovom súbore pod správou verzií, spracovanom open-source nástrojmi príkazového riadka. Vymieňa rozhranie typu klikni-a-bež za trvanlivosť, auditovateľnosť a automatizáciu: vaše dáta prežijú akéhokoľvek dodávateľa, každá zmena je recenzovateľný diff a akýkoľvek skript ich dokáže prečítať. Beancount, Ledger a hledger sú tri najznámejšie implementácie.

Plugin​

Plugin je Python modul, ktorý Beancount načíta pri spracovaní vášho súboru, čo mu umožňuje pridávať, transformovať alebo validovať direktívy pred zostavením reportov. Pluginy sú spôsobom, akým sa implementuje prognózovanie, amortizačné plány a vlastné kontroly bez zmeny jadra jazyka. Zapnete ho pomocou samostatného riadka plugin na začiatku vašej knihy, nikdy pomocou option — option "plugin" "…" je odmietnuté s Option 'plugin' may not be set. Príručka Forecast Plugin prechádza reálny príklad.

Zápis​

Zaúčtovanie je jedna noha transakcie: účet, suma a voliteľne náklad alebo cena. To, čo musí sčítať na nulu v rámci transakcie, nie sú surové sumy, ale ich váhy: obyčajná suma váži sama seba, 10 FUND @ 38.46 USD váži 384.60 USD a 10 FUND {384.61 USD} váži 3,846.10 USD, pretože jednoduché zátvorky držia náklad jednej jednotky. Najviac jedno zaúčtovanie môže nechať svoju sumu prázdnu, v takom prípade Beancount vypočíta vyrovnávajúcu sumu za vás. Úplné pravidlá váh nájdete v Precision & Tolerances.

Direktíva price​

Direktíva price zaznamenáva výmenný kurz medzi dvoma komoditami k danému dátumu, čím Beancount konvertuje držbu na jej trhovú hodnotu v reportoch. Direktíva price sú čisté referenčné údaje: nepohybuje žiadnymi peniazmi a nepatrí žiadnej transakcii. Nezamieňajte ju s cenou @ zapísanou v rámci zaúčtovania, ktorá je aritmetikou — dáva 10 FUND @ 38.46 USD váhu 384.60 USD, a tým rozhoduje o tom, či sa transakcia vyrovná. Bez direktív price sa portfólio stále vyrovnáva v nákladovej cene, ale nedá sa oceniť trhovou hodnotou.

2026-06-30 price VTI   271.40 USD

Live Prices poskytuje spravované direktívy cien pre podporované aktíva v hostovaných knihách. Vaša vlastná cena vyhráva pre ten istý dátum a pár, vrátane recipročného páru. Spravovaná cena k neskoršiemu dátumu môže stále platiť pre neskoršie ocenenie.

Rekonsolidácia​

Odsúhlasenie je akt dokázania, že vaše knihy súhlasia s externým záznamom, ako je bankový alebo brokerský výpis. V plain-text účtovníctve je to zväčša mechanické: pridajte kontrolu zostatku pre každý dátum výpisu a nechajte nástroj povedať, či sa čísla zhodujú. Kniha, ktorá sa každý mesiac čisto odsúhlasí, je taká, z ktorej môžete bez obáv podať daňové priznanie.

Značky a odkazy​

Značky a odkazy sú dva štítky, ktoré priraďujete transakciám na ich zoskupenie mimo hierarchie účtov: značka s # označuje tému, napríklad #trip-japan, a odkaz s ^ spája súvisiace záznamy, napríklad ^invoice-2026-014, dokopy. Značky odpovedajú na „ukáž mi všetko v tejto kategórii"; odkazy odpovedajú na „ukáž mi záznamy patriace k tejto jednej udalosti". Obe sa dajú filtrovať vo Fave a dotazovať v BQL — pozrite Filtering and Searching.

Transakcia​

Transakcia je datovaná ekonomická udalosť spolu so zaúčtovaniami, ktoré ju zaznamenávajú, a je to direktíva, ktorú budete písať najčastejšie. Nesie príznak (* pre potvrdené, ! pre vyžadujúce kontrolu), voliteľného príjemcu, rozprávanie a dve alebo viac zaúčtovaní, ktorých váhy sčítajú na nulu. Všetko ostatné v súbore Beancount existuje na to, aby deklarovalo, kontrolovalo alebo anotovalo transakcie.

2026-02-14 * "Blue Bottle" "Coffee with Dana"
  Expenses:Food:Coffee      9.50 USD
  Assets:US:BofA:Checking  -9.50 USD

Stále viaznete na nejakom slove? Help Center indexuje každú príručku na tomto webe a Cheatsheet dáva syntax pre každú direktívu vedľa seba.