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 applique le reste pour vous — il refuse de charger un fichier dont les transactions ne s'équilibrent pas, donc le logiciel détecte les erreurs qu'un débutant ferait autrement en silence.

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 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 font les comptables, mais 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 de la Syntaxe du langage pour savoir comment sont rédigées les écritures, ou Débits et crédits expliqués pour le contexte comptable en anglais simple.

Parce que l'argent vient toujours de quelque part, et la somme nulle est ce qui transforme ce fait en une vérification d'erreur. Si vous dépensez 40 € en courses, cet argent a quitté un compte bancaire — enregistrer les deux parties signifie que les deux doivent s'annuler, et toute faute de frappe dans l'un ou l'autre montant empêche le fichier de se charger au lieu de produire tranquillement 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 est auto-vérifiante. 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 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 continuez à partir de là.

Le Démarrage rapide présente un exemple complet de solde d'ouverture.

Commencez grossièrement et ne divisez que lorsqu'une division plus fine changerait une décision. Une vingtaine de comptes environ est suffisant pour commencer ; si vous vous demandez si "Expenses:Food" devrait séparer les courses des restaurants, le test utile est de savoir si vous agiriez réellement différemment en connaissant la répartition.

Renommer et diviser plus tard est une opération de recherche-remplacement dans un fichier texte, donc le coût de commencer simplement est faible. Les noms de comptes s'imbriquent, vous pouvez donc commencer par 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 erroné. La comptabilité en texte brut impose la partie double, donc chaque transaction est auto-vérifiante, et le fichier reste recherchable, différentiable et scriptable tant que les fichiers texte existeront. Vous obtenez également un véritable historique des 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 réalité. 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 son intérêt dès que vous avez plusieurs comptes, un prêt hypothécaire, un compte de courtage 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 d'y penser : la partie double est une somme de contrôle pour vos finances. Voir l'Introduction pour une présentation plus longue.

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é, vous pouvez donc utiliser l'interface web au quotidien et passer au terminal uniquement lorsque vous le souhaitez.

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 depuis votre banque, une exportation CSV avec des règles d'importation, une connexion à un 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 établissement : les exportations CSV des banques sont notoirement incohérentes, et un nom de marchand contenant une virgule non échappée est un problème réel et courant. Voir Importation intelligente pour la voie automatisée.

Pour un fichier ponctuel, deux convertisseurs gratuits fonctionnant dans le navigateur effectuent la partie mécanique sans rien téléverser : CSV vers Beancount pour les exports de feuilles de calcul, 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 outils d'importation dédupliquent par rapport aux entrées déjà présentes dans votre grand livre, en faisant correspondre la date, le montant et le bénéficiaire, et signalent tout ce qui est ambigu pour que vous le confirmiez 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 de l'enregistrement permanent.

L'autre moitié de la réponse concerne les virements : l'argent qui se déplace 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.

OFX rend cela plus facile que le CSV : chaque opération comporte un FITID que la banque maintient stable d'un téléchargement à l'autre, de sorte qu'un importateur peut faire correspondre sur la base de l'identité plutôt que de l'inférence — le convertisseur OFX le préserve comme champ de métadonnées id:.

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

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

Ajoutez une assertion balance avec le solde de clôture et la date du relevé. Beancount refusera de charger le fichier si votre grand livre n'est pas d'accord avec la banque, ce qui transforme le rapprochement d'une comparaison manuelle en quelque chose que le logiciel vérifie à chaque exécution.

Une cadence mensuelle est suffisante pour la plupart des gens. Voir Filtrage et recherche pour localiser un écart.

Nativement, et c'est l'un de ses plus grands avantages par rapport aux 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'un changement de taux de change ne réécrit jamais silencieusement votre historique.

Rien n'est converti en coulisse — 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 l'aspect comptable.

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 du calcul au lieu d'être quelque chose que vous calculez à la main.

Beancount prend en charge les méthodes de comptabilisation STRICT, FIFO, LIFO et NONE. La comptabilisation au coût moyen est analysée mais pas complètement 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 tout autre bien : une crypto-monnaie est une unité avec un coût, donc la même logique de lot et de comptabilisation 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 également ainsi que vous obtenez le gain réalisé que la plupart des autorités fiscales veulent voir déclaré.

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

Les 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 simultanée multi-utilisateurs, pas d'interface de facturation intégrée et pas de flux de validation des comptes fournisseurs — c'est un grand livre, pas un ERP.

Voir Configurations spécifiques à un secteur et la vitrine Open Ledger de livres comptables réels d'entreprises.

Gardez-les séparés — soit comme des arborescences de comptes de premier niveau distinctes dans un seul 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 rend la période fiscale plus difficile, 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'exercice, et Beancount la prend directement en charge. 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 l'aspect rapport, Configurations spécifiques à un 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 veut très probablement pas un fichier texte — il veut un compte de résultat, un bilan et une liste de transactions, que vous pouvez produire au format CSV ou PDF depuis l'interface web ou avec une requête.

Voir les Guides de préparation fiscale, les Modèles de rapports financiers, 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 fichiers similaires. Ledger est l'original et l'analyseur syntaxique 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 syntaxique le plus strict et le meilleur support pour les investissements, les lots et les multiples devises, ainsi qu'une API de plugins Python.

La rigueur est le véritable compromis : Beancount refuse de charger un fichier qu'il trouve 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 personnes qui veulent un comportement strict d'enveloppes utilisent 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 lie un fichier à un compte et une date, et l'interface web vous permet de télécharger et de 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 capturer des transactions en déplacement, ce qui est la lacune que la plupart des configurations en texte brut laissent ouverte.

Pour une capture rapide sans application, beaucoup de gens notent une information sommaire et la rapprochent dans le grand livre plus tard.

Une décennie de finances personnelles représente quelques mégaoctets et se charge en 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à, diviser par année avec include maintient les choses confortables.

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