Slovník pojmov

Plain-text účtovníctvo preberá slovnú zásobu z podvojného účtovníctva a pridáva niekoľko vlastných pojmov špecifických pre Beancount. Tento slovník definuje výrazy, s ktorými sa stretnete pri čítaní tejto dokumentácie alebo vlastného súboru účtovnej knihy, pričom každý pojem obsahuje krátky príklad tam, kde to pomáha. 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 automaticky triedia a agregujú. Každý účet musí byť deklarovaný pred prvým použitím. Pravidlá pomenovania nájdete v Syntax jazyka Beancount.

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 sa hotovosť skutočne presunie. Hotovostné účtovníctvo robí opak: oboje uznáva až vtedy, keď dôjde k výmene peňazí. Akruálny princíp dáva pravdivejší obraz o výkonnosti za obdobie, preto faktúra odoslaná v marci patrí do marca, aj keď 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 Beancounte buď napíšete rozdelené zápisy ručne, alebo ich vygenerujete pomocou pluginu — pozri Amortizácia.

Kontrola zostatku​

Kontrola zostatku je direktíva balance, ktorá uvádza, aký musí byť zostatok účtu na začiatku daného dátumu, takže váš bankový výpis sa stane automatickou kontrolou vašich kníh. Ak sa vypočítaný zostatok líši o viac, než je tolerancia kontroly, Beancount nahlas zlyhá s očakávanou a skutočnou sumou. Tolerancia 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ú. Pridanie jednej kontroly na účet a výpis je najlacnejším spôsobom, ako udržať účtovnú 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 účtovná kniha je plain-text súbor, ktorý upravujete v ľubovoľnom textovom editore a overujete pomocou nástroja príkazového riadka. Poskytuje prísnu, parseovateľnú syntax, dotazovací jazyk a webové rozhranie, bez databázy alebo proprietárneho formátu súborov. Pretože je účtovná kniha textová, žije spokojne v Gite vedľa vášho kódu. Začnite s Úvodom do Beancountu.

Beancount Query Language​

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

Metóda účtovania​

Metóda účtovania je pravidlo, ktoré Beancount aplikuje, keď musí zníženie vybrať, ktoré existujúce loty odpísať. Beancount 3.2.3 akceptuje sedem názvov: STRICT (štandardná, pri ktorej lot identifikujete sami), STRICT_WITH_SIZE, NONE, FIFO, LIFO, HIFO a AVERAGE. Nastavte jednu na účet v jeho direktíve open, alebo pre celý súbor pomocou option "booking_method". Šesť zo siedmich je implementovaných: AVERAGE sa naparsuje, ale pri účtovaní zníženia vyhodí AVERAGE method is not supported. Zvolená metóda mení vaše realizované kapitálové zisky, preto vyberte tú, ktorú očakáva vaša daňová jurisdikcia, a držte sa jej. Správa inventára testuje všetkých sedem na rovnakých lotoch a zverejňuje účtovnú knihu, ktorá zlyhá pri AVERAGE.

Účtovná osnova​

Účtovná osnova je úplný zoznam účtov, ktoré vaša účtovná kniha používa, spolu so štruktúrou, ktorá ich organizuje. V Beancounte neexistuje samostatný súbor osnovy — množina direktív open je vašou účtovnou osnovou. Dobrý návrh na začiatku ušetrí veľa premenovávania neskôr; východiskové body nájdete v Odvetvovo špecifických nastaveniach.

Direktíva close​

Direktíva close označuje dátum, po ktorom sa účet už nesmie používať, čím vyradíte bankový účet alebo splatenú pôžičku bez vymazania ich histórie. Minulé transakcie zostávajú platné a reportovateľné; odmietajú sa len nové zápisy. Zatváranie nepoužívaných účtov udržiava reporty čitateľné, keď účtovná kniha starne.

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

Komodita​

Komodita je akákoľvek jednotka hodnoty, ktorú vaša účtovná kniha sleduje — mena ako USD, akciový ticker ako AAPL, kryptoaktívum ako BTC, alebo niečo, čo si sami vymyslíte, napríklad VACATION-DAYS. Beancount nikdy nekonvertuje medzi komoditami bez vášho vedomia, takže suma je vždy číslo spárované s komoditou, v ktorej je denominovaná. Voliteľná direktíva commodity vám umožňuje pripojiť metadáta, ako je názov alebo trieda aktív.

Obstarávacia cena​

Obstarávacia cena je to, čo ste skutočne zaplatili za držbu, zaznamenané v mene, ktorou ste platili, a vedené spolu s držbou, pokiaľ ju vlastníte. Beancount ju píše v zložených zátvorkách — 10 AAPL {150.00 USD} znamená desať akcií nakúpených po 150 dolároch za kus. Zdvojené zátvorky zmenia číslo na celkovú sumu namiesto jednotkovej ceny, takže 10 AAPL {{1,500.00 USD}} zaznamenáva rovnaký lot. Pretože cena cestuje s pozíciou, kapitálové zisky vypadnú z aritmetiky pri predaji. Pozri Správa inventára.

Direktíva​

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

Podvojné účtovníctvo​

Podvojné účtovníctvo je prax zaznamenávania každej ekonomickej udalosti ako najmenej dvoch zodpovedajúcich zápisov, takže ich váhy sa vždy sčítajú na nulu. Peniaze sa nikdy nevytvárajú ani neničia — len sa presúvajú medzi účtami, preto táto technika zachytáva chyby, ktoré jednostĺpcový zoznam nikdy nezachytí. Váha je vlastná suma zápisu alebo jeho cena či hodnota prepočítaná na jednu menu, takže dve strany v rôznych komoditách sa stále vyrušia. Beancount toto pravidlo prísne vynucuje: transakcia, ktorej zápisy nesedia, je chyba, nie varovanie.

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 účel predtým, než ich miniete, takže každá kategória má vlastný limit namiesto súťaženia o jeden spoločný zostatok. Názov pochádza z papierových obálok, ktoré ľudia kedysi plnili hotovosťou na výplatný deň. V plain-text účtovnej knihe modelujete obálky pomocou vyhradených účtov alebo direktív rozpočtu — pozri Rozpočty.

Fava​

Fava je webové rozhranie pre Beancount: grafy, súvahy, výkazy ziskov a strát, editor dotazov a formulár na zadávanie, obsluhované z vášho súboru účtovnej knihy. Je prevažne na čítanie a beží lokálne, takže mení spôsob, akým vidíte svoje knihy, bez zmeny spôsobu, akým ich zaznamenávate. beancount.io hostuje spravovanú verziu spolu s vlastnými nástrojmi; príručka Funkcie rozhrania pokrýva to, čo tam môžete robiť.

Inventár​

Inventár je kolekcia pozícií, ktoré účet momentálne drží, každá so svojou komoditou a prípadne vlastnou obstarávacou cenou a dátumom nadobudnutia. Maklérsky účet, ktorý kúpil rovnakú akciu trikrát, drží tri samostatné loty v jednom inventári, nie jedno zmiešané číslo. Udržiavanie lotov oddelených je to, čo umožňuje presné výpočty ziskov.

Denník​

Denník je chronologický zoznam všetkého, čo sa stalo vo vašich knihách — surový prúd transakcií v poradí podľa dátumu, pred akýmkoľvek zoskupením alebo sumarizáciou. Je to pohľad, ktorý skenujete, keď chcete odpovedať na otázku "čo som vlastne robil v marci?". Stránka denníka vo Fave je zvyčajne najrýchlejším miestom na odhalenie nesprávne zaradenej položky.

Účtovná kniha​

Účtovná kniha je kompletná sada účtovných záznamov pre jednu entitu, čo v Beancounte znamená váš plain-text súbor (plus čokoľvek, čo zahŕňa). Slovo zároveň označuje celú knihu účtov aj samotný názov súboru. Pretože je textová, účtovná kniha môže byť diffovaná, recenzovaná, vetvená a spájaná ako zdrojový kód.

Lot​

Lot je jedna konkrétna akvizícia komodity, identifikovaná svojou obstarávacou cenou a dátumom nadobudnutia. Kúpa rovnakého ETF v januári a znova v júni vytvorí dva loty a neskorší predaj znamená výber, ktorý lot predávate. Loty sú dôvodom, prečo Beancount dokáže vypočítať realizované zisky presne namiesto ich približovania.

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​

Popis je voľný textový opis účelu transakcie, napísaný ako druhý reťazec v úvodzovkách na riadku transakcie. Je pre ľudí: "Mesačné nájomné", "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 je použiteľný, a voliteľne komodity, ktoré môže držať, a metódu účtovania, ktorú používa. Beancount vyžaduje, aby bol každý účet otvorený pred prvým zápisom, čo zabraňuje preklepu v tichom vytvorení úplne nového účtu. 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 akúkoľvek sumu potrebnú na to, aby nasledujúca kontrola zostatku na účte prešla, pričom rozdiel zaúčtuje na druhý účet. Existuje presne na jednu prácu: otvorenie účtovnej knihy uprostred života bez rekonštrukcie rokov histórie. Padding za týmto počiatočným nastavením zvyčajne znamená, že sa zakrýva skutočná chyba.

Príjemca​

Príjemca je ten, s kým ste transakciu uskutočnili, napísaný ako prvý reťazec v úvodzovkách na riadku transakcie. Udržiavanie konzistentných príjemcov — vždy "Whole Foods", nikdy niekedy "WholeFoods" — je to, čo umožňuje reporty založené na príjemcoch a automatické importery. Beancount považuje príjemcu za voliteľného; transakcia môže niesť len popis.

Plain-text účtovníctvo​

Plain-text účtovníctvo je prax vedenia kníh v čitateľnom textovom súbore pod správou verzií, spracovávanom open-source nástrojmi príkazového riadka. Vymieňa rozhranie klikania za trvácnosť, 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 môže čí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 overovať direktívy pred vytvorením reportov. Pluginy sú spôsobom, akým sa implementujú prognózovanie, amortizačné plány a vlastné kontroly bez zmeny základného jazyka. Aktivujete ho samostatným riadkom plugin na začiatku účtovnej knihy, nikdy nie pomocou option — option "plugin" "…" je zamietnuté s Option 'plugin' may not be set. Príručka Plugin prognózovania prechádza skutočným príkladom.

Zápis​

Zápis je jedna strana transakcie: účet, suma a voliteľne cena alebo hodnota. To, čo sa musí sčítať na nulu naprieč transakciou, 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 jednotlivé zložené zátvorky držia cenu jednej jednotky. Najviac jeden zápis môže nechať svoju sumu prázdnu, v takom prípade Beancount vypočíta vyrovnávaciu cifru za vás. Úplné pravidlá váh nájdete v Presnosť a tolerancie.

Direktíva price​

Direktíva price zaznamenáva výmenný kurz medzi dvoma komoditami k dátumu, čo je spôsob, akým Beancount konvertuje držbu na trhovú hodnotu v reportoch. Direktíva price je čisto referenčné dáta: nepresúva žiadne peniaze a nepatrí žiadnej transakcii. Nezamieňajte ju s cenou @ napísanou v zápise, ktorá je aritmetická — dáva 10 FUND @ 38.46 USD váhu 384.60 USD, a teda rozhoduje, či transakcia sedí. Bez direktív price portfólio stále sedí v obstarávacích cenách, ale nemôže byť ocenené trhovou hodnotou.

2026-06-30 price VTI   271.40 USD

Rekonsolidácia​

Rekonsolidácia je akt dokazovania, že vaše knihy súhlasia s externým záznamom, ako je bankový alebo maklérsky výpis. V plain-text účtovníctve je do značnej miery mechanická: pridajte kontrolu zostatku pre každý dátum výpisu a nechajte nástroj, aby vám povedal, či čísla súhlasia. Účtovná kniha, ktorá sa každý mesiac čisto rekonsoliduje, je kniha, z ktorej môžete podávať dane bez strachu.

Značky a odkazy​

Značky a odkazy sú dva štítky, ktoré pripájate k transakciám na zoskupenie mimo hierarchie účtov: značka s # označuje tému ako #trip-japan a odkaz s ^ spája súvisiace záznamy, ako napríklad ^invoice-2026-014. Značky odpovedajú na otázku "ukáž mi všetko v tejto kategórii"; odkazy odpovedajú na "ukáž mi záznamy patriace tejto jednej udalosti". Oboje je filtrovateľné vo Fave a dotazovateľné v BQL — pozri Filtrovanie a vyhľadávanie.

Transakcia​

Transakcia je datovaná ekonomická udalosť spolu so zápismi, ktoré ju zaznamenávajú, a je direktívou, ktorú budete písať najčastejšie. Nesie príznak (* pre potvrdené, ! pre vyžadujúce kontrolu), voliteľného príjemcu, popis a dva alebo viac zápisov, ktorých váhy sa sčítajú na nulu. Všetko ostatné v súbore Beancount existuje na deklarovanie, kontrolu alebo anotovanie transakcií.

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

Stále sa trápite so slovom? Centrum pomoci indexuje všetky príručky na tejto stránke a Ťahák dáva syntax každej direktívy vedľa seba.