Перейти до основного вмісту
Beancount.io LogoBeancount.io
Шпаргалка

Шпаргалка

Вичерпна шпаргалка Beancount зі структурами рахунків, синтаксисом транзакцій, командами та практичними прикладами для обліку у вигляді простого тексту та ведення фінансових записів.

Структура рахунків

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

Тип             Знак    Приклад
------------------------------------------------
Активи          (+)     Assets:US:BofA:Checking
Зобов'язання    (-)     Liabilities:Credit:Amex
Дохід           (-)     Income:Salary:Gross
Витрати         (+)     Expenses:Food:Restaurant
Власний капітал (-)     Equity:Opening-Balances

Формат валют/цінностей

# Фінансові
USD, EUR, CAD, AUD     # Стандартні валюти
GOOG, AAPL, VTI       # Інвестиційні інструменти
BTC, ETH              # Криптовалюти
 
# Кастомний облік
HOURS                 # Облік часу
AIRMILES             # Бонусні бали
HOME_MAYST           # Нерухомість

Синтаксис директив

Управління рахунками

# Відкриття рахунків
2024-01-01 open Assets:Checking            # Простий
2024-01-01 open Assets:Investing USD,GOOG  # З обмеженнями
 
# Закриття рахунків
2024-12-31 close Assets:Old:Account

Оголошення валют/цінностей

2024-01-01 commodity VTSAX
    name: "Vanguard Total Stock Market Index"
    asset-class: "equity"

Запис транзакцій

# Базова транзакція
2024-01-15 * "Продуктовий магазин" "Щотижневі покупки"
    Assets:Checking     -100.00 USD
    Expenses:Food:Groceries
 
# З метаданими та тегами
2024-01-15 * "Ресторан" "Ділова вечеря" #work ^invoice-123
    id: "T-1234"
    receipt: "path/to/receipt.pdf"
    Expenses:Meals      80.00 USD
    Liabilities:Credit

Специфікації проводок

# Базова сума
Assets:Cash              100.00 USD
 
# Облік собівартості
Assets:Invest:VTSAX      10 VTSAX {100.00 USD}        # За одиницю
Assets:Invest:VTSAX      10 VTSAX {{1000.00 USD}}     # Загальна вартість
Assets:Invest:VTSAX      10 VTSAX {100.00 # 9.95 USD} # З комісіями
 
# Специфікації ціни
Assets:Forex            1000.00 USD @ 0.85 EUR        # За одиницю
Assets:Forex            1000.00 USD @@ 850.00 EUR     # Загальна ціна
 
# Датовані партії
Assets:Invest:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

Перевірка балансу

# Підтвердження балансу
2024-01-31 balance Assets:Checking  1000.00 USD
 
# Заповнення балансу
2024-01-01 pad Assets:Checking Equity:Opening-Balances

Облік метаданих

# Прикріплення нотатки
2024-01-15 note Assets:Checking "Зателефонував до банку щодо комісії"
 
# Прив'язка документу
2024-01-15 document Assets:Checking "path/to/statement.pdf"
 
# Запис ціни
2024-01-15 price VTSAX  100.00 USD

Запис подій

# Відстеження місцезнаходження
2024-01-15 event "location" "New York, USA"
 
# Зміни властивостей
2024-01-15 event "address" "123 Main Street"

Управління тегами

# Контроль області дії тега
pushtag #vacation
2024-01-15 * "Hotel"
    Expenses:Travel:Lodging   200.00 USD
    Assets:Credit
poptag #vacation

Параметри конфігурації

# Базові налаштування
option "title" "Персональна фінансова книга"
option "operating_currency" "USD"
 
# Найменування рахунків
option "name_assets" "Assets"
option "name_liabilities" "Liabilities"
option "name_income" "Income"
option "name_expenses" "Expenses"
option "name_equity" "Equity"
 
# Обробка документів
option "documents" "/path/to/docs"

Коментарі та організація

; Однорядковий коментар
 
* Заголовок розділу
** Підрозділ
; Далі йде блок транзакцій...
 
; Групування рахунків
; Активи
2024-01-15 ...
 
; Витрати
2024-01-16 ...

Цей довідник надає повний огляд синтаксичних елементів Beancount з практичними прикладами.