Конфигурация на опциите в Beancount

Поведението на Beancount може да бъде персонализирано чрез директиви option, поставени в горната част на основния ви файл на счетоводната книга. Тези двойки ключ-стойност контролират всичко - от имената на вашите основни сметки до това как се обработват конверсиите на валута. Правилното конфигуриране на тези опции е от съществено значение за приспособяването на Beancount към вашите специфични нужди. ⚙️

Основни опции за конфигуриране

Тези опции контролират основната настройка на вашата счетоводна книга.

Основни настройки

Това са някои от най-често срещаните опции, които ще зададете.

option "title" "Лична счетоводна книга"
option "render_commas" "TRUE"
option "plugin_processing_mode" "raw"

• title: Задава заглавието за отчети и уеб интерфейси.
• render_commas: Ако е TRUE, числата в отчетите ще бъдат форматирани с разделители на хилядите (напр. 1,000,000.00).
• plugin_processing_mode: Контролира начина на зареждане на добавките. raw зарежда само добавките, които изрично сте посочили, докато default включва стандартен набор от полезни добавки.

Персонализиране на имената на сметките

Можете да преименувате петте основни типа сметки на Beancount. Това е чисто козметично и променя начина, по който те се появяват в отчетите.

option "name_assets" "Активи"
option "name_liabilities" "Пасиви"
option "name_equity" "Собствен капитал"
option "name_income" "Приходи"
option "name_expenses" "Разходи"

Конфигурация на сметката за собствен капитал

Beancount автоматично създава няколко специални сметки за собствен капитал, за да обработва началните салда и изчисленията на приходите. Можете да зададете потребителски имена за тези сметки.

option "account_previous_balances" "Начални-Сальда"
option "account_previous_earnings" "Приходи:Предишни"
option "account_current_earnings" "Приходи:Текущи"
option "account_previous_conversions" "Конверсии:Предишни"
option "account_current_conversions" "Конверсии:Текущи"
option "account_rounding" "Закръгляне"

• account_previous_balances: Сметката, използвана за инжектиране на начални салда във вашата счетоводна книга.
• account_current_earnings: Сметката, която натрупва всички приходи и разходи за текущия период, като ефективно изчислява нетната ви печалба.
• account_rounding: Сметката, в която се осчетоводяват малки несъответствия от автоматизираното закръгляне.

Настройки за прецизност и толеранс

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

Конфигурация на толеранс по подразбиране

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

option "inferred_tolerance_default" "USD:0.01"
option "inferred_tolerance_multiplier" "1.1"
option "infer_tolerance_from_cost" "True"

• inferred_tolerance_default: Задава толеранса по подразбиране за дадена валута. Можете да използвате *:0.5, за да зададете стойност по подразбиране за всички валути.
• inferred_tolerance_multiplier: Фактор, приложен към толеранса, за да осигури малко по-голям марж на грешка.
• infer_tolerance_from_cost: Ако е True, толерансът ще бъде извлечен от броя на цифрите в цената.

Метод на осчетоводяване

Тази опция определя начина, по който Beancount обработва транзакции, при които единият крак е заключен.

option "booking_method" "SIMPLE"

• SIMPLE: Позволява автоматично балансиране само на една стока за транзакция. Това е препоръчителният и най-често срещан метод.
• FULL: Позволява балансиране на множество стоки, което е по-сложен и рядко необходим метод.

Управление на валути

Правилната конфигурация на валутата е от жизненоважно значение за точните отчети.

Оперативна валута

Можете да декларирате една или повече "оперативни валути". Това са основните валути, в които трансактирате и искате да виждате в отчетите.

option "operating_currency" "USD"
option "operating_currency" "EUR"
option "conversion_currency" "NOTHING"

Декларирането на оперативни валути казва на Beancount да създаде специални колони за тях в отчетите, което улеснява виждането на вашето финансово състояние във вашите най-използвани валути. Задаването на conversion_currency на NOTHING деактивира колоната за автоматично конвертиране, което често е предпочитано за по-чисти отчети.

Управление на документи

Beancount може да свързва транзакции с външни файлове, като разписки или фактури. Опцията documents указва основната(ите) папка(и), където се съхраняват тези файлове.

option "documents" "/path/to/documents/archive"

Изисквания:

• Файловете трябва да бъдат наименувани във формат YYYY-MM-DD.description.ext (напр. 2025-07-28.amazon-order.pdf).
• Можете да зададете множество опции documents за различни папки.
• Пътищата могат да бъдат абсолютни или относителни спрямо основния файл на счетоводната книга.

Система за добавки

Функционалността на Beancount може да бъде разширена с добавки.

Конфигурация на добавки

Активирате добавка, като зададете нейния модулен път.

option "plugin" "beancount.plugins.module_name"

Както бе споменато по-рано, опцията plugin_processing_mode контролира дали Beancount зарежда само вашите зададени добавки (raw) или и набор по подразбиране (default).

Технически ограничения

Тези опции контролират техническите аспекти на Beancount парсера.

Обработка на низове

Можете да зададете ограничение за броя на редовете, разрешени в многоредов низ, за да предотвратите грешки при синтактичния анализ.

option "long_string_maxlines" "64"

Експериментални функции

Beancount понякога включва експериментални функции, които можете да активирате с опция. Например, за да активирате изричен синтаксис за толеранс:

option "experiment_explicit_tolerances" "True"

Това ви позволява да зададете толеранс директно в осчетоводяването на транзакция, като това: 532.23 ~ 0.001 USD.

Контроли на системното поведение

Тези опции са за поддържане на съвместимост или специфично системно поведение.

Поддръжка на наследени данни

Тази опция активира старите, фиксирани стойности на толеранс за обратна съвместимост със стари счетоводни книги.

option "use_legacy_fixed_tolerances" "True"

Фиксираните толеранси за наследени данни бяха:

• Директиви Balance/Pad: 0.015 единици
• Транзакции: 0.005 единици

Препоръчителна конфигурация ✅

За повечето потребители следната конфигурация осигурява стабилна и разумна отправна точка.

Основна настройка

option "title" "Лична счетоводна книга"
option "operating_currency" "USD"  // Променете на основната си валута
option "documents" "/home/user/Documents/beancount" // Променете на пътя към вашите документи
option "render_commas" "TRUE"

Контрол на прецизността

option "inferred_tolerance_default" "USD:0.01" // Променете на основната си валута
option "inferred_tolerance_multiplier" "1.1"
option "infer_tolerance_from_cost" "True"

Структура на сметките

option "account_previous_balances" "Собствен капитал:Начални-Сальда"
option "account_current_earnings" "Собствен капитал:Текущи-Приходи"
option "account_rounding" "Разходи:Закръгляне"

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