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

# Création de Bassins de Dividendes

> Configurer de nouveaux bassins de dividendes pour allouer les résultats reportés aux membres pour une période spécifique

## Aperçu

La création d'un bassin de dividendes établit le cadre pour distribuer un montant spécifique des résultats reportés aux membres éligibles sur une période définie. Les bassins commencent en statut **brouillon** et doivent être distribués séparément pour effectuer les paiements réels.

<Note>
  **Ce qui se passe** : La création d'un bassin configure les métadonnées (période, montant, libellé) mais ne distribue PAS de fonds ni ne crée d'écritures comptables. Les bassins démarrent en brouillon avec `journalEntryId = null` et doivent être distribués séparément.
</Note>

## Avant de Commencer

<Note>
  **Prérequis :**

  * Vous avez l'autorisation `dividends:write`
  * Vous avez décidé de la période de dividende (dates de début et de fin)
  * Vous avez déterminé le montant total des dividendes à distribuer
  * Vous avez un solde de résultats reportés suffisant
  * Vous comprenez la méthode de distribution de votre organisation (égale ou par\_contribution)
  * Vous comprenez les paramètres de pondération temporelle (si activée)
</Note>

<Warning>
  **La méthode de distribution est définie au niveau de l'organisation** : La méthode de distribution (égale vs. par\_contribution) et les paramètres de pondération temporelle sont configurés au niveau de l'organisation dans les paramètres de dividendes, PAS par bassin. Tous les bassins utilisent les mêmes règles de distribution.
</Warning>

## Instructions Étape par Étape

### Étape 1 : Accéder aux Dividendes

<Steps>
  <Step title="Ouvrir la section Dividendes">
    Cliquer sur **Dividendes** dans la barre latérale gauche
  </Step>

  <Step title="Cliquer sur Ajouter Bassin ou Nouveau Bassin">
    Ouvre la boîte de dialogue de création du bassin de dividendes
  </Step>
</Steps>

### Étape 2 : Saisir les Détails du Bassin

| Champ                  | Description                                              | Obligatoire | Validation                                          |
| ---------------------- | -------------------------------------------------------- | ----------- | --------------------------------------------------- |
| **Libellé de Période** | Nom descriptif de la période (ex. "T1 2026")             | Oui         | Chaîne non vide                                     |
| **Début de Période**   | Premier jour de la période d'éligibilité au dividende    | Oui         | Date ISO (AAAA-MM-JJ), doit être ≤ Fin de Période   |
| **Fin de Période**     | Dernier jour de la période d'éligibilité au dividende    | Oui         | Date ISO (AAAA-MM-JJ), doit être ≥ Début de Période |
| **Montant**            | Montant total à distribuer depuis les résultats reportés | Oui         | Doit être ≥ 0,01                                    |

### Étape 3 : Définir la Période de Dividende

**Exemples :**

**Dividende Trimestriel :**

```
Libellé de Période : "Dividende T1 2026"
Début de Période : 2026-01-01
Fin de Période : 2026-03-31
Montant : 5 000 000
```

**Dividende Annuel :**

```
Libellé de Période : "Dividende Annuel 2026"
Début de Période : 2026-01-01
Fin de Période : 2026-12-31
Montant : 20 000 000
```

**Dividende Semestriel :**

```
Libellé de Période : "Dividende S1 2026"
Début de Période : 2026-01-01
Fin de Période : 2026-06-30
Montant : 10 000 000
```

### Étape 4 : Choisir le Libellé de Période

Utiliser des libellés clairs et spécifiques indiquant la période :

**Bons libellés :**

* "Dividende T1 2026"
* "Dividende Annuel 2026"
* "Janvier-Mars 2026"
* "Distribution de Fin d'Année 2026"
* "Dividende Membre S2 2025"

**Libellés à éviter :**

* "Dividende 1"
* "Distribution"
* "Argent"
* "Bassin"

**Règles de nommage** :

* Inclure la période (année, trimestre, plage de mois)
* Inclure le mot "Dividende" pour la clarté
* Garder concis mais descriptif (moins de 50 caractères)
* Utiliser une convention de nommage cohérente pour tous les bassins

### Étape 5 : Définir le Montant des Dividendes

Saisir le montant total à distribuer depuis les résultats reportés.

**Déterminer le montant :**

1. **Vérifier le solde des résultats reportés** :
   * Consulter le solde des résultats reportés dans le formulaire de création
   * Ou naviguer vers Grand Livre → Consulter le solde du compte RÉSULTATS\_REPORTÉS

2. **Considérer la politique de l'organisation** :
   * Certaines organisations distribuent un pourcentage fixe du bénéfice (ex. 50% du bénéfice annuel)
   * D'autres distribuent un montant fixe par période (ex. 2 000 000 RWF trimestriels)

**Exemples :**

**50% du bénéfice trimestriel :**

```
Bénéfice net trimestriel : 8 000 000 RWF
Montant dividende : 4 000 000 RWF (50%)
Conservé : 4 000 000 RWF
```

**Distribution trimestrielle fixe :**

```
Politique : Distribuer 2 000 000 RWF chaque trimestre
Montant : 2 000 000 RWF
```

**Distribution annuelle :**

```
Bénéfice annuel : 30 000 000 RWF
Cible : Distribuer 60% aux membres, conserver 40% pour les réserves
Montant : 18 000 000 RWF
```

<Warning>
  **Exigence de résultats reportés** : Vous devez avoir un solde de résultats reportés suffisant pour couvrir le montant des dividendes.
</Warning>

### Étape 6 : Vérifier les Contraintes de Validation

**Validation des périodes :**

* Début de Période ≤ Fin de Période
* Pas de chevauchement avec les bassins existants
* Libellé de période non vide

**Chevauchement de périodes :**
Si un autre bassin existe avec une plage de dates qui chevauche, la création échouera avec l'erreur :

```
Un bassin de dividendes existe déjà pour une période se chevauchant : Dividende T1 2026
```

**Exemple de chevauchement :**

```
Bassin existant : 2026-01-01 à 2026-03-31
Nouveau bassin : 2026-02-01 à 2026-04-30
Résultat : ❌ Chevauchement (fév-mars)
```

**Périodes sans chevauchement :**

```
Bassin existant : 2026-01-01 à 2026-03-31
Nouveau bassin : 2026-04-01 à 2026-06-30
Résultat : ✅ Aucun chevauchement
```

### Étape 7 : Soumettre

<Steps>
  <Step title="Vérifier tous les champs">
    S'assurer que les dates de période sont correctes, le montant exact, le libellé descriptif
  </Step>

  <Step title="Cliquer sur Enregistrer ou Créer Bassin">
    Le bassin est créé en statut brouillon
  </Step>

  <Step title="Confirmer la création">
    Le bassin apparaît dans la liste des bassins de dividendes avec le statut "Brouillon"
  </Step>

  <Step title="Distribuer les dividendes (étape suivante)">
    Après la création, utiliser l'action "Distribuer" pour calculer les allocations et effectuer les paiements
  </Step>
</Steps>

## Ce qui se Passe lors de la Création

Lorsque vous créez un bassin de dividendes, Agatabo automatiquement :

1. **Valide la période** — vérifie periodStart ≤ periodEnd, vérifie les chevauchements, valide le montant positif
2. **Crée l'enregistrement DividendPoolMeta** — stocke les métadonnées (id, libellé, début, fin, montant), définit journalEntryId = null (statut brouillon)
3. **Ajoute à la liste des bassins** — apparaît dans la liste avec le statut "Brouillon"
4. **NE crée PAS d'écritures comptables** — pas d'entrées comptables créées, solde des résultats reportés inchangé

<Note>
  **Important** : La création d'un bassin NE distribue PAS de fonds et NE crée PAS d'écritures comptables. Le bassin démarre en brouillon. Vous devez séparément distribuer le bassin pour calculer les allocations des membres et créer les écritures comptables qui débitent les résultats reportés et créditent les comptes d'épargne des membres.
</Note>

[En savoir plus sur la distribution des bassins →](/fr/tontines/dividends/distributing-dividends)

## Scénarios Courants

### Création d'un Dividende Trimestriel Standard

<Steps>
  <Step title="Déterminer les dates du trimestre">
    T1 : 1er jan - 31 mars<br />
    T2 : 1er avr - 30 juin<br />
    T3 : 1er juil - 30 sept<br />
    T4 : 1er oct - 31 déc
  </Step>

  <Step title="Calculer le montant">
    Basé sur le bénéfice trimestriel et la politique de dividendes (ex. 50% du bénéfice net trimestriel)
  </Step>

  <Step title="Créer le bassin">
    **Libellé de Période** : "Dividende T1 2026"<br />
    **Début de Période** : 2026-01-01<br />
    **Fin de Période** : 2026-03-31<br />
    **Montant** : 4 000 000 (basé sur 8M bénéfice × 50%)
  </Step>

  <Step title="Attendre la clôture de la période comptable">
    S'assurer que la période comptable T1 est clôturée avant de distribuer
  </Step>

  <Step title="Distribuer le bassin">
    Utiliser l'action "Distribuer" pour calculer les allocations et effectuer les paiements
  </Step>
</Steps>

### Créer Tous les Bassins Trimestriels en une Fois

<Steps>
  <Step title="Créer le bassin T1">
    **Libellé** : "Dividende T1 2026"<br />
    **Période** : 2026-01-01 à 2026-03-31<br />
    **Montant** : 2 000 000
  </Step>

  <Step title="Créer le bassin T2">
    **Libellé** : "Dividende T2 2026"<br />
    **Période** : 2026-04-01 à 2026-06-30<br />
    **Montant** : 2 000 000
  </Step>

  <Step title="Créer le bassin T3">
    **Libellé** : "Dividende T3 2026"<br />
    **Période** : 2026-07-01 à 2026-09-30<br />
    **Montant** : 2 000 000
  </Step>

  <Step title="Créer le bassin T4">
    **Libellé** : "Dividende T4 2026"<br />
    **Période** : 2026-10-01 à 2026-12-31<br />
    **Montant** : 2 000 000
  </Step>

  <Step title="Distribuer chaque trimestre">
    Distribuer chaque bassin après la clôture de sa période comptable respective
  </Step>
</Steps>

<Note>
  **Avantage de la stratégie** : Créer tous les bassins à l'avance offre une visibilité sur les distributions planifiées et aide à la planification financière. Chaque bassin reste en statut brouillon jusqu'à sa distribution.
</Note>

## Dépannage

### "Un bassin de dividendes existe déjà pour une période se chevauchant"

**Solutions :**

1. Consulter les bassins existants pour identifier le bassin qui chevauche
2. Ajuster les dates de période pour éviter le chevauchement
3. Utiliser des périodes adjacentes sans chevauchement (ex. T1 : jan-mars, T2 : avr-juin)

### "Le début de période ne peut pas être après la fin de période"

**Solution :**

* Intervertir les dates (le début de période doit être la date antérieure)
* Vérifier le format AAAA-MM-JJ

**Exemple :**

```
❌ Incorrect :
Début de Période : 2026-03-31
Fin de Période : 2026-01-01

✅ Correct :
Début de Période : 2026-01-01
Fin de Période : 2026-03-31
```

### Impossible de distribuer le bassin immédiatement après la création

**Cause** : La distribution requiert que la fin de période soit dans une période comptable clôturée

**Solution :**

<Steps>
  <Step title="Créer le bassin">
    Le bassin peut être créé à tout moment (statut brouillon)
  </Step>

  <Step title="Clôturer la période comptable">
    S'assurer que la période comptable contenant pool.periodEnd est clôturée
  </Step>

  <Step title="Distribuer le bassin">
    Après la clôture de la période, utiliser l'action "Distribuer"
  </Step>
</Steps>

## Autorisations Requises

| Action                | Autorisation      | Portée                            |
| --------------------- | ----------------- | --------------------------------- |
| Consulter les bassins | `dividends:read`  | TOUTE                             |
| Créer un bassin       | `dividends:write` | TOUTE                             |
| Modifier un bassin    | `dividends:write` | TOUTE (uniquement les brouillons) |
| Supprimer un bassin   | `dividends:write` | TOUTE (uniquement les brouillons) |

## Sujets Connexes

<CardGroup cols={2}>
  <Card title="Aperçu des Dividendes" icon="info" href="/fr/tontines/dividends/overview">
    Comprendre les bassins de dividendes et leur fonctionnement
  </Card>

  <Card title="Distribution des Dividendes" icon="paper-plane" href="/fr/tontines/dividends/distributing-dividends">
    Calculer les allocations et effectuer les paiements
  </Card>

  <Card title="Rapports sur les Dividendes" icon="chart-bar" href="/fr/tontines/dividends/dividend-reporting">
    Consulter les détails du bassin et les allocations membres
  </Card>

  <Card title="Résultats Reportés" icon="piggy-bank" href="/fr/tontines/reserves/overview">
    Comprendre les résultats reportés et l'allocation des bénéfices
  </Card>

  <Card title="Clôture de Période" icon="lock" href="/fr/tontines/advanced/period-closing">
    En savoir plus sur les exigences de clôture de période
  </Card>
</CardGroup>