Skip to main content

6 posts tagged with "подвійний запис"

View all tags

Екосистема Beancount: Комплексний аналіз

· 30 min read
Mike Thrift
Mike Thrift
Marketing Manager

Основна функціональність та філософія Beancount

Beancount — це система бухгалтерського обліку подвійного запису з відкритим вихідним кодом, яка використовує текстові файли для запису транзакцій. По суті, Beancount розглядає вашу бухгалтерську книгу як набір даних, визначений простою, суворою граматикою. Кожна фінансова подія (транзакції, відкриття рахунків, ціни на товари тощо) є директивою в текстовому файлі, яку Beancount аналізує та перетворює на базу даних записів у пам'яті. Ця архітектура забезпечує дотримання принципу подвійного запису: кожна транзакція повинна балансувати дебети та кредити між рахунками. Результатом є високопрозора та аудитована бухгалтерська книга, яку можна легко контролювати за версіями, перевіряти та запитувати.

2025-04-15-beancount-ecosystem

Філософія – коректність та мінімалізм: Дизайн Beancount надає пріоритет цілісності даних та простоті. Його творець, Мартін Блейс, описує Beancount як "песимістичний", припускаючи, що користувач робитиме помилки, і тому накладає додаткові перевірки та обмеження. Наприклад, Beancount не дозволить вам видалити активи, які ніколи не були додані (запобігаючи від'ємним залишкам запасів або готівки), і може вимагати, щоб кожен рахунок був відкритий перед використанням. Йому бракує концепції "віртуальних" або автоматично збалансованих проводок Ledger – це свідомий вибір, щоб змусити використовувати повністю збалансовані записи. Beancount ефективно "йде напролом" у коректності, надаючи більше перехресних перевірок, ніж забезпечує базовий подвійний запис. Цей обережний підхід приваблює користувачів, які "не надто довіряють собі" і хочуть, щоб програмне забезпечення виявляло їхні помилки.

Мінімальні опції, максимальна послідовність: На відміну від безлічі прапорців командного рядка та параметрів налаштування Ledger, Beancount обирає мінімалізм. Існує дуже мало глобальних опцій, і жодна з них не змінює семантику транзакцій за межами файлу бухгалтерської книги. Всі конфігурації, що впливають на облік (наприклад, методи обліку собівартості товарів або припущення щодо обліку), виконуються у файлі за допомогою директив або плагінів, що гарантує, що завантаження одного й того ж файлу завжди дає однакові результати, незалежно від того, як генеруються звіти. Цей дизайн дозволяє уникнути складності численних налаштувань Ledger та тонких взаємодій між ними. Філософія Beancount полягає в тому, що інструмент обліку повинен бути стабільним, детермінованим конвеєром від вхідного файлу до звітів. Він досягає цього, розглядаючи бухгалтерську книгу як впорядкований потік директив, які можуть бути програмно оброблені послідовно. Навіть те, що Ledger розглядає як спеціальний синтаксис (наприклад, початкові залишки або заяви про ціни), є першокласними директивами в моделі даних Beancount, що робить систему дуже розширюваною.

Розширюваність за допомогою плагінів та мови запитів: Beancount реалізовано на Python і надає хуки для впровадження власної логіки в конвеєр обробки. Користувачі можуть писати плагіни на Python, які працюють з потоком транзакцій (наприклад, для застосування власного правила або генерації автоматичних записів). Ці плагіни запускаються під час обробки файлу, ефективно розширюючи основну функціональність Beancount без необхідності модифікації вихідного коду. Beancount також включає потужну мову запитів (на основі SQL) для аналізу та деталізації бухгалтерської книги. Інструмент bean-query розглядає проаналізовану бухгалтерську книгу як базу даних і дозволяє виконувати на ній аналітичні запити – наприклад, підсумовувати витрати за категоріями або витягувати всі транзакції для певного одержувача. У Beancount 3.x ця можливість запитів була перенесена в окремий пакет beanquery, але з точки зору користувача вона все ще забезпечує гнучку звітність за допомогою SQL-подібних запитів.

Простий текст та контроль версій: Як інструмент обліку на основі простого тексту, Beancount наголошує на контролі користувача та довговічності даних. Бухгалтерська книга – це просто текстовий файл .beancount, який можна редагувати в будь-якому текстовому редакторі. Це означає, що вся ваша фінансова історія зберігається в людиночитаному форматі, і ви можете розмістити її в Git або іншій VCS для відстеження змін з часом. Користувачі часто зберігають свій файл Beancount під контролем версій, щоб підтримувати аудиторський слід кожної зміни (з повідомленнями комітів, що описують зміни). Цей підхід відповідає філософії Beancount, згідно з якою облікові дані, особливо особисті фінанси або фінанси малого бізнесу, повинні бути прозорими та "стійкими до майбутніх змін" – не заблокованими у власницькій базі даних. За словами самого Мартіна Блейса, Beancount – це "плід праці", створений бути простим, довговічним та безкоштовним для спільноти. Він був вперше розроблений близько 2007 року і еволюціонував через значні переробки (з v1 до v2, а тепер v3 у 2024 році), щоб удосконалити свій дизайн, зберігаючи при цьому свою основну філософію мінімалізму та коректності.

Інструменти, Плагіни та Розширення в Екосистемі Beancount

Екосистема Beancount розвинула багатий набір інструментів, плагінів та розширень, що покращують основну функціональність бухгалтерської книги. Вони охоплюють імпорт даних, редагування бухгалтерських книг, перегляд звітів та додавання спеціалізованих бухгалтерських функцій. Нижче наведено огляд ключових компонентів та додатків у світі Beancount:

Утиліти для імпорту даних (Імпортери)

Однією з найважливіших потреб для практичного використання є імпортування транзакцій з банків, кредитних карток та інших фінансових установ. Beancount надає фреймворк для імпорту та скрипти для імпорту, надані спільнотою, для цієї мети. У Beancount 2.x вбудований модуль beancount.ingest (з командами, такими як bean-extract та bean-identify) використовувався для визначення плагінів імпортерів на Python та їх застосування до завантажених виписок. У Beancount 3.x це було замінено зовнішнім проєктом під назвою Beangulp. Beangulp — це спеціалізований фреймворк для імпортерів, який еволюціонував з beancount.ingest і тепер є рекомендованим способом автоматизації імпорту транзакцій для Beancount 3.0. Він дозволяє писати скрипти Python або інструменти командного рядка, які читають зовнішні файли (такі як виписки CSV або PDF) та виводять записи Beancount. Цей новий підхід відокремлює логіку імпорту від ядра Beancount – наприклад, стара команда bean-extract була видалена у версії 3, і натомість ваші скрипти імпорту самі генерують транзакції через інтерфейс командного рядка Beangulp.

Десятки готових імпортерів існують для різних банків та форматів, надані спільнотою. Існують скрипти імпортерів для установ по всьому світу – від Alipay та WeChat Pay у Китаї, до різних європейських банків (Commerzbank, ING, ABN AMRO тощо), до американських банків, таких як Chase та Amex. Багато з них зібрані у публічних репозиторіях (часто на GitHub) або в пакетах, таких як beancount-importers. Наприклад, проєкт Tarioch Beancount Tools (tariochbctools) надає імпортери для швейцарських та британських банків і навіть обробляє імпорт криптотранзакцій. Іншим прикладом є Lazy Beancount, який містить набір поширених імпортерів (для Wise, Monzo, Revolut, IBKR тощо) та надає налаштування на основі Docker для легкої автоматизації. Незалежно від того, який банк чи фінансовий сервіс ви використовуєте, ймовірно, хтось вже написав імпортер Beancount для нього – або ви можете написати свій власний, використовуючи фреймворк Beangulp. Гнучкість Python означає, що імпортери можуть обробляти парсинг файлів CSV/Excel, завантаження OFX/QIF або навіть скрапінг API, а потім генерувати транзакції у стандартизованому форматі Beancount.

Редагування та інтеграція з редакторами

Оскільки бухгалтерські книги Beancount — це просто текст, користувачі часто використовують свої улюблені текстові редактори або IDE для їх ведення. Екосистема пропонує плагіни підтримки редакторів, щоб зробити цей досвід зручнішим. Існують розширення для багатьох популярних редакторів, які додають підсвічування синтаксису, автозаповнення назв рахунків та перевірку помилок у реальному часі:

  • Режим Beancount для Emacs: Доступний основний режим Emacs (beancount-mode) для редагування файлів .beancount, що пропонує такі функції, як підсвічування синтаксису та інтеграцію з перевіркою Beancount. Він може навіть запускати bean-check у фоновому режимі, щоб помилки в бухгалтерській книзі (наприклад, незбалансована транзакція) позначалися під час редагування.
  • Розширення VS Code: Розширення Beancount на VSCode Marketplace надає подібні зручності для користувачів Visual Studio Code. Воно підтримує підсвічування синтаксису, вирівнювання сум, автозаповнення для рахунків/одержувачів і навіть перевірку балансу на льоту при збереженні файлу. Воно також може інтегруватися з Fava, дозволяючи запускати веб-інтерфейс Fava з VSCode.
  • Плагіни або режими також існують для Vim, Atom та інших редакторів. Наприклад, існує граматика Tree-sitter для Beancount, яка забезпечує підсвічування синтаксису в сучасних редакторах і навіть була прийнята у веб-компоненті редактора Fava. Коротко кажучи, незалежно від вашого середовища редагування, спільнота, ймовірно, надала плагін, щоб зробити редагування файлів Beancount зручним і безпомилковим.

Для швидкого введення транзакцій поза традиційними редакторами також існують такі інструменти, як Bean-add та мобільні додатки. Bean-add — це інструмент командного рядка, який дозволяє додавати нову транзакцію через запит або в один рядок, обробляючи пропозиції щодо дати та рахунку. На мобільних пристроях проєкт під назвою Beancount Mobile надає простий інтерфейс для введення транзакцій на ходу (наприклад, запис готівкової покупки з вашого телефону). Крім того, існує Telegram-бот Beancount для фіксації транзакцій через повідомлення — ви можете надіслати повідомлення з деталями транзакції, і бот відформатує його у файл вашої бухгалтерської книги.

Веб-інтерфейси та інструменти візуалізації

(Fava) Веб-інтерфейс Fava надає інтерактивну панель інструментів для Beancount, що містить такі звіти, як звіт про прибутки та збитки з візуалізаціями (тут показано як деревоподібну діаграму витрат за категоріями) разом з таблицями рахунків та залишків.

Флагманським фронтендом для Beancount є Fava, сучасний веб-інтерфейс. Fava працює як локальний веб-додаток, який читає ваш файл Beancount і створює насичений інтерактивний досвід у вашому браузері. Він пропонує повний набір звітів: баланс, звіт про прибутки та збитки, чиста вартість з часом, склад портфеля, графіки ефективності, бюджети та багато іншого – все готове до використання. Користувачі часто називають Fava головною причиною вибору Beancount серед інших інструментів текстового обліку. За допомогою однієї команди (fava ledger.beancount) ви можете переглядати свої фінанси за допомогою графіків та таблиць замість тексту. Fava підтримує такі функції, як: деталізація рахунків, фільтрація транзакцій за отримувачем або тегом, редактор запитів (щоб ви могли виконувати запити Beancount та бачити результати в браузері), і навіть інтегрований веб-редактор для вашої книги обліку. Він дуже зручний у використанні, що робить текстовий облік доступним для тих, хто віддає перевагу візуальним інтерфейсам.

Під капотом Fava написана на Python (Flask на бекенді) та JavaScript (Svelte на фронтенді). Вона має власний цикл випуску та активно підтримується. Зокрема, Fava йшла в ногу з розробкою Beancount – наприклад, Fava 1.30 додала підтримку Beancount v3, перейшовши на використання нових пакетів beanquery та beangulp всередині. (Вона все ще підтримує Beancount 2 для старіших книг обліку.) Зосередженість Fava на зручності використання включає приємні дрібниці, такі як автозавершення у веб-редакторі, та елегантний інтерфейс користувача з темним режимом та адаптивними діаграмами. Існує також відгалуження під назвою Fava-GTK, яке пакує Fava в настільний додаток для користувачів GNOME/Linux, які віддають перевагу відчуттю нативного додатку.

Крім Fava, існують інші варіанти візуалізації та аналізу. Оскільки дані Beancount можуть бути експортовані або запитувані як таблиці, користувачі часто використовують такі інструменти, як Jupyter notebooks або Pandas для власного аналізу. Наприклад, один користувач описує витягування даних з Beancount через інтерфейс запитів у Pandas DataFrame для підготовки власного звіту. Існують також скрипти, надані спільнотою, для конкретних звітів – наприклад, інструмент аналізу розподілу портфеля або контрольна карта процесу для витрат порівняно з чистою вартістю. Однак, для більшості людей Fava надає більш ніж достатньо можливостей звітності без необхідності писати код. Вона навіть підтримує розширення: ви можете просто додати файли Python, які додають нові сторінки звітів або діаграми до Fava. Помітним розширенням є fava-envelope для конвертного бюджетування всередині Fava. Загалом, Fava слугує центральним вузлом візуалізації екосистеми Beancount.

Інструменти командного рядка та скрипти

Beancount постачається з різноманітними інструментами командного рядка (особливо в старішій гілці v2, деякі з яких були скорочені у v3). Ці інструменти працюють з вашим файлом облікової книги для його перевірки або генерації певних звітів у текстовому форматі або HTML:

  • bean-check: валідатор, який перевіряє файл на синтаксичні або бухгалтерські помилки. Запуск bean-check myfile.beancount повідомить вас про будь-який дисбаланс, відсутній рахунок або інші проблеми, і не виведе нічого, якщо файл не містить помилок.
  • bean-format: форматувальник, який впорядковує вашу облікову книгу, вирівнюючи числа в акуратні стовпці, подібно до запуску форматувальника коду для вихідного коду. Це допомагає підтримувати файл чистим і читабельним.
  • bean-query: інтерактивна оболонка або пакетний інструмент для виконання мови запитів Beancount у вашій обліковій книзі. Ви можете використовувати його для створення власних табличних звітів (наприклад, bean-query myfile.beancount "SELECT account, sum(amount) WHERE ...").
  • bean-report: універсальний генератор звітів (у v2), який може виводити попередньо визначені звіти (баланс, звіт про прибутки та збитки, пробний баланс тощо) на консоль або у файли. Наприклад, bean-report file.beancount balances виведе залишки на рахунках. (На практиці, багато з цих текстових звітів були замінені більш приємним представленням Fava.)
  • bean-web / bean-bake: старіший веб-інтерфейс, який обслуговував звіти на localhost або "запікав" їх як статичні HTML-файли. Вони переважно використовувалися до того, як Fava стала популярною; bean-web надавав базовий веб-перегляд тих самих звітів, які міг генерувати bean-report. У Beancount 3 bean-web було видалено (оскільки Fava тепер є рекомендованим веб-інтерфейсом, що пропонує чудовий досвід).
  • bean-example: утиліта для генерації прикладу файлу облікової книги (корисна для новачків, щоб побачити шаблон записів Beancount).
  • bean-doctor: інструмент налагодження, який може діагностувати проблеми у вашій обліковій книзі або середовищі.

Варто зазначити, що станом на Beancount v3, багато з цих інструментів були винесені з основного проєкту. Основний пакет Beancount був оптимізований, а такі інструменти, як механізм запитів та імпортери, були розділені на окремі пакети (beanquery, beangulp тощо) для полегшення обслуговування. Наприклад, функціональність bean-query тепер надається інструментом beanquery, який встановлюється окремо. З точки зору користувача, функціональність залишається доступною; її просто було модулізовано. Спільнота Arch Linux відзначила цю зміну під час оновлення Fava: пакет Fava додав залежності від beanquery та beangulp для підтримки Beancount 3.x. Цей модульний підхід також дозволяє іншим членам спільноти робити внесок у ці допоміжні інструменти більш незалежно від циклу випуску Beancount.

Плагіни та розширення Beancount

Однією з визначних переваг екосистеми Beancount є система плагінів. Додавши рядок plugin "module.name" до вашого файлу Beancount, ви можете інтегрувати власну логіку Python, яка виконується під час обробки книги. Спільнота створила багато плагінів для розширення можливостей Beancount:

  • Якість даних та правила: Приклади включають beancount-balexpr, який дозволяє стверджувати рівняння за участю кількох рахунків (наприклад, Актив А + Актив Б = Зобов'язання X), та beancount-checkclosed, який автоматично вставляє твердження про баланс, коли ви закриваєте рахунок, щоб переконатися, що він дорівнює нулю. Існує навіть плагін для забезпечення сортування транзакцій у файлі за датою (autobean.sorted) для виявлення записів не за порядком.
  • Автоматизація: Плагін beancount-asset-transfer може генерувати записи про перекази в натуральній формі між рахунками (корисно для переміщення акцій між брокерами зі збереженням бази витрат). Інший, autobean.xcheck, перевіряє вашу книгу Beancount на відповідність зовнішнім випискам щодо розбіжностей.
  • Повторювані транзакції та бюджети: Плагін «repeat» або interpolate від Akuukis дозволяє визначати повторювані транзакції або розподіляти річні витрати на місяці. Для бюджетування розширення fava-envelope (використовується через Fava) підтримує методологію конвертного бюджетування у вигляді простого тексту. Існує також MiniBudget від Френка Девіса – невеликий автономний інструмент, натхненний Beancount, що допомагає з бюджетуванням для особистого використання або малого бізнесу.
  • Податки та звітність: Деякі плагіни допомагають з податковим обліком, наприклад, той, що автоматично класифікує приріст капіталу на короткостроковий та довгостроковий. Інший (fincen_114 від Джастуса Пендлтона) генерує звіт FBAR для платників податків США з іноземними рахунками, ілюструючи, як дані Beancount можуть бути використані для регуляторної звітності.
  • Репозиторії плагінів спільноти: Існують підібрані набори плагінів, такі як beancount-plugins (від Дейва Стівенса), що зосереджені на таких речах, як записи про амортизацію, та beancount-plugins-zack (від Стефано Заккіролі), які включають різноманітні допоміжні засоби, такі як сортування директив.

На додаток до плагінів, інші службові інструменти, що оточують Beancount, вирішують специфічні потреби. Наприклад, beancount-black – це автоматичний форматувальник, схожий на форматувальник коду Black, але для файлів книги Beancount. Існує Beancount Bot (Telegram/Mattermost) для додавання транзакцій через чат, як згадувалося, та робочий процес Alfred для macOS для швидкого додавання транзакцій до вашого файлу. Інструмент під назвою Pinto пропонує «потужний» інтерфейс командного рядка з інтерактивним введенням (як покращений bean-add). Для тих, хто мігрує з інших систем, існують конвертери (YNAB2Beancount, CSV2Beancount, GnuCash2Beancount, Ledger2Beancount), які допомагають імпортувати дані з інших джерел.

Підсумовуючи, екосистема Beancount є досить розгалуженою. Таблиця 1 нижче перелічує деякі основні інструменти та розширення з їхніми ролями:

Інструмент/РозширенняОпис
Fava (веб-інтерфейс)Повнофункціональний веб-додаток для перегляду та редагування книг Beancount. Надає інтерактивні звіти (баланс, доходи тощо), діаграми та можливості запитів. Значно підвищує зручність використання Beancount.
Beangulp (фреймворк імпорту)Незалежний фреймворк імпорту для Beancount v3, що замінює старий модуль ingest. Допомагає конвертувати банківські виписки (CSV, PDF тощо) у записи Beancount за допомогою скриптів плагінів.
Beanquery (інструмент запитів)Незалежний SQL-подібний механізм запитів для даних Beancount. Замінює bean-query у v3, дозволяючи розширені запити транзакцій та балансів за допомогою знайомого синтаксису SELECT-FROM-WHERE.
Bean-check / Bean-formatОсновні інструменти командного рядка для перевірки файлу Beancount (на наявність помилок) та його автоматичного форматування для забезпечення послідовності. Корисні для підтримки правильної та чистої книги.
Плагіни редакторів (Emacs, VSCode, Vim тощо)Плагіни/режими, що додають підтримку синтаксису Beancount та лінтинг у текстових редакторах. Покращують досвід ручного редагування файлів .beancount за допомогою таких функцій, як автозавершення та підсвічування помилок у реальному часі.
Імпортери спільнотиКолекції скриптів імпорту банківських даних (багато на GitHub), що охоплюють банки в США, ЄС, Азії та інших регіонах. Дозволяють користувачам автоматично імпортувати транзакції зі своїх фінансових установ у Beancount.
Плагіни (розширення Ledger)Необов'язкові вбудовані плагіни для застосування правил або додавання функціональності (наприклад, розподіл витрат, повторювані записи, власні твердження про баланс). Написані на Python і виконуються під час обробки файлу для налаштування.
Конвертери (інструменти міграції)Утиліти для конвертації даних з інших форматів у Beancount, наприклад, з GnuCash або Ledger CLI у формат Beancount. Сприяють впровадженню Beancount без необхідності починати з нуля.

Порівняння з Ledger, hledger та подібними системами

Beancount належить до сімейства інструментів обліку подвійного запису в текстовому форматі, серед яких виділяються Ledger CLI (Ledger Джона Віглі) та hledger. Хоча всі ці системи поділяють основну ідею текстових файлів обліку та подвійного запису, вони відрізняються синтаксисом, філософією та зрілістю екосистеми. Наступна таблиця висвітлює ключові відмінності між Beancount, Ledger та hledger:

АспектBeancount (Python)Ledger CLI (C++)hledger (Haskell)
Синтаксис та структура файлуСуворий, структурований синтаксис, визначений

Сценарії використання Beancount

Beancount є достатньо універсальним, щоб використовувати його як для відстеження особистих фінансів, так і (в деяких випадках) для бухгалтерського обліку малого бізнесу. Його основний підхід подвійного запису є однаковим в обох сценаріях, але масштаб і конкретні практики можуть відрізнятися.

Особисті фінанси

Багато користувачів Beancount використовують його для управління своїми особистими або сімейними фінансами. Типова конфігурація особистих фінансів у Beancount може включати рахунки для поточних та ощадних рахунків, кредитних карток, інвестицій, позик, категорій доходів (зарплата, відсотки тощо) та категорій витрат (оренда, продукти, розваги тощо). Користувачі записують щоденні транзакції або вручну (вводячи квитанції, рахунки тощо), або імпортуючи з банківських виписок за допомогою раніше обговорених інструментів імпорту. Переваги, які Beancount надає особистим фінансам, включають:

  • Консолідація та аналіз: Усі ваші транзакції можуть зберігатися в одному текстовому файлі (або наборі файлів), що представляє роки фінансової історії. Це полегшує аналіз довгострокових тенденцій. За допомогою мови запитів Beancount або Fava ви можете за лічені секунди відповісти на запитання на кшталт «Скільки я витратив на подорожі за останні 5 років?» або «Який мій середній щомісячний рахунок за продукти?». Один користувач зазначив, що після переходу на Beancount, «аналіз фінансових даних (витрат, пожертвувань, податків тощо) є тривіальним» як через Fava, так і шляхом запитів до даних та використання таких інструментів, як Pandas. По суті, ваша бухгалтерська книга стає особистою фінансовою базою даних, яку ви можете запитувати за бажанням.
  • Бюджетування та планування: Хоча Beancount не нав'язує систему бюджетування, ви можете її реалізувати. Деякі користувачі використовують конвертне бюджетування, створюючи бюджетні рахунки або використовуючи плагін fava-envelope. Інші просто використовують періодичні звіти для порівняння витрат із цільовими показниками. Оскільки це простий текст, інтеграція Beancount із зовнішніми інструментами бюджетування або електронними таблицями є простою (експорт даних або використання виводів CSV із запитів).
  • Відстеження інвестицій та чистої вартості: Beancount чудово відстежує інвестиції завдяки надійній обробці собівартості та ринкових цін. Ви можете записувати купівлі/продажі акцій, криптовалюти тощо з деталями собівартості, а потім використовувати директиви Prices для відстеження ринкової вартості. Fava може відображати графік чистої вартості з часом та розбивку портфеля за класами активів. Це надзвичайно корисно для управління особистим капіталом – ви отримуєте інформацію, подібну до тієї, що надають комерційні інструменти, такі як Mint або Personal Capital, але повністю під вашим контролем. Обробка кількох валют також вбудована, тому, якщо ви тримаєте іноземні валюти або криптовалюту, Beancount може відстежувати їх та конвертувати для звітності.
  • Звірка та точність: Особисті фінанси часто передбачають звірку з банківськими виписками. За допомогою Beancount можна регулярно звіряти рахунки, використовуючи твердження балансу або функцію документів. Наприклад, щомісяця ви можете додавати запис balance Assets:Bank:Checking <date> <balance>, щоб підтвердити, що ваша бухгалтерська книга відповідає банківській виписці на кінець місяця. Інструмент bean-check (або відображення помилок Fava) попередить вас, якщо щось не збігається. Один користувач згадує про щомісячну звірку всіх рахунків, що «допомагає виявити будь-яку незвичайну активність» – хороша практика гігієни особистих фінансів, яку полегшує Beancount.
  • Автоматизація: Технічно підковані особи автоматизували значну частину свого робочого процесу особистих фінансів за допомогою Beancount. Використовуючи імпортери, завдання cron та, можливо, трохи Python, ви можете налаштувати свою систему так, щоб, наприклад, щодня ваші банківські транзакції завантажувалися (деякі використовують OFX або API) та додавалися до вашого файлу Beancount, класифіковані за правилами. З часом ваша бухгалтерська книга здебільшого оновлюється автоматично, і вам залишається лише переглядати та коригувати за потреби. Учасник спільноти на Hacker News поділився, що через 3 роки їхні бухгалтерські книги Beancount були «на 95% автоматичними». Такий рівень автоматизації можливий завдяки відкритості Beancount у простому тексті та можливостям сценаріїв.

Користувачі особистих фінансів часто обирають Beancount замість електронних таблиць або додатків, оскільки він надає їм повне володіння даними (без залежності від хмарного сервісу, який може припинити роботу – наприклад, як це сталося з Mint) і тому, що глибина аналізу більша, коли всі ваші дані інтегровані. Крива навчання є нетривіальною – потрібно вивчити основи бухгалтерського обліку та синтаксис Beancount – але такі ресурси, як офіційна документація та навчальні посібники спільноти, допомагають новачкам розпочати роботу. Після налаштування багато хто виявляє, що це приносить спокій, маючи чітку, надійну картину своїх фінансів у будь-який час.

Облік малого бізнесу

Використання Beancount для малого бізнесу (або неприбуткової організації, клубу тощо) є менш поширеним, ніж для особистого використання, але це, безумовно, можливо, і деякі користувачі успішно це робили. Система подвійного запису Beancount насправді є тією ж системою, що лежить в основі корпоративного обліку, лише без деяких функцій вищого рівня, які надає спеціалізоване бухгалтерське програмне забезпечення (наприклад, модулі виставлення рахунків або інтеграції з розрахунком заробітної плати). Ось як Beancount може вписатися в контекст малого бізнесу:

  • Головна книга та фінансова звітність: Малий бізнес може розглядати файл Beancount як свою головну книгу. Ви матимете рахунки активів для банківських рахунків, дебіторської заборгованості, можливо, запасів; рахунки зобов’язань для кредитних карток, позик, кредиторської заборгованості; власний капітал для капіталу власника; рахунки доходів для продажів або послуг; та рахунки витрат для всіх ділових витрат. Ведучи цю книгу, ви можете в будь-який час скласти Звіт про прибутки та збитки (Звіт про фінансові результати) та Баланс (Звіт про фінансовий стан), використовуючи звіти або запити Beancount. Фактично, вбудовані звіти Beancount або Fava можуть генерувати баланс та Звіт про прибутки та збитки за лічені секунди, які ідеально відповідають принципам бухгалтерського обліку. Цього може бути достатньо для невеликої операції, щоб оцінити прибутковість, фінансовий стан та грошовий потік (з невеликим запитом для грошового потоку, оскільки прямі звіти про рух грошових коштів не вбудовані, але можуть бути виведені).
  • Рахунки-фактури та дебіторська/кредиторська заборгованість: Beancount не має вбудованої системи виставлення рахунків; користувачі зазвичай обробляють виставлення рахунків поза системою (наприклад, створюють рахунки-фактури в Word або додатку для рахунків-фактур), а потім записують результати в Beancount. Наприклад, коли ви виставляєте рахунок-фактуру, ви робите запис, дебетуючи рахунок дебіторської заборгованості та кредитуючи рахунок доходів. Коли надходить платіж, ви дебетуєте рахунок Готівка/Банк та кредитуєте рахунок дебіторської заборгованості. Таким чином, ви можете відстежувати непогашену дебіторську заборгованість, переглядаючи залишок на рахунку дебіторської заборгованості. Те саме стосується рахунків до сплати (кредиторської заборгованості). Хоча це більш ручний процес, ніж у спеціалізованому бухгалтерському програмному забезпеченні (яке може надсилати нагадування або інтегруватися з електронною поштою), це цілком можливо. Деякі користувачі ділилися шаблонами або робочими процесами щодо того, як вони керують рахунками-фактурами за допомогою Beancount та забезпечують, щоб вони не пропускали відкриті рахунки-фактури (наприклад, використовуючи метадані або користувацькі запити для переліку неоплачених рахунків-фактур).
  • Запаси або собівартість реалізованої продукції: Для підприємств, що продають продукцію, Beancount може відстежувати закупівлі та продажі запасів, але це вимагає дисциплінованих записів. Ви можете використовувати функції Inventory (Запаси) та обліку витрат: купівля запасів збільшує рахунок активів (з вартістю, прив'язаною до товарів), продаж переміщує вартість у витрати (СОГС) та реєструє дохід. Оскільки Beancount наполягає на відповідності партій, він забезпечить належне зменшення запасів за правильною вартістю, що може фактично гарантувати точність ваших розрахунків валового прибутку, якщо все зроблено правильно. Однак, немає автоматичного відстеження SKU або чогось подібного – все відбувається на фінансовому рівні (кількість та вартість).
  • Розрахунок заробітної плати та складні операції: Beancount може реєструвати операції з розрахунку заробітної плати (витрати на заробітну плату, утримання податків тощо), але розрахунок цих сум може здійснюватися зовнішньо або за допомогою іншого інструменту, а потім просто заноситися до

Спільнота та діяльність з розробки

Beancount має віддану спільноту та історію розробки, що відображає його відкритий, нішевий, але пристрасний характер. Нижче наведено ключові моменти щодо його спільноти, мейнтейнерів та пов'язаних проєктів:

  • Підтримка Проєкту: Основним автором Beancount є Мартін Блейс, який розпочав проєкт близько 2007 року і провів його через численні версії. Розробка протягом тривалого часу була переважно зусиллям однієї людини (окрім внесків спільноти у вигляді патчів). Філософія Мартіна полягала в створенні інструменту обліку, "корисного насамперед для мене, а також для інших, у найпростіший та найдовговічніший спосіб". Ця особиста мотивація підтримувала проєкт як працю з любові. Станом на 2025 рік Мартін Блейс все ще є провідним мейнтейнером (його ім'я з'являється в комітах, і він відповідає на запитання у списку розсилки/трекері проблем), але екосистема навколо Beancount має багато інших учасників у їхніх відповідних проєктах.

  • GitHub та Репозиторії: Вихідний код розміщено на GitHub у репозиторії beancount/beancount. Проєкт ліцензований за GPL-2.0 і за роки залучив помірну кількість учасників. У середині 2024 року Beancount Версія 3 була офіційно випущена як нова стабільна гілка. Цей випуск передбачав розділення деяких компонентів: наприклад, репозиторій beangulp (для імпортерів) та репозиторій beanquery (для інструменту запитів) тепер є частиною організації beancount на GitHub, що підтримуються дещо незалежно. Основний репозиторій Beancount зосереджений на базовому обліковому двигуні та парсері файлів. Станом на 2025 рік GitHub Beancount показує активні обговорення проблем та деяку поточну розробку – хоча й невеликого обсягу, проблеми та запити на злиття надходять поступово, а періодичні оновлення вносяться для виправлення помилок або вдосконалення функцій.

  • Розробка Fava: Fava, веб-інтерфейс, розпочався як окремий проєкт (створений Домініком Аумайром, який зареєстрував авторські права на нього у 2016 році). Він має власну спільноту учасників і також розміщений на GitHub під beancount/fava. Мейнтейнери та учасники Fava (наприклад, Якоб Шнец, Стефан Отте та інші в останні роки) активно вдосконалюють інтерфейс, випускаючи релізи кожні кілька місяців. Чат Fava на Gitter (посилання на документацію Fava) та трекер проблем GitHub – це місця, де користувачі та розробники обговорюють нові функції або помилки. Проєкт вітає внески, про що свідчить примітка в CHANGELOG, яка дякує численним членам спільноти за їхні PR. Тісне узгодження Fava з розробкою Beancount (таке як швидке додавання підтримки Beancount v3 та нового синтаксису beanquery) свідчить про хорошу співпрацю між двома проєктами.

  • Списки Розсилки та Форуми: Beancount має офіційний список розсилки (раніше на Google Groups, під назвою "Beancount" або іноді обговорювався у загальному списку Ledger). Цей список розсилки є скарбницею знань – користувачі ставлять запитання про те, як моделювати певні сценарії, повідомляють про помилки та діляться порадами. Мартін Блейс відомий тим, що відповідає у списку розсилки з детальними поясненнями. Крім того, ширша спільнота Plain Text Accounting значно перетинається. Список розсилки Ledger CLI часто розглядає питання щодо Beancount, а також існує форум на plaintextaccounting.org та субреддіт r/plaintextaccounting, де часто з'являються теми Beancount. Користувачі на цих платформах обговорюють порівняння, діляться особистими налаштуваннями та допомагають новачкам. Загальний тон спільноти дуже співпрацюючий – користувачі Beancount часто допомагають користувачам Ledger і навпаки, визнаючи, що всі ці інструменти мають схожі цілі.

  • Чат-групи: Окрім списків розсилки, існують чат-канали, такі як Plaintext Accounting Slack/Discord (організовані спільнотою) та Fava Gitter. Це менш формальні, більш оперативні способи отримати допомогу або обговорити функції. Наприклад, можна зайти в Slack, щоб запитати, чи є у когось імпортер для конкретного банку. Існує також канал Matrix/IRC (історично #ledger або #beancount на IRC), де перебувають деякі давні користувачі. Хоча ці канали не такі численні, як спільноти для масового програмного забезпечення, вони мають обізнаних людей, які часто можуть відповісти на незрозумілі бухгалтерські питання.

  • Учасники та Ключові Члени Спільноти: Кілька імен виділяються у спільноті Beancount:

    • "Redstreet" (Red S): Плідний учасник, який написав багато плагінів (таких як beancount-balexpr, sellgains та інші) і часто надає підтримку. Він також підтримує набір скриптів-імпортерів та інструмент під назвою bean-download для отримання виписок.
    • Василь М (Evernight): Автор

Останні розробки та майбутні функції

Станом на 2025 рік, екосистема Beancount зазнала значних розробок за останні кілька років, і тривають обговорення щодо майбутніх вдосконалень. Ось деякі важливі останні розробки та погляд на те, що може з'явитися:

  • Випуск Beancount 3.0 (2024): Після тривалого періоду, коли Beancount 2.x був стандартом, версія 3 була офіційно випущена в середині 2024 року. Це була важлива віха, оскільки v3 представляє спрощення та модернізацію кодової бази. Мартін Блейс передбачав v3 як шанс "перегрупувати та спростити" систему далі. Хоча спочатку вважалося, що це буде велике переписування, на практиці оновлення для користувачів не було надто руйнівним. Основні зміни відбулися під капотом: новий парсер, деякі покращення продуктивності та виділення необов'язкових компонентів з ядра. Випуск впроваджувався поступово (v3 був у бета-версії з 2022 року, але до липня 2024 року він став рекомендованою стабільною версією). Користувачі, такі як Сіддхант Гоел, повідомили, що міграція з 2.x на 3.x була "переважно безпроблемною" лише з кількома змінами у робочому процесі.

  • Модуляризація – інструменти переміщено в окремі пакети: Однією з великих змін у Beancount 3 є те, що багато інструментів, які раніше знаходилися в монолітному репозиторії, були виділені. Наприклад, bean-query тепер надається пакетом beanquery, а beancount.ingest було замінено пакетом beangulp. Команди, такі як bean-extract та bean-identify (для імпорту), були видалені з ядра Beancount. Натомість, філософія полягає у використанні окремих скриптів для імпорту. Це означає, що якщо ви оновитеся до v3, вам потрібно буде встановити beangulp та запускати скрипти імпорту (кожен імпортер – це, по суті, невелика програма), замість того, щоб мати центральний конфігураційний файл bean-extract. Аналогічно, запити виконуються через beanquery, який може встановлюватися та оновлюватися незалежно від ядра Beancount. Цей модульний підхід був розроблений для спрощення обслуговування та заохочення внесків спільноти. Він також зменшив ядро Beancount, тому ядро зосереджується виключно на логіці парсингу та обліку, тоді як допоміжна функціональність може розвиватися окремо. З точки зору користувача, після оновлення потрібно скоригувати команди (наприклад, використовувати bean-query з beanquery або використовувати Fava, яка все одно це абстрагує). Журнал змін Fava чітко зазначає ці зміни: Fava тепер залежить від beanquery та beangulp, і вона обробляє робочі процеси імпорту по-різному для Beancount 3 та 2.

  • Покращення продуктивності: Продуктивність була однією з мотивацій для перегляду дизайну Beancount. План v3 (як викладено в документі Мартіна "Цілі V3") включав оптимізацію парсера та, можливо, прискорення процесу завантаження та зменшення споживання пам'яті. До 2025 року деякі з цих покращень були реалізовані. За словами користувачів, які мають дуже великі облікові книги (десятки тисяч транзакцій або багато операцій з акціями), вони повідомили про кращу продуктивність з останньою версією. Наприклад, користувач, який працює з "мікроінвестиційними транзакціями" і зіткнувся з проблемами продуктивності, зазначив ці занепокоєння в Google Group – такий зворотний зв'язок, ймовірно, вплинув на v3. Новий парсер є більш ефективним і написаний зрозуміліше, що може бути розширено в майбутньому. Крім того, Fava 1.29 перейшла на більш ефективний механізм відстеження файлів (використовуючи бібліотеку watchfiles) для покращення чуйності, коли змінюється облікова книга. Заглядаючи вперед, спільнота може дослідити інкрементальний парсинг (обробка лише змінених частин файлу замість всього) для швидшої обробки великих облікових книг – це було натякнуто в документації як ідея "сервера Beancount / інкрементального проведення операцій".

  • Вдосконалення відстеження інвестицій: Триває робота над покращенням звітування про інвестиції та портфелі. Наприклад, детально обговорювалася обробка середньої собівартості проти FIFO. Хоча Beancount забезпечує відповідність партій, деякі користувачі віддають перевагу середній собівартості для певних юрисдикцій. Існує пропозиція та обговорення щодо того, щоб зробити проведення операцій за собівартістю більш гнучким (можливо, за допомогою плагіна або опції). До 2025 року вбудованого перемикача для середньої собівартості немає, але основа у v3 (переробка проведення операцій) полегшує реалізацію плагінами. Було випущено плагін спільноти "Gains Minimizer", який може пропонувати, які партії продати для мінімізації податків, показуючи тип розширених інструментів, що створюються навколо інвестицій. Fava також додала функції, такі як розширення зведення портфеля (з розрахунками норми прибутку). Щодо майбутніх функцій, можна очікувати більше в цій галузі: можливо, автоматичні пропозиції щодо ребалансування портфеля або аналіз ризиків, ймовірно, як зовнішні інструменти, які читають дані Beancount (оскільки всі дані є).

  • Нові плагіни та розширення: Екосистема плагінів постійно зростає. Останні помітні доповнення включають:

    • Інструменти для звітування про бюджет – наприклад, простий CLI-звітник бюджету, якщо не використовується інтерфейс Fava.
    • Шифрування та безпека – було представлено налаштування fava-encrypt, що дозволяє розміщувати Fava онлайн із зашифрованою обліковою книгою в стані спокою, вирішуючи проблему самостійного розміщення ваших фінансів.
    • Плагіни для покращення якості життя – такі як autobean-format (новий форматер, який може обробляти більше особливих випадків шляхом парсингу та повторного друку файлу), та інтеграція beancheck в редакторах (flymake для Emacs).

    Заглядаючи вперед, спільнота, ймовірно, продовжить заповнювати прогалини за допомогою плагінів. Наприклад, ми можемо побачити більше плагінів, пов'язаних з податками (деякі користувачі поділилися скриптами для таких речей, як розрахунок фіктивних продажів або конкретних місцевих податкових звітів).

  • Потенційні майбутні функції: На основі обговорень у трекері завдань та списку розсилки, на горизонті є кілька ідей (хоча не гарантовано):

    • Роздільна здатність часу: Наразі Beancount відстежує лише дати (без часових міток) для транзакцій. Були питання щодо додавання часу (для операцій з акціями або впорядкування транзакцій одного дня). Мартін Блейс чітко вирішив, що часові мітки в межах дня виходять за рамки, щоб зберегти простоту. Це навряд чи зміниться найближчим часом – тому майбутні версії, ймовірно, не додаватимуть роздільної здатності часу, дотримуючись позиції, що якщо вам потрібен час, ви включаєте його в опис або рахунок.
    • Покращене редагування графічного інтерфейсу: Fava постійно покращує свої можливості редагування. Можливим є більш повнофункціональний веб-редактор (з автозаповненням, можливо, введення нових транзакцій на основі форми). Було закладено основу для використання tree-sitter у редакторі Fava. Ми можемо побачити, як Fava стане не просто переглядачем, а більш потужним редактором, зменшуючи потребу взагалі відкривати текстовий редактор для багатьох завдань.
    • Краща підтримка кількох облікових книг: Деякі користувачі підтримують кілька файлів Beancount (для різних суб'єктів або для розділення особистих та ділових фінансів). Наразі включення файлів можливе, але мало обмеження (плагіни у включених файлах тощо). Нещодавно було створено плагін autobean.include для безпечного включення зовнішніх облікових книг. У майбутньому ми можемо побачити першокласну підтримку багатофайлових налаштувань – можливо, концепцію Beancount-«проєкту» з кількома файлами (на це натякають функції, такі як налаштування beancount.mainBeanFile розширення VSCode). Це допоможе тим, хто веде облік для кількох суб'єктів або хоче модуляризувати свою облікову книгу.
    • Обчислення в реальному часі або інкрементальне обчислення: Зі зростанням облікових книг здатність швидко перераховувати звіти стає важливою. Існує ідея сервера Beancount, який залишається запущеним і оновлює результати зі зміною транзакцій. Це може проявитися як оптимізація у Fava або демон, який плагіни редактора можуть запитувати. Можливо, майбутній випуск Fava використовуватиме безперервно працюючий процес Beancount, щоб зробити інтерфейс користувача більш чуйним для величезних облікових книг.
    • Облік фондів / функції для некомерційних організацій: Була пропозиція щодо вдосконалення обліку фондів у Beancount. Некомерційні організації мають облікові потреби (обмежені проти необмежених фондів), які потенційно можуть моделюватися за допомогою ієрархії тегів або рахунків Beancount. Обговорення ще не призвело до вбудованих функцій, але якщо більше некомерційних організацій почнуть використовувати Beancount, це може сприяти появі нових можливостей (можливо, просто задокументовані найкращі практики або плагіни для відстеження залишків фондів).
  • Довгострокова перспектива: Мартін Блейс натякнув, що бачить майбутнє Beancount у перетворенні ядра на своєрідний двигун та перенесенні більшої функціональності до плагінів. Це відповідає тому, що ми бачимо (модуляризація у v3). Отже, "майбутня функція" у філософському сенсі – це більша розширюваність – можливо, навіть дозволяючи плагінам визначати нові типи директив або розширювати синтаксис контрольованими способами. Якщо це станеться, ядро Beancount може залишатися відносно невеликим і стабільним, тоді як екосистема надаватиме більшість нових функцій як доповнення. Це може призвести до маркетплейсу плагінів або більш централізованого списку плагінів, щоб користувачі могли вибирати (список Awesome Beancount є початком цього).

На завершення, екосистема Beancount у 2025 році є активною та розвивається. Випуск Beancount 3.0 став важливою останньою подією, що забезпечила міцну основу проєкту на майбутнє. Покращення продуктивності, інструментів та зручності використання (особливо через Fava) продовжували знижувати поріг входу. Хоча Beancount залишається інструментом, який вимагає певних знань, він набагато доступніший зараз, ніж кілька років тому, завдяки цим розробкам. Майбутні функції, ймовірно, зосереджуватимуться на удосконаленні досвіду – швидша продуктивність, кращі інтеграції та спеціалізовані розширення – а не на кардинальних змінах до основної філософії. Траєкторія розвитку спільноти св

Розуміння дебіторської та кредиторської заборгованості в Beancount

· 3 min read
Mike Thrift
Mike Thrift
Marketing Manager

Привіт усім! У сьогоднішньому дописі блогу ми занурюємося у світ Beancount, інструменту подвійного запису, який багато хто любить за його простоту та потужність. Зокрема, ми поговоримо про дві ключові концепції: дебіторську та кредиторську заборгованість.

Розуміння цих термінів є вирішальним для ефективного використання Beancount (або будь-якої системи подвійного запису). Але не хвилюйтеся, якщо ви новачок – ми розберемо все крок за кроком!

Дебіторська та кредиторська заборгованість: Основи

2023-05-30-receiveable-and-payable

В обліку «дебіторська заборгованість» та «кредиторська заборгованість» — це терміни, що використовуються для відстеження грошей, які належать. «Дебіторська заборгованість» стосується грошей, які інші винні вам, тоді як «кредиторська заборгованість» стосується грошей, які ви винні іншим.

Розглянемо приклад:

  1. Рахунки дебіторської заборгованості (A/R): Припустимо, ви володієте книжковим магазином, і клієнт купує книгу в кредит. Гроші, які вони винні вам за книгу, є рахунком дебіторської заборгованості.

  2. Рахунки кредиторської заборгованості (A/P): З іншого боку, уявіть, що ви замовляєте новий набір книг у видавця, але не платите за них одразу. Гроші, які ви винні видавцю, є рахунком кредиторської заборгованості.

У Beancount вони зазвичай відстежуються за допомогою відповідних рахунків. Основна перевага полягає в тому, що це надає вам чітку та точну картину вашого фінансового стану в будь-який момент часу.

Налаштування дебіторської та кредиторської заборгованості в Beancount

Структура вашого файлу Beancount може бути настільки простою або складною, наскільки вам це потрібно. Для дебіторської та кредиторської заборгованості ви, ймовірно, захочете створити окремі рахунки в розділах «Активи» та «Зобов'язання».

Ось простий приклад:

1970-01-01 open Assets:AccountsReceivable
1970-01-01 open Liabilities:AccountsPayable

Відстеження транзакцій

Сторона одержувача

Після налаштування рахунків ви можете відстежувати транзакції, що стосуються дебіторської та кредиторської заборгованості. Розглянемо приклад:

2023-05-29 * "Продано книги клієнту в кредит"
Assets:AccountsReceivable 100 USD
Income:BookSales -100 USD

Тут ви додаєте 100 доларів до своєї дебіторської заборгованості, оскільки клієнт винен вам цю суму. Одночасно ви зменшуєте свій дохід на ту саму суму, щоб підтримувати баланс (оскільки ви ще не отримали грошей).

Коли клієнт зрештою заплатить, ви запишете це так:

2023-06-01 * "Отримано платіж від клієнта"
Assets:Bank:Savings 100 USD
Assets:AccountsReceivable -100 USD

Сторона платника

Той самий принцип застосовується до кредиторської заборгованості, але з протилежними знаками:

2023-05-30 * "Куплено книги у видавця в кредит"
Liabilities:AccountsPayable 200 USD
Expenses:BookPurchases -200 USD

І коли ви погашаєте свій борг:

2023-06-02 * "Погашено борг перед видавцем"
Liabilities:AccountsPayable -200 USD
Assets:Bank:Checking 200 USD

Підсумок

Дебіторська та кредиторська заборгованість є основою будь-якої облікової системи. Точно відстежуючи їх, ви отримуєте повне розуміння свого фінансового стану.

Це лише відправна точка, і Beancount здатний набагато більше. Сподіваюся, цей допис у блозі допоможе прояснити ці важливі концепції. Як завжди, успішного обліку!

Деконструкція облікової книги Beancount: Приклад для бізнес-бухгалтерії

· 3 min read
Mike Thrift
Mike Thrift
Marketing Manager

У сьогоднішньому дописі в блозі ми розберемо облікову книгу Beancount для бізнесу, що допоможе вам зрозуміти тонкощі цієї системи обліку подвійним записом у текстовому форматі.

Деконструкція облікової книги Beancount: Приклад для бізнес-бухгалтерії

Почнемо з коду:

2023-05-22-business-template

1970-01-01 open Assets:Bank:Mercury
1970-01-01 open Assets:Crypto

1970-01-01 open Equity:Bank:Chase

1970-01-01 open Income:Stripe
1970-01-01 open Income:Crypto:ETH

1970-01-01 open Expenses:COGS
1970-01-01 open Expenses:COGS:Contabo
1970-01-01 open Expenses:COGS:AmazonWebServices

1970-01-01 open Expenses:BusinessExpenses
1970-01-01 open Expenses:BusinessExpenses:ChatGPT

2023-05-14 * "CONTABO.COM" "Mercury Checking ••1234"
Expenses:COGS:Contabo 17.49 USD
Assets:Bank:Mercury -17.49 USD

2023-05-11 * "Amazon Web Services" "Mercury Checking ••1234"
Expenses:COGS:AmazonWebServices 14490.33 USD
Assets:Bank:Mercury -14490.33 USD

2023-03-01 * "STRIPE" "Mercury Checking ••1234"
Income:Stripe -21230.75 USD
Assets:Bank:Mercury 21230.75 USD

2023-05-18 * "customer_182734" "0x5190E84918FD67706A9DFDb337d5744dF4EE5f3f"
Assets:Crypto -19 ETH {1,856.20 USD}
Income:Crypto:ETH 19 ETH @@ 35267.8 USD

Розуміння коду

  1. Відкриття рахунків: Код починається з відкриття серії рахунків 01.01.1970. До них входять як рахунки активів (Assets:Bank:Mercury та Assets:Crypto), так і рахунок власного капіталу (Equity:Bank:Chase), рахунки доходів (Income:Stripe та Income:Crypto:ETH), а також рахунки витрат (Expenses:COGS, Expenses:COGS:AmazonWebServices, Expenses:BusinessExpenses та Expenses:BusinessExpenses:ChatGPT).

  2. Транзакції: Далі реєструється серія транзакцій між 01.03.2023 та 18.05.2023.

    • Транзакція від 14.05.2023 представляє платіж у розмірі 17.49 USD на адресу CONTABO.COM з рахунку Mercury Checking ••1234. Це реєструється як витрата (Expenses:COGS:Contabo) та відповідне списання з рахунку Assets:Bank:Mercury.

    • Аналогічно, транзакція від 11.05.2023 представляє платіж у розмірі 14490.33 USD на адресу Amazon Web Services з того ж банківського рахунку. Це реєструється під Expenses:COGS:AmazonWebServices.

    • Транзакція від 01.03.2023 показує надходження доходу від STRIPE, який був зарахований на рахунок Mercury Checking ••1234, на загальну суму 21230.75 USD. Це реєструється як дохід (Income:Stripe) та додаток до банківського рахунку (Assets:Bank:Mercury).

    • Остання транзакція від 18.05.2023 представляє криптотранзакцію, що включає 19 ETH від клієнта. Це відстежується під Assets:Crypto та Income:Crypto:ETH. {1,856.20 USD} показує ціну ETH на момент транзакції, тоді як @@ 35267.8 USD вказує загальну вартість транзакції 19 ETH.

У всіх транзакціях дотримується принцип подвійного запису, що гарантує постійне дотримання рівняння Активи = Зобов'язання + Власний капітал.

Заключні думки

Ця облікова книга Beancount надає просту, але надійну систему для відстеження фінансових транзакцій. Як видно з останньої транзакції, Beancount є достатньо гнучким, щоб враховувати нетрадиційні активи, такі як криптовалюта, що є свідченням його корисності в нашому дедалі більш цифровому фінансовому ландшафті.

Ми сподіваємося, що цей розбір допоможе вам краще зрозуміти структуру та можливості Beancount, незалежно від того, чи є ви досвідченим бухгалтером, чи новачком, який намагається відстежувати свої особисті фінанси. Залишайтеся з нами для нашого наступного допису в блозі, де ми заглибимося в розширені операції Beancount.

Шпаргалка Beancount

· 2 min read
Mike Thrift
Mike Thrift
Marketing Manager

Приклад назви рахунку

Assets:US:BofA:Checking

шпаргалка-uk

Типи рахунків

Assets          +
Liabilities -
Income -
Expenses +
Equity -

Товари

CNY, EUR, CAD, AUD
GOOG, AAPL, RBF1005
HOME_MAYST, AIRMILES
HOURS

Директиви

Загальний синтаксис

YYYY-MM-DD <Directive> <Parameters...>

Відкриття та закриття рахунків

2001-05-29 open Expenses:Restaurant
2001-05-29 open Assets:Checking USD,EUR ; Обмеження за валютою

2015-04-23 close Assets:Checking

Оголошення товарів (Необов'язково)

1998-07-22 commodity AAPL
name: "Apple Computer Inc."

Ціни

2015-04-30 price AAPL   125.15 CNY
2015-05-30 price AAPL 130.28 CNY

Примітки

2013-03-20 note Assets:Checking "Зателефонував, щоб запитати про знижку"

Документи

2013-03-20 document Assets:Checking "шлях/до/виписки.pdf"

Транзакції

2015-05-30 * "Деякий опис цієї транзакції"
Liabilities:CreditCard -101.23 CNY
Expenses:Restaurant 101.23 CNY

2015-05-30 ! "Cable Co" "Phone Bill" #tag ˆlink
id: "TW378743437" ; Метадані
Expenses:Home:Phone 87.45 CNY
Assets:Checking ; Ви можете пропустити одну суму

Проводки

  ...    123.45 USD                             Просто
... 10 GOOG {502.12 USD} З вартістю за одиницю
... 10 GOOG {{5021.20 USD}} З загальною вартістю
... 10 GOOG {502.12 # 9.95 USD} З обома вартостями
... 1000.00 USD @ 1.10 CAD З ціною за одиницю
... 10 GOOG {502.12 USD} @ 1.10 CAD З вартістю та ціною
... 10 GOOG {502.12 USD, 2014-05-12} З датою
! ... 123.45 USD ... З прапорцем

Твердження балансу та доповнення

; Перевіряє суму лише для вказаної валюти:
2015-06-01 balance Liabilities:CreditCard -634.30 CNY

; Автоматичне вставлення транзакції для виконання наступного твердження:
2015-06-01pad Assets:Checking Equity:Opening-Balances

Події

2015-06-01 event "місцезнаходження" "Нью-Йорк, США"
2015-06-30 event "адреса" "123 Мей Стріт"

Опції

option "заголовок" "Моя особиста книга обліку"

Інше

pushtag #поїздка-до-перу
...
poptag #поїздка-до-перу
; Коментарі починаються з крапки з комою

Магія обліку в текстових файлах з Beancount

· 5 min read
Mike Thrift
Mike Thrift
Marketing Manager

Відкрийте для себе магію обліку в текстових файлах з Beancount

Банер Beancount.io

Вступ

2023-04-18-вступ-до-beancount

Ласкаво просимо у світ, де бухгалтерський облік більше не є складним завданням. Сьогодні ми представляємо вам Beancount — потужний, гнучкий та інтуїтивно зрозумілий інструмент для обліку в текстових файлах. Beancount дає вам можливість контролювати свої фінанси, пропонуючи прозорий та простий підхід до управління вашими грошима.

У цьому вичерпному посібнику ми заглибимося в основи Beancount, пояснимо його ключові концепції та проведемо вас через його прості, але потужні функції. До кінця цього блогу ви матимете глибоке розуміння Beancount і будете готові почати використовувати його для організації та аналізу свого фінансового життя.

Що таке Beancount?

Beancount — це система обліку в текстових файлах з відкритим вихідним кодом, створена Мартіном Блезом (Martin Blais). Натхненний системою Ledger Джона Віглі (John Wiegley), Beancount прагне забезпечити надійний і стійкий метод управління особистими фінансами та фінансами малого бізнесу за допомогою текстових файлів. За допомогою Beancount ви можете легко відстежувати свої доходи, витрати, інвестиції та багато іншого.

Чому Beancount?

Облік у текстових файлах має кілька переваг перед традиційними системами обліку на основі електронних таблиць або програмного забезпечення:

  • Прозорість: Файли Beancount є зрозумілими для людини, що полегшує розуміння та аудит ваших фінансових даних.
  • Гнучкість: Beancount легко налаштовується відповідно до ваших конкретних потреб, і ви можете використовувати свій улюблений текстовий редактор та систему контролю версій для управління своїми фінансовими даними.
  • Портативність: Ваші фінансові дані доступні на будь-якому пристрої, і їх легко переносити між системами або ділитися ними з іншими.
  • Стійкість до майбутніх змін: Текстові файли є універсально сумісними, що гарантує доступність ваших фінансових даних, навіть коли технології розвиваються.

Основні концепції Beancount

Щоб ефективно використовувати Beancount, важливо зрозуміти його основні концепції:

  • Транзакції: Фінансові події, такі як доходи, витрати або перекази між рахунками, записуються як транзакції.
  • Рахунки: Транзакції включають один або кілька рахунків, таких як активи, зобов'язання, доходи або витрати.
  • Подвійний запис: Beancount застосовує подвійний запис, гарантуючи, що кожна транзакція має збалансовані дебети та кредити.
  • Директиви: Beancount використовує набір директив для визначення транзакцій, відкриття рахунків та інших фінансових подій.

Початок роботи з Beancount

Щоб почати використовувати Beancount, виконайте ці прості кроки:

  • Встановіть Beancount: Встановіть Beancount на свою систему, використовуючи надані інструкції з встановлення для вашої операційної системи.
  • Створіть свій файл Beancount: Створіть новий текстовий файл з розширенням .beancount (наприклад, my_finances.beancount).
  • Визначте свої рахунки: Використовуйте директиву "open" для визначення рахунків, які ви будете використовувати у своїх транзакціях.
  • Записуйте транзакції: Використовуйте директиву "txn" для запису ваших фінансових транзакцій.

Або просто зареєструйтесь на https://beancount.io. Ось кілька прикладів обліку в текстових файлах -

Приклад 1: Базова транзакція

2023-04-01 open Assets:Checking
2023-04-01 open Expenses:Groceries

2023-04-10 txn "Grocery Store" "Buying groceries"
Assets:Checking -50.00 USD
Expenses:Groceries 50.00 USD

У цьому прикладі ми відкриваємо два рахунки: Assets:Checking (Активи:Поточний) та Expenses:Groceries (Витрати:Продукти). 10 квітня 2023 року ми записуємо транзакцію на купівлю продуктів на суму 50 доларів США. Транзакція зменшує залишок на рахунку Assets:Checking на 50 доларів США (дебет) та збільшує залишок на рахунку Expenses:Groceries на 50 доларів США (кредит).

Приклад 2: Транзакція доходу та витрат

2023-04-01 open Assets:Checking
2023-04-01 open Income:Salary
2023-04-01 open Expenses:Rent

2023-04-05 txn "Employer" "Salary payment"
Assets:Checking 2000.00 USD
Income:Salary -2000.00 USD

2023-04-06 txn "Landlord" "Monthly rent payment"
Assets:Checking -1000.00 USD
Expenses:Rent 1000.00 USD

У цьому прикладі ми відкриваємо три рахунки: Assets:Checking (Активи:Поточний), Income:Salary (Дохід:Зарплата) та Expenses:Rent (Витрати:Оренда). 5 квітня 2023 року ми записуємо транзакцію виплати зарплати на суму 2000 доларів США. Транзакція збільшує залишок на рахунку Assets:Checking на 2000 доларів США (кредит) та зменшує залишок на рахунку Income:Salary на 2000 доларів США (дебет). 6 квітня 2023 року ми записуємо транзакцію оплати оренди на суму 1000 доларів США. Транзакція зменшує залишок на рахунку Assets:Checking на 1000 доларів США (дебет) та збільшує залишок на рахунку Expenses:Rent на 1000 доларів США (кредит).

Приклад 3: Переказ між рахунками

2023-04-01 open Assets:Checking
2023-04-01 open Assets:Savings

2023-04-15 txn "Bank" "Transfer from Checking to Savings"
Assets:Checking -500.00 USD
Assets:Savings 500.00 USD

У цьому прикладі ми відкриваємо два рахунки: Assets:Checking (Активи:Поточний) та Assets:Savings (Активи:Ощадний). 15 квітня 2023 року ми записуємо транзакцію переказу 500 доларів США з поточного рахунку на ощадний. Транзакція зменшує залишок на рахунку Assets:Checking на 500 доларів США (дебет) та збільшує залишок на рахунку Assets:Savings на 500 доларів США (кредит).

Ці приклади ілюструють основні концепції системи подвійного запису Beancount. Правильно записуючи транзакції, користувачі можуть вести точні записи своєї фінансової діяльності та генерувати звіти для отримання уявлення про свій фінансовий стан.

Генерування звітів та аналіз даних

Beancount постачається з набором потужних інструментів для генерування фінансових звітів, включаючи баланси, звіти про прибутки та збитки тощо. Ви також можете використовувати Fava, веб-інтерфейс для Beancount, для візуалізації та взаємодії з вашими фінансовими даними. https://beancount.io побудовано на основі Fava з ліцензією MIT.

Висновок

Прийміть силу та простоту обліку в текстових файлах з Beancount. Розуміючи його основні концепції та дотримуючись кроків, викладених у цьому посібнику, ви будете на правильному шляху до легкого та точного управління своїми особистими фінансами або фінансами малого бізнесу. Коли ви освоїте Beancount, ви зможете досліджувати розширені функції та налаштування, щоб адаптувати систему до ваших унікальних потреб.

Незалежно від того, чи хочете ви відстежувати свої витрати, планувати майбутнє або отримувати уявлення про свої фінансові звички, Beancount пропонує гнучкість та прозорість, необхідні для досягнення ваших цілей. Завдяки своєму зручному підходу, Beancount має потенціал революціонізувати спосіб управління вашими фінансами та дати вам можливість взяти під контроль своє фінансове майбутнє.

Тепер, коли у вас є міцна основа в Beancount, настав час розпочати вашу подорож до обліку в текстових файлах. Попрощайтеся з громіздкими електронними таблицями та заплутаним програмним забезпеченням, і вітайте світ Beancount. Щасливого обліку!

Вступ до Beancount.io

· 5 min read
Mike Thrift
Mike Thrift
Marketing Manager

Чому сучасний бухгалтерський облік важливий

Все ще керуєте своїми інвестиціями за допомогою електронних таблиць? Хоча електронні таблиці є універсальними, вони можуть стати громіздкими та схильними до помилок у міру зростання вашого інвестиційного портфеля. Представляємо Beancount.io – складну, але зручну у використанні платформу для відстеження інвестицій, розроблену спеціально для управління портфелями акцій та криптовалют. Створена з урахуванням потреб інженерів та фінансових мінімалістів, Beancount.io поєднує потужні функції з інтуїтивно зрозумілим інтерфейсом для оптимізації вашого досвіду відстеження інвестицій.

2019-09-07-introduction-to-beancount

Expenses

Income Statement

Balance Sheet

Подвійний запис: Основа точності

Beancount.io побудований на принципах подвійного запису – перевіреної часом методології, що використовується фінансовими установами по всьому світу. Ця система забезпечує математичну точність завдяки простій, але потужній концепції: кожна фінансова транзакція повинна ідеально балансувати.

У подвійному записі кожна транзакція вимагає щонайменше двох записів – дебету (+) та кредиту (-) – на різних рахунках. Ця вбудована система перевірки робить практично неможливим запис незбалансованих транзакцій, забезпечуючи точність та надійність ваших фінансових записів.

1970-01-01 open Income:BeancountCorp
1970-01-01 open Assets:Cash
1970-01-01 open Expenses:Food
1970-01-01 open Assets:Receivables:Alice
1970-01-01 open Assets:Receivables:Bob
1970-01-01 open Assets:Receivables:Charlie
1970-01-01 open Liabilities:CreditCard

2019-05-31 * "BeancountCorp" "Salary of May 15th to May 31st"
Income:BeancountCorp -888 USD
Assets:Cash 888 USD

2019-07-12 * "Popeyes chicken sandwiches" "dinner with Alice, Bob, and Charlie"
Expenses:Food 20 USD
Assets:Receivables:Alice 20 USD
Assets:Receivables:Bob 20 USD
Assets:Receivables:Charlie 20 USD
Liabilities:CreditCard -80 USD

Як ви можете бачити у двох прикладах вище, кожна транзакція повинна відповідати бухгалтерському рівнянню.

Assets = Liabilities + Equity(aka Net Assets)

Ми використали синтаксис Beancount від Мартіна Блейса та веб-проєкт Fava від Якоба Шнітцера для створення цього веб-сайту. І він сповістить вас, якщо будь-яка транзакція матиме будь-які частини, що не сумуються до нуля.

Error Alert

Тепер ви розумієте, як ми забезпечуємо коректність головної книги. Але ви можете запитати, що таке ці "рахунки"?

Розуміння рахунків: Аналогія з відрами води

Уявіть свої фінансові рахунки як систему взаємопов'язаних відер з водою, де гроші течуть як вода між ними. Ця аналогія робить подвійний запис інтуїтивно зрозумілим: коли ви переказуєте гроші з одного рахунку на інший, це схоже на переливання води з одного відра в інше – загальна кількість води (грошей) у системі залишається постійною.

Beancount.io пропонує п'ять типів рахунків.

  1. Доходи — Їх сума завжди від'ємна або в дебеті. Це тому, що ви заробляєте гроші, і тоді гроші дебетуються з рахунку "Доходи" та кредитуються на ваші "Активи".
  2. Витрати — Їх сума завжди позитивна або в кредиті. Це тому, що ви витрачаєте гроші, і гроші надходять з "Активів" або "Зобов'язань" на "Витрати".
  3. Зобов'язання — Їх сума позитивна або нульова. Ваші зобов'язання за кредитною карткою є хорошим прикладом, які зростають і падають циклами.
  4. Активи — Їх сума позитивна або нульова. Ваші готівкові кошти або будинки завжди мають певну вартість.
  5. Власний капітал — Ваші чисті активи. Система розрахує це автоматично для вас. Власний капітал = Активи - Зобов'язання, і це відображає ваш рівень достатку.

Тепер ви можете відкрити свої індивідуальні рахунки за допомогою цих ключових слів вище:

1970-01-01 open Assets:Cash
1970-01-01 open Assets:Stock:Robinhood
1970-01-01 open Assets:Crypto:Coinbase
1970-01-01 open Expenses:Transportation:Taxi
1970-01-01 open Equity:OpeningBalance

Розширене відстеження інвестицій за допомогою активів

Beancount.io чудово відстежує різноманітні інвестиції, від акцій до криптовалют. Давайте розглянемо, як він обробляє складні інвестиційні сценарії. Наприклад, ось як ви б записали купівлю 10 біткоїнів по 100 доларів кожен у 2014 році:

2014-08-08 * "Buy 10 Bitcoin"
Assets:Trade:Cash -1000.00 USD
Assets:Trade:Positions 10 BTC {100.00 USD}

А потім, через три роки, ви продаєте їх (спочатку з витратами 100 доларів за одиницю, позначеними {100.00 USD}) за ціною 10 000 доларів за одиницю, позначеною @ 10,000.00 USD.

2017-12-12 * "Sell 2 Bitcoin"
Assets:Trade:Positions -2 BTC {100.00 USD} @ 10,000.00 USD
Assets:Trade:Cash 20,000.00 USD
Income:Trade:PnL -19,800.00 USD

Або та ж транзакція з @@ 20,000.00 USD означає, що за ціною 20 000 доларів загалом.

2017-12-12 * "Sell 2 Bitcoin"
Assets:Trade:Positions -2 BTC {100.00 USD} @@ 20,000.00 USD
Assets:Trade:Cash 20,000.00 USD
Income:Trade:PnL -19,800.00 USD

Сума всіх частин транзакції, включаючи -2 BTC {100.00 USD}, все ще, як завжди, дорівнює нулю.

Тег витрат {100.00 USD} важливий, оскільки ви могли придбати той самий актив за різними цінами.

100 BTC {10.00 USD, 2012-08-08}
10 BTC {100.00 USD, 2014-08-08}

Якщо ви хочете спростити процес, ви можете налаштувати рахунок на початку з ФІФО або ЛІФО. ФІФО означає "першим прийшов — першим вийшов", тоді як ЛІФО означає "останнім прийшов — першим вийшов". У США Податкова служба використовує ФІФО для розрахунку ваших прибутків/збитків та відповідного оподаткування.

1970-01-01 open Assets:Trade:Positions "FIFO"

І тоді, коли ви продаєте його скорочено, наприклад -2 BTC {}, Beancount автоматично застосує стратегію ФІФО та продасть найстаріший актив.

Початок роботи з Beancount.io

Beancount.io – це сучасна хмарна платформа для управління фінансами, яка перетворює ваші текстові записи транзакцій на комплексні фінансові звіти, включаючи звіти про прибутки та збитки, баланси та оборотні відомості. Поєднуючи надійність текстових файлів з потужними інструментами візуалізації, Beancount.io допомагає вам підтримувати точний контроль над вашим фінансовим життям, отримуючи цінні відомості про ефективність ваших інвестицій.

Розпочніть свою фінансову подорож з Beancount.io – Безкоштовно під час нашого акційного періоду!