Додайте метадані cash-flow-role до директиви open рахунку, щоб визначити, як звіт про рух грошових коштів класифікує цей рахунок. Один ключ, чотири значення. Рахунки без цих метаданих зберігають типову евристику.
2000-01-01 open Assets:US:Brokerage
cash-flow-role: "investing"
2000-01-01 open Assets:US:Marcus:Savings
cash-flow-role: "cash"Ключ і значення
| Ключ | Місце | Тип значення | Допустимі значення |
|---|---|---|---|
cash-flow-role | метадані директиви open | рядок | "cash", "operating", "investing", "financing" |
Відповідність чутлива до регістру та є точною. Значення має бути рядком у лапках. Інші ключі метаданих у тій самій директиві ігноруються звітом, а цей ключ ігнорується всіма іншими інструментами.
Що робить кожне значення
Оголошена роль відповідає одразу на два питання: чи є рахунок частиною грошової маси, і до якої секції діяльності він належить інакше.
"cash"— рахунок приєднується до набору грошових коштів та їх еквівалентів. Грошові рахунки ніколи не зʼявляються як статті діяльності. Підсумок звіту, чиста зміна грошових коштів та їх еквівалентів, дорівнює сумі їх змін за період. Перекази між двома грошовими рахунками взаємно компенсуються. Використовуйте це для рахунків, які пропускає евристика за назвою, наприклад, фонд грошового ринку або гаманець стейблкойнів."operating","investing","financing"— рахунок не є грошовим, і його зміна за період зʼявляється як стаття у відповідній секції діяльності. Оголошення однієї з цих ролей для рахунку, який евристика за назвою вважала б грошовим, наприкладAssets:US:Bank:CD, і видаляє його з набору грошових коштів, і відносить до оголошеної секції.
Оголошенням довіряють більше, ніж бухгалтерським умовностям. Рахунок Equity, оголошений як "operating", виконується дослівно.
Пріоритет
Найвищий має перевагу:
- Метадані
cash-flow-roleу директивіopenрахунку. - Вбудована типова евристика нижче.
Типові класифікації
Рахунок без оголошеної ролі класифікується за його коренем, а перевірка назви визначає належність до грошових коштів:
| Корінь рахунку | Типова діяльність |
|---|---|
Income, Expenses | Операційна |
Assets (не грошові) | Інвестиційна |
Liabilities, Equity | Фінансова |
Активні рахунки, назви яких містять Cash, Checking, Savings або Bank, за замовчуванням вважаються грошовими коштами та їх еквівалентами. Оголошена роль перевизначає перевірку назви в обох напрямках.
Неприпустимі значення
Нерозпізнане значення вважається відсутнім. Друкована помилка, як-от "invsting", значення не рядкового типу або неправильний регістр повертають до типової евристики, і звіт позначає рахунок на панелі статусу приміткою про невідоме значення. Нічого не ламається і нічого не приймається мовчки.
Зміна класифікації
Класифікації не залежать від дати. Звіт за будь-який період використовує оголошення такими, якими вони є на сьогодні. Щоб змінити її, відредагуйте директиву open; контроль версій книги фіксує, що і коли змінилося.
Де застосовуються оголошення
Єдиний спільний резолвер формує остаточну роль для кожного рахунку, і всі споживачі читають з нього:
- Звіт про рух грошових коштів: секції діяльності, набір грошових коштів та їх еквівалентів, і підсумкова звірка.
- Експорт у CSV, друк: ті самі числа. Розкриття про визначену класифікацію зʼявляється лише для рядків, які досі розвʼязуються евристикою.
- Діаграма руху грошових коштів на огляді:
"cash"виключає рахунок з вузлів потоків, а оголошені ролі діяльності враховуються для рахунків, відмінних від Income. Income залишається джерелом, а Equity виключається з діаграми; стан рахунку відображається в панелі статусу рахунку. - Панель статусу рахунку: оголошений рахунок більше не відображається як актив без визначеної ролі.
Портативність
Метадані в директивах open є стандартним синтаксисом Beancount. bean-check, Fava та всі інші інструменти v2/v3 аналізують їх та ігнорують невідомий ключ, тому книга залишається повністю сумісною поза Beancount.io. Див. Синтаксис Beancount для загального формату метаданих.
