# Écritures de Journal Beancount : Comment faire, Définitions et Exemples

Chaque transaction financière de votre entreprise doit être enregistrée – et dans le monde de la comptabilité en texte brut, cela commence par les **écritures de journal**. Si vous utilisez [Beancount](https://beancount.io), comprendre les écritures de journal est essentiel pour construire des registres financiers précis, auditables et clairs.

Ce guide vous expliquera :

- Ce qu'est une écriture de journal
- Pourquoi les écritures de journal sont importantes
- Comment les écrire en syntaxe Beancount
- Comment les utiliser efficacement
- Exemples de transactions réelles (paiements clients, achats, prêts, etc.)

## 🧾 Qu'est-ce qu'une Écriture de Journal dans Beancount ?

Dans Beancount, une **écriture de journal** est une transaction datée écrite dans un format texte brut lisible par l'homme. Chaque écriture suit les principes de la **comptabilité en partie double** – vous enregistrez d'où vient l'argent (crédit) et où il va (débit), garantissant que vos livres sont toujours équilibrés.

**Exemple :**

```bean
2024-06-01 * "Client payment for invoice #123"
  Assets:Bank:Checking     600.00 USD
  Income:Sales
```

- Le `*` indique une transaction compensée.
- La description donne le contexte de l'écriture.
- `Assets:Bank:Checking` est débité.
- `Income:Sales` est crédité (valeur implicite).

Chaque écriture réside dans un fichier `.beancount` – un simple fichier texte que vous pouvez versionner, sauvegarder et même éditer dans Vim ou VSCode.

## 📒 Pourquoi les Écritures de Journal sont Importantes

Les écritures de journal sont l'unité atomique de votre grand livre.

Elles :

- Alimentent votre **Grand Livre** et vos **Soldes de Comptes**
- Génèrent tous les rapports : _Comptes de Résultat, Bilans, Flux de Trésorerie_
- Vous permettent de tracer chaque dollar, ligne par ligne, jusqu'à sa source

Avec les bons outils, vous verrez ces transactions affichées dans une interface utilisateur – catégorisées, consultables et filtrables. Mais tout commence par cette simple écriture en texte brut.

## 📚 Comment la Comptabilité en Partie Double Fonctionne dans Beancount

Beancount applique la **comptabilité en partie double**. Chaque transaction doit être équilibrée : total des débits = total des crédits.

Règle rapide :

- **Débitez** les actifs et les dépenses (vous _gagnez_ de l'argent ou engagez un coût)
- **Créditez** les revenus et les passifs (vous _gagnez_ de l'argent ou contractez une dette)

**Exemple – Achat de Fournitures de Bureau :**

```bean
2024-06-02 * "Bought printer ink"
  Expenses:OfficeSupplies   100.00 USD
  Assets:Bank:Checking
```

## 🧠 Visualisation des Écritures

Une fois sauvegardé, dans la navigation latérale gauche de https://beancount.io/ledger/0/income_statement/ vous verrez ...

- **Vue Journal** : Voir les transactions avec recherche, étiquettes et filtrage
- **Menu déroulant de filtre de compte** : Voir les soldes courants et les écritures par compte
- **Compte de Résultat** : Somme de vos comptes `Income:*` et `Expenses:*`
- **Bilan** : Vos actifs moins vos passifs

Fava aide à transformer vos écritures Beancount brutes en rapports exploitables – sans aucune configuration de base de données.

## 💡 Exemples Courants d'Écritures de Journal

### ✅ Vous êtes payé par un client

```bean
2024-06-05 * "Payment for invoice #456"
  Assets:Bank:Checking     1,200.00 USD
  Income:Consulting
```

Optionnel : Si vous utilisez les Comptes Clients :

```bean
2024-05-20 * "Invoice #456 sent"
  Assets:AccountsReceivable   1,200.00 USD
  Income:Consulting

2024-06-05 * "Payment for invoice #456"
  Assets:Bank:Checking        1,200.00 USD
  Assets:AccountsReceivable  -1,200.00 USD
```

### 🖨️ Vous achetez des fournitures de bureau

```bean
2024-06-07 * "Staples run"
  Expenses:OfficeSupplies     85.00 USD
  Assets:Bank:Checking
```

### 🏦 Vous effectuez un remboursement de prêt

Supposons que vous payiez 1 000 \$, avec 200 \$ d'intérêts et 800 \$ pour le principal :

```bean
2024-06-10 * "Loan repayment"
  Liabilities:Loan            800.00 USD
  Expenses:LoanInterest       200.00 USD
  Assets:Bank:Checking      -1,000.00 USD
```

## 🔒 Écritures de Clôture en Fin d'Année

Pour « clôturer les comptes », vous transférez généralement tous les comptes `Income` et `Expenses` dans les `Capitaux propres`.

```bean
2024-01-01 open Income:Consulting
2024-01-01 open Expenses:OfficeSupplies
2024-12-31 close Income:Consulting
2024-12-31 close Expenses:OfficeSupplies
```

Ou, manuellement :

```bean
2024-12-31 * "Close books"
  Equity:RetainedEarnings     45,000.00 USD
  Income:Consulting          -45,000.00 USD
```

## 🛠️ Écritures d'Ajustement

Si vous utilisez la **comptabilité d'engagement**, vous voudrez ajouter des **écritures d'ajustement** – pour les charges constatées d'avance, les produits à recevoir, etc.

Exemple : Abonnement logiciel mensuel de 100 \$ payé annuellement

```bean
2024-01-01 * "Annual software payment"
  Assets:Prepaid             1,200.00 USD
  Assets:Bank:Checking      -1,200.00 USD

2024-01-31 * "Monthly amortization"
  Expenses:Software           100.00 USD
  Assets:Prepaid             -100.00 USD
```

Automatisez avec des scripts ou des outils Beancount disponibles.

## 🧰 Beancount : Léger, Auditable, Puissant

Beancount n'est pas seulement un outil comptable – c'est une idée : une **vérité financière transparente et en texte brut.** C'est un système de grand livre moderne qui est :

- Facile à gérer avec le contrôle de version (Git !)
- Entièrement portable (pas de base de données propriétaire)
- Idéal pour les développeurs, les freelances et les petites entreprises

## Prêt à Commencer ?

Commencez votre fichier Beancount avec :

```bean
option "title" "My Business Ledger"
option "operating_currency" "USD"

2024-01-01 open Assets:Bank:Checking USD
2024-01-01 open Income:Sales USD
2024-01-01 open Expenses:OfficeSupplies USD
2024-01-01 open Equity:OpeningBalances USD

2024-01-01 * "Initial balance"
  Assets:Bank:Checking     10,000.00 USD
  Equity:OpeningBalances
```

Chargez ensuite votre fichier avec votre outil de visualisation préféré pour voir la magie opérer.

Vous voulez un démarrage plus facile ? Essayez les modèles, les importateurs ou les outils communautaires comme `bean-extract`.

Avec Beancount, vos livres sont enfin _les vôtres_ – simples, scriptables et à l'épreuve de l'audit.

Faites-moi savoir si vous souhaitez une version PDF téléchargeable ou des variantes des exemples spécifiques aux petites entreprises.
