Passer au contenu principal

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

Avant de Commencer

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

Instructions Étape par Étape

Étape 1 : Accéder au Bassin

1

Ouvrir la section Dividendes

Cliquer sur Dividendes dans la barre latérale gauche
2

Trouver le bassin brouillon

Localiser le bassin avec le statut “Brouillon”
3

Cliquer sur le bassin

Ouvre la page de détails du bassin avec les allocations calculées

É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

1

Cliquer sur Distribuer

Ouvre la boîte de dialogue de distribution
2

Définir la date de distribution (optionnel)

Par défaut : pool.periodEnd + 1 jour
Personnalisé : Choisir une date spécifique (doit être après la fin de la dernière période clôturée)
3

Lire l'avertissement

La boîte de dialogue avertit que la distribution est permanente et irréversible
4

Confirmer la distribution

Cliquer sur Confirmer pour procéder

Étape 5 : Vérifier la Distribution

Après la distribution :
1

Vérifier le statut du bassin

Le statut doit maintenant être “Distribué” (journalEntryId renseigné)
2

Examiner l'écriture comptable

Naviguer vers Grand Livre → Écritures Comptables
Trouver l’écriture DISTRIBUTION_DIVIDENDE
Vérifier un débit sur RÉSULTATS_REPORTÉS et plusieurs crédits sur les ÉPARGNE des membres
3

Vérifier ponctuellement les soldes membres

Naviguer vers quelques profils de membres
Vérifier que le solde du compte ÉPARGNE a augmenté du montant du dividende
4

Vérifier les résultats reportés

Naviguer vers Grand Livre → Compte RÉSULTATS_REPORTÉS
Vérifier que le solde a diminué du montant du bassin

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 :
  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 :

É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

1

Clôturer la période comptable du trimestre

S’assurer que la période comptable T1 2026 (jan-mars) est clôturée
2

Créer le bassin brouillon

Période : 2026-01-01 à 2026-03-31
Montant : Basé sur le bénéfice et la politique de dividendes
3

Examiner les allocations

Ouvrir les détails du bassin et vérifier les allocations calculées
4

Distribuer

Cliquer sur Distribuer
Date de distribution par défaut : 2026-04-01
Confirmer l’action permanente
5

Vérifier

Vérifier que les comptes ÉPARGNE des membres ont augmenté
Vérifier que RÉSULTATS_REPORTÉS a diminué

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

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.

Option 1 : Écriture Comptable Manuelle

Pour les petites corrections affectant un ou deux membres :
1

Naviguer vers les Écritures Comptables

Grand Livre → Créer une Écriture Comptable Manuelle
2

Créer l'écriture de correction

Nature : AJUSTEMENT
Titre : “Correction Dividende - T1 2026”
Lignes :
  • DÉBIT : ÉPARGNE Membre A (réduire le trop-perçu)
  • CRÉDIT : ÉPARGNE Membre B (corriger le sous-paiement)
3

Documenter la raison

Ajouter une description claire expliquant l’erreur et la correction

Option 2 : Bassin de Correction

Pour les corrections plus importantes affectant de nombreux membres :
1

Créer un nouveau bassin de dividendes

Libellé : “Correction Dividende - T1 2026”
Période : Identique au bassin original
Montant : Montant net de correction
2

Distribuer le bassin de correction

Cela créera des crédits pour les membres sous-payés
Pour les membres trop payés, créer des écritures de débit séparées
3

Documenter en détail

Expliquer l’erreur et la correction dans la description du bassin

Messages d’Erreur Courants

Autorisations Requises

Sujets Connexes

Aperçu des Dividendes

Comprendre les bassins de dividendes et les méthodes de distribution

Création de Bassins de Dividendes

Configurer de nouveaux bassins de dividendes

Rapports sur les Dividendes

Consulter l’historique des distributions et les allocations membres

Clôture de Période

Comprendre les exigences de clôture de période

Écritures Comptables Manuelles

Créer des corrections après distribution