Pridajte metadáta cash-flow-role do direktívy open účtu, aby ste určili, ako výkaz peňažných tokov klasifikuje tento účet. Jeden kľúč, štyri hodnoty. Účty bez týchto metadát používajú predvolené heuristiky.
2000-01-01 open Assets:US:Brokerage
cash-flow-role: "investing"
2000-01-01 open Assets:US:Marcus:Savings
cash-flow-role: "cash"Kľúč a hodnoty
| Kľúč | Kde | Typ hodnoty | Akceptované hodnoty |
|---|---|---|---|
cash-flow-role | metadáta direktívy open | reťazec | "cash", "operating", "investing", "financing" |
Zhoda je presná a rozlišuje veľké a malé písmená. Hodnota musí byť reťazec v úvodzovkách. Ostatné metadáta na rovnakej direktíve výkaz ignoruje a tento kľúč ignorujú všetky ostatné nástroje.
Čo robí každá hodnota
Deklarovaná úloha odpovedá na dve otázky naraz: či je účet súčasťou peňažných prostriedkov a do ktorej časti výkazu aktivít patrí inak.
"cash"— účet sa pripája k množine peňažných prostriedkov a ekvivalentov. Peňažné účty sa nikdy nezobrazujú ako položky aktivít. Spodný riadok výkazu, čistá zmena peňažných prostriedkov a ekvivalentov, sa rovná súčtu ich zmien za obdobie. Prevody medzi dvoma peňažnými účtami sa vzájomne rušia. Použite ho pre účty, ktoré heuristika podľa názvu nezachytí, napríklad fond peňažného trhu alebo peňaženka so stablecoinmi."operating","investing","financing"— účet nie je peňažný a jeho zmena za obdobie sa zobrazuje ako riadok v príslušnej časti aktivít. Deklarovanie jednej z týchto hodnôt na účte, ktorý by heuristika podľa názvu považovala za peňažný, napríkladAssets:US:Bank:CD, ho zároveň odstráni z množiny peňažných prostriedkov a zaradí ho do deklarovanej časti.
Deklarácie majú prednosť pred účtovnými konvenciami. Účet vlastného imania s deklarovanou hodnotou "operating" sa rešpektuje doslova.
Precedencia
Vyhráva najvyššia priorita:
- Metadáta
cash-flow-rolena direktíveopenúčtu. - Vstavané predvolené heuristiky nižšie.
Predvolené klasifikácie
Účet bez deklarovanej úlohy sa klasifikuje podľa svojho koreňa, pričom kontrola názvu rozhoduje o zaradení medzi peňažné prostriedky:
| Koreň účtu | Predvolená aktivita |
|---|---|
Income, Expenses | Prevádzková |
Assets (nepeňažný) | Investičná |
Liabilities, Equity | Finančná |
Majetkové účty, ktorých názov obsahuje Cash, Checking, Savings alebo Bank, sa predvolene považujú za peňažné prostriedky a ekvivalenty. Deklarovaná úloha má prednosť pred kontrolou názvu v oboch smeroch.
Neplatné hodnoty
Nerozpoznaná hodnota sa považuje za chýbajúcu. Preklep ako "invsting", neplatný typ hodnoty alebo nesprávna veľkosť písmen spôsobí návrat k predvolenej heuristike a výkaz označí účet v paneli stavu poznámkou o neznámej hodnote. Nič nezlyhá pri vykresľovaní a nič sa ticho nepreskočí.
Zmena klasifikácie
Klasifikácie nie sú viazané na dátumy. Výkaz pre akékoľvek obdobie používa deklarácie v ich aktuálnej podobe. Ak chcete niečo zmeniť, upravte direktívu open; systém verzovania účtovnej knihy zaznamená, čo sa zmenilo a kedy.
Kde sa deklarácie uplatňujú
Jedna spoločná logika určuje výslednú úlohu pre každý účet a každý spotrebiteľ ju číta rovnako:
- Výkaz peňažných tokov: časti aktivít, množina peňažných prostriedkov a ekvivalentov a spodný riadok výkazu.
- Exporty CSV, Markdown a tlač: rovnaké čísla. Označenie „klasifikácia je odvodená“ sa zobrazuje iba pre riadky, ktoré stále určuje heuristika.
- Prehľadový diagram peňažných tokov:
"cash"vylučuje účet z uzlov tokov a deklarované úlohy aktivít sa rešpektujú pre účty, ktoré nie sú príjmami. Príjmy zostávajú na strane zdrojov a vlastné imanie zostáva vylúčené z diagramu; deklarácie tieto dve skupiny nikdy nepresúvajú. - Panel stavu účtu: deklarovaný účet sa už nezobrazuje ako neklasifikované aktívum.
Prenosnosť
Metadáta na direktívach open sú základnou súčasťou syntaxe Beancount. bean-check, Fava a každý nástroj vo verzii v2 aj v3 ich analyzujú a neznámy kľúč ignorujú, takže účtovná kniha zostáva plne použiteľná aj mimo Beancount.io. Všeobecný formát metadát nájdete v syntaxi Beancount.
