# Introduction à Beancount.io

## Pourquoi la tenue de livres moderne est importante

Gérez-vous toujours vos investissements avec des feuilles de calcul ? Bien que les feuilles de calcul soient polyvalentes, elles peuvent devenir lourdes et sujettes aux erreurs à mesure que votre portefeuille d'investissement s'étoffe. Découvrez Beancount.io – une plateforme de suivi des investissements sophistiquée mais conviviale, conçue spécifiquement pour la gestion des portefeuilles d'actions et de cryptomonnaies. Conçu pour les ingénieurs et les minimalistes financiers, Beancount.io combine des fonctionnalités puissantes avec une interface intuitive pour simplifier votre expérience de suivi des investissements.

![Expenses](https://res.cloudinary.com/dohtidfqh/image/upload/v1567841828/web-guiguio/expenses.png)

![Income Statement](https://res.cloudinary.com/dohtidfqh/image/upload/v1567841514/web-guiguio/income-statement.png)

![Balance Sheet](https://res.cloudinary.com/dohtidfqh/image/upload/v1567841513/web-guiguio/balance-sheet.png)

## La comptabilité en partie double : le fondement de l'exactitude

Beancount.io est construit sur les principes de la comptabilité en partie double – une méthodologie éprouvée utilisée par les institutions financières du monde entier. Ce système assure une exactitude mathématique grâce à un concept simple mais puissant : chaque transaction financière doit s'équilibrer parfaitement.

En comptabilité en partie double, chaque transaction nécessite au moins deux écritures – un débit (+) et un crédit (-) – sur différents comptes. Ce système de vérification intégré rend pratiquement impossible l'enregistrement de transactions déséquilibrées, garantissant ainsi que vos registres financiers restent exacts et fiables.

```bean
1970-01-01 open Income:BeancountCorp
1970-01-01 open Assets:Cash
1970-01-01 open Expenses:Food
1970-01-01 open Assets:Receivables:Alice
1970-01-01 open Assets:Receivables:Bob
1970-01-01 open Assets:Receivables:Charlie
1970-01-01 open Liabilities:CreditCard

2019-05-31 * "BeancountCorp" "Salary of May 15th to May 31st"
  Income:BeancountCorp               -888 USD
  Assets:Cash                         888 USD

2019-07-12 * "Popeyes chicken sandwiches" "dinner with Alice, Bob, and Charlie"
  Expenses:Food 20 USD
  Assets:Receivables:Alice 20 USD
  Assets:Receivables:Bob 20 USD
  Assets:Receivables:Charlie 20 USD
  Liabilities:CreditCard -80 USD
```

Comme vous pouvez le voir dans les deux exemples ci-dessus, chaque transaction doit respecter l'équation comptable.

```txt
Assets = Liabilities + Equity(aka Net Assets)
```

Nous avons utilisé la syntaxe Beancount de Martin Blais et le projet web Fava de Jakob Schnitzer pour construire ce site web. Et il vous alertera si une transaction comporte des lignes dont la somme n'est pas nulle.

![Alerte d'erreur](https://res.cloudinary.com/dohtidfqh/image/upload/v1567898686/web-guiguio/bct-error-alert.png)

Maintenant, vous comprenez comment nous assurons la justesse du grand livre. Mais vous vous demandez peut-être ce que sont ces "comptes" ?

## Comprendre les comptes : l'analogie du seau d'eau

Considérez vos comptes financiers comme un système de seaux d'eau interconnectés, où l'argent circule comme de l'eau entre eux. Cette analogie rend la comptabilité en partie double intuitive : lorsque vous transférez de l'argent d'un compte à un autre, c'est comme verser de l'eau d'un seau à un autre – le montant total d'eau (argent) dans le système reste constant.

Beancount.io introduit cinq types de comptes.

1. **Revenus** — Leur montant est toujours négatif ou au débit. C'est parce que vous gagnez de l'argent, et que l'argent est débité du compte "Revenus" et crédité sur vos "Actifs".
2. **Dépenses** — Leur montant est toujours positif ou au crédit. C'est parce que vous dépensez de l'argent, et que l'argent circule des "Actifs" ou "Passifs" vers les "Dépenses".
3. **Passifs** — Leur montant est positif ou nul. Vos dettes de carte de crédit en sont un bon exemple, qui augmentent et diminuent par cycles.
4. **Actifs** — Leur montant est positif ou nul. Votre argent liquide ou vos maisons ont toujours une certaine valeur.
5. **Capitaux propres** — Vos actifs nets. Le système les calculera automatiquement pour vous. `Capitaux propres = Actifs - Passifs` et cela reflète votre richesse.

Vous pouvez maintenant ouvrir vos comptes personnalisés avec les mots-clés ci-dessus :

```bean
1970-01-01 open Assets:Cash
1970-01-01 open Assets:Stock:Robinhood
1970-01-01 open Assets:Crypto:Coinbase
1970-01-01 open Expenses:Transportation:Taxi
1970-01-01 open Equity:OpeningBalance
```

## Suivi avancé des investissements avec les actifs

Beancount.io excelle dans le suivi des investissements diversifiés, des actions aux cryptomonnaies. Explorons comment il gère les scénarios d'investissement complexes. Par exemple, voici comment vous enregistreriez l'achat de 10 Bitcoins à 100 \$ chacun en 2014 :

```bean
2014-08-08 * "Buy 10 Bitcoin"
  Assets:Trade:Cash -1000.00 USD
  Assets:Trade:Positions  10 BTC {100.00 USD}
```

Et puis trois ans plus tard, vous les vendez (initialement avec un coût de 100 \$ par unité annoté avec `{100.00 USD}`) au prix de **10 000 \$ par unité** annoté avec `@ 10,000.00 USD`.

```bean
2017-12-12 * "Sell 2 Bitcoin"
  Assets:Trade:Positions                   -2 BTC {100.00 USD} @ 10,000.00 USD
  Assets:Trade:Cash                          20,000.00 USD
  Income:Trade:PnL                          -19,800.00 USD
```

Ou la même transaction avec `@@ 20,000.00 USD` signifie qu'au prix de **20 000 \$ au total**.

```bean
2017-12-12 * "Sell 2 Bitcoin"
  Assets:Trade:Positions                   -2 BTC {100.00 USD} @@ 20,000.00 USD
  Assets:Trade:Cash                          20,000.00 USD
  Income:Trade:PnL                          -19,800.00 USD
```

La somme de toutes les lignes de la transaction, y compris `-2 BTC {100.00 USD}`, est toujours, comme toujours, nulle.

L'étiquette de coût `{100.00 USD}` est importante car vous auriez pu acheter le même actif à des coûts différents.

```bean
100 BTC {10.00 USD, 2012-08-08}
10 BTC {100.00 USD, 2014-08-08}
```

Si vous souhaitez simplifier le processus, vous pouvez configurer le compte au début avec FIFO ou LIFO. FIFO signifie "premier entré, premier sorti", tandis que LIFO signifie "dernier entré, premier sorti". Aux États-Unis, l'IRS utilise la méthode FIFO pour calculer votre P&L (profits et pertes) et vos impôts en conséquence.

```bean
1970-01-01 open Assets:Trade:Positions "FIFO"
```

Et puis lorsque vous le vendez en abrégé comme `-2 BTC {}`, Beancount appliquera automatiquement la stratégie FIFO et vendra l'actif le plus ancien.
