90 articles tagués avec « Accounting »

Une entreprise prospère et un portefeuille sain partagent une caractéristique : des limites.

Pour tout propriétaire d'entreprise, du travailleur indépendant à l'entrepreneur en démarrage, l'une des disciplines financières les plus importantes est la séparation stricte des finances professionnelles et personnelles. Mélanger les fonds (utiliser votre compte professionnel pour les courses ou payer un fournisseur professionnel à partir de votre compte courant personnel) crée une image financière opaque et désordonnée. Cela invite non seulement à un examen minutieux de la part des autorités fiscales, mais vous prive également d'une vision claire des performances réelles de votre entreprise.

Heureusement, un système de comptabilité en texte brut comme Beancount fournit le cadre idéal pour appliquer ces limites essentielles directement dans votre grand livre.

Pourquoi la séparation est importante​

Ne pas séparer vos finances n'est pas seulement une mauvaise habitude ; cela comporte des risques importants et masque des informations commerciales précieuses.

• Clarté vis-à-vis du fisc : Le fisc ne fait pas que suggérer de tenir des comptes bancaires séparés ; il le recommande fortement. Lorsque les fonds professionnels et personnels sont mélangés, il devient difficile de prouver quelles dépenses sont des déductions professionnelles légitimes. Cette ambiguïté peut entraîner des questions et des complications qu'il vaut mieux éviter.
• Risque d'audit : Le mélange des transactions est un signal d'alarme majeur pour les auditeurs. Si vos livres sont un fouillis d'activités personnelles et professionnelles, vous risquez de vous voir refuser des déductions valables ou même de faire face à des pénalités. Un grand livre propre et séparé démontre le professionnalisme et rend tout audit potentiel plus fluide et moins stressant.
• Informations plus claires : Comment pouvez-vous connaître votre véritable marge bénéficiaire si les flux de trésorerie de votre entreprise sont obscurcis par des dépenses personnelles ? Un grand livre d'entreprise autonome vous donne une vue non filtrée de la santé financière de votre entreprise. Vous pouvez suivre avec précision les revenus, analyser les dépenses et calculer les obligations fiscales sans le « bruit » de votre vie financière personnelle.

Principales différences en un coup d'œil​

L'objectif, les règles et la structure de la comptabilité d'entreprise et personnelle sont fondamentalement différents. Comprendre ces contrastes est essentiel pour maintenir des enregistrements précis.

Un plan en quatre étapes avec Beancount​

Beancount permet de dresser facilement un mur solide entre vos deux mondes financiers. Voici un flux de travail pratique pour bien faire les choses.

• 1 — Ouvrir des comptes dédiés​

Avant même d'écrire votre première entrée Beancount, ouvrez un compte courant professionnel dédié et une carte de crédit professionnelle. Cette séparation physique est le fondement d'une comptabilité propre. Une fois cela fait, reproduisez cette structure dans votre grand livre Beancount.

2025-07-23 open Assets:Bank:Business   USD
2025-07-23 open Assets:Bank:Personal   USD

Cette configuration simple garantit que chaque transaction peut être clairement affectée à vos finances professionnelles ou personnelles dès qu'elle se produit.

• 2 — Enregistrer les apports et les retraits du propriétaire​

En tant que propriétaire, vous déplacerez de l'argent entre vos fonds personnels et l'entreprise. Ce ne sont pas des revenus ou des dépenses. Au lieu de cela, ils sont suivis via un compte de capitaux propres.

• Apport : Lorsque vous mettez votre propre argent dans l'entreprise pour la démarrer ou couvrir un déficit.
• Retrait : Lorsque vous retirez de l'argent de l'entreprise pour votre usage personnel (c'est ainsi que de nombreux propriétaires uniques se « paient »).

; Injection de capital pour démarrer l'entreprise
2025-07-23 * "Apport du propriétaire"
  Assets:Bank:Business    10 000,00 USD
  Equity:Owner:Contrib

; Retrait d'argent pour les dépenses personnelles
2025-08-05 * "Retrait du propriétaire pour le loyer"
  Equity:Owner:Draw        2 500,00 USD
  Assets:Bank:Business

En enregistrant ces transactions comme des transactions sur capitaux propres, vous vous assurez qu'elles ne gonflent pas incorrectement vos dépenses d'entreprise ou ne réduisent pas votre bénéfice déclaré.

• 3 — Traiter rapidement les reçus mixtes​

Des erreurs se produisent. Vous pourriez accidentellement utiliser votre carte professionnelle pour payer un dîner personnel. La clé est de le corriger immédiatement dans votre grand livre. Ne supprimez pas la transaction ; reclassez-la comme un retrait du propriétaire.

2025-08-07 * "Courses personnelles sur la carte professionnelle"
  Equity:Owner:Draw           72,35 USD
  Assets:Bank:Business

Cette entrée reflète correctement le fait que des fonds de l'entreprise ont été utilisés pour une dépense personnelle, la traitant comme de l'argent que vous avez retiré de l'entreprise. Cela vous empêche de réclamer accidentellement une dépense personnelle non déductible sur vos impôts.

• 4 — Rapprocher et examiner selon un calendrier​

La cohérence est votre meilleure défense contre les livres désordonnés. Réservez du temps chaque semaine ou chaque mois pour rapprocher vos comptes professionnels. Utilisez les outils de Beancount pour vous assurer que votre grand livre correspond à vos relevés bancaires et pour examiner les performances de votre entreprise.

# Vérifiez le solde de votre banque professionnelle par rapport à votre relevé
bean-balance books.bean "Assets:Bank:Business"

# Générer un compte de résultat pour examiner la rentabilité
bean-report  books.bean income_statement -e 2025-08-31

Cette habitude d'examen régulier satisfait aux exigences de tenue de registres du fisc et vous tient informé de la santé financière de votre entreprise.

Considérations fiscales​

• Impôts estimés : Pour éviter une facture fiscale douloureuse, traitez vos impôts futurs comme une dépense d'entreprise continue. Créez des comptes de passif (Liabilities:Tax:Federal, Liabilities:Tax:State) et transférez-y régulièrement un pourcentage fixe de chaque dépôt. Lorsque les paiements trimestriels sont dus, l'argent est déjà disponible.
• Coûts personnels non déductibles : N'oubliez pas la règle du fisc : les dépenses d'entreprise doivent être à la fois « ordinaires et nécessaires » pour votre travail. Vos repas personnels, vos frais de déplacement et vos abonnements non professionnels ne sont pas admissibles et doivent être entièrement exclus du compte de résultat de votre entreprise.

Liste de contrôle de démarrage rapide​

• Ouvrir des comptes bancaires et de crédit réservés aux entreprises.
• Créer un plan comptable Beancount avec Assets:Bank:Business, Equity:Owner:Contrib et Equity:Owner:Draw.
• Décider de votre méthode comptable (comptabilité de caisse ou comptabilité d'exercice) et la noter dans vos options Beancount.
• Étiqueter immédiatement tous les frais personnels accidentels sur les cartes professionnelles comme Equity:Owner:Draw.
• Rapprocher chaque semaine ; sauvegarder votre fichier .bean sur un dépôt Git privé distant.
• Examiner votre compte de résultat, votre bilan et vos rapports de trésorerie chaque mois.

Conclusion : Argent séparé, grands livres séparés. Beancount rend le mur entre vos finances professionnelles et personnelles explicite (et contrôlé par version) afin que votre entreprise reste prête pour un audit tandis que votre habitude de boire des cafés au lait ne regarde que vous. Bonne tenue de comptes !

Les transactions immobilières peuvent constituer l'activité financière la plus importante de la vie d'une famille. Cet article explique comment modéliser l'immobilier dans Beancount. Je traite l'immobilier comme un actif et l'appréciation de la maison comme un gain non réalisé. De plus, le prêt hypothécaire est modélisé comme un passif, et les intérêts sont considérés comme une dépense.

Supposons que M. A ait acheté une maison de luxe située au 123 ABC Street, XYZ City, CA, 12345 le 1er janvier 2020, pour un prix de 1 million. Le taux d'intérêt est de 3,0 %, l'apport personnel est de 20 % et le montant du prêt est de 800 000.

Créer les comptes​

Premièrement, nous traitons la maison comme un Actif (Asset). Puisque la maison est répertoriée comme un Actif, elle doit recevoir une unité. Dans ce cas, la quantité unitaire est de un ; il est peu probable qu'il y en ait plusieurs, et même s'il s'agit de la nième maison, nous voudrions l'enregistrer dans un Actif séparé. C'est-à-dire qu'une maison correspond à un Actif, et cet Actif possède une unité spéciale dont la valeur ne peut être que 1.

2019-12-31 commodity HOUSE.ABC
  name: "123 ABC Street, XYZ City, CA, 12345"

2019-12-31 open Assets:Property:US:CA:123ABC                        HOUSE.ABC
2019-12-31 open Liabilities:Bank:US:SomeBank:Mortgage:Loan          USD

Dans la première ligne ici, nous avons défini une unité de commodité représentant la maison. À la quatrième ligne, nous avons défini un compte d'actif, qui détient l'unité de commodité précédemment définie comme la maison. À la cinquième ligne, nous avons défini un compte pour la banque prêteuse. Comme il s'agit d'une dette, elle relève de la catégorie des Passifs (Liabilities).

Achat​

Avec les comptes configurés comme ci-dessus, l'acte d'acheter une maison équivaut à :

emprunter de l'argent (dette) + dépenser de l'argent (apport personnel) = 1 maison à l'actif

La référence la plus importante lors de l'achat d'un bien immobilier est probablement le décompte de règlement de l'acheteur (Buyer’s Settlement Statement), qui détaille clairement les flux financiers.

2020-01-01 * "Achat de la maison"
    Assets:Property:US:CA:123ABC                  1 HOUSE.ABC {1,000,000 USD}
    Assets:Bank:US:SomeBankA                      -100,000 USD
    Assets:Bank:US:SomeBankB                      -101,000 USD
    Liabilities:Bank:US:SomeBank:Mortgage:Loan    -800,000.00 USD
    Expenses:Home:Insurance                       1,000 USD
    Expenses:Home:Mortgage:Loan:ClosingCost

Ici, nous détaillons la transaction d'achat de la maison, où l'argent sort de certaines banques (utilisé pour l'apport et d'autres frais), un prêt est contracté (s'ajoutant au passif), et une maison est acquise (ajoutée à l'actif).

Remboursement du prêt hypothécaire​

Sur la base du record d'achat ci-dessus, nous devons actuellement 800 000 USD. En raison des intérêts, et considérant que tous les prêts aux États-Unis sont amortis de manière égale en termes de principal et d'intérêts, le paiement mensuel comprend une partie pour les intérêts et une partie pour le principal. Au début, les intérêts constituent la majorité.

Pour enregistrer le remboursement du prêt, il vous suffit de consulter le relevé de votre banque prêteuse. Vous devez simplement savoir quelle part du capital vous remboursez chaque mois, le reste étant les intérêts. Les intérêts sont comptabilisés comme une Dépense (Expense).

2020-02-01 * "Paiement de la mensualité"
    Assets:Bank:US:SomeBank:Saving:Joint              -3,372.83 USD
    Liabilities:Bank:US:SomeBank:Mortgage:Loan         1,376.26 USD
    Expenses:Home:Mortgage:Loan:Interest

Cette écriture détaille le paiement mensuel de l'hypothèque qui est soustrait de votre compte d'épargne joint. Le remboursement du capital réduit le passif, tandis que la partie intérêts est traitée comme une dépense.

Valorisation​

Si vous souhaitez enregistrer la plus-value du bien, certaines personnes créent un compte séparé, enregistrant uniquement l'appréciation du bien actuel. Étant donné que la valeur de la maison peut augmenter ou diminuer, cette appréciation peut être négative. L'avantage est que dans le résumé de vos actifs totaux, ces deux comptes seront inclus : l'un pour la valeur de la maison au moment de la transaction, et l'autre pour la plus-value actuelle, reflétant ainsi le prix du marché en temps réel.

Je n'ai pas adopté cette méthode, principalement pour les raisons suivantes :

1. La valeur actuelle de la maison ne peut être qu'une estimation, à titre indicatif seulement, sans valeur pratique. Généralement, je ne peux obtenir l'évaluation du bien que sur des sites comme Redfin ou Zillow, et je ne pense pas personnellement qu'elle ait une grande valeur de référence. Je n'ai pas non plus envisagé d'intégrer ces plus-values dans les actifs totaux en temps réel.
2. Personnellement, je pense qu'avant que le prêt ne soit remboursé, si le flux de trésorerie de la maison est négatif, dans une certaine mesure, la propriété est toujours un passif. Par conséquent, l'intégrer prématurément aux actifs donnerait une illusion d'enrichissement et de plus-value, et je souhaite personnellement éviter cette illusion.

La méthode que j'utilise pour enregistrer l'appréciation de la propriété est celle qui sera également discutée plus tard pour la modélisation des RSU. Cette méthode consiste à utiliser une unité de monnaie virtuelle. En supposant que votre devise de base soit l'USD, nous pouvons utiliser USD.UNVEST (il semble inutile de créer une nouvelle Commodity pour cela) pour indiquer que cet actif est calculé dans une devise spéciale. La croissance ou la réduction de cet actif ne sera pas enregistrée en USD. De cette façon, je peux atteindre mon objectif initial, à savoir enregistrer la plus-value de la maison, sans que cette plus-value ne soit incluse dans le bilan final (Balance Sheet).

2020-01-01 price HOUSE.ABC                          1,000,000 USD
2025-01-01 price HOUSE.ABC                          1,400,000 USD.UNVEST

Il vous suffit d'évaluer votre propriété en USD.UNVEST régulièrement.

Ainsi, sur la page Commodity de Fava, vous pouvez suivre la tendance du prix de référence de la maison. Mais sur la page du Bilan (Balance Sheet), le prix de la maison reste celui au moment de la transaction. C'est-à-dire que vos actifs totaux correspondent toujours à votre apport de l'époque, plus le capital que vous continuez à rembourser. Le changement final de cet actif ne devrait se produire qu'au moment de la vente ou du rachat.

Vente​

Comme aucun bien n'a encore été vendu et que les divers frais annexes intermédiaires ne sont pas clairs, il s'agit d'un scénario hypothétique.

Supposons qu'au 1er janvier 2025, la propriété ait pris de la valeur pour atteindre 1 400 000 $, et que certaines données de référence soient les suivantes :

La personne A décide de vendre la propriété, et le prix de vente final de la maison est de 1 300 000 $.

2025-01-01 * "Vente de la maison"
    Assets:Property:US:CA:123ABC                  -1 HOUSE.ABC {1,300,000 USD}
    Liabilities:Bank:US:SomeBank:Mortgage:Loan    709,656.20 USD
    Expenses:Home:Agent:Fee                       72,000 USD
    Expenses:Home:ClosingCost                     10,000 USD
    Expenses:Home:Tax                             90,000 USD
    Assets:Bank:US:SomeBankA

Ici, on suppose que le bien a été occupé par son propriétaire pendant 2 années sur 5, de sorte que la plus-value de 500 000 n'a pas besoin d'être imposée. J'ai calculé un chiffre au hasard ici. Au final, la somme qui arrive sur le compte de la personne A est de 418 343,8 $, dont 200 000 correspondent à l'apport initial de l'époque, et environ 100 000 d'intérêts ont été payés. Ainsi, au final, le bénéfice comptable pour la personne A est d'environ 100 000. Il convient de noter que mon calcul n'est pas exhaustif ; après tout, la personne A a économisé un loyer pendant ces 5 ans, et il peut y avoir d'autres dépenses liées à la maison, comme l'entretien, la décoration, et ainsi de suite.

Pour refléter cela dans le bilan, vous pouvez ajouter cette évaluation de prix.

2025-01-01 price HOUSE.ABC                          1,300,000 USD

Bonjour à tous ! Dans l'article de blog d'aujourd'hui, nous plongeons dans le monde de Beancount, un outil de comptabilité en partie double apprécié par beaucoup pour sa simplicité et sa puissance. Plus précisément, nous allons parler de deux concepts clés : les créances et les dettes.

Comprendre ces termes est crucial pour utiliser Beancount (ou tout système de comptabilité en partie double) efficacement. Mais ne vous inquiétez pas si vous êtes débutant - nous allons tout décortiquer, étape par étape !

Créances et Dettes : Les Bases​

En comptabilité, les « créances » et les « dettes » sont des termes utilisés pour suivre l'argent dû. Les « créances » désignent l'argent que d'autres vous doivent, tandis que les « dettes » désignent l'argent que vous devez à d'autres.

Prenons un exemple :

1. Comptes Clients (A/R) : Supposons que vous possédez une librairie et qu'un client achète un livre à crédit. L'argent qu'il vous doit pour le livre est un compte client.

2. Comptes Fournisseurs (A/P) : D'un autre côté, imaginez que vous commandez un nouvel ensemble de livres à un éditeur, mais que vous ne les payez pas d'avance. L'argent que vous devez à l'éditeur est un compte fournisseur.

Dans Beancount, ceux-ci sont généralement suivis via des comptes correspondants. Le principal avantage est que cela vous fournit une image claire et précise de votre situation financière à tout moment.

Mise en place des créances et des dettes dans Beancount​

La structure de votre fichier Beancount peut être aussi simple ou complexe que vous le souhaitez. Pour les créances et les dettes, vous voudrez probablement créer des comptes distincts sous vos sections Actifs et Passifs.

Voici un exemple simple :

1970-01-01 open Assets:AccountsReceivable
1970-01-01 open Liabilities:AccountsPayable

Suivi des Transactions​

Côté bénéficiaire​

Après avoir configuré vos comptes, vous pouvez suivre les transactions impliquant des créances et des dettes. Examinons un exemple :

2023-05-29 * "Sold books to customer on credit"
  Assets:AccountsReceivable  100 USD
  Income:BookSales          -100 USD

Ici, vous ajoutez 100 $ à vos créances parce qu'un client vous doit ce montant. Simultanément, vous réduisez vos revenus du même montant pour maintenir l'équilibre (puisque vous n'avez pas encore réellement reçu l'argent).

Lorsque le client paiera finalement, vous l'enregistrerez comme ceci :

2023-06-01 * "Received payment from customer"
  Assets:Bank:Savings        100 USD
  Assets:AccountsReceivable -100 USD

Côté payeur​

Le même principe s'applique aux dettes, mais avec des signes inversés :

2023-05-30 * "Bought books from publisher on credit"
  Liabilities:AccountsPayable  200 USD
  Expenses:BookPurchases     -200 USD

Et lorsque vous remboursez votre dette :

2023-06-02 * "Paid off debt to publisher"
  Liabilities:AccountsPayable -200 USD
  Assets:Bank:Checking        200 USD

En Résumé​

Les créances et les dettes sont au cœur de tout système comptable. En les suivant avec précision, vous obtenez une compréhension complète de votre santé financière.

Ce n'est qu'un point de départ, et Beancount est capable de bien plus. J'espère que cet article de blog vous aide à clarifier ces concepts importants. Comme toujours, bonne comptabilité !

Dans l'article de blog d'aujourd'hui, nous allons décortiquer un grand livre Beancount pour les entreprises, ce qui vous aidera à comprendre les subtilités de ce système de comptabilité en partie double en texte brut.

Commençons par le code :

1970-01-01 open Assets:Bank:Mercury
1970-01-01 open Assets:Crypto

1970-01-01 open Equity:Bank:Chase

1970-01-01 open Income:Stripe
1970-01-01 open Income:Crypto:ETH

1970-01-01 open Expenses:COGS
1970-01-01 open Expenses:COGS:Contabo
1970-01-01 open Expenses:COGS:AmazonWebServices

1970-01-01 open Expenses:BusinessExpenses
1970-01-01 open Expenses:BusinessExpenses:ChatGPT

2023-05-14 * "CONTABO.COM" "Mercury Checking ••1234"
  Expenses:COGS:Contabo                               17.49 USD
  Assets:Bank:Mercury                                -17.49 USD

2023-05-11 * "Amazon Web Services" "Mercury Checking ••1234"
  Expenses:COGS:AmazonWebServices                  14490.33 USD
  Assets:Bank:Mercury                             -14490.33 USD

2023-03-01 * "STRIPE" "Mercury Checking ••1234"
  Income:Stripe                                   -21230.75 USD
  Assets:Bank:Mercury                              21230.75 USD

2023-05-18 * "customer_182734" "0x5190E84918FD67706A9DFDb337d5744dF4EE5f3f"
  Assets:Crypto                                         -19 ETH {1,856.20 USD}
  Income:Crypto:ETH                                      19 ETH @@ 35267.8 USD

Comprendre le code​

1. Ouverture des comptes : Le code commence par l'ouverture d'une série de comptes le 1970-01-01. Ceux-ci incluent un mélange de comptes d'actifs (Assets:Bank:Mercury et Assets:Crypto), un compte de capitaux propres (Equity:Bank:Chase), des comptes de revenus (Income:Stripe et Income:Crypto:ETH), et des comptes de dépenses (Expenses:COGS, Expenses:COGS:AmazonWebServices, Expenses:BusinessExpenses, et Expenses:BusinessExpenses:ChatGPT).

2. Transactions : Il procède ensuite à l'enregistrement d'une série de transactions entre le 2023-03-01 et le 2023-05-18.

   • La transaction du 2023-05-14 représente un paiement de 17,49 $ à CONTABO.COM depuis Mercury Checking ••1234. Ceci est enregistré comme une dépense (Expenses:COGS:Contabo) et une déduction correspondante du compte Assets:Bank:Mercury.

   • De même, la transaction du 2023-05-11 représente un paiement de 14490,33 $ à Amazon Web Services depuis le même compte bancaire. Ceci est enregistré sous Expenses:COGS:AmazonWebServices.

   • La transaction du 2023-03-01 montre des revenus de STRIPE déposés sur Mercury Checking ••1234, totalisant 21230,75 $. Ceci est enregistré comme un revenu (Income:Stripe) et un ajout au compte bancaire (Assets:Bank:Mercury).

   • La dernière transaction du 2023-05-18 représente une transaction crypto impliquant 19 ETH d'un client. Celle-ci est suivie sous Assets:Crypto et Income:Crypto:ETH. Le {1 856,20 USD} indique le prix de l'ETH au moment de la transaction, tandis que le @@ 35267,8 USD spécifie la valeur totale de la transaction de 19 ETH.

Dans toutes les transactions, le principe de la comptabilité en partie double est maintenu, garantissant que l'équation Actifs = Passifs + Capitaux propres est toujours vérifiée.

Réflexions finales​

Ce grand livre Beancount offre un système simple mais robuste pour le suivi des transactions financières. Comme le montre la dernière transaction, Beancount est suffisamment flexible pour prendre en compte des actifs non traditionnels comme les cryptomonnaies, ce qui témoigne de son utilité dans notre paysage financier de plus en plus numérique.

Nous espérons que cette analyse vous aidera à mieux comprendre la structure et les capacités de Beancount, que vous soyez un comptable expérimenté ou un débutant essayant de suivre vos finances personnelles. Restez à l'écoute pour notre prochain article de blog, où nous approfondirons les opérations avancées de Beancount.

Nous sommes ravis d'annoncer qu'à partir du 1er mai 2023, nous réintroduirons le plan gratuit pour les nouveaux clients. Cette décision fait suite à des améliorations significatives apportées à notre plateforme et à l'optimisation de nos ressources afin de mieux servir tous nos clients, qu'ils soient gratuits ou payants.

Le plan gratuit a toujours été une partie essentielle de notre vision visant à fournir un service accessible et convivial pour tous. Nous sommes convaincus que les changements que nous avons apportés au cours des derniers mois nous permettront d'offrir une expérience encore meilleure à nos utilisateurs tout en maintenant la qualité de service pour nos clients du plan Pro.

Les nouveaux clients qui s'inscrivent après le 1er mai 2023 auront accès au plan Gratuit.

Votre soutien et votre fidélité ont été essentiels pour rendre cette réintroduction du plan gratuit financièrement possible. C'est grâce à vos contributions que nous avons pu investir dans notre infrastructure et nos systèmes de support, nous assurant de pouvoir continuer à fournir le service de haute qualité que vous attendez tout en élargissant l'accès à notre plateforme pour les nouveaux utilisateurs. Votre engagement envers notre vision nous a aidés à grandir et à évoluer, et nous sommes vraiment reconnaissants de votre partenariat continu. Ensemble, nous bâtissons une communauté florissante et donnons aux utilisateurs de tous horizons les moyens d'atteindre leurs objectifs.

Si vous avez des questions ou des préoccupations, n'hésitez pas à nous contacter. Nous sommes toujours là pour écouter vos commentaires et résoudre tout problème que vous pourriez rencontrer. Merci pour votre soutien continu, et nous sommes impatients de vous offrir le meilleur service possible.

Exemple de nom de compte​

Assets:US:BofA:Checking

Types de comptes​

Assets          +
Liabilities     -
Income          -
Expenses        +
Equity          -

Devises et Marchandises​

CNY, EUR, CAD, AUD
GOOG, AAPL, RBF1005
HOME_MAYST, AIRMILES
HOURS

Directives​

Syntaxe générale

YYYY-MM-DD <Directive> <Paramètres...>

Ouverture et clôture de comptes​

2001-05-29 open Expenses:Restaurant
2001-05-29 open Assets:Checking     USD,EUR  ; Contraintes de devises

2015-04-23 close Assets:Checking

Déclaration de devises / marchandises (Facultatif)​

1998-07-22 commodity AAPL
  name: "Apple Computer Inc."

Prix​

2015-04-30 price AAPL   125.15 CNY
2015-05-30 price AAPL   130.28 CNY

Notes​

2013-03-20 note Assets:Checking "Appelé pour demander le remboursement"

Documents​

2013-03-20 document Assets:Checking "chemin/vers/relevé.pdf"

Transactions​

2015-05-30 * "Description de cette transaction"
  Liabilities:CreditCard   -101.23 CNY
  Expenses:Restaurant       101.23 CNY

2015-05-30 ! "Compagnie de câble" "Facture de téléphone" #tag ˆlien
  id: "TW378743437"               ; Méta-données
  Expenses:Home:Phone  87.45 CNY
  Assets:Checking                 ; Vous pouvez laisser un montant vide

Écritures​

  ...    123.45 USD                             Simple
  ...        10 GOOG {502.12 USD}               Avec coût unitaire
  ...        10 GOOG {{5021.20 USD}}            Avec coût total
  ...        10 GOOG {502.12 # 9.95 USD}        Avec les deux coûts
  ...   1000.00 USD   @ 1.10 CAD                Avec prix unitaire
  ...        10 GOOG {502.12 USD} @ 1.10 CAD    Avec coût et prix
  ...        10 GOOG {502.12 USD, 2014-05-12}   Avec date
  ! ...   123.45 USD ...                        Avec drapeau

Assertions de solde et ajustements​

; Affirme le montant pour la devise donnée uniquement :
2015-06-01 balance Liabilities:CreditCard  -634.30 CNY

; Insertion automatique de transaction pour satisfaire l'assertion suivante :
2015-06-01pad Assets:Checking Equity:Opening-Balances

Événements​

2015-06-01 event "location" "New York, USA"
2015-06-30 event "address" "123 May Street"

Options​

option "title" "Mon Grand Livre Personnel"

Autre​

pushtag #voyage-au-perou
...
poptag  #voyage-au-perou
; Les commentaires commencent par un point-virgule

Découvrez la Magie de la Comptabilité en Texte Brut avec Beancount

Introduction​

Bienvenue dans un monde où la comptabilité n'est plus une tâche intimidante. Aujourd'hui, nous vous présentons Beancount, un outil de comptabilité en texte brut puissant, flexible et intuitif. Beancount vous permet de prendre le contrôle de vos finances en offrant une approche transparente et simple pour gérer votre argent.

Dans ce guide complet, nous allons explorer les bases de Beancount, expliquer ses concepts fondamentaux et vous guider à travers ses fonctionnalités simples mais puissantes. À la fin de cet article, vous aurez une solide compréhension de Beancount et serez prêt à l'utiliser pour organiser et analyser votre vie financière.

Qu'est-ce que Beancount ?​

Beancount est un système de comptabilité en texte brut open source créé par Martin Blais. Inspiré par le système Ledger de John Wiegley, Beancount vise à fournir une méthode robuste et fiable pour gérer les finances personnelles et des petites entreprises à l'aide de fichiers en texte brut. Avec Beancount, vous pouvez suivre vos revenus, dépenses, investissements et bien plus encore, en toute simplicité.

Pourquoi Beancount ?​

La comptabilité en texte brut offre plusieurs avantages par rapport aux systèmes comptables traditionnels basés sur des feuilles de calcul ou des logiciels :

• Transparence : Les fichiers Beancount sont lisibles par l'homme, ce qui facilite la compréhension et l'audit de vos données financières.
• Flexibilité : Beancount peut être facilement personnalisé pour répondre à vos besoins spécifiques, et vous pouvez utiliser votre éditeur de texte et votre système de contrôle de version préférés pour gérer vos données financières.
• Portabilité : Vos données financières sont accessibles sur n'importe quel appareil, et il est facile de les transférer entre systèmes ou de les partager avec d'autres.
• Pérennité : Les fichiers en texte brut sont universellement compatibles, garantissant que vos données financières resteront accessibles, même à mesure que la technologie évolue.

Concepts Fondamentaux de Beancount​

Pour utiliser Beancount efficacement, il est crucial de comprendre ses concepts fondamentaux :

• Transactions : Les événements financiers, tels que les revenus, les dépenses ou les transferts entre comptes, sont enregistrés comme des transactions.
• Comptes : Les transactions impliquent un ou plusieurs comptes, tels que les actifs, les passifs, les revenus ou les dépenses.
• Comptabilité en partie double : Beancount applique la comptabilité en partie double, garantissant que chaque transaction a des débits et des crédits équilibrés.
• Directives : Beancount utilise un ensemble de directives pour définir les transactions, les ouvertures de comptes et d'autres événements financiers.

Démarrer avec Beancount​

Pour commencer à utiliser Beancount, suivez ces étapes simples :

• Installer Beancount : Installez Beancount sur votre système en suivant les instructions d'installation fournies pour votre système d'exploitation.
• Créer votre fichier Beancount : Créez un nouveau fichier en texte brut avec l'extension .beancount (par exemple, mes_finances.beancount).
• Définir vos comptes : Utilisez la directive "open" pour définir les comptes que vous utiliserez dans vos transactions.
• Enregistrer les transactions : Utilisez la directive "txn" pour enregistrer vos transactions financières.

Ou inscrivez-vous simplement sur https://beancount.io. Voici quelques exemples de comptabilité en texte brut -

Exemple 1 : Transaction de Base

2023-04-01 open Assets:Checking
2023-04-01 open Expenses:Groceries

2023-04-10 txn "Grocery Store" "Buying groceries"
  Assets:Checking         -50.00 USD
  Expenses:Groceries       50.00 USD

Dans cet exemple, nous ouvrons deux comptes, Assets:Checking et Expenses:Groceries. Le 10 avril 2023, nous enregistrons une transaction pour l'achat de 50 $ d'épicerie. La transaction réduit le solde de Assets:Checking de 50 $ (débit) et augmente le solde de Expenses:Groceries de 50 $ (crédit).

Exemple 2 : Transaction de Revenus et Dépenses

2023-04-01 open Assets:Checking
2023-04-01 open Income:Salary
2023-04-01 open Expenses:Rent

2023-04-05 txn "Employer" "Salary payment"
  Assets:Checking       2000.00 USD
  Income:Salary        -2000.00 USD

2023-04-06 txn "Landlord" "Monthly rent payment"
  Assets:Checking       -1000.00 USD
  Expenses:Rent          1000.00 USD

Dans cet exemple, nous ouvrons trois comptes : Assets:Checking, Income:Salary et Expenses:Rent. Le 5 avril 2023, nous enregistrons une transaction de paiement de salaire de 2000 $. La transaction augmente le solde de Assets:Checking de 2000 $ (crédit) et diminue le solde de Income:Salary de 2000 $ (débit). Le 6 avril 2023, nous enregistrons une transaction de paiement de loyer de 1000 $. La transaction réduit le solde de Assets:Checking de 1000 $ (débit) et augmente le solde de Expenses:Rent de 1000 $ (crédit).

Exemple 3 : Transfert entre Comptes

2023-04-01 open Assets:Checking
2023-04-01 open Assets:Savings

2023-04-15 txn "Bank" "Transfer from Checking to Savings"
  Assets:Checking       -500.00 USD
  Assets:Savings         500.00 USD

Dans cet exemple, nous ouvrons deux comptes : Assets:Checking et Assets:Savings. Le 15 avril 2023, nous enregistrons une transaction pour transférer 500 $ du compte courant vers le compte d'épargne. La transaction réduit le solde de Assets:Checking de 500 $ (débit) et augmente le solde de Assets:Savings de 500 $ (crédit).

Ces exemples illustrent les concepts de base du système de comptabilité en partie double de Beancount. En enregistrant correctement les transactions, les utilisateurs peuvent maintenir des registres précis de leurs activités financières et générer des rapports pour obtenir des informations sur leur situation financière.

Générer des Rapports et Analyser les Données​

Beancount est livré avec un ensemble d'outils puissants pour générer des rapports financiers, y compris des bilans, des comptes de résultat, et plus encore. Vous pouvez également utiliser Fava, une interface utilisateur web pour Beancount, pour visualiser et interagir avec vos données financières. https://beancount.io est construit sur Fava sous licence MIT.

Conclusion​

Adoptez la puissance et la simplicité de la comptabilité en texte brut avec Beancount. En comprenant ses concepts fondamentaux et en suivant les étapes décrites dans ce guide, vous serez en bonne voie pour gérer vos finances personnelles ou celles de votre petite entreprise avec facilité et précision. À mesure que vous vous familiariserez avec Beancount, vous pourrez explorer des fonctionnalités avancées et des personnalisations pour adapter le système à vos besoins uniques.

Que vous cherchiez à suivre vos dépenses, à planifier l'avenir ou à obtenir des informations sur vos habitudes financières, Beancount offre la flexibilité et la transparence nécessaires pour atteindre vos objectifs. Grâce à son approche conviviale, Beancount a le potentiel de révolutionner la façon dont vous gérez vos finances et de vous permettre de prendre le contrôle de votre avenir financier.

Maintenant que vous avez une base solide en Beancount, il est temps de vous lancer dans votre parcours de comptabilité en texte brut. Dites adieu aux feuilles de calcul fastidieuses et aux logiciels complexes, et bienvenue dans le monde de Beancount. Bonne comptabilité !

Beancount, le système de comptabilité en partie double apprécié des développeurs et des passionnés de finance, est puissant par sa simplicité. Mais pour ceux qui souhaitent plus de contrôle et une navigation plus rapide dans Fava, l'interface web de Beancount, les liens de barre latérale et les requêtes SQL personnalisés peuvent faire passer votre flux de travail au niveau supérieur.

Dans ce guide, nous allons vous montrer comment :

• Ajouter des liens d'accès rapide à la barre latérale de Fava
• Utiliser des requêtes SQL pour un filtrage et une analyse avancés
• Personnaliser votre flux de travail pour les revues mensuelles ou la détection d'anomalies

Pourquoi Personnaliser Fava ?​

Fava est déjà une belle interface pour visualiser votre grand livre Beancount, mais à mesure que votre journal grandit, le besoin de meilleurs raccourcis et de requêtes plus intelligentes augmente également.

Problèmes résolus :​

• Naviguer à travers des plages de temps de manière répétée
• Filtrer les transactions à travers des comptes imbriqués
• Repérer plus rapidement les soldes négatifs ou les anomalies

✨ Liens de Barre Latérale Personnalisés​

Commençons par améliorer votre flux de travail quotidien avec de simples raccourcis de barre latérale. Ces liens apparaissent dans la barre latérale gauche de Fava et peuvent vous emmener directement vers des vues filtrées comme les transactions de ce mois-ci ou les revenus du mois dernier.

Ajoutez ces lignes à votre fichier Beancount :

2021-01-01 custom "fava-sidebar-link" "Current Month" "/jump?time=month"
2021-01-01 custom "fava-sidebar-link" "Last Month" "/jump?time=month-1"
2021-01-01 custom "fava-sidebar-link" "Clear All" "/jump?account=&time=&filter="

Ce qu'ils font :​

• Mois Actuel : Ouvre la vue des transactions filtrée sur le mois en cours.
• Mois Dernier : Passe instantanément au mois précédent — idéal pour les revues de fin de mois.
• Effacer Tout : Réinitialise les filtres, affichant à nouveau toutes les entrées.

Ces raccourcis éliminent la saisie manuelle de la période et rendent votre expérience Fava plus fluide et personnalisée.

🔍 Requêtes SQL Personnalisées​

Pour une analyse plus approfondie, l'interface SQL de Fava est incroyablement puissante. Voici une requête qui trouve tous les soldes négatifs dans les comptes qui correspondent à un modèle — parfait pour signaler les transactions inhabituelles ou problématiques.

SELECT account, units(sum(position)), sum(position)
WHERE number(units(position)) < 0
  AND account ~ '.*:BCM:.*'
  AND date >= DATE(2021,12,9)
  AND date < DATE(2022,1,9)

Explication :​

• account ~ '.*:BCM:.*' : Filtre les comptes contenant :BCM: dans leur nom.
• number(units(position)) < 0 : Signale les soldes négatifs (par exemple, les budgets dépassés).
• Les filtres de date réduisent le résultat à une fenêtre spécifique d'un mois.

Cas d'utilisation :​

• Repérer les erreurs comme les dépenses en double ou les écritures incorrectes
• Auditer un fournisseur ou une catégorie spécifique
• Extraire rapidement des informations exploitables pour la budgétisation

🛠 Astuce de Pro : Combiner Liens + Requêtes​

Bien que Fava ne permette pas de liens directs vers des requêtes personnalisées, vous pouvez créer une habitude de revue mensuelle en :

• Utilisant le lien "Mois Actuel" pour commencer votre revue
• Ouvrant votre onglet de requêtes enregistrées dans un autre volet
• Révisant les deux simultanément — filtrez d'abord, puis approfondissez

Cette combinaison vous aide à détecter les anomalies avant qu'elles ne s'aggravent et à garantir la propreté de votre grand livre.

Dernières Réflexions​

Beancount est minimaliste par conception, mais de petites améliorations comme celles-ci apportent d'énormes gains d'efficacité. Que vous examiniez votre budget, déboguiez des soldes étranges ou simplement économisiez des clics, les liens personnalisés et les requêtes SQL vous offrent plus de puissance et moins de friction.

Bonus : Si vous utilisez les rapports personnalisés de Fava, vous pouvez même créer des tableaux de bord complets adaptés à vos rituels de finances personnelles.

Prêt à prendre le contrôle ?

Commencez petit : ajoutez le lien "Mois Actuel". Ensuite, créez vos propres requêtes. Votre futur vous remerciera.

Vous voulez plus d'astuces comme celles-ci ? Abonnez-vous à notre newsletter ou explorez d'autres recettes Beancount sur Beancount.io.

Il existe un plugin pour Beancount permettant de prévoir les transactions récurrentes futures. Comment l'appliquer dans beancount.io ? Insérez le contenu suivant dans votre fichier de grand livre.

; import the plugin
plugin "fava.plugins.forecast"

; add a monthly HOA fee
2022-05-30 # "HOA fee [MONTHLY]"
  Expenses:Hoa                                      1024.00 USD
  Assets:Checking                                  -1024.00 USD

Ensuite, vous verrez la prévision dans le graphique de bénéfice net.

Le tag [MONTHLY] ci-dessus signifie qu'il se reproduira indéfiniment. Si vous avez plus de conditions à appliquer, essayez [MONTHLY UNTIL 2022-06-01], [MONTHLY REPEAT 5 TIMES], [YEARLY REPEAT 5 TIMES], ou [WEEKLY SKIP 1 TIME REPEAT 5 TIMES].

Un modèle en texte brut, un flux de travail reproductible et une seule requête pour savoir « Qui me doit encore de l'argent ? »

La facturation peut sembler être une corvée, coincée entre le travail que vous avez terminé et le paiement que vous attendez. Mais un bon processus de facturation est l'épine dorsale d'un flux de trésorerie sain. Il a une double fonction : il indique clairement à vos clients ce qu'ils doivent et quand, et il fournit à votre système comptable les faits incontestables dont il a besoin.

Bien que les applications SaaS dédiées puissent envoyer des PDF automatisés et élégants, elles sont souvent assorties de frais mensuels et enferment vos données dans un silo propriétaire. Une approche légère en texte brut utilisant Beancount offre une alternative puissante. Vous pouvez transformer chaque facture en un ensemble clair d'écritures comptables, vous offrant tous les avantages du contrôle de version, de métadonnées puissantes et d'interrogation instantanée, sans abonnement requis.

La facture minimale viable (champs à ne jamais omettre)​

Avant de toucher à votre grand livre, vous avez besoin d'une facture professionnelle. Le format peut être simple, mais le contenu doit être précis. Ces champs, empruntés aux pratiques éprouvées des petites entreprises, sont non négociables.

• Coordonnées du vendeur : Nom et adresse physique de votre entreprise.
• Coordonnées du client : Nom et (idéalement) adresse de votre client.
• Numéro de facture : Un identifiant unique et séquentiel qui n'est jamais réutilisé. FACT-045 suit FACT-044.
• Dates d'émission et d'échéance : Indiquez clairement la date d'émission de la facture et la date à laquelle le paiement est attendu.
• Lignes d'articles : Une description claire des services ou des produits, ainsi que la quantité, le taux et le total de la ligne.
• Sous-total, taxes et total : Montrez le calcul pour que le client puisse le suivre facilement.
• Notes facultatives : Un endroit pour un remerciement, des instructions de virement ou un numéro de bon de commande fourni par le client.

Pour vous aider à démarrer, nous avons créé un ensemble de modèles prêts à être modifiés qui incluent tous ces champs. Les versions tableur pré-calculent même les totaux pour vous.

Note: Invoice templates are coming soon! In the meantime, you can create your own using the fields listed above in Google Docs, Word, Sheets, Excel, or any other document format.

Enregistrer la facture dans votre grand livre​

Une fois que vous avez envoyé le PDF de la facture à votre client, vous devez l'enregistrer dans Beancount. Il s'agit d'une étape cruciale qui reconnaît les revenus lorsqu'ils sont gagnés, et pas seulement lorsqu'ils sont payés. Le processus implique deux transactions distinctes.

1. Lorsque vous émettez la facture :

Vous créez une transaction qui déplace le montant total de votre compte Revenus vers Actifs:ComptesClients. Cela crée une reconnaissance de dette numérique dans vos livres.

; 2025‑07‑21 Facture #045  Sprint de conception Web pour Acme Corp.
2025-07-21 * "Acme Corp" "FACT-045 Sprint de conception Web"
  Actifs:ComptesClients             3500.00 USD  ; échéance:2025-08-04
  Revenus:Conception:Web
  invoice_id: "FACT-045"
  contact_email: "[email protected]"
  link: "docs/invoices/2025-07-21_Acme_FACT-045.pdf"

Ici, vous débitez ComptesClients et créditez votre compte Revenus. Remarquez les métadonnées riches : la date d'échéance, un invoice_id unique et même un link: direct vers le PDF que vous avez envoyé.

2. Lorsque le client paie :

Lorsque l'argent arrive sur votre compte bancaire, vous enregistrez une deuxième transaction pour « clôturer » la reconnaissance de dette. Cela déplace le solde de ComptesClients vers votre compte courant.

2025-08-01 * "Acme Corp" "Paiement FACT-045"
  Actifs:Banque:CompteCourant        3500.00 USD
  Actifs:ComptesClients
  invoice_id: "FACT-045"

Le solde de FACT-045 dans Actifs:ComptesClients est maintenant nul, et vos livres sont parfaitement équilibrés.

Joindre le PDF : La clé de métadonnées link: est particulièrement puissante lorsqu'elle est utilisée avec Fava, l'interface web de Beancount. Fava affichera un lien cliquable directement dans la vue de la transaction, de sorte que le document source n'est jamais à plus d'un clic. Ce flux de travail a été envisagé dès 2016 dans une demande de fonctionnalité (GitHub).

Une requête pour lister toutes les factures ouvertes​

Alors, qui vous doit encore de l'argent ? Avec ce système, vous n'avez pas besoin de chercher dans vos e-mails ou vos feuilles de calcul. Vous avez juste besoin d'une simple requête.

Enregistrez ce qui suit dans un fichier nommé factures-ouvertes.sql :

SELECT
  meta('invoice_id') AS id,
  payee,
  narration,
  date,
  number(balance) AS outstanding
WHERE
  account = "Actifs:ComptesClients"
  AND balance != 0
ORDER BY
  date;

Maintenant, exécutez-la depuis votre ligne de commande :

bean-query books.beancount factures-ouvertes.sql

En quelques secondes, vous obtiendrez un rapport de vieillissement clair et à jour de toutes les factures impayées, indiquant l'ID de la facture, le client, la date d'émission et le montant dû. Aucun logiciel supplémentaire requis.

Automatiser les tâches fastidieuses​

La beauté du texte brut est sa scriptabilité. Vous pouvez automatiser les parties fastidieuses de ce flux de travail.

• Modèle + Pandoc = PDF : Maintenez votre modèle de facture en Markdown. Un petit script Python peut renseigner les variables (nom du client, lignes d'articles, numéro de facture), et l'outil en ligne de commande Pandoc peut le convertir instantanément en un PDF professionnel.
• Hook Git Pre-commit : Si vous stockez votre grand livre dans Git, un simple hook pre-commit peut effectuer des vérifications avant d'enregistrer votre travail. Il peut vérifier que chaque nouvel invoice_id est unique, que les écritures de la transaction sont équilibrées à zéro et que le fichier référencé dans les métadonnées link: existe réellement.
• Tâche Cron : Configurez une tâche planifiée (une tâche cron) pour exécuter votre requête factures-ouvertes.sql chaque nuit et vous envoyer le résumé par e-mail. Vous commencerez chaque journée en sachant exactement qui a besoin d'un petit rappel amical.

Une mise en garde réaliste​

Beancount est un outil comptable, pas un service de facturation. Il n'enverra pas automatiquement de rappels de paiement à vos clients ni ne traitera leurs paiements par carte de crédit. Le flux de travail est le suivant : vous créez et envoyez la facture en utilisant la méthode de votre choix (comme les modèles ci-dessus), puis vous enregistrez les écritures comptables dans votre grand livre.

Pour la plupart des freelances et des petites entreprises, cette étape manuelle est un faible prix à payer pour un système comptable à l'épreuve des balles, vérifiable et gratuit que vous possédez et contrôlez entièrement (beancount.io).

Prochaines étapes​

Prêt à prendre le contrôle de votre facturation ? Voici comment démarrer.

1. Téléchargez un modèle et utilisez-le pour créer votre prochaine vraie facture, en vous assurant d'utiliser un numéro de facture séquentiel.
2. Stockez vos PDF envoyés dans un dossier dédié comme docs/invoices/ et utilisez la clé de métadonnées link: dans votre transaction Beancount pour les référencer.
3. Enregistrez la requête factures-ouvertes.sql et intégrez son exécution à votre revue financière hebdomadaire.

La comptabilité en texte brut ne signifie pas renoncer à la précision ou au contrôle, cela signifie simplement que la base de données est interrogeable avec grep. Avec un modèle simple et les extraits ci-dessus, vous serez payé plus rapidement et vous garderez vos livres impeccables.