> ## 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.
# Aperçu du Grand Livre
> Comprendre le système de comptabilité en partie double d'Agatabo, les écritures comptables, les comptes du grand livre et le fondement des rapports financiers
## Qu'est-ce que le Grand Livre ?
Le grand livre est le système comptable central d'Agatabo qui suit toutes les transactions financières en utilisant la **comptabilité en partie double**. Chaque dépôt, décaissement de prêt, paiement, dépense, dividende et allocation de réserve crée des écritures comptables qui maintiennent automatiquement des comptes équilibrés.
**Comptabilité automatique** : La plupart des écritures comptables sont créées automatiquement lorsque vous effectuez des opérations métier. Vous enregistrez les transactions (dépôts, prêts, dépenses), et Agatabo gère la comptabilité en coulisses.
## Concepts Clés
### Comptabilité en Partie Double
Chaque transaction affecte au moins deux comptes :
* Côté **Débit** : Augmente les actifs/dépenses, diminue les passifs/revenus/capitaux propres
* Côté **Crédit** : Augmente les passifs/revenus/capitaux propres, diminue les actifs/dépenses
* **Exigence d'équilibre** : Le total des débits doit toujours égaler le total des crédits
**Exemple :**
```
Un membre dépose 100 000 RWF en épargne :
DÉBIT : Trésorerie +100 000 RWF (l'actif augmente)
CRÉDIT : Épargne Membre +100 000 RWF (le passif augmente)
```
[En savoir plus sur la comptabilité en partie double →](/fr/tontines/general-ledger/understanding-double-entry)
### Écritures Comptables
Une écriture comptable est l'enregistrement d'une transaction financière composée de :
* **Nature** : Type de transaction (ex. DÉPÔT\_ÉPARGNE, DÉCAISSEMENT\_PRÊT, DISTRIBUTION\_DIVIDENDE)
* **Date de transaction** : Quand la transaction a eu lieu
* **Statut** : BROUILLON ou PUBLIÉE
* **Lignes** : Lignes de débit et de crédit qui doivent être équilibrées
* **Métadonnées** : Titre, description, documents, clé d'idempotence
* **Références** : Liens vers des entités spécifiques (utilisateur, prêt, réserve, etc.)
### Natures d'Écritures Comptables
Agatabo prend en charge les types de transactions suivants :
**Épargne et Dépôts :**
* **DÉPÔT\_ÉPARGNE** : Dépôt de fonds par un membre sur son compte d'épargne
* **FRAIS\_ADHÉSION** : Paiement des frais d'adhésion initiaux
**Prêts :**
* **DÉCAISSEMENT\_PRÊT** : Capital du prêt décaissé au membre
* **PAIEMENT\_PRÊT** : Paiement de prêt par le membre (capital + intérêts)
* **PÉNALITÉ\_PRÊT** : Pénalité de retard appliquée
* **DÉFAUT\_PRÊT** : Prêt passé en pertes et profits
* **INTÉRÊTS\_PAYÉS\_AVANCE** : Paiement d'intérêts anticipé
**Dépenses :**
* **PAIEMENT\_DÉPENSE** : Paiement de dépense opérationnelle
* **FRAIS\_BANCAIRES** : Frais et commissions bancaires
**Réserves :**
* **DOTATION\_RÉSERVE** : Allocation de fonds des résultats reportés vers les réserves
* **LIBÉRATION\_RÉSERVE** : Libération de fonds des réserves vers les résultats reportés
* **DÉPENSE\_RÉSERVE** : Dépense payée directement depuis les fonds de réserve
**Dividendes :**
* **DISTRIBUTION\_DIVIDENDE** : Distribution des résultats reportés vers les comptes d'épargne des membres
**Immobilisations :**
* **ACHAT\_ESPÈCES\_ACTIF** : Achat d'actif avec de la trésorerie
* **NANTISSEMENT\_ACTIF** : Acquisition d'actif en garantie de prêt
* **DON\_ACTIF** : Réception d'un actif en donation
* **CESSION\_ACTIF** : Vente ou cession d'actif
* **OUVERTURE\_CAISSE** : Solde d'ouverture de trésorerie
**Administratif :**
* **ANNULATION** : Annulation d'une écriture comptable précédente
* **CLÔTURE\_PÉRIODE** : Clôture de la période comptable et transfert du résultat net vers les résultats reportés
### Statut des Écritures Comptables
**BROUILLON :**
* Écriture créée mais pas encore finalisée
* Peut être modifiée ou supprimée
* N'affecte pas les soldes de comptes
* Non incluse dans les rapports financiers
**PUBLIÉE :**
* Écriture finalisée et verrouillée
* Ne peut pas être modifiée ou supprimée (permanente)
* Affecte immédiatement les soldes de comptes
* Incluse dans tous les rapports financiers
* Crée une piste d'audit
**La plupart des écritures sont PUBLIÉES automatiquement** : Lorsque vous enregistrez une transaction (dépôt, paiement de prêt, distribution de dividendes), Agatabo crée et publie immédiatement l'écriture comptable. Les écritures manuelles peuvent être créées en brouillon pour révision avant publication.
### Comptes du Grand Livre
Les comptes du grand livre sont catégorisés par **type** et **rôle**.
**Types de comptes** (5 catégories) :
* **ACTIF** : Ressources possédées (Trésorerie, Prêts à Recevoir, Immobilisations)
* **PASSIF** : Obligations dues (Épargne Membres, Excédent Emprunteur)
* **CAPITAUX PROPRES** : Résultats Reportés, Réserves, Capitaux d'Ouverture
* **PRODUITS** : Sources de revenus (Intérêts, Frais, Pénalités)
* **CHARGES** : Coûts engagés (Dépenses Opérationnelles, Créances Douteuses, Frais Bancaires)
**Rôles de comptes** :
**Actifs :**
* **CAISSE** : Trésorerie disponible ou en banque
* **PRÊTS\_À\_RECEVOIR** : Montant du capital des prêts en cours
* **INTÉRÊTS\_À\_RECEVOIR** : Intérêts courus non encore payés
* **PÉNALITÉS\_À\_RECEVOIR** : Pénalités courues non encore payées
* **IMMOBILISATION** : Équipements, mobilier, bâtiments
**Passifs :**
* **ÉPARGNE** : Soldes d'épargne des membres (un compte par membre)
* **EXCÉDENT\_EMPRUNTEUR** : Trop-perçus des emprunteurs
**Capitaux Propres :**
* **RÉSULTATS\_REPORTÉS** : Bénéfices accumulés
* **ALLOCATION\_RÉSERVE** : Réserves désignées (un compte par réserve)
* **CAPITAUX\_PROPRES\_OUVERTURE** : Capital initial
* **AUTRES\_CAPITAUX\_PROPRES** : Capitaux propres divers
**Produits :**
* **PRODUITS\_INTÉRÊTS** : Intérêts gagnés sur les prêts
* **PRODUITS\_PÉNALITÉS** : Pénalités de retard de paiement
* **PRODUITS\_FRAIS\_ADHÉSION** : Frais d'adhésion
* **PRODUITS\_FRAIS\_DÉCAISSEMENT** : Frais de traitement des prêts
* **PRODUITS\_RÉCUPÉRATION\_CRÉANCES** : Créances douteuses récupérées
* **AUTRES\_PRODUITS** : Produits divers
**Charges :**
* **DÉPENSES\_OPÉRATIONNELLES** : Coûts opérationnels généraux
* **CHARGES\_BANCAIRES** : Frais bancaires
* **CRÉANCES\_DOUTEUSES** : Passages en pertes et profits de prêts
[Voir tous les rôles du grand livre →](/fr/tontines/general-ledger/ledger-roles)
### Clés de Portée
Les clés de portée lient les comptes du grand livre à des entités spécifiques.
**Format :**
```
{type_entité}:{id_entité}
```
**Exemples :**
```
organizationUser:abc-123 → Compte ÉPARGNE du membre
reserve:xyz-789 → Compte ALLOCATION_RÉSERVE de la réserve spécifique
loan:def-456 → Compte PRÊTS_À_RECEVOIR du prêt spécifique
organization:org-001 → Compte CAISSE de l'organisation
```
**Utilité :**
* Permet plusieurs comptes avec le même rôle (ex. un compte ÉPARGNE par membre)
* Lie les comptes à des membres, prêts, réserves ou organisations spécifiques
* Prend en charge la comptabilité par membre, par prêt, par réserve
## Comment les Transactions Créent des Écritures Comptables
### Exemple 1 : Dépôt de 500 000 RWF par un Membre
**Transaction :** Le membre Alice dépose 500 000 RWF sur son compte d'épargne
**Écriture comptable créée :**
```
Nature : DÉPÔT_ÉPARGNE
Statut : PUBLIÉE
Date de Transaction : 2026-06-12
Lignes :
DÉBIT : Caisse (organization:org123) +500 000 RWF
CRÉDIT : Épargne (organizationUser:alice123) +500 000 RWF
```
### Exemple 2 : Distribution de Dividende de 5 000 000 RWF
**Transaction :** Distribuer 5 000 000 RWF de dividendes à 50 membres
**Écriture comptable créée :**
```
Nature : DISTRIBUTION_DIVIDENDE
Statut : PUBLIÉE
Date de Transaction : 2026-06-12
Lignes :
DÉBIT : Résultats Reportés (organization:org123) -5 000 000 RWF
CRÉDIT : Épargne (organizationUser:alice) +100 000 RWF
CRÉDIT : Épargne (organizationUser:bob) +100 000 RWF
CRÉDIT : Épargne (organizationUser:carol) +100 000 RWF
... (50 membres au total)
```
### Exemple 3 : Allocation de Réserve de 1 000 000 RWF
**Transaction :** Allouer 1 000 000 RWF des résultats reportés au fonds d'urgence
**Écriture comptable créée :**
```
Nature : DOTATION_RÉSERVE
Statut : PUBLIÉE
Date de Transaction : 2026-06-12
Lignes :
DÉBIT : Allocation Réserve (reserve:emergency-fund) +1 000 000 RWF
CRÉDIT : Résultats Reportés (organization:org123) -1 000 000 RWF
```
## Consultation des Écritures Comptables
Cliquer sur **Grand Livre** → **Écritures Comptables** dans la barre latérale
Filtrer par nature, plage de dates, statut ou rechercher des écritures spécifiques
Cliquer sur une écriture pour voir toutes les lignes et les métadonnées
Utiliser pour la piste d'audit, le rapprochement ou la production de rapports
[En savoir plus sur la consultation des écritures comptables →](/fr/tontines/general-ledger/viewing-journal-entries)
## Création d'Écritures Comptables Manuelles
La plupart des écritures comptables sont automatiques, mais vous pouvez créer des écritures manuelles pour :
* Ajustements et corrections
* Régularisations
* Transactions ponctuelles non prises en charge par les fonctionnalités standard
* Tests ou migration de données
**Les écritures manuelles requièrent des connaissances comptables** : Assurez-vous de comprendre la comptabilité en partie double avant de créer des écritures manuelles. Des écritures incorrectes peuvent déséquilibrer vos livres.
[En savoir plus sur la création d'écritures manuelles →](/fr/tontines/general-ledger/manual-journal-entries)
## Contraintes des Périodes Comptables
Les écritures comptables sont soumises aux règles des périodes comptables :
**Règles :**
* Impossible de publier des écritures avec une date de transaction dans une **période comptable clôturée**
* La date de transaction doit être dans une période ouverte
* Une fois une période clôturée, toutes les écritures avec des dates dans cette période sont verrouillées
* Empêche l'antidatage des transactions ou la modification des enregistrements historiques
```
Périodes clôturées : 1er jan - 31 mars 2026
Période ouverte actuelle : 1er avr - 30 juin 2026
Dates de transaction valides : 1er avril 2026 ou plus tard
Invalide : 31 mars 2026 ou plus tôt (période clôturée)
```
## Idempotence
Les écritures comptables prennent en charge l'idempotence pour éviter les transactions en double :
* Fournir une `cléIdempotence` lors de la création d'une écriture
* Si la même clé est utilisée deux fois, la deuxième requête retourne l'écriture existante (pas de doublon)
* Sûr pour les nouvelles tentatives après des échecs réseau
## Bonnes Pratiques
**Bonnes pratiques du grand livre :**
**Pour les Non-Comptables :**
* Faites confiance aux écritures automatiques (elles sont correctes)
* Examinez périodiquement les écritures pour comprendre les flux de trésorerie
* N'créez pas d'écritures manuelles à moins que nécessaire
* Consultez un comptable en cas de doute sur les écritures manuelles
* Utilisez la balance de vérification pour s'assurer que les livres s'équilibrent
**Pour les Comptables :**
* Examinez régulièrement les écritures pour leur exactitude
* Utilisez les écritures manuelles avec parcimonie (uniquement si nécessaire)
* Documentez toujours les écritures manuelles avec des descriptions claires
* Vérifiez la balance de vérification avant de clôturer les périodes
* Exportez les écritures pour les audits externes
* Surveillez les écritures déséquilibrées (ne devrait jamais arriver)
**Rapprochement :**
* Effectuez la balance de vérification mensuellement
* Rapprochez les comptes bancaires avec le compte de grand livre CAISSE
* Vérifiez que les soldes d'épargne des membres correspondent aux totaux du compte ÉPARGNE
* Vérifiez que les prêts en cours correspondent au total PRÊTS\_À\_RECEVOIR
## Opérations Courantes
Bases comptables pour les non-comptables
Liste complète des rôles et types de comptes
Examiner les enregistrements de transactions et la piste d'audit
Créer des ajustements comptables manuels
Voir les actifs, passifs et capitaux propres
Voir les produits et les charges