> ## 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.

# Ajout de Comptes Bancaires

> Enregistrer les comptes bancaires de votre organisation dans Agatabo et configurer le suivi de trésorerie

## Aperçu

Avant de pouvoir suivre les transactions, vous devez ajouter vos comptes bancaires dans Agatabo. Cela crée un enregistrement pour chaque compte physique et configure automatiquement le système de grand livre pour suivre les soldes.

## Avant de Commencer

<Note>
  **Prérequis :**

  * Vous avez l'autorisation `bank_accounts:write`
  * Vous connaissez les noms et types de vos comptes bancaires
  * Vous disposez des informations de solde actuel si vous définissez des soldes d'ouverture
</Note>

## Ce qui se Passe lors de l'Ajout d'un Compte

Lorsque vous créez un compte bancaire, Agatabo automatiquement :

1. **Crée un enregistrement de compte bancaire** avec le nom et le type que vous avez spécifiés
2. **Crée un compte de grand livre CAISSE** en arrière-plan pour suivre les transactions
3. **Définit le solde initial à zéro** (vous pouvez l'ajuster plus tard si nécessaire)
4. **Le rend disponible** pour les dépôts, prêts, dépenses et autres transactions
5. **Le définit par défaut** (premier compte uniquement — devient automatiquement le compte par défaut)

## Instructions Étape par Étape

### Étape 1 : Accéder aux Comptes Bancaires

<Steps>
  <Step title="Ouvrir les Comptes Bancaires">
    Cliquer sur "Comptes Bancaires" dans la barre latérale ou le menu de navigation
  </Step>

  <Step title="Cliquer sur Ajouter un Compte Bancaire">
    Ouvre le formulaire de création de compte bancaire
  </Step>
</Steps>

### Étape 2 : Saisir les Informations du Compte

Remplir les champs obligatoires :

| Champ         | Description                                  | Obligatoire | Validation                                     |
| ------------- | -------------------------------------------- | ----------- | ---------------------------------------------- |
| **Nom**       | Nom descriptif du compte                     | Oui         | Doit être unique au sein de votre organisation |
| **Type**      | ÉPARGNE ou COURANT                           | Oui         | Ne peut pas être modifié après la création     |
| **Est Actif** | Si le compte est actuellement en utilisation | Non         | Valeur par défaut : `vrai` (actif)             |

<Note>
  **Les noms de comptes doivent être uniques** : Chaque nom de compte doit être unique au sein de votre organisation.
</Note>

<Note>
  **Conseils de nommage** : Utiliser des noms descriptifs faciles à identifier :

  * Inclure le nom de la banque : "Compte Opérations BK", "Compte Épargne Equity"
  * Inclure les 4 derniers chiffres : "BK Courant \*\*\*1234", "Equity Épargne \*\*\*5678"
  * Inclure l'objectif : "Compte Décaissement Prêts", "Fonds d'Urgence"
</Note>

### Étape 3 : Choisir le Type de Compte

<Tabs>
  <Tab title="COURANT">
    **Compte Courant (Chèques)**

    **À utiliser pour :**

    * Dépenses opérationnelles quotidiennes
    * Décaissements et remboursements de prêts
    * Transactions fréquentes
    * Traitement des paiements
    * Dépôts des membres

    **Note** : La plupart des tontines utilisent un compte COURANT comme compte principal par défaut. Au moins un compte COURANT actif est requis.
  </Tab>

  <Tab title="ÉPARGNE">
    **Compte d'Épargne**

    **À utiliser pour :**

    * Réserves à long terme
    * Fonds d'urgence
    * Accumulation de dividendes
    * Épargne d'investissement
    * Réserves réglementaires

    **Note** : Les comptes d'épargne sont généralement utilisés pour les fonds qui ne doivent pas être dépensés pour les opérations régulières.
  </Tab>
</Tabs>

**Impossible de changer le type** : Une fois le compte créé avec un type spécifique (ÉPARGNE ou COURANT), vous ne pouvez pas le modifier. Supprimer et recréer si nécessaire (sous réserve des contraintes de suppression).

### Étape 4 : Soumettre

<Steps>
  <Step title="Vérifier les informations">
    Vérifier le nom et le type avant de soumettre
  </Step>

  <Step title="Cliquer sur Enregistrer ou Ajouter un Compte">
    Crée l'enregistrement du compte bancaire
  </Step>

  <Step title="Vérifier la création">
    Le compte doit apparaître dans la liste des comptes bancaires avec un solde de 0,00
  </Step>
</Steps>

## Comportement Spécial du Premier Compte

**Votre premier compte bancaire est automatiquement défini comme compte par défaut.**

**Ce que cela signifie** :

* Lors de l'enregistrement des transactions, ce compte sera présélectionné
* Utilisé automatiquement quand aucun compte spécifique n'est sélectionné
* Simplifie la saisie des données pour les opérations courantes

## Définition des Soldes d'Ouverture

Si votre compte bancaire a déjà de l'argent lorsque vous l'ajoutez dans Agatabo, vous devez ajuster le solde d'ouverture :

### Quand Ajuster le Solde d'Ouverture

**Ajuster le solde d'ouverture si** :

* Vous commencez à utiliser Agatabo en cours d'année
* Le compte bancaire physique a des fonds existants
* Vous migrez depuis un autre système
* Votre relevé bancaire montre un solde non nul

**Ignorer si** :

* Vous démarrez avec de nouveaux comptes
* Le compte a réellement un solde nul
* Vous importerez des transactions historiques

### Comment Ajuster le Solde d'Ouverture

<Steps>
  <Step title="Accéder au compte bancaire">
    Trouver le compte nouvellement créé dans la liste
  </Step>

  <Step title="Cliquer sur Ajuster le Solde">
    Rechercher l'action "Ajuster le Solde" ou "Définir le Solde d'Ouverture"
  </Step>

  <Step title="Saisir le solde actuel">
    Saisir le solde de votre relevé bancaire le plus récent
  </Step>

  <Step title="Ajouter une description">
    Exemple : "Solde d'ouverture au 1er juin 2026 selon relevé bancaire"
  </Step>

  <Step title="Soumettre">
    Crée une écriture comptable OUVERTURE\_CAISSE
  </Step>
</Steps>

**Ce qui se passe** :

```
Écriture Comptable (OUVERTURE_CAISSE) :
Dt CAISSE (Votre Compte Bancaire)    5 000 000
   Ct CAPITAUX_PROPRES_OUVERTURE     5 000 000

Résultat : Le compte bancaire affiche désormais un solde de 5 000 000 RWF
```

<Warning>
  **Règles importantes pour le solde d'ouverture :**

  * N'ajuster le solde d'ouverture QU'UNE SEULE FOIS lors de la configuration initiale du compte
  * Faire cela AVANT d'enregistrer des transactions
  * Après la configuration initiale, tous les changements de solde doivent provenir de transactions réelles
  * Impossible d'ajuster le solde d'ouverture après la clôture de la période comptable
</Warning>

## Changement du Compte Par Défaut

Si vous souhaitez changer quel compte est le compte par défaut :

<Steps>
  <Step title="Accéder aux comptes bancaires">
    Consulter la liste de tous les comptes bancaires
  </Step>

  <Step title="Trouver le compte cible">
    Localiser le compte que vous souhaitez définir comme par défaut
  </Step>

  <Step title="Cliquer sur Définir par Défaut">
    Bouton d'action ou option de menu
  </Step>

  <Step title="Confirmer">
    Le précédent compte par défaut est automatiquement décoché, le nouveau compte devient par défaut
  </Step>
</Steps>

## Comptes Actifs vs Inactifs

### Comptes Actifs

**Caractéristiques** :

* Disponibles dans les listes déroulantes de transactions
* Peuvent recevoir des dépôts et des décaissements
* Apparaissent dans la sélection du compte par défaut
* Entièrement fonctionnels

### Comptes Inactifs

**Caractéristiques** :

* Masqués dans les listes déroulantes de transactions
* Impossible de les sélectionner pour de nouvelles transactions
* Les transactions historiques restent visibles
* Le solde est toujours suivi

**Quand désactiver** :

* Compte bancaire physique fermé
* N'utilise plus ce compte
* Migration vers un nouveau compte

**Contraintes** :

* Impossible de désactiver si c'est le seul compte COURANT actif
* Impossible de désactiver le compte par défaut (définir un autre comme par défaut d'abord)

## Autorisations Requises

| Action                              | Autorisation          | Portée |
| ----------------------------------- | --------------------- | ------ |
| Créer un compte bancaire            | `bank_accounts:write` | TOUTE  |
| Consulter les comptes bancaires     | `bank_accounts:read`  | TOUTE  |
| Définir le compte par défaut        | `bank_accounts:write` | TOUTE  |
| Ajuster le solde d'ouverture        | `bank_accounts:write` | TOUTE  |
| Mettre à jour les détails du compte | `bank_accounts:write` | TOUTE  |

## Sujets Connexes

<CardGroup cols={2}>
  <Card title="Aperçu des Comptes Bancaires" icon="building-columns" href="/fr/tontines/bank-accounts/overview">
    Apprendre la gestion des comptes bancaires
  </Card>

  <Card title="Enregistrement des Transactions" icon="file-invoice-dollar" href="/fr/tontines/bank-accounts/recording-transactions">
    Commencer à utiliser vos comptes bancaires
  </Card>

  <Card title="Rapprochement" icon="check-double" href="/fr/tontines/bank-accounts/reconciliation">
    Comparer les enregistrements avec les relevés bancaires
  </Card>

  <Card title="Grand Livre" icon="book" href="/fr/tontines/general-ledger/overview">
    Comprendre l'intégration au grand livre
  </Card>
</CardGroup>
