FAQ Beancount : Questions sur la comptabilité en texte brut

Environ cinq concepts, pas un diplôme. Vous avez besoin des cinq types de comptes (actifs, passifs, capitaux propres, revenus, dépenses), de l'idée que chaque transaction déplace de la valeur entre au moins deux d'entre eux, et de la règle selon laquelle une transaction doit s'équilibrer. Beancount applique le reste pour vous — il signale toute transaction dont les chiffres ne s'additionnent pas comme une erreur au lieu de l'accepter silencieusement, de sorte que le logiciel détecte les erreurs qu'un débutant manquerait autrement.

Commencez par l'Introduction à Beancount, gardez le Glossaire ouvert dans un onglet, et ajoutez vos premières transactions dans le Démarrage rapide.

Beancount n'utilise pas du tout les mots « débit » et « crédit » — il utilise des nombres signés qui doivent totaliser zéro. L'argent qui quitte un compte est négatif, l'argent qui arrive est positif, et une transaction est valide lorsque ses écritures s'annulent. C'est la même comptabilité en partie double que pratiquent les comptables, avec le vocabulaire qui déroute les nouveaux venus supprimé.

Si vous avez utilisé un logiciel de comptabilité traditionnel, la traduction est la suivante : un débit est un nombre positif et un crédit un nombre négatif. Consultez la référence Syntaxe du langage pour la façon dont les écritures sont rédigées, ou Débits et crédits expliqués pour le contexte comptable en langage simple.

Parce que l'argent vient toujours de quelque part, et c'est ce jeu à somme nulle qui transforme ce fait en contrôle d'erreur. Si vous dépensez 40 $ en courses, cet argent a quitté un compte bancaire — enregistrer les deux moitiés signifie que les deux doivent s'annuler, et toute faute de frappe dans l'un ou l'autre montant est signalée comme une erreur au lieu de produire discrètement un solde erroné.

C'est pourquoi un grand livre en texte brut est plus fiable qu'un tableur de dépenses : la structure elle-même s'autovérifie. Une assertion de solde est le mécanisme associé qui vérifie votre grand livre par rapport à la réalité.

Enregistrez une transaction à votre date de début qui déplace le solde actuel de chaque compte depuis Equity:Opening-Balances, puis ajoutez une assertion balance pour le verrouiller. Vous n'avez pas besoin de reconstituer votre historique financier — choisissez une date de début, prenez les soldes tels qu'ils sont ce jour-là, et avancez à partir de là.

Le Démarrage rapide détaille un exemple complet de soldes d'ouverture.

Commencez grossièrement et ne subdivisez que lorsqu'une ventilation plus fine changerait une décision. Une vingtaine de comptes suffit amplement pour débuter ; si vous vous demandez si « Expenses:Food » devrait séparer les courses des restaurants, le test utile est de savoir si vous feriez réellement quelque chose différemment en connaissant la ventilation.

Renommer et subdiviser plus tard se fait par rechercher-remplacer dans un fichier texte, donc le coût de commencer simplement est faible. Les noms de comptes s'imbriquent, donc vous pouvez commencer par une catégorie large et la subdiviser en sous-comptes plus tard sans réécrire l'historique — voir Comment concevoir un plan de comptes si vous voulez une structure à copier.

Un tableur ne peut pas vous dire quand il est faux. La comptabilité en texte brut impose la partie double, de sorte que chaque transaction s'autovérifie, et le fichier reste interrogeable par grep, comparable par diff et scriptable aussi longtemps que les fichiers texte existeront. Vous obtenez aussi un véritable historique de versions : git log sur votre grand livre montre exactement ce qui a changé, quand et pourquoi.

La différence pratique apparaît avec plusieurs comptes, devises ou investissements, où un tableur en partie simple dérive silencieusement loin de la vérité. Voir Comptabilité transparente et auditable.

Si vous voulez seulement savoir combien vous avez dépensé en café, oui — un tableur suffit. La partie double justifie son coût dès que vous avez plusieurs comptes, un prêt immobilier, un compte-titres ou plus d'une devise, car ce sont exactement les situations où le suivi en partie simple perd de l'argent sans vous le dire.

Une façon utile d'y penser : la partie double est une somme de contrôle pour vos finances. Voir l'Introduction pour l'argumentaire complet.

Non. Fava est une interface web complète au-dessus du même fichier texte — bilans, comptes de résultat, graphiques et saisie de transactions — et Beancount.io l'exécute pour vous avec votre grand livre dans le cloud. Le fichier texte reste la source de vérité, donc vous pouvez utiliser l'interface web au quotidien et passer au terminal seulement quand vous le souhaitez. Si vous préférez un terminal, la ligne de commande bea crée, vérifie et produit des rapports sur ce même fichier — voir le démarrage rapide de la CLI.

Voir Fonctionnalités de l'interface pour ce que l'interface peut faire, ou essayez la démo en direct.

La plupart des gens importent 80 à 95 % des transactions et saisissent le reste à la main. Par ordre approximatif de fiabilité : un téléchargement direct OFX/QFX depuis votre banque, un export CSV plus des règles d'import, une connexion via un agrégateur, et — en dernier recours seulement — un relevé PDF converti en CSV. La synchronisation bancaire de Beancount.io gère la connexion et la catégorisation pour vous.

Prévoyez d'écrire ou d'ajuster une règle par institution : les exports CSV des banques sont notoirement incohérents, et un nom de commerçant contenant une virgule non échappée est un problème réel et courant. Voir Import intelligent pour la voie automatisée.

Pour un fichier ponctuel, deux convertisseurs gratuits dans le navigateur font la partie mécanique sans rien téléverser : CSV vers Beancount pour les exports de tableurs, et OFX et QIF vers Beancount pour les téléchargements .ofx, .qfx, .qbo et .qif que les banques proposent lorsqu'elles n'offrent aucun CSV.

Les importateurs dédupliquent par rapport aux écritures déjà présentes dans votre grand livre, en faisant correspondre la date, le montant et le bénéficiaire, et signalent tout élément ambigu à confirmer plutôt que de deviner. Le flux de travail habituel marque les imports incertains comme en attente afin que vous les vérifiiez avant qu'ils ne fassent partie du registre permanent.

OFX rend cela plus facile que CSV : chaque transaction porte un FITID que la banque garde stable d'un téléchargement à l'autre, donc un importateur peut faire correspondre par identité plutôt que par inférence — le convertisseur OFX le conserve comme champ de métadonnées id:.

L'autre moitié de la réponse concerne les virements : l'argent qui circule entre deux comptes que vous possédez apparaît dans les exports des deux banques. Enregistrez-le une fois comme une seule transaction avec deux écritures.

Non — et pour beaucoup de gens, c'est la raison même d'utiliser la comptabilité en texte brut. Vous pouvez exporter OFX ou CSV depuis votre banque vous-même et ne jamais confier vos identifiants à un agrégateur. Si vous préférez la synchronisation automatisée, Beancount.io utilise un agrégateur agréé par les banques plutôt que de stocker votre mot de passe de banque en ligne.

Lisez les détails sur la page de sécurité.

Ajoutez une assertion balance pour le solde de clôture du relevé, datée du jour suivant la date de clôture. Les assertions de solde sont évaluées au début de leur date, donc l'assertion du lendemain matin est celle qui inclut toutes les transactions jusqu'au dernier jour du relevé. Si votre grand livre diverge de la banque, bea check signale une erreur Balance failed et se termine avec un code non nul, ce qui transforme le rapprochement d'une comparaison manuelle en quelque chose que le logiciel vérifie à chaque exécution.

Une fréquence mensuelle suffit pour la plupart des gens. Voir Filtrage et recherche pour traquer un écart.

Nativement, et c'est l'un de ses plus grands avantages sur les applications de finances grand public. Chaque montant porte sa devise, les comptes peuvent en détenir plusieurs à la fois, et les conversions sont enregistrées explicitement avec @ pour un prix ou {} pour un coût, de sorte qu'une variation du taux de change ne réécrit jamais silencieusement votre historique.

Rien n'est converti à votre insu — vous voyez toujours à la fois la devise d'origine et la valeur convertie. Voir Syntaxe du langage, Précision et tolérances, et Comptabilité multi-devises pour le côté comptable.

Utilisez Prix en direct pour les actifs pris en charge dans un grand livre Beancount.io hébergé, ou récupérez des cotations dans des fichiers de prix locaux pour Beancount en amont et Fava. Le sélecteur vous permet de choisir une devise de cotation et de copier les includes gérés. Les versions compatibles de bea prennent aussi en charge les includes gérés ; le guide de configuration renvoie à leurs instructions.

Les prix gérés affectent la valorisation de marché, pas les montants des transactions ni la base de coût. Votre propre prix est prioritaire pour la même date et la même paire. Les rafraîchissements peuvent utiliser des prix en cache périmés pendant une panne, et une cotation ultérieure ne peut pas combler une date de valorisation historique manquante.

Enregistrez les achats avec un coût entre accolades — 10 AAPL {150.00 USD} — et Beancount suit chaque lot séparément. Lorsque vous vendez, vous indiquez quel lot vous réduisez, et la plus-value découle automatiquement de l'arithmétique au lieu d'être quelque chose que vous calculez à la main.

Beancount prend en charge les méthodes d'affectation STRICT, FIFO, LIFO et NONE. L'affectation au coût moyen est analysée mais pas entièrement implémentée — si votre juridiction fiscale exige le coût moyen, prévoyez de le suivre avec un plugin ou des lots explicites. Voir Gestion des stocks.

Exactement comme n'importe quelle autre marchandise : une cryptomonnaie est une unité avec un coût, donc la même mécanique de lots et d'affectation s'applique. Un échange d'un jeton contre un autre est une seule transaction qui réduit un lot et en ouvre un autre, ce qui est aussi la façon d'obtenir la plus-value réalisée que la plupart des administrations fiscales veulent voir déclarée.

Voir Suivi de portefeuille de cryptomonnaies et les modèles crypto prêts à l'emploi.

Les entreprises l'utilisent, y compris des sociétés comptant des centaines de milliers de transactions. Il gère la comptabilité d'engagement, les structures multi-entités et les rapports qu'un comptable attend. Les limites honnêtes sont l'absence d'édition concurrente multi-utilisateurs, d'interface de facturation intégrée et de flux d'approbation des comptes fournisseurs — c'est un grand livre, pas un ERP.

Voir Configurations propres à chaque secteur et la vitrine Open Ledger de vrais livres d'entreprise.

Gardez-les séparés — soit comme arborescences de comptes de premier niveau distinctes dans un même fichier, soit comme deux fichiers combinés avec include. Les mélanger rend le compte de résultat de l'entreprise dénué de sens et complique la période fiscale, et les séparer ne coûte rien au départ.

Deux fichiers sont généralement le choix le plus propre une fois que l'entreprise a son propre compte bancaire. Voir Prise en charge multi-fichiers.

Modélisez les créances comme un compte d'actif et les dettes comme un passif, puis enregistrez la facture lorsque vous l'émettez et le paiement lorsqu'il arrive — c'est la comptabilité d'engagement, et Beancount la prend en charge directement. Ce qu'il n'a pas, c'est une interface de facturation : il suit ce qu'on vous doit, il ne génère ni n'envoie la facture.

Voir Modèles de reporting financier pour le volet rapports, Configurations propres à chaque secteur pour des exemples concrets, et Comprendre les créances clients pour les concepts.

Exportez les rapports plutôt que le grand livre. Votre comptable ne voudra presque certainement pas d'un fichier texte — il veut un compte de résultat, un bilan et une liste de transactions, que vous pouvez produire en CSV ou PDF depuis l'interface web ou avec une requête.

Voir les Guides de préparation fiscale, les Modèles de reporting financier, et Interroger avec SQL pour extraire exactement les chiffres qu'il demande.

Les trois sont des systèmes en partie double en texte brut avec des formats de fichier similaires. Ledger est l'original et l'analyseur le plus permissif ; hledger est une réimplémentation en Haskell connue pour ses règles d'import CSV conviviales et sa documentation ; Beancount a l'analyseur le plus strict et le meilleur support des investissements, des lots et des devises multiples, plus une API de plugins Python.

La strictness est le vrai compromis : Beancount refuse de charger un fichier qu'il juge ambigu, ce qui détecte les erreurs tôt au prix d'être plus pointilleux. Voir Beancount vs Ledger CLI et Beancount vs hledger.

Pas nativement — c'est une véritable lacune plutôt qu'une fonctionnalité cachée. La budgétisation intégrée de Beancount est limitée, et les gens qui veulent un comportement strict par enveloppes utilisent généralement un plugin communautaire ou modélisent les enveloppes comme des comptes.

Si la budgétisation par enveloppes est votre principal besoin, lisez Beancount vs YNAB avant de changer. Pour ce qui fonctionne aujourd'hui, voir Budgétisation dans Beancount.

Oui. La directive document lie un fichier à un compte et une date, et l'interface web vous permet de téléverser et de parcourir ces documents aux côtés des transactions auxquelles ils appartiennent. Les reçus restent des fichiers ordinaires sur le disque, donc ils sont aussi portables que le grand livre lui-même.

Voir Fonctionnalités de l'interface.

Oui — Beancount.io publie des applications iOS et Android pour consulter votre grand livre et saisir des transactions en déplacement, ce qui est la lacune que la plupart des configurations en texte brut laissent ouverte.

Pour une saisie rapide sans application, beaucoup de gens notent une approximation et la réconcilient dans le grand livre plus tard.

Une décennie de finances personnelles représente quelques mégaoctets et se charge en bien moins d'une seconde. Beancount recalcule les soldes à partir de l'historique complet des transactions à chaque chargement, et cela reste rapide jusqu'à des centaines de milliers d'écritures. Au-delà, la limite est le confort d'édition et de diff, pas le temps de chargement : fractionner par année avec include garde les fichiers individuels petits, mais les fichiers inclus forment toujours un seul grand livre combiné que Beancount charge et recalcule en entier, donc c'est une commodité d'organisation de fichiers plutôt qu'une accélération ou un moyen de tenir des livres séparés.

Voir Prise en charge multi-fichiers pour savoir comment fractionner un grand livre qui grossit.