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 * "Grocery Store" "Ежеседмично пазаруване"
    Assets:Checking     -100.00 USD
    Expenses:Food:Groceries

# С метаданни и тагове
2024-01-15 * "Restaurant" "Бизнес вечеря" #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" "Ню Йорк, САЩ"

# Промени в собствеността
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" "Активи"
option "name_liabilities" "Пасиви"
option "name_income" "Приходи"
option "name_expenses" "Разходи"
option "name_equity" "Собствен капитал"

# Обработка на документи
option "documents" "/path/to/docs"

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

; Коментар на един ред

* Заглавие на секция
** Подсекция
; Следва блок транзакции...

; Групиране на сметки
; Активи
2024-01-15 ...

; Разходи
2024-01-16 ...

Тази справка предоставя пълен преглед на синтактичните елементи на Beancount с практически примери.