Comprendre les écritures comptables dans Beancount
Les écritures comptables sont la colonne vertébrale de la comptabilité en partie double, et dans Beancount, chaque transaction * que vous saisissez est une écriture comptable. Ce guide explique les notions essentielles — débits et crédits, écritures d’ajustement et écritures de contre‑passation — et montre comment elles se traduisent proprement en syntaxe texte brut de Beancount. Vous apprendrez à tenir des livres précis avec un minimum de formalisme.
Rappel rapide : qu’est‑ce qu’une écriture comptable ?
Une écriture comptable est le registre formel, daté, d’une transaction financière. Elle s’exprime en termes de débits et crédits qui maintiennent l’équation comptable fondamentale en équilibre :
Dans un système à partie double, chaque transaction affecte au moins deux comptes, et le total des débits doit être égal au total des crédits. Cette règle simple rend les rapports financiers en aval, comme le compte de résultat et le bilan, fiables et précis.
Débits et crédits en une minute
Les concepts de débits et de crédits peuvent sembler déroutants au départ, mais ils se résument à quelques règles simples. Pensez ainsi : « d’où vient la valeur ? » (crédit) et « où va la valeur ? » (débit).
Voici une fiche mémo indiquant comment ils augmentent les cinq types de comptes principaux :
| Type de compte | Augmente avec |
|---|---|
| Actifs | Débit |
| Charges | Débit |
| Passifs | Crédit |
| Capitaux propres | Crédit |
| Produits | Crédit |
À quoi ressemble une écriture comptable dans Beancount
Beancount utilise des directives texte simples et lisibles par l’humain pour enregistrer les transactions. Chaque transaction doit s’équilibrer à zéro pour chaque marchandise (par ex. USD, EUR, action AAPL). Beancount déclenchera une erreur sinon.
Voici une transaction de base pour l’achat d’un café :
2025-09-10 * "Café Bar" "Café d'équipe"
Expenses:Food:Coffee 18.00 USD
Assets:Bank:Checking -18.00 USD
Remarquez comment les deux écritures (lignes avec comptes) s’annulent : $18.00 + (-$18.00) = 0.
Vous pouvez ajouter un contexte puissant directement dans la narration en utilisant des tags (comme #clientX) pour le filtrage et des liens (comme ^INV-2025-001) pour connecter les écritures liées.
Par exemple, voici comment lier une facture à son paiement :
; Premièrement, enregistrez la facture que vous avez envoyée au client
2025-09-15 * "Acme Corp" "Facture 2025-001 #clientX ^INV-2025-001"
Assets:AccountsReceivable 1000.00 USD
Income:Consulting -1000.00 USD
; Plus tard, enregistrez le paiement et liez‑le à la facture d’origine
2025-09-28 * "Acme Corp" "Paiement sur ^INV-2025-001"
Assets:Bank:Checking 1000.00 USD
Assets:AccountsReceivable -1000.00 USD
Le tag #clientX vous permet de filtrer facilement toutes les transactions de ce client, et le lien ^INV-2025-001 crée une connexion entre les deux écritures que vous pouvez suivre dans les rapports.
Écritures comptables courantes (prêtes à coller)
Voici plusieurs transactions commerciales courantes formatées pour Beancount.
Le propriétaire investit des liquidités
Un propriétaire apporte des fonds personnels pour démarrer l’entreprise.
2025-01-01 * "Propriétaire" "Apport de capital initial"
Assets:Bank:Checking 10000.00 USD
Equity:Owner-Capital -10000.00 USD
Vente en espèces avec taxe de vente
Un client paie en espèces pour un produit, incluant une taxe de vente de 8 % que vous devez ensuite reverser à l’État.
2025-01-05 * "Client sans rendez‑vous" "Vente en espèces avec taxe de 8 %"
Assets:Cash 108.00 USD
Income:Sales -100.00 USD
Liabilities:Tax:Sales -8.00 USD
Vente à crédit (facture) et encaissement
Vous fournissez un service et facturez le client, puis recevez le paiement plus tard.
2025-01-10 * "Acme Corp" "Facture de conseil ^INV-2025-002"
Assets:AccountsReceivable 2500.00 USD
Income:Consulting -2500.00 USD
2025-01-30 * "Acme Corp" "Paiement sur ^INV-2025-002"
Assets:Bank:Checking 2500.00 USD
Assets:AccountsReceivable -2500.00 USD
Dépense sur carte de crédit
Vous achetez du matériel de bureau avec une carte de crédit d’entreprise.
2025-01-12 * "OfficeMax" "Fournitures sur carte de crédit"
Expenses:Office:Supplies 75.00 USD
Liabilities:CreditCard -75.00 USD
Paie (modèle simple)
Vous effectuez la paie, en enregistrant la charge salariale brute, les retenues fiscales des employés, et le paiement net depuis votre banque.
2025-01-31 * "Paie" "Salaires de janvier et retenues"
Expenses:Payroll:Wages 2000.00 USD
Liabilities:Taxes:Withheld -400.00 USD
Assets:Bank:Checking -1600.00 USD
Amortissement mensuel
Vous enregistrez la charge d’amortissement mensuel d’un actif, comme un ordinateur portable.
2025-01-31 * "Amortissement" "Ordinateur portable, ligne droite"
Expenses:Depreciation 100.00 USD
Assets:Equipment:AccumDepr -100.00 USD
Charge prépayée & amortissement mensuel
Vous payez d’avance l’assurance pour une année complète, puis vous comptabilisez un mois de charge.
; 1. Paiement de la police annuelle
2025-01-01 * "AssureCo" "Prime d’assurance annuelle"
Assets:Prepaid:Insurance 1200.00 USD
Assets:Bank:Checking -1200.00 USD
; 2. Reconnaissance d’un mois de charge à la fin de janvier
2025-01-31 * "AssureCo" "Amortir 1/12 de l’assurance"
Expenses:Insurance 100.00 USD
Assets:Prepaid:Insurance -100.00 USD
Produit différé & reconnaissance mensuelle
Un client paie d’avance un abonnement de 3 mois. Vous enregistrez l’encaissement puis reconnaissez un mois de revenu.
; 1. Le client paie d’avance le service
2025-02-01 * "Abonné" "Plan de 3 mois prépayé"
Assets:Bank:Checking 300.00 USD
Liabilities:Unearned:Subs -300.00 USD
; 2. Reconnaissance d’un mois de revenu après prestation du service
2025-02-28 * "Reconnaissance" "Reconnaître le mois 1 sur 3"
Liabilities:Unearned:Subs 100.00 USD
Income:Subscriptions -100.00 USD
Provision pour créances douteuses et radiation
Vous constituez une provision pour les factures potentiellement irrécouvrables, puis vous radiez une facture précise.
; 1. Création d’une provision de 2 % des comptes clients
2025-03-31 * "Provision" "2 % des comptes clients pour créances douteuses"
Expenses:BadDebt 200.00 USD
Assets:AllowanceForDoubtful -200.00 USD
; 2. Radiation d’une facture précise que vous savez ne pas être payée
2025-04-15 * "Radiation" "Facture client XYZ"
Assets:AllowanceForDoubtful 150.00 USD
Assets:AccountsReceivable -150.00 USD
Inventaire périodique & ajustement du COGS
En fin de période, vous calculez le coût des marchandises vendues (COGS) en ajustant votre compte d’inventaire.
2025-03-31 * "Ajustement COGS" "Méthode d’inventaire périodique"
Expenses:COGS 4500.00 USD
Assets:Inventory -4500.00 USD
Écritures d’ajustement vs. écritures de contre‑passation
Les écritures d’ajustement sont enregistrées à la fin d’une période comptable (mois ou trimestre) afin d’aligner correctement les revenus et les charges à la période où ils ont réellement été gagnés ou engagés. Cela comprend les provisions, les reports et les estimations comme l’amortissement.
Les écritures de contre‑passation sont des écritures optionnelles effectuées le premier jour d’une nouvelle période qui annulent exactement une écriture d’ajustement du période précédente. Leur but est de simplifier la comptabilité. En annulant une provision, vous pouvez comptabiliser la transaction de trésorerie suivante de façon standard sans devoir vous souvenir de la ventiler contre le compte de passif.
Exemple : comptabilisation et contre‑passation des services publics
Supposons que vous devez enregistrer votre charge de services publics de janvier, mais que la facture n’arrivera qu’en février.
; 1. Comptabiliser la charge estimée à la fin de janvier
2025-01-31 * "Provision" "Estimation de la charge de services publics de janvier"
Expenses:Utilities 500.00 USD
Liabilities:Accrued:Utilities -500.00 USD
; 2. (Optionnel) Annuler la provision le premier jour de la période suivante
2025-02-01 * "Annulation" "Annuler la provision de services publics de janvier"
Liabilities:Accrued:Utilities 500.00 USD
Expenses:Utilities -500.00 USD
; 3. Enregistrer le paiement réel lorsque la facture arrive en février
; La facture réelle est de 520 USD. Grâce à l’annulation, vous pouvez
; comptabiliser le montant complet dans le compte de charge sans problème.
; La charge nette pour février sera 520 USD - 500 USD = 20 USD.
2025-02-10 * "Services publics" "Paiement sur ^INV-2025-001"
Assets:Bank:Checking 520.00 USD
Liabilities:Accrued:Utilities -520.00 USD
Checklist pour chaque écriture comptable Beancount
- Vérifiez que chaque ligne de transaction commence par un espace après le symbole
*. - Utilisez des descriptions claires dans les champs de narration.
- Assurez‑vous que les montants débités et crédités s’équilibrent à zéro.
- Ajoutez des tags pertinents (
#exemple) pour faciliter le filtrage. - Créez des liens (
^CODE) lorsque des écritures sont liées entre elles. - Incluez, si nécessaire, des champs de métadonnées supplémentaires (par ex.
metadata: "valeur").
Erreurs courantes (et comment Beancount aide)
- Oublier d’équilibrer les montants – Beancount signale immédiatement une erreur si le total des débits n’est pas égal au total des crédits.
- Mauvaise utilisation des tags – Les tags doivent être précédés d’un
#et ne doivent contenir aucun espace. Beancount les reconnaît automatiquement pour le filtrage. - Confusion entre comptes d’actif et de passif – Vérifiez toujours que les comptes sont correctement classés dans le plan comptable.
- Oublier les provisions – Les écritures d’ajustement permettent de refléter les charges réellement engagées même si la facture n’est pas encore arrivée.
- Gestion manuelle des contre‑passations – Beancount simplifie le processus en annulant automatiquement les écritures d’ajustement lorsqu’elles sont correctement marquées.
Où aller ensuite
- Documentation officielle de Beancount – explorez les guides détaillés et les références de syntaxe.
- Tutoriels vidéo – regardez des démonstrations pas à pas pour créer vos propres écritures.
- Forums communautaires – posez des questions et partagez vos modèles avec d’autres utilisateurs.
- Extensions et plugins – découvrez des outils qui automatisent la génération d’écritures à partir de CSV ou d’autres sources de données.
Annexe : Correspondance comptabilité → Beancount
| Concept comptable | Syntaxe Beancount |
|---|---|
| Écriture d’ajustement | adjust |
| Écriture de contre‑passation | reversal |
| Provision | allowance |
| Charge prépayée | prepaid |
| Produit différé | unearned |
| Amortissement | depreciation |
| Facture | invoice |
| Paiement | payment |
| Compte d’actif | Assets |
| Compte de passif | Liabilities |
| Compte de charge | Expenses |
| Compte de produit | Income |
| Compte de capitaux propres | Equity |
