2 записи с тегом "ledger"

Что это такое, когда это выгодно и как правильно моделировать это в вашем журнале (с примерами).

⚠️ Это руководство предназначено только для пользователей из США и носит исключительно образовательный характер. Проконсультируйтесь с налоговым специалистом по вашей конкретной ситуации.

TL;DR (кратко)​

• S-corp - это налоговый статус, который вы выбираете в IRS (через форму 2553), чтобы прибыль бизнеса переходила в личные налоговые декларации владельцев. Ключевое требование заключается в том, что вы должны выплачивать владельцам-операторам разумную зарплату по форме W-2 до получения какой-либо прибыли в виде дивидендов или распределений.
• Сроки имеют значение: для существующего бизнеса вы должны подать заявку не позднее 15-го дня 3-го месяца налогового года, с которого вы хотите начать использовать статус S-corp. Для выбора календарного 2025 года 15 марта 2025 года приходится на субботу, поэтому фактический срок - следующий рабочий день, понедельник, 17 марта 2025 года.
• Зачем это делать? Основная привлекательность - потенциальная экономия на налоге на самозанятость. В то время как ваша зарплата по форме W-2 облагается налогами FICA, распределения - нет. Однако это преимущество связано с дополнительными расходами на заработную плату, соблюдение требований и, в некоторых штатах, дополнительными налогами на уровне организации.
• В Beancount крайне важно отделять заработную плату от распределений. Вам нужно будет отслеживать обязательства по заработной плате, учитывать особенности учета медицинского страхования для акционеров, владеющих более 2% компании, и явно регистрировать распределения через счета капитала.

Что такое выбор S-corp?​

По сути, выбор S-corp - это запрос, который вы подаете в IRS, чтобы изменить способ налогообложения вашего бизнеса. Подавая форму 2553, вы просите IRS облагать вашу корпорацию или LLC налогом в соответствии с подглавой S Налогового кодекса. Это делает ваш бизнес «сквозным» субъектом, что означает, что его доход, убытки, вычеты и кредиты передаются непосредственно в личные налоговые декларации акционеров. Это исключительно налоговая классификация, а не другой тип юридического лица.

Ключевые последствия для владельца-оператора​

Как только выбор вступает в силу, ваша роль принципиально разделяется на две: теперь вы являетесь одновременно акционером и сотрудником вашей компании.

Это различие имеет решающее значение. Компенсация, которую вы получаете за свой труд, должна выплачиваться в виде заработной платы по форме W-2, которая облагается стандартными налогами на заработную плату (социальное обеспечение и медицинское обслуживание). Любая оставшаяся прибыль может быть выплачена в виде распределений, которые, как правило, не облагаются налогами на самозанятость. IRS настаивает на том, чтобы вы платили себе разумную зарплату за свою работу, прежде чем получать какие-либо распределения.

Стоит ли вам выбирать статус S-corp?​

Выбор S-corp часто стоит оценить, когда ваш бизнес генерирует стабильную и значительную прибыль. Распространенное практическое правило - рассматривать его, когда ваша текущая прибыль от бизнеса может комфортно поддерживать рыночную зарплату для вашей роли, оставляя достаточно средств для осуществления распределений после покрытия всех новых административных расходов.

Точная точка безубыточности уникальна для вашей ситуации и зависит от нескольких факторов:

• Ваша «разумная зарплата»: сколько бы бизнес заплатил за кого-то с вашими навыками и обязанностями в вашей отрасли? Эта цифра является основой для вашей заработной платы по форме W-2 и подлежит проверке IRS.
• Налоги и сборы штата: в некоторых штатах действуют свои правила. Например, Калифорния взимает 1,5% налог на чистую прибыль S-corp, плюс минимальный ежегодный франчайзинговый налог в размере 800 долларов.
• Дополнительные расходы: вам понадобится служба расчета заработной платы, и вы будете платить за страхование от безработицы. Ваши сборы за бухгалтерский учет и подготовку налоговой отчетности также, вероятно, увеличатся из-за возросшей сложности.
• Вычет QBI (раздел 199A): выбор S-corp может повлиять на ваш вычет квалифицированного бизнес-дохода. Заработная плата по форме W-2, которую вы себе выплачиваете, может либо помочь вам получить право на полный вычет, либо, при более высоких уровнях дохода, стать ограничивающим фактором.

Право на участие и сроки​

Не каждый бизнес может стать S-corp. Вот основные требования:

• Это должна быть отечественная корпорация или LLC, имеющая право на участие.
• У нее может быть не более 100 акционеров.
• У нее может быть только один класс акций.
• Акционерами должны быть физические лица, определенные трасты или наследственные фонды (т. е. не партнерства, корпорации или акционеры-нерезиденты).

Когда подавать форму 2553​

Сроки имеют решающее значение, и правила немного различаются для новых и существующих предприятий.

• Для нового бизнеса: вы должны подать заявку в течение 2 месяцев и 15 дней после первого дня вашего первого налогового года. Например, если налоговый год вашего бизнеса начинается 7 января, срок подачи заявки - 21 марта.
• Для существующей C-corp (или LLC, облагаемой налогом как C-corp): вы можете подать заявку в любое время в течение предыдущего налогового года или до 15-го дня 3-го месяца года, в котором вы хотите, чтобы выбор вступил в силу. Если эта дата приходится на выходные или праздничные дни, срок переносится на следующий рабочий день, что предусмотрено разделом 7503 IRC.

Что делать, если вы пропустили срок? Не паникуйте. IRS предоставляет возможность для подачи заявки с опозданием в соответствии с документом о доходах 2013-30. Вы часто можете подать заявку на это в течение 3 лет и 75 дней с предполагаемой даты вступления в силу, при условии, что у вас есть уважительная причина для поздней подачи.

Разумная зарплата: то, что сбивает людей с толку​

Это наиболее тщательно проверяемый аспект структуры S-corp. IRS очень четко заявляет: акционерам-сотрудникам должна выплачиваться разумная компенсация за предоставляемые ими услуги до того, как какая-либо прибыль будет получена в виде распределений.

Что означает «разумный»? Нет единой суммы в долларах. IRS и суды рассматривают различные факторы, чтобы определить, является ли ваша зарплата соответствующей, включая ваши обязанности, время, которое вы тратите на работу, ваш уровень опыта и то, что сопоставимые предприятия заплатили бы за аналогичные услуги. Ожидайте, что IRS внимательно изучит, если вы платите себе очень низкую зарплату по форме W-2, получая при этом большие распределения. Это часто рассматривается как тревожный сигнал для попытки уклониться от уплаты налогов на заработную плату.

Медицинское страхование и дополнительные льготы для акционеров, владеющих >2% акций​

Существует специальное правило относительно того, как S-corp обрабатывает медицинское страхование для акционеров, владеющих более 2% компании. Если S-corp оплачивает или возмещает эти страховые взносы на медицинское страхование, стоимость вычитается S-corp.

Однако стоимость этих премий также должна быть включена в заработную плату акционера-сотрудника по форме W-2. Хотя эта сумма подлежит удержанию федерального подоходного налога, она освобождена от налогов на социальное обеспечение и медицинское обслуживание (FICA), если она обработана правильно. Вы должны координировать свои действия с вашим поставщиком услуг по расчету заработной платы, чтобы гарантировать, что эти суммы правильно указаны в вашей форме W-2.

Подводные камни на уровне штата (примеры)​

Федеральный статус S-corp не всегда напрямую переводится на уровень штата. Всегда проверяйте конкретные правила вашего штата.

• Калифорния: S-corp облагаются налогом в размере 1,5% от их чистого дохода из источников в Калифорнии. Кроме того, большинство корпораций должны ежегодно платить минимальный франчайзинговый налог в размере 800 долларов США (хотя в первый год действуют некоторые исключения).
• Нью-Йорк: недостаточно сделать федеральный выбор S-corp. Вы также должны подать отдельное заявление на уровне штата, форму CT-6, чтобы рассматриваться как S-корпорация Нью-Йорка. Невыполнение этого требования означает, что вы будете облагаться налогом как стандартная C-corp на уровне штата.

Как правильно моделировать S-corp в Beancount​

Простой текстовый учет идеально подходит для управления возросшей сложностью S-corp. Вот как структурировать ваш журнал.

Рекомендуемый план счетов (начальный)​

Эта базовая структура отделяет ваши расходы на заработную плату от распределений и создает счета обязательств для отслеживания налогов, которые вы должны.

; Основной банк и доход
1970-01-01 open Assets:Bank:Checking              USD
1970-01-01 open Income:Sales                      USD
1970-01-01 open Income:Other                      USD

; Расходы на заработную плату и обязательства
1970-01-01 open Expenses:Payroll:Wages            USD
1970-01-01 open Expenses:Payroll:EmployerTaxes    USD
1970-01-01 open Expenses:Benefits:HealthInsurance USD
1970-01-01 open Liabilities:Payroll:Federal:FIT    USD
1970-01-01 open Liabilities:Payroll:FICA          USD
1970-01-01 open Liabilities:Payroll:Medicare      USD
1970-01-01 open Liabilities:Payroll:State:Withholding USD

; Капитал
1970-01-01 open Equity:ContributedCapital         USD
1970-01-01 open Equity:Distributions              USD
1970-01-01 open Equity:RetainedEarnings           USD

Типичный расчет заработной платы (упрощенный)​

Ваш поставщик услуг по расчету заработной платы (например, Gusto, ADP) спишет с вашего банковского счета вашу чистую зарплату и общую налоговую задолженность. Ваша транзакция Beancount должна разбить это на валовую заработную плату, налоги работодателя и соответствующие обязательства.

; Эта транзакция регистрирует годовую зарплату в размере 100 тысяч долларов, выплачиваемую ежемесячно.
2025-01-31 * "Gusto" "Январская заработная плата — акционер-сотрудник"
  Expenses:Payroll:Wages                   8,333.33 USD ; Валовая заработная плата
  Expenses:Payroll:EmployerTaxes             637.50 USD ; Налоги FICA/Medicare работодателя
  Liabilities:Payroll:Federal:FIT         -1,200.00 USD ; Удержание с сотрудника
  Liabilities:Payroll:FICA                  -516.67 USD ; Удержание с сотрудника
  Liabilities:Payroll:Medicare              -120.83 USD ; Удержание с сотрудника
  Assets:Bank:Checking                    -7,133.33 USD ; Чистая зарплата, списанная с банковского счета

Когда ваш поставщик услуг по расчету заработной платы перечисляет эти налоги правительству от вашего имени, вы записываете другую транзакцию, чтобы очистить обязательства.

; Это представляет собой налоговый платеж, произведенный вашим поставщиком услуг по расчету заработной платы.
2025-02-15 * "EFTPS" "Федеральный депозит по налогу на заработную плату"
  Liabilities:Payroll:Federal:FIT          1,200.00 USD
  Liabilities:Payroll:FICA                   516.67 USD
  Liabilities:Payroll:Medicare               120.83 USD
  Assets:Bank:Checking                    -1,837.50 USD ; Эта сумма соответствует налоговой части списания Gusto.

Медицинское страхование для акционера >2%​

Запишите оплату премии как бизнес-расход. Вы можете использовать метаданные, чтобы напомнить себе, что это должно быть указано в форме W-2.

2025-02-01 * "BlueCross" "Медицинское страхование акционера (указать в W-2)"
  Expenses:Benefits:HealthInsurance          600.00 USD  ; w2: "true"
  Assets:Bank:Checking                      -600.00 USD

Распределения владельцу (не заработная плата)​

Распределения - это уменьшение капитала, а не бизнес-расход. Регистрируйте их отдельно от заработной платы.

2025-03-31 * "Распределение владельцу" "Распределение за 1 квартал"
  Equity:Distributions                    20,000.00 USD
  Assets:Bank:Checking                   -20,000.00 USD

Отслеживание базы акционеров (необязательно, но рекомендуется)​

Ваша база акционеров определяет, являются ли распределения необлагаемыми налогом и можете ли вы вычитать бизнес-убытки из вашей личной декларации. Хотя официальный расчет производится в вашей налоговой декларации, вы можете отслеживать оценку в Beancount, используя специальный субсчет капитала или метаданные. Вы будете ежегодно сверять это с Приложением K-1, которое вы получаете от S-corp.

Замечание о вычете QBI (раздел 199A)​

Владельцы сквозных предприятий, включая S-corp, могут иметь право на вычет до 20% от своего квалифицированного бизнес-дохода (QBI). Однако для налогоплательщиков с доходом выше определенного порога этот вычет может быть ограничен суммой заработной платы по форме W-2, которую выплачивает предприятие. Это создает сложное взаимодействие: выплата разумной зарплаты требуется для S-corp, и эта же зарплата может повлиять на ваш вычет QBI - иногда помогая ему, иногда ограничивая его. Это ключевая область для моделирования с вашим налоговым консультантом.

Что меняется в операционной деятельности после вашего выбора?​

Переход на S-corp добавляет несколько административных уровней:

• Ведение заработной платы: вы должны официально вести заработную плату, включая удержание налогов, выплату налогов работодателя, ежеквартальную отчетность и годовые формы W-2.
• Подача формы 1120-S: это ежегодная налоговая декларация S-корпорации. Вы также выдадите Приложение K-1 каждому акционеру с подробным описанием его доли в финансовых результатах компании.
• Правильное обращение с медицинским страхованием акционеров: убедитесь, что премии для владельцев >2% включены в их заработную плату по форме W-2.
• Соблюдение правил штата: будьте в курсе любых требуемых выборов S-corp на уровне штата или налогов на уровне организации (как в Калифорнии и Нью-Йорке).

Распространенные ловушки, которых следует избегать​

• Поздний или недействительный выбор: дважды проверьте сроки и убедитесь, что все необходимые акционеры подписали форму 2553. Если вы пропустили срок, изучите возможность смягчения последствий в соответствии с Rev. Proc. 2013-30.
• Неразумная зарплата: не поддавайтесь искушению платить себе искусственно низкую зарплату. Документируйте, почему ваша компенсация является разумной, исходя из вашей роли и рыночных данных.
• Смешивание заработной платы и распределений: держите эти транзакции чистыми и раздельными в ваших книгах. Распределения - это не заработная плата.
• Игнорирование требований штата: забывание о выборе штата или невыплата налога на уровне организации может привести к штрафам и проблемам с соблюдением требований.

Краткий контрольный список​

• Подтвердите, что вы имеете право на участие и что потенциальная налоговая экономия перевешивает новые расходы.
• Отметьте в календаре срок подачи формы 2553 (и помните о правиле выходных/праздничных дней).
• Настройте службу расчета заработной платы и определите хорошо документированную, разумную зарплату.
• Планируйте получать распределения только после выплаты зарплаты и бизнес-расходов.
• Изучите и соблюдайте конкретные требования вашего штата к подаче заявлений S-corp и налогам.
• Обновите свой журнал Beancount необходимыми счетами для заработной платы, обязательств и капитала акционеров.

Beancount S-Corp Starter (нейтральный шаблон)

;
; Beancount S-Corp Starter (нейтральный шаблон)
; Создано: 2025-08-09
; ---
; Как использовать это:
; 1) Найдите "TODO" и заполните свой штат(ы), поставщика услуг по расчету заработной платы, EIN и названия банков.
; 2) Держите заработную плату и распределения владельцу отдельно.
; 3) Скоординируйтесь с вашим поставщиком услуг по расчету заработной платы, чтобы сообщить о медицинском страховании акционера >2% в форме W-2 (поле 1).
; 4) Удалите или адаптируйте примеры CA/NY, если вы находитесь в другом штате.
;
; Примечания:
; - Это шаблон бухгалтерского учета, а не налоговая консультация.
; - Предполагается, что операционная валюта - USD. Измените по мере необходимости.
;

option "title" "Журнал S-Corp"
option "operating_currency" "USD"
commodity USD

; === Счета (открыты с 2025-01-01; скорректируйте даты по мере необходимости) ==================
2025-01-01 open Assets:Bank:Checking                    USD  ; TODO: Переименуйте в свой банк (например, Assets:Bank:Chase:Operating)
2025-01-01 open Assets:Bank:Savings                     USD
2025-01-01 open Assets:AccountsReceivable               USD
2025-01-01 open Assets:PrepaidExpenses                  USD

2025-01-01 open Liabilities:CreditCard:Corporate        USD
2025-01-01 open Liabilities:Payroll:Federal:FIT         USD
2025-01-01 open Liabilities:Payroll:Federal:FICA        USD
2025-01-01 open Liabilities:Payroll:Federal:Medicare    USD
2025-01-01 open Liabilities:Payroll:Federal:FUTA        USD
2025-01-01 open Liabilities:Payroll:State:Withholding   USD   ; TODO: Переименуйте штат (например, CA, NY)
2025-01-01 open Liabilities:Payroll:State:Unemployment  USD
2025-01-01 open Liabilities:Payroll:Local               USD

2025-01-01 open Equity:ContributedCapital               USD
2025-01-01 open Equity:Distributions                    USD
2025-01-01 open Equity:RetainedEarnings                 USD
2025-01-01 open Equity:OpeningBalances                  USD

2025-01-01 open Income:Sales                            USD
2025-01-01 open Income:Other                            USD

2025-01-01 open Expenses:COGS                            USD
2025-01-01 open Expenses:Payroll:Wages                   USD
2025-01-01 open Expenses:Payroll:EmployerTaxes:FICA      USD
2025-01-01 open Expenses:Payroll:EmployerTaxes:Medicare  USD
2025-01-01 open Expenses:Payroll:EmployerTaxes:FUTA      USD
2025-01-01 open Expenses:Payroll:EmployerTaxes:State     USD
2025-01-01 open Expenses:Benefits:HealthInsurance        USD
2025-01-01 open Expenses:Benefits:HSA                    USD
2025-01-01 open Expenses:Benefits:Retirement:Match       USD
2025-01-01 open Expenses:Taxes:State:S-Corp              USD  ; например, 1,5% налог на уровне организации в CA
2025-01-01 open Expenses:Taxes:State:Franchise           USD  ; например, минимальный франчайзинговый налог в CA $800
2025-01-01 open Expenses:Professional:Payroll            USD
2025-01-01 open Expenses:Professional:Accounting         USD
2025-01-01 open Expenses:Professional:Legal              USD
2025-01-01 open Expenses:BankFees                        USD
2025-01-01 open Expenses:Software                        USD
2025-01-01 open Expenses:Office                          USD
2025-01-01 open Expenses:Meals                           USD
2025-01-01 open Expenses:Travel                          USD
2025-01-01 open Expenses:Insurance:GeneralLiability      USD

; === Пример: Капитализация владельца =================================================
2025-01-02 * "Владелец" "Первоначальный взнос капитала"
  Assets:Bank:Checking                        25,000.00 USD
  Equity:ContributedCapital                  -25,000.00 USD

; === Пример: Платеж клиента =====================================================
2025-01-15 * "Stripe" "Январские поступления по подписке"
  Assets:Bank:Checking                        12,000.00 USD
  Income:Sales                               -12,000.00 USD

; === Пример: Ежемесячная заработная плата (один акционер-сотрудник) ========================
; Цифры выбраны для идеального баланса. Адаптируйте цифры FIT/State к вашей реальности.
; Валовая заработная плата: 8,333.33 | FIT сотрудника: 1,200.00 | Удержание штата: 300.00
; FICA сотрудника (6.2%): 516.67 | Medicare сотрудника (1.45%): 120.83
; FICA работодателя: 516.67 | Medicare работодателя: 120.83
; Чистая зарплата: 6,195.83
2025-01-31 * "Gusto" "Январская заработная плата — акционер-сотрудник"
  Expenses:Payroll:Wages                         8,333.33 USD
  Expenses:Payroll:EmployerTaxes:FICA              516.67 USD
  Expenses:Payroll:EmployerTaxes:Medicare          120.83 USD
  Liabilities:Payroll:Federal:FIT               -1,200.00 USD
  Liabilities:Payroll:Federal:FICA              -1,033.34 USD  ; сотрудник + работодатель
  Liabilities:Payroll:Federal:Medicare            -241.66 USD  ; сотрудник + работодатель
  Liabilities:Payroll:State:Withholding           -300.00 USD
  Assets:Bank:Checking                          -6,195.83 USD

; === Пример: Депозиты по налогу на заработную плату (EFTPS и штат) =================================
2025-02-15 * "EFTPS" "Федеральный депозит по заработной плате (FIT, FICA, Medicare)"
  Liabilities:Payroll:Federal:FIT                1,200.00 USD
  Liabilities:Payroll:Federal:FICA               1,033.34 USD
  Liabilities:Payroll:Federal:Medicare             241.66 USD
  Assets:Bank:Checking                          -2,475.00 USD

2025-02-16 * "STATE DOR" "Удержание заработной платы штата"
  Liabilities:Payroll:State:Withholding            300.00 USD
  Assets:Bank:Checking                            -300.00 USD

; === Пример: Медицинское страхование для акционера >2% =================================
; Скоординируйтесь с расчетом заработной платы, чтобы общая годовая премия была включена в поле 1 формы W-2.
; Сама премия вычитается здесь; НЕ удерживайте SS/Medicare с нее, если она обработана правильно.
2025-02-01 * "BlueCross" "Медицинское страхование акционера (включение в W-2 обрабатывается расчетом заработной платы)"
  Expenses:Benefits:HealthInsurance                600.00 USD  ; w2: "true"
  Assets:Bank:Checking                            -600.00 USD

; === Пример: Распределение владельцу (не заработная плата) =======================================
2025-03-31 * "Распределение владельцу" "Распределение за 1 квартал"
  Equity:Distributions                         20,000.00 USD
  Assets:Bank:Checking                        -20,000.00 USD

; === Примеры штатов (удалите/измените, если не применимо) =================================
; Минимальный франчайзинговый налог Калифорнии (не всегда в первый год; проверьте правила)
2025-04-15 * "California FTB" "Ежегодный франчайзинговый налог"
  Expenses:Taxes:State:Franchise                   800.00 USD
  Assets:Bank:Checking                            -800.00 USD

; 1,5% налог на S-Corp в Калифорнии (пример оценочного платежа)
2025-06-15 * "California FTB" "Оценочный налог S-Corp"
  Expenses:Taxes:State:S-Corp                    1,500.00 USD
  Assets:Bank:Checking                          -1,500.00 USD

; Отдельный выбор S в Нью-Йорке (CT-6) не имеет прямого влияния на журнал; замещающее примечание.
2025-01-05 note Equity:RetainedEarnings "Выбор S в NY (CT-6) подан — только бухгалтерская запись (без проводки)"

; === Отслеживание базы (необязательно — заметка вне книги) =====================================
2025-12-31 note Equity:RetainedEarnings "Перенос базы: +Капитал 25 000 +Доход 60 000 -Распределения 20 000 = Конечная база 65 000 (сверка с K-1)"

; === Подсказки по импорту (CSV из Gusto/ADP) =============================================
; - Для CSV-файлов реестра заработной платы Gusto сопоставьте столбцы:
;   Валовая зарплата -> Expenses:Payroll:Wages
;   FIT/FICA/Medicare сотрудника -> Liabilities:Payroll:Federal:FIT/FICA/Medicare (отрицательное)
;   Удержание штата -> Liabilities:Payroll:State:Withholding (отрицательное)
;   FICA/Medicare/FUTA/SUTA работодателя -> Expenses:Payroll:EmployerTaxes:* (положительное) И
;       если ваш CSV-файл перечисляет налоги работодателя как суммы к уплате, отразите их как Liabilities:* (отрицательное),
;       затем очистите их с помощью ваших платежей EFTPS/штата.
;   Чистая зарплата -> Assets:Bank:Checking (отрицательное, соответствует дате выплаты)
; - Медицинское страхование, оплачиваемое компанией:
;   Платеж поставщику -> Expenses:Benefits:HealthInsurance (положительное) / Bank (отрицательное);
;   убедитесь, что расчет заработной платы включает годовую премию в поле 1 формы W-2 для акционера >2%.
;
; Советы:
; - Держите распределения вне счетов заработной платы.
; - Используйте теги, такие как #payroll #distribution, для фильтрации в Fava.
; - Рассмотрите возможность использования отдельных банковских субсчетов для резервирования налогов (федеральных/штатных).

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

Опираясь на подробный сравнительный отчет, давайте проанализируем технические особенности Beancount по сравнению с его популярными аналогами с открытым исходным кодом: Ledger-CLI, hledger и GnuCash.

Скорость и производительность: количественные тесты 🚀​

Для любого серьезного набора данных производительность не подлежит обсуждению. Beancount спроектирован для обработки данных о транзакциях за десятилетия без ущерба для скорости. Несмотря на то, что он реализован на Python (v2), его высокооптимизированный парсер чрезвычайно эффективен.

• Beancount: Практическое использование показывает, что он может загружать и обрабатывать журналы с сотнями тысяч транзакций примерно за 2 секунды. Использование памяти скромное; парсинг ~100 тыс. транзакций преобразует исходный текст в объекты в памяти, используя всего десятки мегабайт ОЗУ.
• Стресс-тест на 1 млн транзакций: Тест с использованием синтетического журнала из 1 миллиона транзакций, 1000 счетов и 1 миллиона ценовых записей выявил существенные архитектурные различия:
  • hledger (Haskell): Успешно завершил полный парсинг и отчет за ~80,2 секунды, обрабатывая ~12 465 транзакций/сек, используя ~2,58 ГБ ОЗУ.
  • Ledger-CLI (C++): Процесс был завершен через 40 минут без завершения, вероятно, из-за известной регрессии, вызывающей чрезмерное использование памяти и процессора с очень сложными журналами.
  • Beancount: Хотя он не был включен в этот конкретный тест на 1 млн, его кривая производительности предполагает, что он справится с задачей эффективно. Более того, ожидается, что грядущий Beancount v3 с новым ядром на C++ и Python API обеспечит еще один порядок повышения пропускной способности.
• GnuCash (C/Scheme): Поскольку GUI-приложение загружает весь свой набор данных в память, производительность заметно снижается с увеличением размера. Файл XML размером ~50 МБ (представляющий более 100 тыс. транзакций) открывался 77 секунд. Переход на серверную часть SQLite лишь незначительно улучшил это до ~55 секунд.

Вывод: Beancount обеспечивает исключительную производительность, которая масштабируется предсказуемо, что является критически важной функцией для долгосрочного управления данными. Он избегает падения производительности, наблюдаемого в Ledger, и задержки, связанной с пользовательским интерфейсом GnuCash.

Архитектура данных: простой текст против непрозрачных баз данных 📄​

Способ хранения данных системой определяет ее прозрачность, переносимость и долговечность. Beancount использует чистый, удобочитаемый формат простого текста, который превосходен для технических пользователей.

• Компактный и эффективный: Файл Beancount со 100 000 транзакций занимает всего ~8,8 МБ. Это компактнее, чем эквивалентный файл Ledger (~10 МБ), отчасти потому, что синтаксис Beancount позволяет выводить окончательную балансовую сумму в транзакции, уменьшая избыточность.
• Структурно обеспеченный: Beancount требует явных директив YYYY-MM-DD\ open\ Account. Этот дисциплинированный подход предотвращает опечатки в названиях счетов, которые молча создают новые, неверные счета — распространенная ошибка в таких системах, как Ledger и hledger, которые создают счета на лету. Эта структура делает данные более надежными для программного манипулирования.
• Готовность к контролю версий: Журнал в виде простого текста идеально подходит для контроля версий с помощью Git. Вы получаете полную, проверяемую историю каждого финансового изменения, которое вы делаете.
• Сравнение с GnuCash: GnuCash по умолчанию использует сжатый с помощью gzip файл XML, где данные многословны и заключены в теги с GUID для каждой сущности. Хотя он предлагает серверные части SQLite, MySQL и PostgreSQL, это абстрагирует данные от простого, прямого управления текстом и управления версиями. Редактирование необработанного XML возможно, но гораздо более громоздко, чем редактирование файла Beancount.

Вывод: Формат данных Beancount — это не просто текст; это четко определенный язык, который максимизирует ясность, обеспечивает правильность и легко интегрируется с инструментами разработчика, такими как git и grep.

Убойная функция: настоящий Python API и архитектура плагинов 🐍​

В этом заключается определяющее техническое преимущество Beancount. Это не монолитное приложение, а библиотека со стабильным, первоклассным Python API. Это дизайнерское решение открывает безграничные возможности автоматизации и интеграции.

• Прямой программный доступ: Вы можете читать, запрашивать и манипулировать данными своего журнала непосредственно в Python. Вот почему разработчики мигрируют. Как отметил один пользователь, разочарование от попыток написания скриптов для плохо документированных внутренних связей Ledger исчезает с Beancount.
• Конвейер плагинов: Загрузчик Beancount позволяет вставлять пользовательские функции Python непосредственно в конвейер обработки. Это позволяет выполнять произвольные преобразования и проверки потока данных по мере его загрузки — например, написать плагин, чтобы обеспечить, чтобы каждый расход от определенного поставщика имел определенный тег.
• Мощная инфраструктура импорта: Выйдите за рамки неуклюжих мастеров импорта CSV. С Beancount вы пишете скрипты Python для анализа финансовой отчетности из любого источника (OFX, QFX, CSV). Такие инструменты сообщества, как smart_importer, даже используют модели машинного обучения для автоматического прогнозирования и назначения учетных записей проводок, превращая часы ручной категоризации в процесс, занимающий несколько секунд и выполняемый одной командой.
• Как сравниваются другие:
  • Ledger/hledger: Расширяемость в основном внешняя. Вы передаете данные в/из исполняемого файла. Хотя они могут выводить JSON/CSV, вы не можете внедрить логику в их основной цикл обработки без изменения исходного кода C++/Haskell.
  • GnuCash: Расширяемость обрабатывается через крутую кривую обучения с Guile (Scheme) для пользовательских отчетов или через привязки Python (с использованием SWIG и таких библиотек, как PieCash), которые взаимодействуют с движком GnuCash. Это мощно, но менее прямо и "питонично", чем подход Beancount к родной библиотеке.

Вывод: Beancount разработан для программиста. Его библиотечно-ориентированный дизайн и глубокая интеграция с Python делают его наиболее гибкой и автоматизируемой системой из четырех.

Философия: строгий компилятор для ваших финансов 🤓​

Кривая обучения Beancount является прямым результатом его основной философии: ваши финансовые данные — это формальный язык, и он должен быть правильным.

Парсер Beancount функционирует как строгий компилятор. Он выполняет надежную синтаксическую и логическую проверку. Если транзакция не сбалансирована или счет не был открыт, он откажется обрабатывать файл и вернет описательную ошибку с номером строки. Это функция, а не ошибка. Это гарантирует, что если ваш файл "компилируется", базовые данные структурно надежны.

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

Для кого предназначен Beancount?​

На основе этого технического анализа Beancount является оптимальным выбором для:

• Разработчиков и инженеров, которые хотят рассматривать свои финансы как контролируемый версиями, программируемый набор данных.
• Любителей данных, которые хотят писать пользовательские запросы, создавать уникальные визуализации с помощью таких инструментов, как Fava, или передавать свои финансовые данные в другие аналитические модели.
• Любого, кто ценит доказуемую правильность и автоматизацию больше, чем удобство графического интерфейса или снисходительность менее структурированного формата.

Если вам нужна чистая производительность C++ для стандартных отчетов, Ledger — это претендент. Для исключительной масштабируемости в парадигме функционального программирования hledger впечатляет. Для многофункционального графического интерфейса с минимальной настройкой GnuCash превосходит.

Но если вы хотите построить действительно надежную, автоматизированную и глубоко настраиваемую систему управления финансами, Beancount обеспечивает превосходную техническую основу.