Шпаргалка по 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 * "Отель"
    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 с практическими примерами.