Ledger¶
Ledger-cli est un outil de comptabilité en double entrée en ligne de commande. Il s'utilise avec un fichier texte nommé par exemple compta.ledger.
Logique de Ledger¶
Dans la logique de double entrée, ledger considère tout comme un compte.
La logique qui revient en comptabilité c'est:
- Assets ou Actifs
- Liabilities ou Passifs
- Equity ou Capitaux
- Income ou Revenus
- Expenses ou Dépenses
Quelques règles pour construire son fichier¶
J'ai l'habitude d'espacer de 3 espaces les lignes secondaires après la date et la désignation.
exemple:
Il faut minimum 2 espaces entre une ligne et un montant ! J'ai l'habitude de mettre une ou deux tabulations.
exemple:
Il est préférable, pour la lisibilité, de faire des séparations de montant avec des virgules.Contenu du fichier compta.ledger¶
2026-06-14 Total initial BNP
Actifs:Banque:BNP:Perso 1000,00 EUR
Actifs:Banque:BNP:Pro 2000,00 EUR
Actifs:Banque:BNP:LivretA 3000,00 EUR
Actifs:Banque:BNP:PEL 4000,00 EUR
Capitaux:Soldeinitial
2026-06-12 Essence Station machin
Actifs:Banque:BNP:Perso
Dépenses:Essence 69,08 EUR
2026-06-12 Courses magasin truc
Actifs:Banque:BNP:Perso
Dépenses:Courses 25,83 EUR
2026-06-12 Règlement FV20260059 M Untel
Actifs:Banque:BNP:Pro 69,00 EUR
Revenus:Services
...
Usage avancé avec les débours¶
Les frais de débours sont des dépenses avancées par l'entreprise, remboursées ensuite par le client, sans impact sur le chiffre d'affaires.
Par exemple:
- Je fais l'avance pour un client avec mon compte perso pour une pièce à 40€. Je ne ferai pas de marge dessus.
- Je lui facture de la main d'oeuvre à 60€.
- Il me fait un paiement de 100€ au global.
Le chiffre d'affaire que j'ai a déclaré à l'URSSAF est 60€.
Fonctionnement dans le fichier ledger:
...
2026-06-15 Achat pièce Dupont
Actifs:Débours:Dupont 40,00 EUR
Actifs:Banque:BNP:Perso
2026-06-15 FV20266666 Dupont chèque-123456-CIC
Actifs:Banque:BNP:Pro 100,00 EUR
Revenus:Services
Actifs:Débours:Dupont -40,00 EUR
...
Pointer une opération¶
Pour pointer une opération, il suffira d'ajouter un astérisque après la date, comme suit:
Ligne de commande de ledger¶
Balance ou total¶
Voir la balance général de tous les comptes¶
Exemple fictif de résultat de la commande:
10000,00 EUR Actifs:Banque:BNP
3000,00 EUR LivretA
4000,00 EUR PEL
1000,00 EUR Perso
2000,00 EUR Pro
-10000,00 EUR Capitaux:Soldeinitial
94,91 EUR Dépenses
25,83 EUR Courses
69,08 EUR Essence
-129,00 EUR Revenus:Services
--------------------
0
Voir la balance d'un compte en particulier¶
Exemple fictif de résultat de la commande:
Registre¶
Voir le registre de toutes les opérations sur un compte¶
Les opérations pointées seront affichées en ""non gras"", pendant que les opérations non pointées seront affichées en gras !
Exemple fictif de résultat de la commande:26-Jun-14 Total initial BNP Actifs:Banque:BNP:Perso 787,61 EUR 787,61 EUR
26-Jun-12 Essence Station machin Actifs:Banque:BNP:Perso -69,08 EUR 718,53 EUR
26-Jun-12 Courses magasin truc Actifs:Banque:BNP:Perso -25,83 EUR 692,70 EUR
26-Jun-15 Achat pièce Dupont Actifs:Banque:BNP:Perso -40,00 EUR 652,70 EUR
Exemple fictif de résultat de la commande:
26-Jun-12 Règlement FV20260059 M Untel Revenus:Services -69,00 EUR -69,00 EUR
26-Jun-15 FV20266666 Dupont chèque-123456-CIC Revenus:Services -60,00 EUR -129,00 EUR
Cleared et uncleared¶
Pour afficher les opérations pointées ""cleared"" et non-pointées "uncleared", on utilisera:
Pratique quand on veut comparer notre compta avec un relevé bancaire alors qu'une opération non pointée a été ajoutée à la compta !Voir le chiffre d'affaire mois par mois¶
Afin de voir le chiffre d'affaire et donc le compte Revenus mois par mois, on pourra utiliser:
Résultat de la commande:Filtrer par date¶
Ici, on listera les opérations du compte perso du 1er juin au 1er juillet 2026
26-Jun-14 Total initial BNP Actifs:Banque:BNP:Perso 787,61 EUR 787,61 EUR
26-Jun-12 Essence Station machin Actifs:Banque:BNP:Perso -69,08 EUR 718,53 EUR
26-Jun-12 Courses magasin truc Actifs:Banque:BNP:Perso -25,83 EUR 692,70 EUR
26-Jun-15 Achat pièce Dupont Actifs:Banque:BNP:Perso -40,00 EUR 652,70 EUR
Ici, on listera les opérations du compte Revenus du 1er juin au 1er juillet 2026
26-Jun-12 Règlement FV20260059 M Untel Revenus:Services -69,00 EUR -69,00 EUR
26-Jun-15 FV20266666 Dupont chèque-123456-CIC Revenus:Services -60,00 EUR -129,00 EUR
Exporter en csv¶
Il est possible d'exporter un compte précis à une date précise en csv. Ici tout le mois de juin 2026.
On utilisera la commande suivante:
Afin d'exporter et voir d'un coup d'oeil le chiffre d'affaire mois par mois sur toute l'année, on pourra utiliser l'argument --monthly.Convention de nommage¶
J'ai choisis de nommer les différentes lignes comptables comme suit:
- Actifs:Banque:BNP:Perso
- Actifs:Banque:BNP:Pro
- Actifs:Banque:BNP:LivretA
- Actifs:Banque:BNP:PEL
- Actifs:Débours:Dupont (exemple)
- Capitaux:Soldeinitial
- Dépenses:Courses (exemple)
- Revenus:Services
- Revenus:Marchandises