04 - Основи Beancount для користувачів¶
Beancount зберігає бухгалтерський облік у вигляді читабельного тексту. Кожна транзакція вказує, що сталося, коли, хто був залучений і які рахунки змінилися.
Базова структура транзакції¶
2026-01-13 ! "Tragerwerk Soziale Dienste in Sachsen-Anhalt GmbH" "RgNr. T-2504"
Vermoegen:Bank:Sparkasse-Tohuwabohu:Freies-Geld 680.00 EUR
Einnahmen:Sonstiges
| Частина | Значення |
|---|---|
2026-01-13 |
Дата транзакції. |
! |
Маркер статусу. У цій системі він зазвичай використовується для імпортованих або ще не остаточно перевірених записів. |
| Перший текст у лапках | Одержувач або відправник. |
| Другий текст у лапках | Опис або текст банківської виписки. |
| Перший рядок рахунку | Звідки надійшли або куди пішли гроші. |
| Другий рядок рахунку | Протилежна категорія. Якщо сума не вказана, Beancount розраховує її автоматично. |
Назви рахунків¶
Назви рахунків розділені двокрапками:
Vermoegen:Bank:Sparkasse-NICA:Freies-Geld
Читайте зліва направо: активи, банківський рахунок, Sparkasse-NICA, вільно доступні кошти.
П'ять сімейств рахунків¶
| Сімейство | Значення | Приклад |
|---|---|---|
Vermoegen |
Активи: банк, PayPal, готівка, запаси. | Vermoegen:Bank:Sparkasse-NICA |
Verbindlichkeiten |
Зобов'язання: гроші, винні людям або іншим. | Verbindlichkeiten:Person:Marc-Bielert |
Equity |
Початкові залишки та балансуючі записи. | Equity:Opening-Balances |
Einnahmen |
Доходи. | Einnahmen:Vereinsbeitrag |
Ausgaben |
Витрати. | Ausgaben:Buero:Miete |
Знаки доходів та витрат¶
У звітах Beancount доходи часто відображаються з внутрішнім від'ємним знаком, а витрати — з додатним. Fava та панелі інструментів часто представляють ці значення у більш зручному для користувача форматі. Не змінюйте транзакції лише тому, що число доходу виглядає від'ємним у необробленому запиті.
Перевірки балансу¶
Перевірка балансу стверджує, що рахунок повинен мати певний баланс на певну дату:
2026-03-13 balance Vermoegen:Bank:Sparkasse-NICA 1234.56 EUR
Якщо Beancount не може співставити цей баланс із транзакціями до цієї дати, Fava покаже помилку. Перевірки балансу є основним механізмом контролю якості.
Відкриття та закриття рахунків¶
Перед використанням рахунок відкривається:
2025-04-01 open Ausgaben:Projekt:25-ZGV:Honorar
Коли проект завершено, а баланс рахунку проекту дорівнює нулю, його можна закрити:
2026-02-27 close Ausgaben:Projekt:TOHUCON-25
Закриті рахунки зазвичай не повинні отримувати нових транзакцій.
Коментарі та документи¶
Рядки, що починаються з ;, є коментарями. Вони пояснюють рішення або невизначені ситуації та не впливають на цифри.
Квитанції можна пов'язати за допомогою рядків document:
2025-10-02 document Ausgaben:Projekt:TOHUCON-25:Essen "Belege Ausgaben/Quittung-Tohu25-001.pdf"