Бухгалтерия для гика

2014-09-21 Проезд на метро во время Московского марафона
    актив:наличные  ; понятно, что здесь должно быть -35
    расходы:проезд      35

Учебник Hledger

Ранее учет с ledger (на русском) был описан в статьях Планирование финансов через командную стоку в ledger, Финансовый учёт с ledger и Ledger — бухучёт в командной строке. Для общего развития рекомендую ознакомиться с ними.

Немного теории

Счетом мы называем любой вид Дохода/Расхода, а также любое “место”, откуда/куда приходят деньги. Кто-то называет их категориями, но суть от этого не меняется.

Обычно заводят такие счета как “Продукты”, “Авто”, “Подарки”, “Зарплата”, “Наличные”, “Ипотека” и т.п.

В системе двойной записи деньги переходят с одного счета на другой. И при этом отображаются в обоих строках транзакции с разными знаками. К примеру, покупка книги за 500 рублей переводит деньги со счета “Наличные” на счет “Книги”. Получение зарплаты отражается как перевод денег со счета “Зарплата” на счет “Наличные” (ну или “Банковская карта”). Главное — помнить, что при перемещении денег в итоге должен быть обязательно ноль, иначе ничего не получится.

Итак, мы выяснили, что счета могут быть самые разные, но многие пользователи добавляют такие счета верхнего уровня:

• Расходы (Expenses)
• Доходы (Income)
• Активы (Assets)
• Обязательства (Liabilities)

для того, чтобы в дальнейшем построить удобную структуру доходов/расходов. Иерархия счета таким образом может выглядеть так: “Расходы” -> “Авто” -> “Бензин”. И записываются такие счета в транзакциях через двоеточие: “Расходы:Авто:Бензин” (хотя вы можете использовать другой разделитель, об этом будет написано ниже).

Предупреждение

Я опишу здесь свой опыт реального использования утилиты hledger. Если у вас появятся вопросы, с радостью отвечу на них в комментариях или чате 🙂

Прежде всего, почему hledger, а не ledger-cli? На самом деле между ними нет большой разницы, используйте любую утилиту, благо формат журнала у них очень похожий. Мне нравятся функциональные языки программирования, а hledger написан на Haskell. При этом я пользуюсь MS Windows, а ledger-cli в этой ОС работает не очень хорошо. У hledger есть hledger-api для написания своих программ поверх hledger и я планирую заняться этим в ближайшее время, но и у ledger есть python api, который тоже очень удобен. В общем, решать вам, что использовать, я для себя пока выбрал hledger и он мне нравится 🙂

В этом учебнике мы создадим удобное дерево счетов, настроим программу на работу с несколькими валютами, покажем типовые сценарии использования различных финансовых инструментов и настроим удобный ввод транзакций.
Также построим надежную и гибкую структуру файлов журнала с выгрузкой изменений в систему хранения версий BitBucket (в приватном бесплатном репозитории).

Создадим файл журнала

Создайте пустой файл в блокноте и сохраните файл под любым именем, например “ledger.txt”.

В дальнейшем нужно будет запускать hledger так:

hledger -f ledger.txt <команда>

Но для hledger можно назвать файл “.hledger.journal” и поместить его в директорию пользователя ( /home для *nix систем или “C:\Users\<Имя пользователя>\” в Windows ) и тогда при вызове hledger вам не нужно будет каждый раз указывать имя файла. Например, так:

hledger <команда>

Предположим, вы так и сделали и у вас теперь есть файл журнала в домашней директории.

Ввод транзакций

У hledger есть удобная команда интерактивного ввода add, здесь вы можете ее увидеть в действии. Вы можете попробовать ввести с ее помощью транзакцию и затем посмотреть что записалось в файл журнала.
Откройте журнал любимым редактором ( я рекомендую SublimeText3 с плагином подсветки/дополнения или Vim/Emacs ) и добавьте следующую операцию (или замените транзакцию, созданную при помощи команды add):

2016/09/01 * Зарплата
	Кошелек:Наличные   10000 руб
	Доходы:Зарплата

Вкратце поясню что мы написали, но рекомендую все же ознакомиться с форматом записи ledger. У нас описана операция получения зарплаты в размере 10000 руб от 1 сентября 2016 г. В ней мы зачисляем 10000 руб на счет “Кошелек:Наличные” со счета “Доходы:Зарплата”.
Вы можете указать сумму с минусом в строке “Доходы:Зарплата”, но это не обязательно и важно только в транзакциях с тремя и более строками. Hledger автоматически понимает, что с другой стороны проводки нужная нам сумма.

При этом, в нашей транзакции указан флаг *, который говорит нам о том, что транзакция выверенная (флаг может быть ! и *, а можно его вообще не указывать). К примеру, вы вводите транзакции, а в конце недели сверяете с банковской выпиской, отмечая при этом сверенные транзакции флажком *. Знаком ! отмечают незаконченные транзакции (в статусе ожидания), но вам это, возможно, пригодится позже.

Свой разделитель счетов. Если вам не нравится знак двоеточие между счетами, вы можете указать свой разделитель. Для этого в начале журнала добавьте псевдоним для двоеточия и программа его обработает как разделитель, к примеру, укажем точку:

# alias /РЕГУЛЯРНОЕ ВЫРАЖЕНИЕ/=ЗАМЕНА
alias /\./=:

2016/10/01 зарплата
    Кошелек.Расчетный счет  1000 руб
    Доход.Зарплата

Еще момент — необходимо указать минимум два пробела между счетом и суммой, иначе программа будет считать сумму частью названия счета и выдаст ошибку!

Теперь запустим отчет Баланс (команда balance или bal):

hledger balance

          -10000 руб  Доходы:Зарплата
           10000 руб  Кошелек:Наличные
--------------------
                   0

Ноль под чертой очень важен и показывает, что у нас все транзакции записаны правильно с точки зрения двойной записи. А остаток в кошельке у нас 10 000 руб.

Теперь вы видите насколько просто вести учет денег с ledger?

Вы спросите, почему Доходы показаны с минусом? Если кратко, то в двойной записи деньги (как и любая другая ценность) должны откуда-то переместиться куда-то. В нашем примере они пришли со статьи дохода на статью расхода. Поэтому на счете поступления показан плюсовой остаток, а на другом счете — отрицательный. Иными словами, на счете дохода их стало меньше, чем в нашем кошельке 🙂

Введем еще одну операцию:

2016/09/05 * Бензин
    Кошелек:Наличные
    Расходы:Авто     1000 руб

Вы можете вводить транзакции с помощью команды add, тогда вам не нужно запоминать форматирование, флаги и т.п. Однако, сам формат журнала ledger очень простой и вводить транзакции руками не сложно. Я чаще всего использую копирование предыдущих записей с правкой даты и суммы — для каждодневных трат это удобно.
Для редких записей несложно либо найти их ранее в журнале, либо ввести “с нуля”, для этого и важно понимать формат.

Отчеты

Чаще всего нужен ответ на вопрос “Сколько я трачу в месяц на …?” Увидеть это можно так:

hledger -M register Расходы:Авто

2016/09                 Расходы:Авто                      1000 руб      1000 руб

Теперь купим немного продуктов:

2016/09/21 * продукты
	Кошелек:Наличные
	Расходы:Продукты			700 руб

Запускаем баланс:

hledger balance
          -10000 руб  Доходы:Зарплата
            8300 руб  Кошелек:Наличные
            1700 руб  Расходы
            1000 руб    Авто
             700 руб    Продукты
--------------------
                   0

Выводим список наших транзакций:

hledger reg
2016/09/01 Зарплата             Кошелек:Наличные         10000 руб     10000 руб
                                Доходы:Зарплата         -10000 руб             0
2016/09/05 Бензин               Кошелек:Наличные         -1000 руб     -1000 руб
                                Расходы:Авто              1000 руб             0
2016/09/21 продукты             Кошелек:Наличные          -700 руб      -700 руб
                                Расходы:Продукты           700 руб             0

Ну и баланс еще раз:

# Сколько потратил на авто:
hledger bal Расходы:Авто
            1000 руб  Расходы:Авто
--------------------
            1000 руб

# Сколько у меня денег:
hledger bal ^Расходы ^Доходы
          -10000 руб  Доходы:Зарплата
            1700 руб  Расходы
            1000 руб    Авто
             700 руб    Продукты
--------------------
           -8300 руб

Дерево статей

Один из самых важных вопросов в ведении личных доходов — удобное дерево статей (счетов).
Кто-то пытается максимально подробно вести учет, вплоть до того, что делают статьи чрезмерно большой вложенности: “Расходы — Продукты — Крупы — Гречка”. Если вы ведете учет финансов больше года, то это может быть оправдано, но если вы только начали, то ведение настолько подробного учета прогонит все желание продолжать.
Я предлагаю начать с малого и увеличивать количество статей в процессе. Итак, мы с вами уже описали счета “Кошелек:Наличные”, “Доходы:Зарплата”, “Расходы:Авто” и “Расходы:Продукты”. Отличное начало.
Теперь представим основные кошельки / доходы / расходы / долги и на основе этого (пока мысленно) составим наше дерево статей. К слову, у меня примерно такое (это не файл примера):

λ hledger accounts --tree   

Кошелек                                        
  Кредитка                   
  Наличные                   
Расходы                     
  Авто                       
    Бензин                   
    Налоги                    
    Ремонт                                       
  Здоровье                   
  Коммунальные               
  Налоги                     
  Одежда                     
  Продукты                   
  Прочие                     
  Связь                      
Кредиты
  Банк1
  Банк2
Доход                       
  Зарплата                  
  Прочий                     

Еще момент про дерево статей: когда мне нужно увидеть какой-то расход более подробно, я создаю для него отдельный счет. К примеру, все продукты я учитываю на счете “Расходы:Продукты”, но, к примеру, мне стало интересно, сколько я трачу на кофе ( и это не праздный интерес, кофе действительно стало уменьшаться очень быстро 🙂 ). Для этого я создаю транзакции по покупке кофе так:

2016/10/01 * кофе
    Кошелек:Наличные
    Расходы:Продукты:Кофе  200 руб

Так в вашем балансе будет видно расходы в целом на продукты, а также отдельной строкой затраты на кофе. Очень удобно!

Вы теперь умеете вводить транзакции (через команду add или вручную в текстовом редакторе) и пользуетесь при этом вашим деревом статей. Замечательно. Теперь давайте сделаем наш журнал более удобным.

Файл журнала

Откроем снова наш файл .hledger.journal:

; Это главный файл журнала hledger.
; Реальные данные содержатся в файлах в папке myledger
; Вложим актуальный журнал

include myledger/main.journal

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

Создайте папку myledger в домашней директории пользователя. Откройте ее.

Предупреждение: Вы можете пропустить этот абзац, если не планируте хранить ваш журнал в системе версий.
Зарегистрируйтесь на BitBucket и создайте новый приватный репозиторий. Нозовите его, к примеру, “myledger”. Откройте терминал и перейдите в эту папку:

cd myledger
git init
git remote add origin https://fokusov@bitbucket.org/fokusov/myledger.git

примечание: название репозитория и имя пользователя замените на свое.

Создадим файл main.journal в этой папке и откроем его:

alias Кредиты = Liabilities
alias Кошелек = Assets
alias Расходы = Expenses
alias Доходы = Income

D 1000.00 руб

include 2015.journal
include 2016.journal

end aliases

include prices.dat

Итак, в этом файле также нет транзакций, но указана метаинформация, очень важная для hledger.
Первые строки, начинающиеся с alias — это наши псевдонимы для счетов, чтобы программа могла составлять правильно отчетные формы, а мы могли писать название корневых счетов по-русски.
Далее идет строка D 1000.00 руб, описывающая валюту по-умолчанию и ее формат. Таким образом, не указывая явно валюту в каждой транзакции, мы будем знать, что она рублевая и пересчет между валютами будет корректен.
Далее мы вкладываем журналы транзакций, разбитые по годам. Я веду учет три года и у меня вложены файлы журнала за последние три года.
Сортировать по годам необязательно, но очень удобно, что записи разных лет хранятся в разных файлах, а не в одном большом. Фразой end aliases мы завершаем применение псевдонимов к нашим файлам и ниже вкладываем файл с ценами prices.dat.

Создайте указанные файлы (2015.journal, 2016.journal, prices.dat) или закомментируйте строку с ненужным файлом. Комментарии начинаются со знака ;

Сохраним наши файлы в репозитории:

git add *
git commit -m "Initial commit"
git push -u origin master

Теперь открываем файл нужного года (к примеру, 2016.journal) и вводим в него транзакции с помощью текстового редактора. Либо с помощью команды add, но с обязательным указание файла журнала, иначе она добавит наши транзакции в главный журнал:

hledger add -f myledger\2016.journal

Сделаем командный файл, который будет выгружать наши изменения в удаленный репозиторий:

myledger\upd.cmd:

git add -A
git commit -m "upd"
git push origin master

Добавим еще один служебный тег в текущий файл журнала (2016.journal):

Добавьте в начало файла указание на год:

Y2016

Теперь мы можем вводить транзакции немного быстрее:

10/01
    Кошелек:Наличные
    Расходы:Продукты    500

не указывая год и валюту (но если укажете год в транзакции, ничего страшного не произойдет). При этом программа знает, что это рублевая транзакция, совершенная в 2016 году.

Мультивалютность

В ledger очень легко вести учет в разных валютах и пересчитывать их из одной в другую автоматически.

Для этого необходимо вести файл с ценами/курсами (этот файл также нужен для автоматического расчета стоимости ценных бумаг), который можно сделать для автоматической загрузки из сети. У нас он уже есть, это файл prices.dat. Откроем его:

P 2016/10/28 10:00:00 USD 62.96 руб
P 2016/10/28 10:00:00 EUR 68.77 руб

Как мы видим, это официальные курсы валют центробанка на указанную дату, структурированные в формате ledger.

Если вы ведете транзакции в разной валюте, к примеру так:

2016/09/01 Зарплата
  Кошелек:Наличные   10000 руб
  Доходы:Зарплата
  
2016/09/05 * Бензин
    Кошелек:Наличные
    Расходы:Авто     1000 руб

2016/09/21 * продукты
  Кошелек:Наличные
  Расходы:Продукты   700 руб

2016/09/10 Шабашка
  Кошелек:Наличные   500 USD
  Доходы:Прочие

то баланс будет не очень красивый:

λ hledger bal
            -500 USD
          -10000 руб  Доходы
          -10000 руб    Зарплата
            -500 USD    Прочие
             500 USD
            8300 руб  Кошелек:Наличные
            1700 руб  Расходы
            1000 руб    Авто
             700 руб    Продукты
--------------------
                   0

# Попросим сконвертировать все данные в базовую валюту:
λ hledger bal -V
       -41480.00 руб  Доходы
       -10000.00 руб    Зарплата
       -31480.00 руб    Прочие
        39780.00 руб  Кошелек:Наличные
         1700.00 руб  Расходы
         1000.00 руб    Авто
          700.00 руб    Продукты
--------------------
                   0

Так лучше 🙂

Теперь введем валютную транзакцию, но чтобы она посчиталась корректно. Для этого есть три способа:

; 1. указываем уже рассчитанную стоимость в рублях - к примеру, когда наш банк уже пересчитал ее по своему курсу и снял с карты
2016/10/28 покупка домена
    Кошелек:Карта
    Расходы:Прочие     8.17 USD @@ 514.38 руб


; 2. указываем курс валюты / цену товара за единицу
2016/10/28 покупка домена
    Кошелек:Карта
    Расходы:Прочие     8.17 USD @ 62.96 руб


; 3. позволим hledger рассчитать курс / цену
2016/10/28 покупка домена
    Кошелек:Карта      -514.38 руб
    Расходы:Прочие     8.17 USD

Выведите баланс в консоли и потом баланс с ключом -V.

Полезные команды

У hledger есть немало команд, не говоря о плагинах. Но я рассмотрю те, которыми пользуюсь сам.

Команды:

  print            выводит список транзакций на экран
  accounts         выводит названия счетов
  balance          выводит счета и баланс (bal)
  register         транзакции и сальдо каждой (reg)
  incomestatement  отчет о доходах и расходах (is)
  balancesheet     выводит баланс - активы/пассивы (bs)
  cashflow         выводит денежный поток (cf)
  activity         выводит диаграмму в ascii о движении денег за период
                   (по умолчанию: за день)
  stats            выводит статистику журнала

Выведем статистику моего журнала:

λ hledger stats
Main file                : C:\Users\fokusov\.hledger.journal
Included files           : C:\Users\fokusov\myledger/main.journal
                           C:\Users\fokusov\myledger\2014.journal
                           C:\Users\fokusov\myledger\2015.journal
                           C:\Users\fokusov\myledger\2016.journal
                           C:\Users\fokusov\myledger\prices.dat
Transactions span        : 2014-04-01 to 2016-11-03 (947 days)
Last transaction         : 2016-11-02 (1 days ago)
Transactions             : 431 (0.5 per day)
Transactions last 30 days: 76 (2.5 per day)
Transactions last 7 days : 12 (1.7 per day)
Payees/descriptions      : 89
Accounts                 : 39 (depth 3)
Commodities              : 3 (EUR, USD, руб)

Интересное применение команды print:

# заархивируем 2015 год в отдельном файле
hledger print -b 2015 -e 2016 > 2015.journal

Команда balancesheet

$ hledger balancesheet
Balance Sheet

Assets:
                 $-1  assets
                  $1    Банк:Вклад
                 $-2    Наличные
--------------------
                 $-1

Liabilities:
                  $1  liabilities:Долги
--------------------
                  $1

Total:
--------------------
                   0

Команда cashflow

$ hledger cashflow
Cashflow Statement

Cash flows:
                 $-1  assets
                  $1    Банк:Вклад
                 $-2    Наличные
--------------------
                 $-1

Total:
--------------------
                 $-1

Команда incomestatement

$ hledger incomestatement
Income Statement

Revenues:
                 $-2  income
                 $-1    Подарки
                 $-1    Зарплата
--------------------
                 $-2

Expenses:
                  $2  expenses
                  $1    Продукты
                  $1    Прочее
--------------------
                  $2

Total:
--------------------
                   0

Еще транзакции

Я опишу для примера несколько видов транзакций, которыми пользуюсь сам — это учет долгов, ввод начальных остатков, ввод большого чека. Это справочная информация, возможно, она вам не пригодится. Однако, для общего развития очень полезна:

• Ввод начального остатка. К примеру, вы начали ведение журнала не с нуля, а имея начальные остатки. Здесь есть немало вариантов как это сделать, я покажу свой:

2016/09/01 начальный остаток
  Кошелек:Наличные   10000 руб
  Старт 

где “Старт” можно заменить на “Капитал:Открытие счета” или что-то подобное. Важно что на нужном счете появится нужная сумма, при этом взятая из другого источника (т.е. нам он не важен).

• Учет долгов. Здесь все просто — долг это такой же счет, но многие поначалу путаются, как правильно внести долги.

2016/09/01 Взял в долг у Ивана
  Кошелек:Наличные   10000 руб
  Долги:Иван

2016/09/11 Отдал долг Ивану
  Кошелек:Наличные
  Долги:Иван         10000 руб

• Большой чек. Вы купили много товаров, при этом хотите все внести одной транзакцией:

2016/10/01 * Леруа
  Кошелек:Наличные                 -47850 руб ; цифра введена для контроля, если ее не вводить, то она рассчитается автоматом
  Расходы:Ремонт квартиры:Обои     8250 руб
  Расходы:Ремонт квартиры:Краска   6300 руб
  Расходы:Ремонт квартиры:Ламинат  23000 руб
  Расходы:Ремонт квартиры:Светильник  10300 руб

Дальнейшая работа

Я продолжаю изучать возможности ledger и многое еще предстоит открыть.
В ближайших планах:
— настроить синхронизацию с мобильным приложением Monefy (или аналогом);
— найти хороший веб-интерфейс для просмотра отчетов ledger;
— настроить обмен данными с банками (выгрузка в csv);
— настроить автоматический расчет налогов с дохода (6% для фрилансера на УСН) при вводе транзакций.

Возможно, вы тоже нашли интересные штуки при работе с ledger, поделитесь ими в комментариях 🙂