Configuration des Options dans Beancount

Le comportement de Beancount peut être personnalisé à l'aide de directives option placées en haut de votre fichier de grand livre principal. Ces paires clé-valeur contrôlent tout, des noms de vos comptes racines à la manière dont les conversions de devises sont gérées. Une configuration correcte de ces options est essentielle pour adapter Beancount à vos besoins spécifiques. ⚙️

Options de Configuration de Base

Ces options contrôlent la configuration fondamentale de votre grand livre.

Paramètres de Base

Voici quelques-unes des options les plus courantes que vous définirez.

option "title" "Grand Livre Personnel"
option "render_commas" "TRUE"
option "plugin_processing_mode" "raw"

• title : Définit le titre des rapports et des interfaces web.
• render_commas : Si TRUE, les nombres dans les rapports seront formatés avec des séparateurs de milliers (par exemple, 1 000 000,00).
• plugin_processing_mode : Contrôle la manière dont les plugins sont chargés. raw charge uniquement les plugins que vous spécifiez explicitement, tandis que default inclut un ensemble standard de plugins utiles.

Personnalisation des Noms de Compte

Vous pouvez renommer les cinq types de comptes fondamentaux de Beancount. Ceci est purement esthétique et modifie leur apparence dans les rapports.

option "name_assets" "Actifs"
option "name_liabilities" "Passifs"
option "name_equity" "Capitaux Propres"
option "name_income" "Revenus"
option "name_expenses" "Dépenses"

Configuration du Compte de Capitaux Propres

Beancount crée automatiquement plusieurs comptes de capitaux propres spéciaux pour gérer les soldes d'ouverture et les calculs de revenus. Vous pouvez spécifier des noms personnalisés pour ces comptes.

option "account_previous_balances" "Soldes-Ouverture"
option "account_previous_earnings" "Bénéfices:Précédents"
option "account_current_earnings" "Bénéfices:Courants"
option "account_previous_conversions" "Conversions:Précédentes"
option "account_current_conversions" "Conversions:Courantes"
option "account_rounding" "Arrondissement"

• account_previous_balances : Le compte utilisé pour injecter les soldes d'ouverture dans votre grand livre.
• account_current_earnings : Le compte qui accumule tous les totaux des revenus et des dépenses pour la période actuelle, calculant ainsi votre revenu net.
• account_rounding : Le compte où sont comptabilisées les petites différences d'arrondissement automatique.

Paramètres de Précision et de Tolérance

Ces options contrôlent la manière dont Beancount gère l'arrondissement et les petits déséquilibres dans les transactions.

Configuration de la Tolérance par Défaut

Beancount peut automatiquement déduire une tolérance pour les transactions avec plusieurs devises ou coûts, permettant de petites différences d'arrondissement sans provoquer d'erreurs.

option "inferred_tolerance_default" "USD:0.01"
option "inferred_tolerance_multiplier" "1.1"
option "infer_tolerance_from_cost" "True"

• inferred_tolerance_default : Définit la tolérance par défaut pour une devise donnée. Vous pouvez utiliser *:0.5 pour définir une valeur par défaut pour toutes les devises.
• inferred_tolerance_multiplier : Un facteur appliqué à la tolérance pour fournir une marge d'erreur légèrement plus grande.
• infer_tolerance_from_cost : Si True, la tolérance sera déduite du nombre de chiffres dans le coût.

Méthode de Comptabilisation

Cette option définit la manière dont Beancount gère les transactions où une branche est déduite.

option "booking_method" "SIMPLE"

• SIMPLE : Autorise l'équilibrage automatique d'une seule commodité par transaction. C'est la méthode recommandée et la plus courante.
• FULL : Permet d'équilibrer plusieurs commodités, ce qui est une méthode plus complexe et rarement nécessaire.

Gestion des Devises

Une configuration correcte des devises est essentielle pour des rapports précis.

Devise Opérationnelle

Vous pouvez déclarer une ou plusieurs "devises opérationnelles". Ce sont les principales devises dans lesquelles vous effectuez des transactions et que vous souhaitez voir dans les rapports.

option "operating_currency" "USD"
option "operating_currency" "EUR"
option "conversion_currency" "NOTHING"

Déclarer des devises opérationnelles indique à Beancount de créer des colonnes dédiées pour celles-ci dans les rapports, ce qui facilite la visualisation de votre situation financière dans vos devises les plus utilisées. Définir conversion_currency sur NOTHING désactive la colonne de conversion automatique, ce qui est souvent préférable pour des rapports plus clairs.

Gestion des Documents

Beancount peut lier des transactions à des fichiers externes tels que des reçus ou des factures. L'option documents spécifie le(s) dossier(s) racine(s) où ces fichiers sont stockés.

option "documents" "/path/to/documents/archive"

Exigences :

• Les fichiers doivent être nommés au format AAAA-MM-JJ.description.ext (par exemple, 2025-07-28.amazon-order.pdf).
• Vous pouvez spécifier plusieurs options documents pour différents dossiers.
• Les chemins peuvent être absolus ou relatifs au fichier de grand livre principal.

Système de Plugins

La fonctionnalité de Beancount peut être étendue avec des plugins.

Configuration des Plugins

Vous activez un plugin en spécifiant son chemin de module.

option "plugin" "beancount.plugins.module_name"

Comme mentionné précédemment, l'option plugin_processing_mode contrôle si Beancount charge uniquement les plugins que vous avez spécifiés (raw) ou un ensemble par défaut également (default).

Limites et Contraintes Techniques

Ces options contrôlent les aspects techniques de l'analyseur Beancount.

Gestion des Chaînes de Caractères

Vous pouvez définir une limite au nombre de lignes autorisées dans une chaîne de caractères multiligne pour éviter les erreurs d'analyse.

option "long_string_maxlines" "64"

Fonctionnalités Expérimentales

Beancount inclut parfois des fonctionnalités expérimentales que vous pouvez activer avec une option. Par exemple, pour activer la syntaxe de tolérance explicite :

option "experiment_explicit_tolerances" "True"

Cela vous permet de spécifier la tolérance directement dans une écriture de transaction, comme ceci : 532.23 ~ 0.001 USD.

Contrôles du Comportement du Système

Ces options servent à maintenir la compatibilité ou des comportements système spécifiques.

Support Hérité

Cette option active les anciennes valeurs de tolérance fixes pour assurer la rétrocompatibilité avec les anciens grands livres.

option "use_legacy_fixed_tolerances" "True"

Les tolérances fixes héritées étaient :

• Directives Balance/Pad : 0,015 unités
• Transactions : 0,005 unités

Configuration Recommandée ✅

Pour la plupart des utilisateurs, la configuration suivante offre un point de départ robuste et judicieux.

Configuration de Base

option "title" "Grand Livre Personnel"
option "operating_currency" "USD"  // Modifiez avec votre devise principale
option "documents" "/home/user/Documents/beancount" // Modifiez avec le chemin vers vos documents
option "render_commas" "TRUE"

Contrôle de la Précision

option "inferred_tolerance_default" "USD:0.01" // Modifiez avec votre devise principale
option "inferred_tolerance_multiplier" "1.1"
option "infer_tolerance_from_cost" "True"

Structure des Comptes

option "account_previous_balances" "Equity:Opening-Balances"
option "account_current_earnings" "Equity:Current-Earnings"
option "account_rounding" "Expenses:Rounding"

Cette configuration fournit une base solide pour un nouveau grand livre Beancount, garantissant des rapports clairs, un contrôle de précision judicieux et une structure de compte de capitaux propres logique.