Slovník pojmov

Účtovníctvo v čistom texte preberá slovnú zásobu z podvojného účtovníctva a pridáva niekoľko vlastných Beancount-špecifických výrazov. Tento slovník definuje pojmy, s ktorými sa stretnete pri čítaní tejto dokumentácie alebo vlastného súboru hlavnej knihy, pričom každý pojem je doplnený stručným príkladom tam, kde je to užitočné. Každý záznam má svoj vlastný odkaz, takže môžete kolegu nasmerovať priamo na definíciu.

Účet (Account)​

Účet je pomenovaná kategória, ktorá sleduje jeden tok hodnoty, zapísaná ako hierarchia oddelená dvojbodkou pod jedným z piatich koreňových typov: Assets (Aktíva), Liabilities (Pasíva), Equity (Vlastné imanie), Income (Výnosy) alebo Expenses (Náklady). Hierarchia tvorí celú organizačnú štruktúru vašich kníh – Assets:US:BofA:Checking a Expenses:Food:Restaurant sa automaticky triedia a sumarizujú. Každý účet musí byť deklarovaný pred jeho použitím. Pravidlá pomenovania nájdete v časti Syntax jazyka Beancount.

Akruálny princíp (Accrual basis)​

Účtovníctvo na akruálnom princípe zaznamenáva výnosy v čase, keď sú zarobené, a náklady v čase, keď vzniknú, bez ohľadu na to, kedy skutočne dôjde k pohybu hotovosti. Hotovostný princíp (cash-basis accounting) robí opak: uznáva oboje až pri zmene vlastníctva peňazí. Akruálny princíp poskytuje pravdivejší obraz o výkonnosti za obdobie, preto faktúra, ktorú ste vystavili v marci, patrí do marca, aj keď klient zaplatí v máji.

Amortizácia (Amortization)​

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 nákladom všetkých dvanástich mesiacov, nielen januára. V Beancounte buď napíšete rozdelené účtovné zápisy ručne, alebo ich vygenerujete pomocou pluginu – pozri Amortizovať.

Kontrola zostatku (Balance assertion)​

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, Beancount hlasito zlyhá s očakávanými a skutočnými sumami. Pridanie jednej kontroly zostatku na účet a výpis je najjednoduchší spôsob, ako udržať hlavnú knihu dôveryhodnou.

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 hlavná kniha je súborom v čistom texte, ktorý upravujete v ľubovoľnom textovom editore a overujete pomocou nástroja príkazového riadka. Poskytuje prísnu, analyzovateľnú syntax, dotazovací jazyk a webové rozhranie bez databázy alebo proprietárneho formátu súboru. Keďže hlavná kniha je text, žije šťastne v Gite popri vašom kóde. Začnite s Úvodom do Beancountu.

Dotazovací jazyk Beancount (Beancount Query Language, BQL)​

Dotazovací jazyk Beancount, zvyčajne skracovaný ako BQL, je jazyk podobný SQL, ktorý používate na kladenie otázok vašej hlavnej knihe. Pracuje s analyzovaný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. Prečítajte si príručku k dotazovaciemu jazyku pre úplnú gramatiku.

Metóda účtovania (Booking method)​

Metóda účtovania je pravidlo, ktoré Beancount aplikuje, keď musí úbytok vybrať, ktoré existujúce šarže (loty) odpísať. Možnosti sú STRICT (musíte šaržu identifikovať sami), FIFO, LIFO, AVERAGE a NONE, nastavené na účet v jeho direktíve open. Zvolená metóda mení vaše realizované kapitálové zisky, preto si vyberte tú, ktorú očakáva vaša daňová jurisdikcia, a držte sa jej.

Účtovný rozvrh (Chart of accounts)​

Účtovný rozvrh je kompletný zoznam účtov, ktoré vaša hlavná kniha používa, spolu so štruktúrou, ktorá ich organizuje. V Beancounte neexistuje samostatný súbor rozvrhu – množina direktív open je váš účtovný rozvrh. Jeho dobrý návrh na začiatku ušetrí veľa premenovania neskôr; pozrite Nastavenia špecifické pre odvetvia pre východiskové body.

Direktíva uzavretia (Close directive)​

Direktíva close označuje dátum, po ktorom už účet nemožno používať. Týmto spôsobom vyradíte bankový účet alebo splatený úver bez vymazania jeho histórie. Minulé transakcie zostávajú platné a vykazovateľné; odmietajú sa iba nové účtovné zápisy. Uzatváranie nepoužívaných účtov udržuje prehľady čitateľné, keď hlavná kniha starne.

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

Komodita (Commodity)​

Komodita je akákoľvek jednotka hodnoty, ktorú vaša hlavná 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 za vaším chrbtom, takže suma je vždy číslo spárované s komoditou, v ktorej je denominovaná. Voliteľná direktíva commodity vám umožňuje pridať metadata, ako je názov alebo trieda aktív.

Obstarávacia cena (Cost basis)​

Obstarávacia cena je to, čo ste skutočne zaplatili za držbu, zaznamenaná v mene, v ktorej ste platili, a vedená spolu s držbou počas celej doby, kým ju vlastníte. Beancount ju zapisuje do zložených zátvoriek – 10 AAPL {150,00 USD} znamená desať akcií nadobudnutých za 150 dolárov každá. Keďže obstarávacia cena cestuje s pozíciou, kapitálové zisky vyplynú z aritmetiky pri predaji. Pozri Správa zásob.

Direktíva (Directive)​

Direktíva je jedna datovaná inštrukcia v súbore Beancount a direktívy sú všetko, čo hlavná kniha obsahuje. Každý riadok, ktorý začína dátumom, je jedna: open, close, balance, price, note, document, pad, event, commodity a samotná transakcia. Beancount triedi direktívy podľa dátumu pred spracovaním, takže ich môžete ponechať v ľubovoľnom poradí, ktoré sa najlepšie číta.

Podvojné účtovníctvo (Double-entry bookkeeping)​

Podvojné účtovníctvo je prax zaznamenávania každej ekonomickej udalosti ako najmenej dvoch zodpovedajúcich položiek, takže sumy sa vždy rovnajú nule. Peniaze nie sú nikdy vytvorené ani zničené – iba sa pohybujú medzi účtami, a preto táto technika zachytáva chyby, ktoré by jednostĺpcový zoznam nikdy neodhalil. Beancount toto pravidlo prísne vynucuje: transakcia, ktorej účtovné zápisy nie sú v rovnováhe, je chyba, nie varovanie.

Obálkové rozpočtovanie (Envelope budgeting)​

Obálkové rozpočtovanie odkladá peniaze na určitý účel ešte predtým, ako ich miniete, takže každá kategória má svoj vlastný limit namiesto súťaženia o jeden spoločný zostatok. Názov pochádza z papierových obálok, ktoré ľudia kedysi naplnili hotovosťou v deň výplaty. V hlavnej knihe v čistom texte 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, všetko obsluhované z vášho súboru hlavnej 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 popri vlastných nástrojoch; príručka Funkcie rozhrania pokrýva, čo tam môžete robiť.

Zásoba (Inventory)​

Zásoba je kolekcia pozícií, ktoré účet aktuálne drží, každá so svojou vlastnou komoditou a tam, kde je to relevantné, aj vlastnou obstarávacou cenou a dátumom nadobudnutia. Maklérsky účet, ktorý kúpil rovnakú akciu trikrát, drží tri samostatné šarže v jednej zásobe, nie jedno zmiešané číslo. Udržiavanie šarží oddelených umožňuje presné výpočty ziskov.

Denník (Journal)​

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.

Hlavná kniha (Ledger)​

Hlavná kniha je kompletná sada účtovných záznamov pre jednu entitu, čo v Beancounte znamená váš súbor v čistom texte (plus všetko, čo zahŕňa). Toto slovo slúži ako názov celej knihy účtov aj názov samotného súboru. Keďže je to text, hlavnú knihu možno porovnávať (diff), kontrolovať, vetviť a spájať (merge) ako zdrojový kód.

Šarža (Lot)​

Šarža je jedno konkrétne nadobudnutie komodity, identifikované svojou obstarávacou cenou a dátumom nadobudnutia. Kúpa rovnakého ETF v januári a znova v júni vytvorí dve šarže a neskorší predaj znamená výber, ktorú šaržu predávate. Šarže sú dôvodom, prečo Beancount dokáže vypočítať realizované zisky presne namiesto ich aproximácie.

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 (Narration)​

Popis je voľný textový opis, na čo transakcia slúžila, zapísaný ako druhý reťazec v úvodzovkách na riadku transakcie. Je pre ľudí: „Mesačné nájomné", „Potraviny a domácnosť". Beancount ho neanalyzuje, ale je to to, čo budete čítať, keď vám položka o šesť mesiacov už nebude dávať zmysel.

Direktíva otvorenia (Open directive)​

Direktíva open deklaruje účet, dátum, od ktorého je možné ho používať, 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 svojím prvým účtovným zápisom, č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"

Výplň (Pad)​

Direktíva pad hovorí Beancountu, aby vložil sumu potrebnú na úspešné splnenie nasledujúcej kontroly zostatku na účte, pričom rozdiel zaúčtuje na druhý účet. Existuje presne na jednu úlohu: otvorenie hlavnej knihy v polovici životnosti bez rekonštrukcie rokov histórie. Používanie výplne nad rámec tohto počiatočného nastavenia zvyčajne znamená, že sa zakrýva skutočná chyba.

Príjemca (Payee)​

Príjemca je osoba alebo subjekt, s ktorým ste transakciu uskutočnili, zapísaný ako prvý reťazec v úvodzovkách na riadku transakcie. Udržiavanie konzistentných príjemcov – vždy "Whole Foods", nikdy občas "WholeFoods" – je to, čo umožňuje správne fungovanie správ na základe príjemcu a automatických importérov. Beancount považuje príjemcu za voliteľný; transakcia môže obsahovať iba popis.

Účtovníctvo v čistom texte (Plain-text accounting)​

Účtovníctvo v čistom texte je prax vedenia svojich 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 point-and-click za trvácnosť, auditovateľnosť a automatizáciu: vaše dáta prežijú akéhokoľvek dodávateľa, každá zmena je kontrolovateľný rozdiel (diff) a akýkoľvek skript ich dokáže čítať. Beancount, Ledger a hledger sú tri najznámejšie implementácie.

Plugin (Plugin)​

Plugin je modul v Pythone, ktorý Beancount načíta počas spracovania vášho súboru, čo mu umožňuje pridávať, transformovať alebo overovať direktívy pred vytvorením správ. Pluginy sú spôsob, akým sú implementované prognózovanie, amortizačné plány a vlastné kontroly bez zmeny základného jazyka. Jeden aktivujete riadkom plugin na začiatku vašej hlavnej knihy – príručka Prognózovací plugin prechádza reálnym príkladom.

Účtovný zápis (Posting)​

Účtovný zápis je jedna strana transakcie: účet, suma a voliteľne obstarávacia cena alebo cena. Transakcia potrebuje najmenej dva účtovné zápisy a ich sumy sa musia rovnať nule. Najviac jeden účtovný zápis môže nechať svoju sumu prázdnu, v takom prípade Beancount vypočíta vyrovnávajúcu hodnotu za vás.

Direktíva ceny (Price directive)​

Direktíva price zaznamenáva výmenný kurz medzi dvoma komoditami k určitému dátumu, čo je spôsob, akým Beancount konvertuje držbu na jej trhovú hodnotu v správach. Ceny sú čisto referenčné údaje – nikdy nepresúvajú peniaze a nikdy sa neobjavujú v transakcii. Bez nich je portfólio stále v rovnováhe v obstarávacích cenách, ale nemožno ho oceniť trhovou hodnotou.

2026-06-30 price VTI   271.40 USD

Zosúladenie (Reconciliation)​

Zosúladenie je činnosť preukazovania, že vaše knihy sú v súlade s externým záznamom, ako je bankový alebo maklérsky výpis. V účtovníctve v čistom texte je do značnej miery mechanické: pridajte kontrolu zostatku pre každý dátum výpisu a nechajte nástroj povedať, či sa čísla zhodujú. Hlavná kniha, ktorá sa každý mesiac čisto zosúlaďuje, je taká, z ktorej môžete podávať dane bez obáv.

Značky a odkazy (Tags and links)​

Značky a odkazy sú dva typy štítkov, ktoré pripájate k transakciám na zoskupenie mimo hierarchie účtov: značka so # označuje tému, napríklad #cesta-japonsko, a odkaz so ^ spája súvisiace položky, napríklad ^faktura-2026-014 dohromady. Značky odpovedajú na otázku „ukáž mi všetko v tejto kategórii"; odkazy odpovedajú na otázku „ukáž mi položky, ktoré patria k tejto jednej udalosti". Oba sú filtrovateľné vo Fave a dotazovateľné v BQL – pozri Filtrovanie a vyhľadávanie.

Transakcia (Transaction)​

Transakcia je datovaná ekonomická udalosť spolu s účtovnými zápismi, 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, popis a dva alebo viac účtovných zápisov, ktorých sumy sa rovnajú nule. Všetko ostatné v súbore Beancount existuje na deklarovanie, kontrolu alebo anotáciu transakcií.

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

Stále si neviete rady s nejakým slovom? Centrum pomoci obsahuje index všetkých príručiek na tejto stránke a Ťahák uvádza syntax pre každú direktívu vedľa seba.