6.7 KiB
Here are some yearly journal files demonstrating issues and techniques discussed in the close docs.
2021.journal, 2022.journal and
2023.journal each have only an opening balances transaction
and some ordinary transactions. These are what you’d get if you started
a new file each year using hledger’s close --open command
or Ledger’s equity command. These files show correct
balances when used individually, but they can’t be combined for a
multi-year report; their opening transactions are redundant and will
produce nonsense balances.
To solve this, whenever we transition to a new file we can
- add a counterbalancing closing transaction
using
close.
Also (not necessary for basic personal accounting, but if we want to be fully correct), we should ensure all equity is accounted for:
- where we have used @/@@ notation to convert between commodities, add equivalent equity postings
- and consolidate revenues and expenses into equity (AKA retain earnings).
Combining all of these in the right sequence is tricky, so here’s an
example of fully migrating to a new file at the end of 2021/start of
2022. 2021-closed.journal and
2022-closed.journal are the result of applying this
procedure to the 2021 and 2022 journals. (They are given a different
name here for clarity; normally you probably wouldn’t change the
name.)
First ensure all equity changes are recorded:
$ hledger -f 2021.journal print --infer-equity > 2021-closed.journal # add explicit equity:conversion postings where needed
$ hledger -f 2021-closed.journal close --retain -e 2022 >> 2021-closed.journal # retain earnings (transfer RX to E)
Next migrate asset/liability balances from old file to new file. (If
you want to preserve equity balances too, add a type:ALE
argument.) Note how –open is done first and –close second; or you
could –close first and --open not:desc:closing second:
$ hledger -f 2021-closed.journal close --open -e 2022 >> 2022.journal # migrate balances (add opening txn to 2022.journal)
$ hledger -f 2021-closed.journal close --close -e 2022 >> 2021-closed.journal # migrate balances (add closing txn to 2021.journal)
Finally, add a tag like this (manually) to the closing and opening transactions to make them easier to exclude from reports:
2021-12-31 closing balances ; start:2022
...
2022-01-01 opening balances ; start:2022
...
Now we can confirm that the accounting equation was preserved in 2021 (Net: is 0). We must exclude the closing balances transaction to see the end balances:
$ hledger -f 2021-closed.journal bse not:tag:start=2022
Balance Sheet With Equity 2021-12-31
|| 2021-12-31
=================================++==============
Assets ||
---------------------------------++--------------
assets || 21
---------------------------------++--------------
|| 21
=================================++==============
Liabilities ||
---------------------------------++--------------
---------------------------------++--------------
||
=================================++==============
Equity ||
---------------------------------++--------------
equity:conversion:A-B:A || -1 A
equity:conversion:A-B:B || 1 B
equity:opening/closing balances || 20
equity:retained earnings || 1, 1 A, -1 B
---------------------------------++--------------
|| 21
=================================++==============
Net: || 0
We can check the accounting equation for 2022 too, after adding all equity changes:
$ (hledger -f 2022.journal print --infer-equity; hledger -f 2022.journal close --retain) | hledger -f- bse
Balance Sheet With Equity 2024-01-19
|| 2024-01-19
==========================++==============
Assets ||
--------------------------++--------------
assets || 22
--------------------------++--------------
|| 22
==========================++==============
Liabilities ||
--------------------------++--------------
--------------------------++--------------
||
==========================++==============
Equity ||
--------------------------++--------------
equity:conversion:A-B:A || -1 A
equity:conversion:A-B:B || 1 B
equity:retained earnings || 1, 1 A, -1 B
equity:start || 21
--------------------------++--------------
|| 22
==========================++==============
Net: || 0
We can see correct balance sheets from any range of files if we exclude all opening/closing transactions except the first:
$ hledger bs -Y -f 2021-closed.journal -f 2022-closed.journal -f 2023.journal expr:'tag:start=2021 or not tag:start'
$ hledger bs -Y -f 2021-closed.journal -f 2022-closed.journal expr:'tag:start=2021 or not tag:start'
$ hledger bs -Y -f 2022-closed.journal -f 2023.journal expr:'tag:start=2022 or not tag:start'
$ hledger bs -Y -f 2021-closed.journal expr:'tag:start=2021 or not tag:start'
$ hledger bs -Y -f 2022-closed.journal expr:'tag:start=2022 or not tag:start'
$ hledger bs -Y -f 2023.journal # unclosed file, no query needed
And we can see correct income statements from any range of files if we exclude retain earnings transactions:
$ hledger is -Y -f 2021-closed.journal -f 2022-closed.journal -f 2023.journal not:desc:retain
$ hledger is -Y -f 2021-closed.journal -f 2022-closed.journal not:desc:retain
$ hledger is -Y -f 2022-closed.journal -f 2023.journal not:desc:retain
$ hledger is -Y -f 2021-closed.journal not:desc:retain
$ hledger is -Y -f 2022-closed.journal not:desc:retain
$ hledger is -Y -f 2023.journal # unclosed file, no query needed