# 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](https://beancount.io/sk/docs/Basics/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](https://beancount.io/sk/docs/Tips/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ú.

```beancount
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](https://beancount.io/sk/docs/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](https://beancount.io/sk/docs/Basics/beancount-query-language).

## 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](https://beancount.io/sk/docs/Basics/inventories) 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](https://beancount.io/sk/docs/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.

```beancount
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](https://beancount.io/sk/docs/Basics/inventories).

## 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.

```beancount
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](https://beancount.io/sk/docs/Tips/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](https://beancount.io/sk/docs/Tips/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.

```beancount
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.

```beancount
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](https://beancount.io/sk/docs/Tips/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](https://beancount.io/sk/docs/Basics/precision).

## 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.

```beancount
2026-06-30 price VTI   271.40 USD
```

[Live Prices](https://beancount.io/sk/docs/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](https://beancount.io/sk/docs/Tips/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.

```beancount
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](https://beancount.io/sk/docs/help-center) indexuje každú príručku
na tomto webe a [Cheatsheet](https://beancount.io/sk/docs/Basics/cheatsheet) dáva syntax pre každú direktívu
vedľa seba.
