Glossaire

La comptabilité en texte brut emprunte son vocabulaire à la comptabilité en partie double et y ajoute quelques mots propres à Beancount. Ce glossaire définit les termes que vous rencontrerez en lisant cette documentation ou votre propre fichier journal, chacun accompagné d'un court exemple lorsque cela est utile. Chaque entrée possède son propre lien, vous pouvez donc envoyer un collègue directement vers une définition.

Compte​

Un compte est un conteneur nommé qui suit un flux de valeur, écrit sous forme d'une hiérarchie séparée par des deux-points, sous l'un des cinq types racines : Assets, Liabilities, Equity, Income ou Expenses. La hiérarchie constitue toute la structure organisatrice de vos livres — Assets:US:BofA:Checking et Expenses:Food:Restaurant se trient et se cumulent automatiquement. Chaque compte doit être déclaré avant d'être utilisé. Voir Syntaxe du langage Beancount pour les règles de nommage.

Comptabilité d'engagement​

La comptabilité d'engagement enregistre les revenus lorsqu'ils sont gagnés et les dépenses lorsqu'elles sont encourues, indépendamment du moment où l'argent circule réellement. La comptabilité de trésorerie fait le contraire : elle ne reconnaît les deux que lorsque l'argent change de mains. La comptabilité d'engagement donne une image plus fidèle de la performance d'une période, c'est pourquoi une facture envoyée en mars appartient à mars même si le client paie en mai.

Amortissement​

L'amortissement répartit un paiement unique important sur les périodes qu'il couvre réellement, de sorte que chaque mois supporte sa juste part du coût. Une prime d'assurance annuelle payée en janvier est une charge des douze mois, pas seulement de janvier. Dans Beancount, vous écrivez les écritures de répartition à la main ou les générez avec un plugin — voir Amortir.

Assertion de solde​

Une assertion de solde est une directive balance qui indique quel doit être le solde d'un compte au début d'une date donnée, de sorte que votre relevé bancaire devienne une vérification automatique de vos livres. Si le solde calculé diffère, Beancount échoue bruyamment avec les montants attendus et réels. Placer une assertion par compte et par relevé est le moyen le moins cher de rendre un journal digne de confiance.

2026-01-01 balance Assets:US:BofA:Checking   4,321.00 USD

Beancount​

Beancount est un système de comptabilité en partie double open source dont le journal est un fichier texte brut que vous éditez dans n'importe quel éditeur de texte et validez avec un outil en ligne de commande. Il vous offre une syntaxe stricte et analysable, un langage de requête et une interface web, sans base de données ni format de fichier propriétaire. Parce que le journal est du texte, il vit joyeusement dans Git aux côtés de votre code. Commencez par Introduction à Beancount.

Langage de requête Beancount​

Le langage de requête Beancount, généralement abrégé BQL, est le langage de type SQL que vous utilisez pour poser des questions à votre journal. Il s'exécute sur les directives analysées plutôt que sur une base de données, donc SELECT account, sum(position) WHERE year = 2026 répond immédiatement à partir du même fichier que vous éditez. Lisez le guide du langage de requête pour la grammaire complète.

Méthode de comptabilisation​

Une méthode de comptabilisation est la règle que Beancount applique lorsqu'une réduction doit choisir quels lots existants déduire. Les choix sont STRICT (vous devez identifier le lot vous-même), FIFO, LIFO, AVERAGE et NONE, définis par compte sur sa directive open. La méthode que vous choisissez modifie vos gains en capital réalisés, choisissez donc celle attendue par votre juridiction fiscale et gardez-la stable.

Plan comptable​

Un plan comptable est la liste complète des comptes que votre journal utilise, ainsi que la structure qui les organise. Dans Beancount, il n'y a pas de fichier de plan comptable séparé — l'ensemble des directives open est votre plan comptable. Bien le concevoir tôt évite beaucoup de renommages ultérieurs ; voir Configurations spécifiques à un secteur pour des points de départ.

Directive Close​

Une directive close marque la date après laquelle un compte ne peut plus être utilisé, ce qui permet de retirer un compte bancaire ou un prêt remboursé sans supprimer son historique. Les transactions passées restent valides et déclarables ; seules les nouvelles écritures sont rejetées. Fermer les comptes inutilisés maintient les rapports lisibles à mesure que le journal vieillit.

2026-03-31 close Assets:US:OldBank:Checking

Marchandise​

Une marchandise est toute unité de valeur que votre journal suit — une devise comme USD, un ticker boursier comme AAPL, un actif crypto comme BTC, ou quelque chose que vous inventez comme VACATION-DAYS. Beancount ne convertit jamais de marchandises en cachette, donc un montant est toujours un nombre associé à la marchandise dans laquelle il est libellé. Une directive commodity facultative vous permet d'attacher des métadonnées comme un nom ou une classe d'actifs.

Base de coût​

La base de coût est ce que vous avez réellement payé pour une position, enregistrée dans la devise avec laquelle vous avez payé et transportée avec la position aussi longtemps que vous la possédez. Beancount l'écrit entre accolades — 10 AAPL {150.00 USD} signifie dix actions acquises à 150 dollars chacune. Parce que la base voyage avec la position, les gains en capital découlent de l'arithmétique lorsque vous vendez. Voir Gestion des inventaires.

Directive​

Une directive est une instruction datée dans un fichier Beancount, et les directives sont tout ce que contient un journal. Chaque ligne qui commence par une date en est une : open, close, balance, price, note, document, pad, event, commodity et la transaction elle-même. Beancount trie les directives par date avant de les traiter, vous pouvez donc les conserver dans l'ordre de lecture le plus pratique.

Comptabilité en partie double​

La comptabilité en partie double est la pratique consistant à enregistrer chaque événement économique sous forme d'au moins deux écritures correspondantes, de sorte que les montants s'additionnent toujours à zéro. L'argent n'est jamais créé ni détruit — il se déplace uniquement entre les comptes, c'est pourquoi cette technique détecte des erreurs qu'une simple liste à une colonne ne détecterait jamais. Beancount applique strictement cette règle : une transaction dont les écritures ne s'équilibrent pas est une erreur, pas un avertissement.

Budget par enveloppes​

Le budget par enveloppes consiste à mettre de côté de l'argent pour un but avant de le dépenser, de sorte que chaque catégorie ait sa propre limite au lieu de se disputer un solde commun. Le nom vient des enveloppes en papier que les gens remplissaient autrefois de liquide le jour de paie. Dans un journal en texte brut, vous modélisez les enveloppes avec des comptes dédiés ou des directives de budget — voir Budgets.

Fava​

Fava est l'interface web pour Beancount : graphiques, bilans, comptes de résultat, un éditeur de requêtes et un formulaire de saisie, servis à partir de votre fichier journal. Il est principalement en lecture seule et s'exécute localement, donc il change la façon dont vous voyez vos livres sans changer la façon dont vous les enregistrez. beancount.io héberge une version gérée aux côtés de ses propres outils ; le guide Fonctionnalités de l'interface utilisateur couvre ce que vous pouvez y faire.

Inventaire​

Un inventaire est l'ensemble des positions qu'un compte détient actuellement, chacune avec sa propre marchandise et, le cas échéant, sa propre base de coût et sa propre date d'acquisition. Un compte de courtage qui a acheté la même action trois fois détient trois lots séparés dans un seul inventaire, pas un nombre mélangé. Garder les lots distincts est ce qui permet des calculs de gains précis.

Journal​

Le journal est la liste chronologique de tout ce qui s'est passé dans vos livres — le flux brut des transactions, dans l'ordre des dates, avant tout regroupement ou résumé. C'est la vue que vous parcourez lorsque vous voulez répondre à "qu'ai-je réellement fait en mars ?". La page du journal dans Fava est généralement l'endroit le plus rapide pour repérer une écriture mal catégorisée.

Livre / Journal​

Un livre est l'ensemble complet des enregistrements comptables pour une entité, ce qui dans Beancount signifie votre fichier texte brut (plus tout ce qu'il inclut). Le mot fait double emploi comme nom du livre de comptes entier et comme nom du fichier lui-même. Parce qu'il est textuel, un livre peut être comparé, révisé, branché et fusionné comme du code source.

Lot​

Un lot est une acquisition spécifique d'une marchandise, identifiée par sa base de coût et sa date d'acquisition. Acheter le même ETF en janvier et à nouveau en juin crée deux lots, et vendre plus tard implique de choisir quel lot vous vendez. Les lots sont la raison pour laquelle Beancount peut calculer exactement les gains réalisés au lieu de les approximer.

2026-06-15 * "Broker" "Buy VTI"
  Assets:US:Broker:VTI     5 VTI {260.00 USD, 2026-06-15}
  Assets:US:Broker:Cash            -1,300.00 USD

Narration​

La narration est la description en texte libre de ce qu'était une transaction, écrite comme la deuxième chaîne entre guillemets sur la ligne de transaction. Elle est destinée aux humains : "Loyer mensuel", "Courses et ménage". Beancount ne l'analyse pas, mais c'est ce que vous lirez quand l'écriture n'aura plus de sens dans six mois.

Directive Open​

Une directive open déclare un compte, la date à laquelle il commence à être utilisable, et éventuellement les marchandises qu'il peut contenir et la méthode de comptabilisation qu'il utilise. Beancount exige que chaque compte soit ouvert avant sa première écriture, ce qui empêche une faute de frappe de créer silencieusement un tout nouveau compte. Restreindre les marchandises autorisées transforme une autre classe entière d'erreurs en erreurs.

2026-01-01 open Assets:US:Broker:VTI   VTI   "FIFO"

Pad​

Une directive pad dit à Beancount d'insérer le montant nécessaire pour faire réussir la prochaine assertion de solde sur un compte, en imputant la différence à un second compte. Elle existe pour exactement un travail : ouvrir un journal en cours de route sans reconstruire des années d'historique. Utiliser le pad au-delà de cette configuration initiale signifie généralement qu'une vraie erreur est en train d'être masquée.

Bénéficiaire​

Le bénéficiaire est la personne avec laquelle vous avez effectué la transaction, écrit comme la première chaîne entre guillemets sur une ligne de transaction. Garder les bénéficiaires cohérents — toujours "Whole Foods", jamais parfois "WholeFoods" — est ce qui fait fonctionner les rapports basés sur les bénéficiaires et les importateurs automatisés. Beancount traite le bénéficiaire comme facultatif ; une transaction peut n'avoir qu'une narration.

Comptabilité en texte brut​

La comptabilité en texte brut est la pratique consistant à tenir vos livres dans un fichier texte lisible par l'homme sous contrôle de version, traité par des outils open source en ligne de commande. Elle échange une interface pointer-cliquer contre la durabilité, l'auditabilité et l'automatisation : vos données survivent à tout fournisseur, chaque changement est une différence révisable, et n'importe quel script peut les lire. Beancount, Ledger et hledger sont les trois implémentations les plus connues.

Plugin​

Un plugin est un module Python que Beancount charge lors du traitement de votre fichier, lui permettant d'ajouter, transformer ou valider des directives avant que les rapports ne soient construits. Les plugins sont la façon dont les prévisions, les échéanciers d'amortissement et les vérifications personnalisées sont implémentés sans modifier le langage principal. Vous en activez un avec une ligne plugin en haut de votre journal — le guide Plugin de prévision parcourt un exemple réel.

Écriture​

Une écriture est une jambe d'une transaction : un compte, un montant, et éventuellement un coût ou un prix. Une transaction a besoin d'au moins deux écritures, et leurs montants doivent totaliser zéro. Au plus une écriture peut laisser son montant vide, auquel cas Beancount calcule le chiffre d'équilibrage pour vous.

Directive Price​

Une directive price enregistre le taux de change entre deux marchandises à une date, ce qui permet à Beancount de convertir une position en sa valeur de marché dans les rapports. Les prix sont de pures données de référence — ils ne déplacent jamais d'argent et n'apparaissent jamais dans une transaction. Sans eux, un portefeuille s'équilibre toujours au coût mais ne peut pas être évalué au marché.

2026-06-30 price VTI   271.40 USD

Rapprochement​

Le rapprochement est l'acte de prouver que vos livres concordent avec un enregistrement externe tel qu'un relevé bancaire ou de courtage. En comptabilité en texte brut, il est largement mécanique : ajoutez une assertion de solde pour chaque date de relevé et laissez l'outil vous dire si les nombres correspondent. Un livre qui se rapproche proprement chaque mois est un livre à partir duquel vous pouvez déclarer vos impôts sans crainte.

Tags et liens​

Les tags et les liens sont les deux étiquettes que vous attachez aux transactions pour les regrouper en dehors de la hiérarchie des comptes : un tag avec # marque un thème comme #voyage-japon, et un lien avec ^ relie des entrées connexes comme ^facture-2026-014. Les tags répondent à "montre-moi tout dans cette catégorie" ; les liens répondent à "montre-moi les entrées qui appartiennent à cet événement". Les deux sont filtrables dans Fava et interrogeables en BQL — voir Filtrage et recherche.

Transaction​

Une transaction est un événement économique daté accompagné des écritures qui l'enregistrent, et c'est la directive que vous écrirez le plus souvent. Elle porte un drapeau (* pour confirmé, ! pour à vérifier), un bénéficiaire facultatif, une narration, et deux écritures ou plus dont les montants totalisent zéro. Tout le reste dans un fichier Beancount existe pour déclarer, vérifier ou annoter des transactions.

2026-02-14 * "Blue Bottle" "Coffee with Dana"
  Expenses:Food:Coffee      9.50 USD
  Assets:US:BofA:Checking  -9.50 USD

Toujours bloqué sur un mot ? Le Centre d'aide indexe tous les guides de ce site, et l'Aide-mémoire présente la syntaxe de chaque directive côte à côte.