> ## Documentation Index
> Fetch the complete documentation index at: https://help.agatabo.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Comprendre la Comptabilité en Partie Double
> Apprendre les principes comptables qui soutiennent le système financier d'Agatabo
## Qu'est-ce que la Comptabilité en Partie Double ?
La **comptabilité en partie double** est une méthode dans laquelle chaque transaction financière affecte au moins deux comptes : un compte est débité et un autre est crédité. Le total des débits égale toujours le total des crédits, ce qui maintient l'équation comptable équilibrée.
**Principe clé** : Pour chaque transaction, total des débits = total des crédits. Cela garantit que les comptes restent toujours équilibrés et que les erreurs sont faciles à détecter.
## L'Équation Comptable
```
Actifs = Passifs + Capitaux propres
```
Chaque transaction dans Agatabo maintient cet équilibre fondamental :
* **Actifs** : Ce que l'organisation possède (caisse, prêts à recevoir, immobilisations)
* **Passifs** : Ce que l'organisation doit (épargne des membres, dettes à payer)
* **Capitaux propres** : La valeur nette de l'organisation (résultats reportés, réserves)
**Exemple :**
```
Caisse : 10 000 000 RWF (actif)
Épargne des membres : 8 000 000 RWF (passif)
Résultats reportés : 2 000 000 RWF (capitaux propres)
10 000 000 = 8 000 000 + 2 000 000 ✓ Équilibré
```
***
## Débits et Crédits
### Règles de Base
| Type de Compte | Augmentation | Diminution | Solde Normal |
| ------------------------------------------------------ | ------------ | ---------- | ------------ |
| **Actifs** (Caisse, Prêts à Recevoir, Immobilisations) | Débit | Crédit | Débit |
| **Passifs** (Épargne des Membres, Dettes à payer) | Crédit | Débit | Crédit |
| **Capitaux propres** (Résultats Reportés, Réserves) | Crédit | Débit | Crédit |
| **Revenus** (Revenus d'intérêts, Frais) | Crédit | Débit | Crédit |
| **Dépenses** (Dépenses Opérationnelles, Salaires) | Débit | Crédit | Débit |
**Aide-mémoire** : **DEALER**
* Les **D**ébits augmentent : **D**ividendes (distributions), **E**xpenses, **A**ctifs, **L**osses (pertes)
* Les **C**rédits augmentent : **E**quity (capitaux propres, sauf distributions), **A**ccounts payable (dettes fournisseurs), **R**evenue (revenus)
***
## Exemples de Transactions (depuis Agatabo)
### Exemple 1 : Un Membre Dépose de l'Argent
**Transaction** : La membre Alice dépose 100 000 RWF sur son compte d'épargne
**Écriture comptable créée :**
| Compte | Type | Débit | Crédit |
| --------------------------------------- | ------ | ------- | ------- |
| Caisse (organization:org123) | Actif | 100 000 | |
| Épargne Membre (organizationUser:alice) | Passif | | 100 000 |
**Effet** :
* L'organisation a plus de caisse (l'actif augmente)
* L'organisation doit davantage à Alice (le passif augmente)
* L'équation comptable reste équilibrée
**Explication** : L'organisation reçoit de l'argent (débit pour augmenter l'actif), mais elle doit le restituer sur demande ; c'est donc un passif (crédit pour augmenter le passif).
***
### Exemple 2 : Décaissement de Prêt
**Transaction** : L'organisation prête 500 000 RWF au membre Bob
**Écriture comptable créée :**
| Compte | Type | Débit | Crédit |
| ----------------------------------- | ----- | ------- | ------- |
| Prêt à Recevoir (loan:bob-loan-123) | Actif | 500 000 | |
| Caisse (organization:org123) | Actif | | 500 000 |
**Effet** :
* La caisse diminue (crédit pour diminuer l'actif)
* Le prêt à recevoir augmente (débit pour augmenter l'actif)
* Le total des actifs reste inchangé (un actif est échangé contre un autre)
**Explication** : L'argent est remis au membre, mais l'organisation obtient un prêt à recevoir (droit de recouvrer le capital + les intérêts à l'avenir).
***
### Exemple 3 : Paiement de Prêt avec Intérêt
**Transaction** : Le membre Bob rembourse 110 000 RWF (100 000 de capital + 10 000 d'intérêt)
**Écriture comptable créée :**
| Compte | Type | Débit | Crédit |
| -------------------------------------- | ------ | ------- | ------- |
| Caisse (organization:org123) | Actif | 110 000 | |
| Prêt à Recevoir (loan:bob-loan-123) | Actif | | 100 000 |
| Revenu d'Intérêt (organization:org123) | Revenu | | 10 000 |
**Effet** :
* La caisse augmente de 110 000 (débit pour augmenter l'actif)
* Le prêt à recevoir diminue de 100 000 (crédit pour diminuer l'actif)
* Le revenu d'intérêt augmente de 10 000 (crédit pour augmenter le revenu)
**Explication** : L'organisation reçoit de l'argent, réduit le prêt à recevoir et gagne un revenu d'intérêt.
***
### Exemple 4 : Enregistrement d'une Dépense
**Transaction** : Payer 50 000 RWF de loyer pour le bureau
**Écriture comptable créée :**
| Compte | Type | Débit | Crédit |
| -------------------------------------------- | ------- | ------ | ------ |
| Dépense Opérationnelle (organization:org123) | Dépense | 50 000 | |
| Caisse (organization:org123) | Actif | | 50 000 |
**Effet** :
* La caisse diminue de 50 000 (crédit pour diminuer l'actif)
* La dépense augmente de 50 000 (débit pour augmenter la dépense, ce qui réduit le bénéfice)
**Explication** : L'argent est payé, et la dépense est enregistrée. Les dépenses réduisent le résultat net.
***
### Exemple 5 : Distribution de Dividendes
**Transaction** : Distribuer 200 000 RWF de dividendes aux membres (50 membres × 4 000 RWF chacun)
**Écriture comptable créée :**
| Compte | Type | Débit | Crédit |
| ---------------------------------------- | ---------------- | ------- | ------ |
| Résultats Reportés (organization:org123) | Capitaux propres | 200 000 | |
| Épargne Membre (organizationUser:alice) | Passif | | 4 000 |
| Épargne Membre (organizationUser:bob) | Passif | | 4 000 |
| Épargne Membre (organizationUser:carol) | Passif | | 4 000 |
| ... (50 membres au total) | Passif | | ... |
**Effet** :
* Les résultats reportés diminuent de 200 000 (débit pour diminuer les capitaux propres)
* Le solde d'épargne de chaque membre augmente (crédit pour augmenter le passif)
* Le total des passifs augmente de 200 000
**Explication** : Les dividendes distribuent les bénéfices accumulés (capitaux propres) vers les comptes d'épargne des membres (passif). Les membres peuvent retirer leurs dividendes ou les laisser s'accumuler.
**Idée reçue fréquente** : Dans Agatabo, les dividendes créditent les comptes d'ÉPARGNE (passif), et NON un compte séparé de "Capitaux propres des membres". L'épargne des membres est un passif parce que l'organisation doit ces fonds aux membres sur demande.
***
### Exemple 6 : Allocation de Réserve
**Transaction** : Allouer 1 000 000 RWF des résultats reportés vers la réserve du fonds d'urgence
**Écriture comptable créée :**
| Compte | Type | Débit | Crédit |
| ---------------------------------------------- | ---------------- | --------- | --------- |
| Allocation de Réserve (reserve:emergency-fund) | Capitaux propres | 1 000 000 | |
| Résultats Reportés (organization:org123) | Capitaux propres | | 1 000 000 |
**Effet** :
* Le solde de réserve augmente de 1 000 000 (débit pour augmenter les capitaux propres)
* Les résultats reportés diminuent de 1 000 000 (crédit pour diminuer les capitaux propres)
* Le total des capitaux propres reste inchangé (transfert interne au sein des capitaux propres)
**Explication** : Les deux comptes sont des comptes de capitaux propres. Il s'agit d'un reclassement interne des capitaux propres, des résultats reportés généraux vers une réserve désignée.
***
### Exemple 7 : Un Membre Retire son Épargne
**Transaction** : La membre Alice retire 50 000 RWF de son épargne
**Écriture comptable créée :**
| Compte | Type | Débit | Crédit |
| --------------------------------------- | ------ | ------ | ------ |
| Épargne Membre (organizationUser:alice) | Passif | 50 000 | |
| Caisse (organization:org123) | Actif | | 50 000 |
**Effet** :
* Le solde d'épargne d'Alice diminue de 50 000 (débit pour diminuer le passif)
* La caisse diminue de 50 000 (crédit pour diminuer l'actif)
* Les actifs et les passifs diminuent du même montant
**Explication** : L'organisation paie Alice en espèces, ce qui réduit son passif (ce qu'elle lui doit) et sa caisse (actif).
***
## Clés de Portée et Comptes par Entité
Agatabo utilise des **clés de portée** pour créer des comptes séparés pour différentes entités :
**Format :** `{entity_type}:{entity_id}`
**Exemples :**
* `organizationUser:alice123` - compte d'ÉPARGNE personnel d'Alice
* `organizationUser:bob456` - compte d'ÉPARGNE personnel de Bob
* `loan:loan-789` - compte PRÊTS\_À\_RECEVOIR d'un prêt spécifique
* `reserve:emergency-fund` - compte ALLOCATION\_RÉSERVE du fonds d'urgence
* `organization:org123` - compte CAISSE global de l'organisation
**Pourquoi c'est important :**
* Chaque membre a son propre compte d'ÉPARGNE (tous sont des passifs, mais suivis séparément)
* Chaque prêt a son propre compte PRÊTS\_À\_RECEVOIR
* Chaque réserve a son propre compte ALLOCATION\_RÉSERVE
* Cela permet une comptabilité par membre, par prêt et par réserve
***
## Pourquoi Agatabo Utilise la Partie Double
**Avantages :**
**Exactitude et détection des erreurs :**
* Les erreurs apparaissent immédiatement (les débits doivent égaler les crédits)
* Les écritures non équilibrées sont rejetées par le système
* Le mécanisme d'auto-contrôle évite de nombreuses erreurs courantes
**Vue complète des transactions :**
* Voir les deux côtés de chaque transaction (ce qui est donné et ce qui est reçu)
* Comprendre l'impact sur plusieurs comptes en même temps
* Piste d'audit claire pour chaque événement financier
**États financiers automatisés :**
* Bilan généré à partir des soldes des comptes
* Compte de Résultat généré à partir des comptes de revenus et de dépenses
* Tableau des flux de trésorerie généré à partir des variations de comptes
**Conformité et audit :**
* Requis pour les rapports financiers formels
* Respecte les normes comptables (GAAP, IFRS)
* Fournit une piste d'audit complète
* Prend en charge les audits et revues externes
**Informations de gestion :**
* Suivre précisément d'où vient l'argent et où il va
* Comprendre la santé financière en un coup d'oeil
* Prendre des décisions éclairées à partir de données complètes
* Suivre la rentabilité, la liquidité et la solvabilité
***
## Écritures Comptables dans Agatabo
Chaque transaction dans Agatabo crée une **écriture comptable** avec :
**Composants :**
* **Nature** : Type de transaction (DÉPÔT\_ÉPARGNE, DÉCAISSEMENT\_PRÊT, DISTRIBUTION\_DIVIDENDE, DOTATION\_RÉSERVE, PAIEMENT\_DÉPENSE, etc.)
* **Date de transaction** : Quand la transaction a eu lieu
* **Statut** : POSTED (permanent, affecte les soldes) ou DRAFT (temporaire, peut être modifié)
* **Lignes** : 2 lignes ou plus montrant les débits et les crédits (doivent être équilibrées)
* **Métadonnées** : Titre, description, documents justificatifs
* **Clé d'idempotence** : Empêche les écritures en double
**Exemple de structure d'écriture comptable :**
```json theme={null}
{
"id": "je-123",
"kind": "SAVINGS_DEPOSIT",
"transactionDate": "2026-06-12",
"status": "POSTED",
"lines": [
{
"side": "DEBIT",
"amount": 100000,
"account": "Cash (organization:org123)"
},
{
"side": "CREDIT",
"amount": 100000,
"account": "Savings (organizationUser:alice)"
}
]
}
```
[En savoir plus sur les écritures comptables →](/fr/tontines/general-ledger/viewing-journal-entries)
***
## Questions Fréquentes
### Q : Dois-je comprendre les débits et les crédits pour utiliser Agatabo ?
**R** : Non ! Agatabo crée automatiquement les écritures comptables lorsque vous enregistrez des dépôts, prêts, dépenses, dividendes et réserves. Comprendre la partie double aide pour :
* Résoudre les écarts
* Créer des écritures comptables manuelles
* Effectuer des tâches comptables avancées
* Interpréter les états financiers
Mais ce n'est **pas obligatoire** pour les opérations quotidiennes comme l'enregistrement des dépôts ou des paiements de prêt.
***
### Q : Que se passe-t-il si les débits ne sont pas égaux aux crédits ?
**R** : Agatabo n'autorise pas la publication d'écritures non équilibrées :
* Toutes les écritures automatiques sont validées avant leur création
* Les écritures comptables manuelles sont rejetées si les débits ≠ les crédits
* Le système impose l'équilibre en permanence
Si vous rencontrez malgré tout une écriture non équilibrée, c'est une anomalie système qui doit être signalée.
***
### Q : Pourquoi ma caisse augmente-t-elle (débit) alors que l'épargne du membre augmente aussi (crédit) ?
**R** : Parce qu'il s'agit de **types de comptes différents** :
* La caisse (actif) augmente avec un **débit**
* L'épargne des membres (passif) augmente avec un **crédit**
Les deux peuvent augmenter simultanément parce que la transaction affecte différentes parties de l'équation comptable :
```
Actifs (Caisse ↑) = Passifs (Épargne ↑) + Capitaux propres
```
L'équation reste équilibrée !
***
### Q : Quelle est la différence entre Income et Revenue ?
**R** : Dans Agatabo (et dans beaucoup de systèmes comptables) :
* **Income** : Terme préféré pour les revenus gagnés (INTEREST\_INCOME, FEE\_INCOME, PENALTY\_INCOME)
* **Revenue** : Terme général pour l'argent gagné
Ils signifient la même chose. Agatabo utilise "Income" dans les noms de comptes pour rester cohérent.
***
### Q : Pourquoi l'épargne des membres est-elle un passif ?
**R** : Parce que l'organisation **doit** ces fonds aux membres :
* Les membres peuvent retirer leur épargne à tout moment
* L'organisation a l'obligation de restituer les fonds sur demande
* Il s'agit donc d'un passif (argent dû à d'autres)
Même si les membres sont des "propriétaires", leurs comptes d'épargne sont des passifs, pas des capitaux propres. Les dividendes que les membres choisissent de laisser en épargne augmentent aussi ce passif.
***
### Q : Comment fonctionnent les réserves en partie double ?
**R** : Les réserves sont des **comptes de capitaux propres** (résultats reportés désignés) :
* Les Résultats Reportés et les Allocations de Réserve sont tous deux des capitaux propres
* Allouer vers des réserves déplace l'argent des capitaux propres généraux vers des capitaux propres désignés
* Le total des capitaux propres ne change pas (reclassement interne)
* Les deux côtés de l'écriture sont des comptes de capitaux propres
**Exemple :**
```
DÉBIT : Allocation de Réserve (capitaux propres) +1 000 000
CRÉDIT : Résultats Reportés (capitaux propres) -1 000 000
```
***
## Guide Visuel : Flux des Comptes
```
ACTIFS PASSIFS
┌─────────────┐ ┌─────────────┐
│ │ │ │
│ Caisse │ │ Épargne │
│ Prêts │ │ des │
│ Actifs │ │ Membres │
│ fixes │ │ │
│ │ │ │
└─────────────┘ └─────────────┘
↕ ↕
Débit ↑ Crédit ↑
Crédit ↓ Débit ↓
CAPITAUX PROPRES REVENUS
┌─────────────┐ ┌─────────────┐
│ │ │ │
│ Résultats │ │ Intérêts │
│ Reportés │ │ Frais │
│ Réserves │ │ Pénalités │
│ │ │ │
│ │ │ │
└─────────────┘ └─────────────┘
↕ ↕
Crédit ↑ Crédit ↑
Débit ↓ Débit ↓
DÉPENSES
┌─────────────┐
│ │
│ Dépenses │
│ opération. │
│ Créances │
│ douteuses │
│ Charges │
│ bancaires │
└─────────────┘
↕
Débit ↑
Crédit ↓
```
***
## Bonnes Pratiques
**Pour les non-comptables :**
* Faites confiance aux écritures comptables automatiques (elles sont correctes)
* Concentrez-vous sur les transactions métier, pas sur les mécanismes comptables
* Consultez les rapports financiers (Bilan, Compte de Résultat) plutôt que les écritures brutes
* Demandez l'aide d'un comptable avant de créer des écritures manuelles
**Pour les comptables :**
* Examinez régulièrement les écritures comptables pour vérifier leur exactitude
* Vérifiez chaque mois l'équilibre de la balance de vérification
* Documentez clairement toutes les écritures comptables manuelles
* Utilisez des noms et classifications de comptes cohérents
* Formez le personnel aux concepts de base de la partie double
* Surveillez les transactions ou tendances inhabituelles
***
## Besoin d'Aide ?
Voir les détails des transactions et la piste d'audit
Aperçu complet du système comptable
Voir l'équation comptable en action
Voir les revenus et les dépenses
Créer des écritures comptables manuelles