Enregistrer ses impôts dans Beancount (l’approche pragmatique)

Les impôts peuvent sembler être un cas particulier et complexe dans le monde des finances personnelles. Mais et si ce n'était pas le cas ? Et si vous pouviez les traiter comme n'importe quel autre flux d'argent dans votre grand livre ? Bonne nouvelle : c'est possible. En traitant les impôts comme de simples mouvements de valeur, votre grand livre Beancount restera propre, facile à interroger et, surtout, compréhensible.

Vous trouverez ci-dessous un modèle pratique et simple à intégrer dans un fichier Beancount personnel ou de petite entreprise. Il s'agit d'un système simple pour gérer les fiches de paie, les paiements d'impôts et même les remboursements qui chevauchent la nouvelle année. Nous aborderons les comptes essentiels, des exemples concrets et les requêtes exactes à exécuter pour obtenir les réponses dont vous avez besoin.

Les principes de base​

Avant de plonger dans le code, convenons de quelques règles simples. Ces principes maintiennent la logique et évitent de futurs maux de tête.

• Séparez « ce que c'est » de « quand l'argent bouge ». 🗓️ C'est le concept le plus important. Une charge fiscale appartient à l'année où vous avez gagné le revenu (par exemple, 2024), même si vous réglez la facture à l'administration fiscale en avril 2025. Si vous ne séparez pas le moment de la charge du moment du paiement en espèces, vos rapports d'une année sur l'autre seront désordonnés et trompeurs.

• Gardez une hiérarchie de comptes simple et ennuyeuse. 📁 Nommez vos comptes clairement en fonction du type d'impôt (par exemple, IncomeTax, SocialSecurity). Cela simplifie énormément vos requêtes. N'encombrez pas les noms de comptes avec des noms de fournisseurs ou des numéros de formulaire comme « W-2 » ou « 1099 » ; utilisez plutôt des métadonnées et des balises pour ces détails.

• Adoptez la comptabilité d'exercice pour les ajustements de fin d'exercice. ⚖️ Même pour un grand livre personnel, une simple écriture de régularisation en fin d'exercice est le moyen le plus propre d'obtenir des rapports précis. Cela signifie comptabiliser une charge ou un remboursement dans la bonne année, même si l'argent ne bouge que l'année suivante. C'est une petite étape supplémentaire qui vous évitera des contorsions mentales par la suite.

• Écrivez pour votre futur moi. 🧠 Votre objectif est la clarté. N'ajoutez des détails supplémentaires, comme l'année d'imposition, au nom d'un compte que si cela facilite vraiment vos requêtes. Évitez de créer un nouvel ensemble de comptes chaque année (Expenses:Taxes:2024:Federal, Expenses:Taxes:2025:Federal, etc.) sauf en cas de raison impérieuse. Une structure plate est souvent plus facile à gérer.

Une structure de comptes minimale​

Voici un ensemble de base de comptes pour commencer. Cette structure est axée sur les États-Unis, mais vous pouvez facilement adapter les noms au système fiscal de votre pays. Il suffit d'ajouter ces directives open à votre fichier Beancount.

; --- Impôts fédéraux américains sur le revenu et les salaires ---
; Pour l'argent retenu sur votre paie
2024-01-01 open Expenses:Taxes:Federal:IncomeTax:Withheld       USD
; Pour les acomptes provisionnels ou les soldes à payer au moment de la déclaration
2024-01-01 open Expenses:Taxes:Federal:IncomeTax:Payments       USD
; Pour les remboursements d'impôts reçus
2024-01-01 open Expenses:Taxes:Federal:IncomeTax:Refunds        USD
 
; Vos cotisations de sécurité sociale
2024-01-01 open Expenses:Taxes:Federal:SocialSecurity           USD
2024-01-01 open Expenses:Taxes:Federal:Medicare                 USD
 
; --- Autres impôts courants ---
; Pour les taxes de vente ou d'utilisation payées sur les achats
2024-01-01 open Expenses:Taxes:Sales                            USD
 
; --- Comptes pour les ajustements de fin d'exercice (facultatif mais recommandé !) ---
; Un compte de dépôt temporaire pour les impôts dus mais non encore payés
2024-01-01 open Liabilities:AccruedTaxes:Federal:Income         USD
; Un compte de dépôt temporaire pour un remboursement dû mais pas encore reçu
2024-01-01 open Assets:Tax:Receivable                           USD

Cette configuration sépare les impôts retenus à la source des paiements directs et des remboursements, ce qui permet de voir clairement où va votre argent. Les comptes Liabilities et Assets sont notre arme secrète pour maintenir l'exactitude des rapports de fin d'exercice.

Exemple 1 : La fiche de paie​

Comptabilisons une fiche de paie typique où les impôts sont retenus automatiquement. La clé est d'enregistrer d'abord votre salaire brut, puis de montrer comment il a été réparti entre les impôts et l'argent réellement déposé sur votre compte en banque.

2025-07-15 * "Employeur Inc." "Salaire de la première quinzaine de juillet"
  Income:Work:Salary                                  -6,000.00 USD
  Expenses:Taxes:Federal:IncomeTax:Withheld             1,200.00 USD
  Expenses:Taxes:Federal:SocialSecurity                   372.00 USD
  Expenses:Taxes:Federal:Medicare                          87.00 USD
  Assets:Cash:Checking                                  4,341.00 USD

Cette seule transaction raconte tout :

• Vous avez gagné 6 000 $ en revenu brut.
• 1 200 $ ont été envoyés à l'administration fiscale pour l'impôt fédéral sur le revenu.
• 372 $sont allés à la sécurité sociale et 87$ à l'assurance-maladie.
• Le reste, 4 341 $, est ce que vous avez rapporté à la maison.

Conseil de pro : Vous pouvez ajouter des métadonnées provenant de votre fiche de paie (comme pay_period_end: "2025-07-15") à la transaction pour une piste d'audit facile.

Exemple 2 : Déclarer vos impôts (le problème du chevauchement d'années)​

Voici le scénario qui pose problème : nous sommes en avril 2025 et vous préparez votre déclaration de revenus 2024. Vous apprenez qu'après tous vos prélèvements, vous devez encore 3 000 $.

Comment enregistrer cela ? Vous voulez que la dépense compte pour 2024, mais le paiement en espèces a lieu en 2025. Voici deux excellentes façons de gérer cela.

Option A : La comptabilité de régularisation manuelle en deux étapes​

Cette méthode est du Beancount pur, sans plugin. C'est un processus clair en deux étapes.

Étape 1 : Constater la dépense à la fin de l'exercice fiscal. Le dernier jour de 2024, vous créez une écriture de régularisation. Aucun argent ne bouge encore ; vous reconnaissez simplement la dépense et la placez dans un compte de passif temporaire.

2024-12-31 * "Régularisation de l'impôt fédéral sur le revenu pour 2024"
  Expenses:Taxes:Federal:IncomeTax:Payments             3,000.00 USD
  Liabilities:AccruedTaxes:Federal:Income             -3,000.00 USD

Votre compte de résultat 2024 affiche désormais correctement cette dépense de 3 000 $.

Étape 2 : Enregistrer le paiement en espèces au moment où il se produit. En avril 2025, lorsque vous envoyez réellement l'argent à l'administration fiscale, vous soldez le passif.

2025-04-15 * "Administration fiscale" "Paiement pour la déclaration de revenus 2024"
  Liabilities:AccruedTaxes:Federal:Income              3,000.00 USD
  Assets:Cash:Checking                                -3,000.00 USD

Vos rapports 2024 sont corrects et vos flux de trésorerie 2025 sont corrects. Parfait ! Ce même modèle fonctionne en sens inverse pour un remboursement : utilisez Assets:Tax:Receivable au lieu du compte de passif.

Option B : Automatiser avec un plugin​

Si vous préférez conserver le paiement dans une seule transaction, un excellent plugin communautaire appelé beancount_reds_plugins.effective_date peut vous aider. Il vous permet d'attribuer une « date d'effet » différente à un seul article.

Tout d'abord, activez le plugin dans votre fichier Beancount principal : plugin "beancount_reds_plugins.effective_date"

Vous pouvez alors écrire une seule transaction. Le plugin la divisera automatiquement en arrière-plan pour que vos rapports soient exacts.

; Une seule entrée ; le plugin s'occupe du reste
2025-04-15 * "Administration fiscale" "Paiement pour la déclaration de revenus 2024"
  Assets:Cash:Checking                                 -3,000.00 USD
  Expenses:Taxes:Federal:IncomeTax:Payments             3,000.00 USD
    effective_date: 2024-12-31

Ici, la partie en espèces est enregistrée le 15 avril 2025, mais la partie charge est appliquée rétroactivement au 31 décembre 2024. Vous obtenez le même résultat qu'avec l'option A avec un flux de travail différent.

Et la taxe de vente (TVA) ?​

Pour la plupart des comptes personnels, la taxe de vente est simple. Si vous ne la récupérez pas, il suffit de la séparer en tant que dépense distincte lors d'un achat.

2025-07-19 * "Épicerie locale"
  Expenses:Groceries                                      12.32 USD
  Expenses:Taxes:Sales                                     1.28 USD
  Assets:Cash:Checking                                   -13.60 USD

Cela vous permet de suivre facilement le montant que vous dépensez en taxe de vente au cours de l'année. Si vous gérez une entreprise soumise à la TVA, vous utiliserez un système plus formel avec des comptes créditeurs et débiteurs, mais le principe est le même.

Des requêtes que vous allez réellement utiliser​

Tout l'intérêt de cette structure est de faciliter l'obtention de réponses. Voici quelques requêtes BQL pour avoir une vision claire de vos impôts.

1. Quel a été mon impôt fédéral total sur le revenu pour 2024 ?

SELECT cost(sum(position))
WHERE account ~ "Expenses:Taxes:Federal:IncomeTax"
  AND date >= 2024-01-01 AND date < 2025-01-01 ;

2. Comment ce total se décompose-t-il entre les retenues, les paiements et les remboursements ?

SELECT account, cost(sum(position))
WHERE account ~ "Expenses:Taxes:Federal:IncomeTax"
  AND date >= 2024-01-01 AND date < 2025-01-01
GROUP BY account
ORDER BY account;

3. Ai-je des dettes fiscales ou des créances impayées ? (Utile pour vérifier votre travail !)

SELECT account, units(sum(position))
WHERE account ~ "Liabilities:AccruedTaxes" OR account ~ "Assets:Tax"
GROUP BY account
ORDER BY account;

Si cette requête renvoie des soldes non nuls, cela signifie que vous avez des charges à payer non encore réglées.

FAQ rapide​

• Ai-je vraiment besoin de comptes par année comme Expenses:Taxes:2024 ? Probablement pas. La méthode de la comptabilité d'exercice (ou le plugin) maintient une structure de compte plate propre et lisible. Ne créez des comptes par année que si cela simplifie vos requêtes spécifiques.

• Beancount peut-il calculer mes impôts à ma place ? Pas directement, mais il peut préparer les données. Certains utilisateurs avancés écrivent des scripts pour intégrer les résultats de requêtes BQL dans des logiciels de calcul d'impôts, ce qui est idéal pour estimer votre obligation fiscale en cours d'année.

• Ceci est-il un conseil fiscal ? Non. Il s'agit d'un modèle de tenue de livres pour organiser vos données. La comptabilité est saine, mais vous devriez toujours consulter un professionnel de la fiscalité pour un conseil adapté à votre situation.

Votre liste de contrôle pour commencer​

Prêt à démarrer ?

1. ✅ Ajoutez la structure de comptes à votre fichier Beancount (et adaptez les noms à votre pays).
2. ✅ Comptabilisez les salaires en commençant par le revenu brut et en décomposant les écritures fiscales.
3. ✅ À la fin de l'exercice, régularisez tout écart pour les paiements ou remboursements à l'aide d'un compte d'actif ou de passif (ou utilisez le plugin effective_date).
4. ✅ Suivez les remboursements en tant que créances et soldez-les à réception de l'argent.
5. ✅ Exécutez les requêtes BQL ci-dessus pour vérifier vos totaux avant de produire votre déclaration.

Restez simple, restez cohérent, et la saison des impôts ne sera plus qu'une étape comme une autre de votre histoire financière, plus un mystère à résoudre.