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 qu'une transaction doit être équilibrée. Beancount s'occupe du reste pour vous — il signale toute transaction dont les nombres ne correspondent pas comme une erreur au lieu de l'accepter silencieusement, donc le logiciel attrape 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 sommer à zéro. L'argent quittant un compte est négatif, l'argent arrivant est positif, et une transaction est valide lorsque ses écritures s'annulent. C'est la même comptabilité en partie double que font les comptables, avec le vocabulaire qui déroute les novices supprimé.

Si vous avez utilisé un logiciel de comptabilité traditionnel, la traduction est : un débit est un nombre positif et un crédit est un nombre négatif. Consultez la référence Syntaxe du langage pour savoir comment 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 la somme nulle est ce qui transforme ce fait en un contrôle d'erreur. Si vous dépensez 40 $ en épicerie, cet argent a quitté un compte bancaire — enregistrer les deux moitiés signifie que les deux doivent s'annuler, et toute erreur de frappe dans l'un des montants est signalée comme une erreur au lieu de produire silencieusement un solde incorrect.

C'est pourquoi un grand livre en texte brut est plus fiable qu'un tableur de dépenses : la structure elle-même est auto-vérifiable. Une assertion de solde est le mécanisme connexe 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 la verrouiller. Vous n'avez pas besoin de reconstruire votre historique financier — choisissez une date de début, prenez les soldes tels qu'ils sont ce jour-là, et allez de l'avant à partir de là.

Le Démarrage rapide vous guide à travers un exemple complet de solde d'ouverture.

Commencez grossier et divisez seulement quand une division plus fine changerait une décision. Une vingtaine de comptes suffit pour commencer ; si vous vous demandez si « Dépenses:Alimentation » devrait séparer l'épicerie des restaurants, le test utile est de savoir si vous feriez réellement quelque chose de différent en connaissant la division.

Renommer et diviser plus tard est un 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 avec une catégorie large et la diviser en sous-comptes plus tard sans réécrire l'historique — voir Comment concevoir un plan comptable si vous voulez une structure à copier.

Un tableur ne peut pas vous dire quand il est faux. La comptabilité en texte brut applique la partie double, donc chaque transaction est auto-vérifiable, et le fichier reste interrogeable, différentiable et scriptable aussi longtemps que les fichiers texte existent. Vous avez 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 à entrée unique dérive silencieusement de la vérité. Voir Comptabilité transparente et vérifiable.

Si vous voulez seulement savoir ce que vous avez dépensé en café, oui — un tableur suffit. La partie double montre sa valeur dès que vous avez plusieurs comptes, un prêt hypothécaire, un courtier ou plus d'une devise, car ce sont exactement les situations où le suivi à entrée unique perd de l'argent sans vous le dire.

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

Non. Fava est une interface web complète sur le 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 utiliser un terminal, la ligne de commande bea crée, vérifie et génère 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 OFX/QFX direct de votre banque, une exportation CSV avec des règles d'importation, une connexion d'agrégateur, et — seulement en dernier recours — un relevé PDF converti en CSV. La synchronisation bancaire de Beancount.io gère la connexion et la catégorisation pour vous.

Attendez-vous à écrire ou ajuster une règle par institution : les exportations CSV bancaires sont notoirement incohérentes, et un nom de commerçant contenant une virgule non échappée est un problème réel et courant. Voir Importation intelligente pour le chemin automatisé.

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

Les importateurs dédupliquent par rapport aux entrées déjà dans votre grand livre, en faisant correspondre la date, le montant et le bénéficiaire, et signalent toute ambiguïté pour confirmation plutôt que de deviner. Le flux de travail habituel marque les importations incertaines comme en attente pour que vous les examiniez avant qu'elles ne fassent partie du registre permanent.

OFX rend cela plus facile que CSV : chaque transaction porte un FITID que la banque maintient stable entre les téléchargements, donc un importateur peut faire correspondre par identité plutôt que par inférence — le convertisseur OFX le préserve comme champ de métadonnées id:.

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

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

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

Ajoutez une assertion balance pour le chiffre de clôture du relevé, datée du jour après la date de clôture. Les assertions de solde sont évaluées au début de leur date, donc l'assertion du lendemain matin inclut chaque transaction jusqu'au dernier jour du relevé. Si votre grand livre est en désaccord avec 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.

Un rythme mensuel suffit pour la plupart des gens. Voir Filtrage et recherche pour retrouver une divergence.

Nativement, et c'est l'un de ses plus grands avantages sur les applications de finances personnelles. 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, donc un changement de taux de change ne réécrit jamais silencieusement votre historique.

Rien n'est converti dans votre dos — 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.

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

Beancount prend en charge les méthodes de réservation STRICT, FIFO, LIFO et NONE. La réservation 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 toute autre marchandise : une cryptomonnaie est une unité avec un coût, donc le même mécanisme de lots et de réservation 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 comment vous obtenez le gain réalisé que la plupart des autorités fiscales veulent voir déclaré.

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

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

Voir Configurations spécifiques à l'industrie et la vitrine Open Ledger de livres d'entreprises réels.

Gardez-les séparés — soit comme des arbres de comptes de niveau supérieur distincts dans un fichier, soit comme deux fichiers combinés avec include. Les mélanger rend le compte de résultat de l'entreprise sans signification et rend la saison fiscale plus difficile, et les séparer ne coûte rien au départ.

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

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

Voir Modèles de rapports financiers pour le côté rapports, Configurations spécifiques à l'industrie pour des exemples détaillés, et Comprendre les comptes clients pour les concepts.

Exportez les rapports plutôt que le grand livre. Votre comptable ne veut 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, Modèles de rapports financiers, et Requêtes avec SQL pour extraire exactement les chiffres qu'il demande.

Ce sont tous les trois des systèmes en partie double en texte brut avec des formats de fichiers 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'importation CSV conviviales et sa documentation ; Beancount a l'analyseur le plus strict et le plus grand support pour les investissements, les lots et les devises multiples, plus une API de plugins Python.

La rigueur est le vrai compromis : Beancount refuse de charger un fichier qu'il trouve ambigu, ce qui attrape 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 d'enveloppes strict utilise généralement un plugin communautaire ou modélisent les enveloppes comme des comptes.

Si la budgétisation par enveloppes est la principale chose que vous voulez, lisez Beancount vs YNAB avant de changer. Pour ce qui fonctionne aujourd'hui, voir Budgétisation dans Beancount.

Oui. La directive document relie un fichier à un compte et une date, et l'interface web vous permet de téléverser et parcourir ces documents à côté des transactions auxquelles ils appartiennent. Les reçus restent comme 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 note approximative et la rapprochent 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'entrées. Au-delà, la limite est le confort d'édition et de comparaison, pas le temps de chargement : diviser par année avec include maintient les fichiers individuels petits, mais les fichiers inclus forment toujours un grand livre combiné que Beancount charge et recalcule entièrement, donc c'est une commodité d'organisation de fichiers plutôt qu'une accélération ou un moyen de garder des livres séparés.

Voir Support multi-fichiers pour savoir comment diviser un grand livre qui grossit.