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

Швидкий старт

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

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

Перегляд журналу beancount.io зі списком транзакцій подвійного запису та фільтрами за типами директив

Дослідіть живий реєстр →

Початкове налаштування​

Створення вашого першого реєстру​

; Basic structure for a new ledger
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances
 
2024-01-02 * "Initial Deposit"
  Assets:Checking           100.00 USD
  Equity:Opening-Balances

Основна конфігурація​

option "title" "Personal Finance Ledger"
option "operating_currency" "USD"

Організація файлів​

Рекомендована структура​

; 1. Configuration Options
option "title" "Personal Ledger"
option "operating_currency" "USD"
 
; 2. Account Declarations
2024-01-01 open Assets:Checking    USD
2024-01-01 open Assets:Savings     USD
2024-01-01 open Expenses:Food      USD
2024-01-01 open Equity:Opening-Balances
 
; 3. Initial Balances
; Pad fills the gap up to Equity:Opening-Balances, so it must be dated
; before the assertion. Balance assertions are checked at the start of
; their day, so assert the next morning.
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-02 balance Assets:Checking 1000.00 USD
 
; 4. Transactions
2024-01-15 * "Grocery Store" "Weekly groceries"
  Expenses:Food            50.00 USD
  Assets:Checking

Розділ 1. Постійні рахунки​

2024-01-01 open Liabilities:Payables    USD
2024-01-01 open Assets:Receivables      USD

Розділ 2. Банківські рахунки​

2024-01-01 open Assets:Bank:Checking     USD
2024-01-01 open Assets:Bank:Savings      USD
2024-01-01 open Income:Bank:Interest     USD

Розділ 3. Інвестиційні рахунки​

2024-01-01 open Assets:Investment:Cash    USD
2024-01-01 open Assets:Investment:Stocks  VTSAX
2024-01-01 open Income:Investment:Dividend USD

Валідація та звітність​

Базова валідація​

# Check for errors (prints nothing and exits 0 when clean)
bean-check ledger.beancount
 
# Browse balances, reports, and charts in the web interface
fava ledger.beancount

bean-check — це валідатор: він нічого не виводить і завершується з кодом 0, якщо реєстр чистий, або виводить список помилок і завершується з ненульовим кодом в іншому випадку. Fava — це веб-інтерфейс — запустіть його та відкрийте вказану адресу http://localhost:5000 для перегляду балансу, звіту про прибутки та збитки та журналу рахунків.

Стандартні звіти​

Beancount 3 формує звіти через веб-інтерфейс Fava або за допомогою ad-hoc запитів через bean-query, який використовує мову запитів Beancount. Старі команди bean-report та bean-web було видалено в Beancount 3, тому наведені нижче команди замінюють їх.

# Balance-sheet numbers: balances by asset, liability, and equity account
bean-query ledger.beancount "SELECT account, sum(position) AS balance WHERE account ~ '^(Assets|Liabilities|Equity)' GROUP BY account ORDER BY account"
 
# Income-statement numbers: totals by income and expense account
bean-query ledger.beancount "SELECT account, sum(position) AS total WHERE account ~ '^(Income|Expenses)' GROUP BY account ORDER BY account"
 
# One account's journal, with a running balance
bean-query ledger.beancount "SELECT date, narration, position, balance WHERE account = 'Assets:Checking'"

Керування початковими залишками​

Приклад вирівнювання​

2024-01-01 open Assets:Checking    USD
2024-01-01 open Equity:Opening-Balances
 
; Pad account to match a known balance
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Assert the known balance the next day: assertions are evaluated at the
; start of their date, and the pad transaction must fall before it
2024-01-02 balance Assets:Checking 1525.00 USD

Директива balance перевіряє залишок рахунку на початок вказаної дати, тому вона має бути датована після директиви pad (або будь-якої транзакції), яку вона має враховувати. Якщо датувати pad та balance одним днем, директива pad не буде застосована, і перевірка balance завершиться помилкою — Beancount повідомить Unused Pad entry та Balance failed. Рахунок Equity:Opening-Balances має бути відкритий до того, як до нього буде застосовано pad.

Закриття рахунку​

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking  ; Account closed

Дедуплікація транзакцій​

Обробка переказів​

; Credit card payment - combined view
2024-01-15 * "Credit Card Payment"
  Assets:Checking            -500.00 USD
  Liabilities:CreditCard     500.00 USD
 
; Flag for pending match
2024-01-15 * "Pending CC Payment"
  ! Assets:Checking         -500.00 USD
  Liabilities:CreditCard    500.00 USD

Перевірка залишків​

; Regular balance checks prevent duplicates
2024-01-31 balance Assets:Checking    2150.25 USD
2024-01-31 balance Liabilities:CreditCard  -350.00 USD

Найкращі практики​

  1. Організація файлів

    • Спочатку тримайте один основний файл
    • Використовуйте зрозумілі заголовки розділів
    • Групуйте пов'язані рахунки разом

  2. Назви рахунків

    • Використовуйте узгоджені правила найменування
    • Включайте префікси країни/установи
    • Підтримуйте логічну ієрархію

  3. Перевірка балансів

    • Регулярно виконуйте перевірку залишків
    • Належним чином вирівнюйте рахунки
    • Відстежуйте закриття рахунків

  4. Робота з валютами

    • Оголошуйте робочі валюти
    • Використовуйте узгоджені коди валют
    • Вказуйте курси обміну, де це необхідно

Наступні кроки​

Тепер, коли у вас є базовий реєстр:

  1. Записуйте регулярні транзакції: Почніть зі своїх щоденних витрат та доходів
  2. Налаштуйте імпорт банківських виписок: Використовуйте CSV-імпорт або банківські з'єднання для автоматизації введення даних. Вставте виписку у конвертер CSV у Beancount, щоб отримати збалансовані записи у вашому браузері, або скористайтеся OFX та QIF у Beancount для завантаження файлів .ofx, .qfx та .qif.
  3. Скопіюйте перевірений шаблон: Завантажте готовий стартовий файл із розділів домашні фінанси, бюджетування за конвертами або фріланс у прикладах робочих реєстрів, а потім адаптуйте патерни з цієї галереї під свої потреби
  4. Вивчіть розширений синтаксис: Ознайомтеся з довідником із синтаксису для складніших сценаріїв
  5. Сформуйте свої перші звіти: Використовуйте функції інтерфейсу для створення фінансових звітів та аналізу своїх витрат

Довідник​

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

  • Assets:Bank:Checking — ваш поточний рахунок
  • Expenses:Food:Groceries — витрати на продукти
  • Income:Salary:Company — дохід від зарплати
  • Liabilities:CreditCard:Visa — борг за кредитною карткою

Основні команди:

  • bean-check ledger.beancount — перевірка реєстру (завершується з ненульовим кодом за наявності помилок)
  • fava ledger.beancount — запуск веб-інтерфейсу для перегляду звітів та графіків
  • bean-query ledger.beancount "SELECT ..." — виконання запитів до балансів та транзакцій

Ці рекомендації створюють міцну основу для керування особистими фінансами за допомогою Beancount. Готові додати свою першу транзакцію? Перегляньте наш посібник із додавання першої транзакції.

Швидкий старт

Джерело: https://beancount.io/uk/docs/Basics/getting-started