Ledger - Introduction 🏦

Article “pense-bête” sur mon utilisation récente de Ledger et du concept de plaintextaccounting. (Probablement pas mal de choses à améliorer).

Structure

Il est possible de créer un fichier .ledgerrc dans son répertoire utilisateur pour renseigner les options par défaut. Par exemple :

--file ~/chemin/vers/ledger/.ledger
--date-format=%Y/%m/%d
--decimal-comma

La structure du fichier Ledger elle-même est séparée en plusieurs fichiers :

ledger
 |--.ledger
 |--data/
 |   |--00-banque1.ldg
 |   |--2020-banque2.ldg
 |   |--2021-banque2.ldg
 |   |--definitions.ldg
 |   `--prices.db
 `--dump/

.ledger : fichier maître qui référence les fichiers dans data,
data :
- 00-banque1.ldg : consigne les transactions d’une banque ou comptes à faibles mouvements,
- 2020-banque2.ldg & 2021-banque2.ldg : consigne les transactions d’une banque ou comptes à mouvements réguliers, et donc séparé en années pour plus de clarté,
- definitions.ldg : déclarations des actifs et des bénéficiaires réguliers,
- prices.db : base des prix de change pour les monnaies étrangères ou les actions (voir ci-dessous),
dump : stock les fichiers d’exports des établissements financiers (csv, qif, etc.).

Base de prix de change

Comme évoqué ci-dessus, il est possible de maintenir une base de données de prix de change afin d’obtenir facilement une correspondance entre les actions et leurs équivalences en Euros, ou si l’ont souhaite suivre des dépenses dans des monnaies étrangères.

L’outil Pricehist sera utilisé pour cela.

Après l’avoir installé, vous pouvez par exemple récupérer l’historique des prix des actions Air Liquide (avec le code Yahoo Finance) :

$ ~/.local/bin/pricehist fetch yahoo AI.PA -s 2011-01-01 -e 2021-12-15 -o ledger --fmt-decimal , > data/prices.db

Ledger peut ensuite indiquer la liste des prix connus (identification par Ledger au travers des transactions + pricehist) :

$ ledger prices --price-db data/prices.db
2021/12/13 "AI.PA"  154,979996 EUR
2021/12/14 "AI.PA"  152,919998 EUR
2021/12/15 "AI.PA"  153,919998 EUR
2021/01/06 DYN         36,47 EUR
2021/10/14 DYN         38,00 EUR
2021/01/06 ORA          9,75 EUR
2021/12/15 ORA         13,51 EUR
2021/01/06 EQU        24,932 EUR
2021/11/25 EQU         24,84 EUR
2021/01/06 EVO         41,29 EUR
2021/10/14 EVO         41,95 EUR
2020/11/08 "3DEC"      65,91 EUR

Exemples de commandes

Dépenses du mois en cours par catégories

$ ledger bal ^Expenses --period "this month" --flat --invert

Creuser les dépenses d’une catégorie

$ ledger reg ^Expenses:Transports:Train --period "this month"

Dépenses d’une catégori epar mois

ledger reg -M Expenses:Courses

Balances des mois précédents

Total des dépenses par mois :

$ ledger reg ^exp --period "this month" --monthly --collapse

Total des revenus par mois :

$ ledger reg ^inc --period "this month" --monthly --collapse

État des actifs

En valeur brute :

$ ledger bal assets --flat

En Euros :

$ ledger --exchange EUR bal assets --flat --price-db data/prices.db

Possible de retirer le total avec l’option --no-total

Sources :

finance ledger plaintextaccounting