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

# Distribution des Dividendes

> Calculer les allocations des membres et créditer leurs comptes d'épargne depuis les bassins de dividendes

## Aperçu

La distribution d'un bassin de dividendes calcule les allocations individuelles des membres selon la méthode de distribution de votre organisation et crée une écriture comptable qui débite les résultats reportés et crédite les comptes d'épargne des membres. Cette action fait passer le bassin du statut brouillon au statut distribué et est **permanente et irréversible**.

<Note>
  **Ce qui se passe** : La distribution crée une seule écriture comptable DISTRIBUTION\_DIVIDENDE avec un débit sur RÉSULTATS\_REPORTÉS et plusieurs crédits sur les comptes ÉPARGNE des membres. Le `journalEntryId` du bassin est défini, le marquant définitivement comme distribué.
</Note>

## Avant de Commencer

<Note>
  **Prérequis :**

  * Vous avez l'autorisation `dividends:write`
  * Le bassin de dividendes existe en statut brouillon (`journalEntryId = null`)
  * La fin de période du bassin est au plus égale à la fin de la dernière période comptable clôturée
  * Au moins une période comptable a été clôturée
  * Solde de résultats reportés suffisant pour couvrir le montant du bassin
  * Au moins un membre actif (isActive = true) existe
</Note>

<Warning>
  **La distribution est permanente et irréversible** : Une fois distribué, le bassin ne peut pas être annulé, modifié ou supprimé. L'écriture comptable débite immédiatement les résultats reportés et crédite les comptes d'épargne des membres. Ne distribuer que lorsque vous êtes certain que le bassin est correct.
</Warning>

## Instructions Étape par Étape

### Étape 1 : Accéder au Bassin

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

  <Step title="Trouver le bassin brouillon">
    Localiser le bassin avec le statut "Brouillon"
  </Step>

  <Step title="Cliquer sur le bassin">
    Ouvre la page de détails du bassin avec les allocations calculées
  </Step>
</Steps>

### Étape 2 : Vérifier les Allocations Calculées

Avant de distribuer, vérifier les allocations des membres automatiquement calculées :

**Vérifier les montants individuels :**

* Examiner le montant de dividende calculé de chaque membre
* S'assurer que les calculs correspondent aux attentes selon la méthode de distribution
* Vérifier qu'aucun membre n'est exclu de façon inattendue

**Vérifier le total :**

* La somme de toutes les allocations membres doit égaler le montant total du bassin
* Agatabo gère automatiquement l'arrondi pour assurer la correspondance exacte

**Comprendre la méthode de distribution :**

* **Égale** : Tous les membres actifs reçoivent des parts égales (ou pondérées temporellement si activé)
* **Par contribution** : Les membres avec des contributions d'épargne plus élevées reçoivent des dividendes proportionnellement plus grands
* **Pondération temporelle** (si activée) : Allocations ajustées selon les jours de participation pendant la période

### Étape 3 : Vérifier les Prérequis

**Clôture de période comptable :**

* La fin de période du bassin doit être au plus égale à la fin de la dernière période comptable clôturée
* La date de distribution sera par défaut pool.periodEnd + 1 jour (ou vous pouvez spécifier une date personnalisée)

**Résultats reportés :**

* Solde des résultats reportés ≥ montant du bassin
* La distribution débitera les résultats reportés du montant intégral du bassin

**Membres actifs :**

* Au moins un membre actif (isActive = true) doit exister
* Seuls les membres actifs reçoivent des dividendes
* Les membres inactifs sont automatiquement exclus des allocations

### Étape 4 : Distribuer le Bassin

<Steps>
  <Step title="Cliquer sur Distribuer">
    Ouvre la boîte de dialogue de distribution
  </Step>

  <Step title="Définir la date de distribution (optionnel)">
    **Par défaut** : pool.periodEnd + 1 jour<br />
    **Personnalisé** : Choisir une date spécifique (doit être après la fin de la dernière période clôturée)
  </Step>

  <Step title="Lire l'avertissement">
    La boîte de dialogue avertit que la distribution est permanente et irréversible
  </Step>

  <Step title="Confirmer la distribution">
    Cliquer sur Confirmer pour procéder
  </Step>
</Steps>

### Étape 5 : Vérifier la Distribution

Après la distribution :

<Steps>
  <Step title="Vérifier le statut du bassin">
    Le statut doit maintenant être "Distribué" (journalEntryId renseigné)
  </Step>

  <Step title="Examiner l'écriture comptable">
    Naviguer vers Grand Livre → Écritures Comptables<br />
    Trouver l'écriture DISTRIBUTION\_DIVIDENDE<br />
    Vérifier un débit sur RÉSULTATS\_REPORTÉS et plusieurs crédits sur les ÉPARGNE des membres
  </Step>

  <Step title="Vérifier ponctuellement les soldes membres">
    Naviguer vers quelques profils de membres<br />
    Vérifier que le solde du compte ÉPARGNE a augmenté du montant du dividende
  </Step>

  <Step title="Vérifier les résultats reportés">
    Naviguer vers Grand Livre → Compte RÉSULTATS\_REPORTÉS<br />
    Vérifier que le solde a diminué du montant du bassin
  </Step>
</Steps>

## Ce qui se Passe lors de la Distribution

Lors de la distribution d'un bassin de dividendes, Agatabo automatiquement :

1. **Valide les contraintes de période comptable** — vérifie qu'au moins une période est clôturée, que pool.periodEnd ≤ fin dernière période clôturée, que la date de distribution > fin dernière période

2. **Récupère les paramètres de l'organisation** — charge la méthode de distribution (égale ou par\_contribution) et le paramètre de pondération temporelle

3. **Identifie les membres éligibles** — interroge tous les utilisateurs de l'organisation avec `isActive = true`, exclut les membres inactifs

4. **Calcule les allocations individuelles** — méthode égale : divise le montant également (ou par jours de participation si pondération temporelle) ; méthode par contribution : alloue proportionnellement selon le solde d'épargne ; gère l'arrondi ; filtre les allocations nulles

5. **Crée une écriture comptable unique** :
   ```
   Nature : DISTRIBUTION_DIVIDENDE
   Date de Transaction : date spécifiée ou défaut (pool.periodEnd + 1 jour)

   Dt RÉSULTATS_REPORTÉS           MontantTotal
      Ct ÉPARGNE (Membre A)        AllocationA
      Ct ÉPARGNE (Membre B)        AllocationB
      Ct ÉPARGNE (Membre C)        AllocationC
      ...
   ```

6. **Met à jour le statut du bassin** — définit `journalEntryId`, le bassin passe de "brouillon" à "distribué", le bassin est verrouillé

7. **Journalise la piste d'audit** — enregistre qui a distribué le bassin et le timestamp

## Date de Distribution

**Comportement par défaut :**

* Si aucune date de distribution n'est spécifiée : `pool.periodEnd + 1 jour`
* Exemple : Période du bassin 1er jan - 31 mars → date de distribution par défaut 1er avril

**Date personnalisée :**

* Vous pouvez spécifier n'importe quelle date après la fin de la dernière période comptable clôturée
* Généralement définie au jour réel de distribution

**Validation :**

```
dateDistribution > finDernièrePériodeComptableClôturée
```

## Éligibilité

Seuls les **membres actifs** reçoivent des dividendes :

* `organizationUser.isActive = true` (seule exigence)
* Aucun solde d'épargne minimum requis
* Aucune durée d'adhésion minimum requise

Les membres inactifs sont automatiquement exclus des allocations et ne peuvent pas recevoir de dividendes même s'ils ont de l'épargne.

## Scénarios Courants

### Distribution de Dividende Trimestriel

<Steps>
  <Step title="Clôturer la période comptable du trimestre">
    S'assurer que la période comptable T1 2026 (jan-mars) est clôturée
  </Step>

  <Step title="Créer le bassin brouillon">
    **Période** : 2026-01-01 à 2026-03-31<br />
    **Montant** : Basé sur le bénéfice et la politique de dividendes
  </Step>

  <Step title="Examiner les allocations">
    Ouvrir les détails du bassin et vérifier les allocations calculées
  </Step>

  <Step title="Distribuer">
    Cliquer sur Distribuer<br />
    Date de distribution par défaut : 2026-04-01<br />
    Confirmer l'action permanente
  </Step>

  <Step title="Vérifier">
    Vérifier que les comptes ÉPARGNE des membres ont augmenté<br />
    Vérifier que RÉSULTATS\_REPORTÉS a diminué
  </Step>
</Steps>

### Gérer des Résultats Reportés Insuffisants

Si le solde des résultats reportés est inférieur au montant du bassin :

**Option 1** : Supprimer le bassin et recréer avec un montant inférieur
**Option 2** : Libérer des fonds depuis les réserves vers les résultats reportés
**Option 3** : Attendre que davantage de bénéfices s'accumulent
**Option 4** : Corriger les erreurs après distribution via des écritures manuelles

## Corriger les Erreurs Après Distribution

<Warning>
  **La distribution est permanente** : Les bassins distribués ne peuvent pas être annulés, modifiés ou supprimés. Toutes les corrections doivent être effectuées avec de nouvelles transactions.
</Warning>

### Option 1 : Écriture Comptable Manuelle

Pour les petites corrections affectant un ou deux membres :

<Steps>
  <Step title="Naviguer vers les Écritures Comptables">
    Grand Livre → Créer une Écriture Comptable Manuelle
  </Step>

  <Step title="Créer l'écriture de correction">
    **Nature** : AJUSTEMENT<br />
    **Titre** : "Correction Dividende - T1 2026"<br />
    **Lignes** :<br />

    * DÉBIT : ÉPARGNE Membre A (réduire le trop-perçu)<br />
    * CRÉDIT : ÉPARGNE Membre B (corriger le sous-paiement)
  </Step>

  <Step title="Documenter la raison">
    Ajouter une description claire expliquant l'erreur et la correction
  </Step>
</Steps>

### Option 2 : Bassin de Correction

Pour les corrections plus importantes affectant de nombreux membres :

<Steps>
  <Step title="Créer un nouveau bassin de dividendes">
    **Libellé** : "Correction Dividende - T1 2026"<br />
    **Période** : Identique au bassin original<br />
    **Montant** : Montant net de correction
  </Step>

  <Step title="Distribuer le bassin de correction">
    Cela créera des crédits pour les membres sous-payés<br />
    Pour les membres trop payés, créer des écritures de débit séparées
  </Step>

  <Step title="Documenter en détail">
    Expliquer l'erreur et la correction dans la description du bassin
  </Step>
</Steps>

## Messages d'Erreur Courants

| Message d'Erreur                                                                 | Cause                                                 | Solution                                                 |
| -------------------------------------------------------------------------------- | ----------------------------------------------------- | -------------------------------------------------------- |
| "Aucune période comptable n'a été clôturée"                                      | Impossible de distribuer sans période clôturée        | Clôturer la période comptable contenant pool.periodEnd   |
| "La fin de période doit être au plus à la fin de la dernière période clôturée"   | Pool.periodEnd est après la dernière période clôturée | Clôturer la période requise                              |
| "La date de distribution doit être après la fin de la dernière période clôturée" | Date de distribution incorrecte                       | Changer la date pour le lendemain de la clôture ou après |
| "Résultats reportés insuffisants"                                                | Solde insuffisant                                     | Réduire le montant du bassin ou libérer des réserves     |
| "Aucun utilisateur actif de l'organisation éligible pour la distribution"        | Aucun membre actif                                    | Activer au moins un membre                               |

## Autorisations Requises

| Action                             | Autorisation          | Portée |
| ---------------------------------- | --------------------- | ------ |
| Consulter les bassins              | `dividends:read`      | TOUTE  |
| Distribuer un bassin               | `dividends:write`     | TOUTE  |
| Consulter les écritures comptables | `general-ledger:read` | TOUTE  |

## Sujets Connexes

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

  <Card title="Création de Bassins de Dividendes" icon="plus" href="/fr/tontines/dividends/creating-dividend-pools">
    Configurer de nouveaux bassins de dividendes
  </Card>

  <Card title="Rapports sur les Dividendes" icon="chart-bar" href="/fr/tontines/dividends/dividend-reporting">
    Consulter l'historique des distributions et les allocations membres
  </Card>

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

  <Card title="Écritures Comptables Manuelles" icon="pen-to-square" href="/fr/tontines/general-ledger/manual-journal-entries">
    Créer des corrections après distribution
  </Card>
</CardGroup>