+|==================================
+
+=== Suivre un compte (`register`)
+
+[source,sh]
+.Suivi de la somme des crédits du compte `5112`
+----
+% hledger register -f Paris.2011.hledger 'amt:<0' '^5.Finance:1.Etablissement:1.Valeur:2.Chèque_à_encaisser'
+2011/05/23 Remise chq 0994029 ..Chèque_à_encaisser -100,00€ -100,00€
+2011/09/29 Remise chq 1101801 ..Chèque_à_encaisser -20,00€ -120,00€
+2011/11/18 Remise chq 1101802 ..Chèque_à_encaisser -2000,00€ -2120,00€
+----
+
+[source,sh]
+.Suivi de la somme des débits du compte `5112`
+----
+% hledger register -f Paris.2011.hledger 'amt:>0' '^5.Finance:1.Etablissement:1.Valeur:2.Chèque_à_encaisser'
+2011/05/15 Prêt ..Chèque_à_encaisser 100,00€ 100,00€
+2011/09/20 Cotisations ..Chèque_à_encaisser 20,00€ 120,00€
+2011/11/10 Prêt ..Chèque_à_encaisser 2000,00€ 2120,00€
+----
+
+NOTE: Si ces deux commandes ne donnent pas le même montant final
+c’est qu’il reste des chèques à encaisser.
+
+
+=== Observer des statistiques (`stats`, `activity`)
+
+[cols="a,a"]
+|==================================
+|
+[float]
+[source,sh]
+.Statistiques annuelles
+----
+% hledger stats --period yearly -f Paris.2012.hledger
+Main journal file : Paris.2012.hledger
+Included journal files : Paris.Plan_comptable.hledger
+ Cyclofficine.Plan_comptable.hledger
+Transactions span : 2012-01-01 to 2013-01-01 (366 days)
+Last transaction : 2012-12-31 (576 days ago)
+Transactions : 210 (0.6 per day)
+Transactions last 30 days: 0 (0.0 per day)
+Transactions last 7 days : 0 (0.0 per day)
+Payees/descriptions : 144
+Accounts : 448 (depth 6)
+Commodities : 1 (€)
+----
+
+|
+[float]
+[source,sh]
+.Jours de l’année avec au moins 5 flux
+----
+hledger activity --period daily -f Paris.2012.hledger \| grep '\*\{5\}'
+2012-01-01 ***********
+2012-02-29 ******
+2012-03-23 ******
+2012-03-31 *********
+2012-04-03 ******
+2012-04-30 ********
+2012-05-03 ****************
+2012-05-11 ********
+2012-05-14 ****************
+2012-05-31 **********
+2012-06-11 ******************
+2012-06-30 *************
+2012-07-13 *********
+2012-07-17 ******
+2012-07-30 ******
+2012-07-31 ***********
+2012-08-31 ******
+2012-09-26 ********
+2012-09-30 ******
+2012-11-13 ********
+2012-11-30 *****
+2012-12-31 *************
+----
+
+|==================================
+
+=== Écrire des écritures (`add`)
+
+[source,sh]
+.Sélection d’un modèle selon le libellé
+----
+% hledger add -f /tmp/test.ledger
+Adding transactions to journal file /tmp/test.ledger
+Any command line arguments will be used as defaults.
+Use tab key to complete, readline keys to edit, enter to accept defaults.
+An optional (CODE) may follow transaction dates.
+An optional ; COMMENT may follow descriptions or amounts.
+If you make a mistake, enter < at any prompt to restart the transaction.
+To end a transaction, enter . when prompted.
+To quit, enter . at a date prompt or press control-d or control-c.
+Date [2014/07/30]: 2014/01/01
+Description: Libellé de l’écriture ; UN_TAG:, Autre_tag:Avec_Valeur
+Account 1: A:AA
+Amount 1: -42
+Account 2: B:BB:BBB
+Amount 2 [42.0]: 40
+Account 3: B:A
+Amount 3 [2.0]:
+Account 4 (or . or enter to finish this transaction): .
+2014/01/01 Libellé de l’écriture ; UN_TAG:, Autre_tag:Avec_Valeur
+ A:AA -42
+ B:BB:BBB 40
+ B:A 2.0
+
+Save this transaction to the journal ? [y]: y
+Saved.
+Starting the next transaction (. or ctrl-D/ctrl-C to quit)
+Date [2014/01/01]:
+Description: Libellé d’une autre écriture
+Using this similar transaction for defaults:
+2014/01/01 Libellé de l’écriture ; UN_TAG:, Autre_tag:Avec_Valeur
+ A:AA -42
+ B:BB:BBB 40
+ B:A 2.0
+
+Account 1 [A:AA]:
+Amount 1 [-42.0]: 100
+Account 2 [B:BB:BBB]: B
+Amount 2 [-100.0]:
+Account 3 (or . to finish this transaction) [B:A]: .
+2014/01/01 Libellé d’une autre écriture
+ A:AA 100
+ B -100.0
+
+Save this transaction to the journal ? [y]: y
+Saved.
+Starting the next transaction (. or ctrl-D/ctrl-C to quit)
+Date [2014/01/01]: .
+----
+
+[source,sh]
+.Complètement automatique des comptes
+----
+% hledger add -f data/exemple-plan-comptable.ledger
+Adding transactions to journal file /home/julm/admin/cyber.coop/src/tool/hledger/doc/data/exemple-plan-comptable.ledger
+Any command line arguments will be used as defaults.
+Use tab key to complete, readline keys to edit, enter to accept defaults.
+An optional (CODE) may follow transaction dates.
+An optional ; COMMENT may follow descriptions or amounts.
+If you make a mistake, enter < at any prompt to restart the transaction.
+To end a transaction, enter . when prompted.
+To quit, enter . at a date prompt or press control-d or control-c.
+Date [2014/07/30]: yesterday
+Description: Trololo
+Account 1: 1.Capital:
+1.Capital:0.Fonds 1.Capital:3.Sub_invest_BNR:9.Compte_résultat:1.Equipement
+1.Capital:0.Fonds:2.SDR 1.Capital:3.Sub_invest_BNR:9.Compte_résultat:1.Equipement:1.État
+1.Capital:0.Fonds:2.SDR:4.Apport 1.Capital:3.Sub_invest_BNR:9.Compte_résultat:1.Equipement:2.Région
+1.Capital:0.Fonds:2.SDR:6.Sub_invest_BR 1.Capital:3.Sub_invest_BNR:9.Compte_résultat:1.Equipement:3.Département
+1.Capital:0.Fonds:3.ADR 1.Capital:3.Sub_invest_BNR:9.Compte_résultat:1.Equipement:4.Commune
+1.Capital:0.Fonds:3.ADR:4.Apport 1.Capital:3.Sub_invest_BNR:9.Compte_résultat:1.Equipement:5.Collectivité_publique
+1.Capital:0.Fonds:3.ADR:6.Sub_invest_BR 1.Capital:3.Sub_invest_BNR:9.Compte_résultat:1.Equipement:6.Entreprise_publique
+1.Capital:0.Fonds:6.Réserve 1.Capital:3.Sub_invest_BNR:9.Compte_résultat:1.Equipement:7.Organisme_privé
+1.Capital:0.Fonds:6.Réserve:3.Statutaire 1.Capital:3.Sub_invest_BNR:9.Compte_résultat:1.Equipement:8.Autre
+1.Capital:0.Fonds:6.Réserve:8.Autre 1.Capital:3.Sub_invest_BNR:9.Compte_résultat:2.Autre
+1.Capital:1.Report 1.Capital:5.Provision_risque&charge
+1.Capital:1.Report:0.Bénéfice 1.Capital:5.Provision_risque&charge:1.Risque
+1.Capital:1.Report:5.Financeur 1.Capital:5.Provision_risque&charge:5.Impôt
+1.Capital:1.Report:9.Déficit 1.Capital:5.Provision_risque&charge:8.Autre
+1.Capital:2.Résultat 1.Capital:5.Provision_risque&charge:8.Autre:2.Congés_à_payer
+1.Capital:2.Résultat:0.Bénéfice 1.Capital:6.Emprunt,Dette
+1.Capital:2.Résultat:9.Déficit 1.Capital:6.Emprunt,Dette:4.Etablissement_crédit
+1.Capital:3.Sub_invest_BNR 1.Capital:6.Emprunt,Dette:5.Dépôt,Caution
+1.Capital:3.Sub_invest_BNR:1.Equipement 1.Capital:6.Emprunt,Dette:8.Autre
+1.Capital:3.Sub_invest_BNR:1.Equipement:1.État 1.Capital:6.Emprunt,Dette:8.Autre:1.Emprunt
+1.Capital:3.Sub_invest_BNR:1.Equipement:2.Région 1.Capital:6.Emprunt,Dette:8.Autre:1.Emprunt:1.Bénévole
+1.Capital:3.Sub_invest_BNR:1.Equipement:3.Département 1.Capital:6.Emprunt,Dette:8.Autre:1.Emprunt:2.Salarié-e
+1.Capital:3.Sub_invest_BNR:1.Equipement:4.Commune 1.Capital:6.Emprunt,Dette:8.Autre:1.Emprunt:3.Cyclofficine
+1.Capital:3.Sub_invest_BNR:1.Equipement:5.Collectivité_publique 1.Capital:6.Emprunt,Dette:8.Autre:1.Emprunt:4.Autre
+1.Capital:3.Sub_invest_BNR:1.Equipement:6.Entreprise_publique 1.Capital:6.Emprunt,Dette:8.Autre:7.Dette
+1.Capital:3.Sub_invest_BNR:1.Equipement:7.Organisme_privé 1.Capital:9.Fonds_dédiés
+1.Capital:3.Sub_invest_BNR:1.Equipement:8.Autre 1.Capital:9.Fonds_dédiés:4.Sub_exploit
+1.Capital:3.Sub_invest_BNR:8.Autre 1.Capital:9.Fonds_dédiés:5.Don_affecté
+1.Capital:3.Sub_invest_BNR:9.Compte_résultat
+Account 1: 1.Capital:6.Emprunt,Dette
+1.Capital:6.Emprunt,Dette 1.Capital:6.Emprunt,Dette:8.Autre:1.Emprunt 1.Capital:6.Emprunt,Dette:8.Autre:1.Emprunt:4.Autre
+1.Capital:6.Emprunt,Dette:4.Etablissement_crédit 1.Capital:6.Emprunt,Dette:8.Autre:1.Emprunt:1.Bénévole 1.Capital:6.Emprunt,Dette:8.Autre:7.Dette
+1.Capital:6.Emprunt,Dette:5.Dépôt,Caution 1.Capital:6.Emprunt,Dette:8.Autre:1.Emprunt:2.Salarié-e
+1.Capital:6.Emprunt,Dette:8.Autre 1.Capital:6.Emprunt,Dette:8.Autre:1.Emprunt:3.Cyclofficine
+Account 1: 1.Capital:6.Emprunt,Dette:4.Etablissement_crédit
+Amount 1: -666 ; Don’t panic
+Account 2: 5.Finance:
+5.Finance:1.Etablissement 5.Finance:1.Etablissement:2.Banque:002.Livret 5.Finance:8.Virement
+5.Finance:1.Etablissement:1.Valeur 5.Finance:3.Caisse 5.Finance:8.Virement:0.Interne
+5.Finance:1.Etablissement:1.Valeur:2.Chèque_à_encaisser 5.Finance:3.Caisse:1.Siège 5.Finance:8.Virement:1.Fonds
+5.Finance:1.Etablissement:2.Banque:001.Courant 5.Finance:3.Caisse:2.Atelier
+Account 2: 5.Finance:1.Etablissement:2.Banque:001.Courant
+Amount 2 [666.0]:
+Account 3 (or . or enter to finish this transaction): .
+2014/07/29 Trololo
+ 1.Capital:6.Emprunt,Dette:4.Etablissement_crédit -666 ; Don’t panic
+ 5.Finance:1.Etablissement:2.Banque:001.Courant 666.0
+
+Save this transaction to the journal ? [y]: y
+Saved.
+Starting the next transaction (. or ctrl-D/ctrl-C to quit)
+Date [2014/07/29]: .
+----
+
+== Exercice comptable
+
+ifdef::backend-slidy2[>>>]
+=== Plan comptable d’une association
+
+//NOTE: Brouillon de documentation @ https://wiki.cyclocoop.org/Comptabilité/Document/Plan_comptable/[]
+
+[source,hledger]
+----
+include::data/Cyclofficine.Plan_comptable.hledger[]
+----
+
+//[cols="a,a"]
+//|==================================
+//|
+//[float]
+//+
+//[source,hledger]
+//----
+//01/01 Vélo ; Écriture d’engagement (pièce comptable : facture)
+// 7.Produit:0.Vente:1.Produit_fini:1.Vélo -80
+// 5.Finance:1.Etablissement:1.Valeur:2.Chèque_à_encaisser 80
+//01/02 Chèque ; Écriture de paiement (pièce comptable : relevé de compte)
+// 5.Finance:1.Etablissement:1.Valeur:2.Chèque_à_encaisser -80
+// 5.Finance:1.Etablissement:2.Banque:001.Courant 80
+//----
+//+
+//NOTE: pour des espèces, transiter par : ++5.Finance:3.Caisse:1.Siège++
+
+//|==================================
+
+=== Relation de Chasles par écritures d’[black]*engagement* et de [black]*paiement*
+
+++hledger++ laisse l’humain s’occuper de ce principe de la tâche comptable
+qui traduit la réalité temporelle des mouvements d’argent.
+
+[source,hledger]
+----
+01/01 Prestation ; Écriture d’engagement (pièce comptable : facture)
+ 7.Produit:0.Vente:6.Prest'action -700,00
+ 4.Tiers:1.Client:1.Client:1.Bien,Prestation:007.Mairie_du_XI 700,00
+01/14 Virement ; Écriture de paiement (pièce comptable : relevé de compte)
+ 4.Tiers:1.Client:1.Client:1.Bien,Prestation:007.Mairie_du_XI -700,00
+ 5.Finance:1.Etablissement:2.Banque:001.Courant 700,00
+----
+
+==== Soldes nuls souhaitables
+
+- Écritures des recettes
++
+1. latexmath:[$\sum{\mbox{ventes}} + \sum{\mbox{dons}} = \sum{\mbox{espèces entrées en caisse}} + \sum{\mbox{Chèques à encaisser}}$] +
+(Total des ventes + dons == Total d’espèces entrée en caisse + chèques à encaisser (5112))
+
+2. Total chèques à encaisser (5112) == Total remises de chèques à la banque (512) (+/- chèques non déposés en banque)
++
+NOTE: vérifier qu’il ne reste plus de chèques comptabilisés dans le tiroir
+
+3. Solde du compte caisse (531) == Total entrées espèces en caisse - Total des sorties
+(remises d’espèces en banque - sorties d’achats - erreur de caisse)
+
+- Écritures de paye
++
+TODO
+
+== Import et export avec ++hledger++
+
+Comme la plupart des logiciels de comptabilité,
+++hledger++ interropère avec le format de tableaux
+http://en.wikipedia.org/wiki/Comma-separated_values[CSV]
+
+++hledger-print-csv++::
++
+[source,sh]
+----
+% hledger-print-csv -f data/exemple-syntaxe.ledger
+sys::[hledger-print-csv -f data/exemple-syntaxe.ledger]
+----
+
+++*.ledger.rules++:: http://hledger.org/manual#csv-files[]
++
+[source,txt]
+----
+% cat banque-postale.livret_A.csv.rules
+skip 1
+fields date,description,amount
+date-format %-d/%-m/%Y