documentation
Kohinos v3 Doc générée le commit 8d60b1904

Scénarios SSA — quelle caisse pour quel besoin ?

SSA Configuration des caisses SSA — uniquement applicable au dispositif SSA.

Vous lancez une caisse SSA et vous hésitez entre les options ? Cette page passe en revue tous les scénarios possibles de cotisation et de redistribution, avec des petits schémas comparatifs. Trois préréglages prêts à l'emploi sont proposés à la fin pour démarrer rapidement.

Comment lire cette page ?

Chaque caisse SSA se règle sur deux axes : la cotisation (côté payeur) et la redistribution (côté bénéficiaire). On y ajoute ensuite quelques options automatiques (auto-abondement, auto-complément, prélèvement automatique). Les exemples chiffrés utilisent une caisse fictive : 10 participants, commission 5 %, cotisation moyenne 30 €.

Les deux familles de paramètres

Une caisse se configure par son responsable (caisse SSA). Chaque adhérent ajuste ensuite sa participation (engagement SSA). Les deux jeux de paramètres se combinent au moment du calcul mensuel.

Paramètres de la caisse

  • Type de cotisation : libre, recommandée, min fixe, ou choix restreints
  • Mode de redistribution : calculé, fixe, ou paliers
  • Bornes : montant minimum, maximum et cible par participant
  • Commission (%) prélevée sur le pot avant redistribution
  • Auto-abondement : la caisse complète si le pot manque
  • Secours compte principal : ponction du compte principal en complément
  • Prélèvement automatique SSA : cotis prélevée sur le solde SSA
  • Prélèvement SEPA : autorisé + jour de prélèvement imposé
  • Cotisation obligatoire : pas de redistribution sans cotiser
  • Règles par tranche : barème par foyer (mode paliers)

Paramètres de l'adhérent

  • Montant cotisé ce mois-ci
  • Minimum personnel : seuil indicatif (cotisation suggérée)
  • Taille du foyer : nombre de personnes (mode paliers)
  • Mensualisation : cotisation mensuelle automatique
  • Don : don pur, sans recevoir de redistribution
  • Prélèvement auto sur le solde SSA
  • Acceptation du secours compte principal
  • Jour de prélèvement SEPA

Côté cotisation — les 4 types possibles

Le type de cotisation détermine la marge de manœuvre du participant au moment de fixer son montant. Quatre modes existent, choisis à la création de la caisse.

A · Libre

Cotisation libre

Le participant choisit le montant qu'il souhaite, entre un plancher et un plafond.

min 10€ max 100€ 35€

Pour qui ? Caisses très souples, public mixte. Risque : total imprévisible.

B · Recommandée

Cotisation suggérée ± tolérance

Un montant est suggéré (personnalisable par adhérent). Le participant peut s'en écarter d'un pourcentage de tolérance défini par la caisse.

24€ 36€ 30€ ±20%

Pour qui ? Caisses pédagogiques : cible claire, latitude limitée. L'option « cotisation obligatoire pour participer » permet d'exclure les sous-cotisants.

C · Min fixe

Plancher imposé

Un plancher obligatoire, on peut donner plus. Pas de tolérance descendante.

≥ 25€ jusqu'à max 40€

Pour qui ? Caisses qui ont besoin de garantir un fonds minimal. Compatible avec l'option « cotisation obligatoire pour participer ».

D · Choix restreints

Liste fermée

Le participant choisit parmi une liste fermée définie par la caisse : ex. 15€, 30€, 50€, 80€.

15€ 30€ 50€ 80€ cliqué : 30€

Pour qui ? Caisses qui veulent garder la statistique propre. Plus simple à comprendre pour un nouvel adhérent.

Combinaison fréquente : type C (min fixe) + cotisation obligatoire activée : tout le monde paye au moins le plancher, sinon pas de redistribution ce mois-ci.

Côté redistribution — les 3 modes possibles

Le mode décide comment le fonds est partagé entre les participants actifs (ceux qui ont cotisé, hors dons). Trois modes :

1 · Calculé

Égalitaire avec commission

Tout le monde reçoit la même part : pot ÷ participants, après commission.

part = (Σ cotis × (1 − commission)) / N
pot collecté = 300€ → 285€ après 5% 28,50€ 28,50€ 28,50€ 28,50€ …×10

Exemple : 10 personnes cotisent 30€ → pot 300€ → 285€ après 5% → 28,50€/pers.

2 · Fixe

Montant pré-défini

Chaque participant reçoit exactement le montant cible fixé par la caisse, quel que soit le pot.

part = montant cible par participant (constante)
cible : 40€/pers × 10 = 400€ 40€ 40€ 40€ 40€ …×10

Si pot < cible : activer l'auto-abondement pour combler depuis le compte du manager. Sinon, écart visible en fin de mois.

3 · Paliers

Selon la taille du foyer

Chaque participant reçoit selon la taille de son foyer et les règles par tranche définies.

part = palier correspondant à la taille du foyer
1 personne 100€ 2 personnes 150€ 3+ personnes 200€

Pour qui ? Caisses sociales (Camille Bessière, ATD Quart Monde). L'option « foyer décimal » permet la garde alternée (1,5).

Les options automatiques (caisse × adhérent)

Trois options déclenchent des comportements automatiques au moment du calcul mensuel. Toutes nécessitent un opt-in côté caisse ; deux d'entre elles nécessitent en plus l'opt-in côté adhérent (sécurité : l'adhérent accepte que son compte principal serve de secours).

canAutoAbound

Auto-abondement de la caisse

Quand le pot est insuffisant pour atteindre l'objectif (mode fixe uniquement avec un montant cible par participant), le manager comble la différence.

Mode fixecible par personne
→
Pot < ciblecible × N
→
Manager payecomplément depuis compte

Garde-fou : si le manager n'a pas assez sur son compte, fallback automatique sur le mode calculé classique (logs d'erreur).

canAutoCompleteFromMainAccount

Secours compte principal (adhérent)

Si le compte SSA de l'adhérent ne suffit pas pour payer la cotis, le manque est ponctionné sur son compte eMLc principal.

Caisse opt-insecours activé
+
Adhérent opt-inaccord donné
→
Ponction mixteSSA + principal

Exemple : cotis 30€, solde SSA 10€, solde principal 50€ → 10€ depuis SSA + 20€ depuis principal. Si principal trop bas → échec, log et email.

canAutopayWithSsa

Prélèvement automatique SSA

Après redistribution, la cotisation du mois suivant est prélevée d'office depuis le compte SSA qui vient d'être crédité. Évite les oublis.

Caisse opt-inauto-pay activé
+
Adhérent opt-inaccord donné
→
Redistrib puis cotisen chaîne

Idempotence : le système garde en mémoire le dernier mois prélevé, ce qui bloque le double-prélèvement même en cas de relance manuelle dans le mois.

6 cas pratiques chiffrés

Exemples concrets pour visualiser les combinaisons. Caisse fictive : 10 participants réguliers, commission 5 %, mois de mai.

Cas 1

Calculé · Libre · sans options

10 cotis libres : 5×30€ + 3×50€ + 2×20€ = 340€. Commission 5%.

part = 340 × 0,95 / 10 = 32,30€

Tout le monde reçoit le même montant, indépendamment de ce qu'il a versé. Tolérance maximale, redistribution stable mais imprévisible.

Cas 2

Fixe · Min fixe · auto-abondement

Plancher 25€, cible 40€/pers. 10 cotis = 280€, manque 120€ pour atteindre 400€.

Pot280€
+
Manager+120€
=
10 × 40€garanti

Manager doit avoir >120€ sur son compte. Sinon échec gracieux (mode calculé en fallback).

Cas 3

Paliers · Min fixe · don autorisé

Barème 100/150/200€. Foyers : 4 solos + 3 couples + 3 familles. 2 dons à 20€.

total = 4×100 + 3×150 + 3×200 = 1450€

Les 2 donateurs n'apparaissent pas en redistribution. Pot collecté indépendant du total à payer : l'auto-abondement est impossible en mode paliers.

Cas 4

Calculé · Recommandée · autopay SSA

Le mois M, redistribution 28,50€/pers. Au mois M+1, prélèvement auto du même montant depuis le solde SSA pour la cotis.

Mois Mreçoit 28,50€
→
Mois M+1auto-prélevé
→
Pot M+1auto-alimenté

Système quasi-autonome après le 1er mois. Idéal pour fidéliser. Coupable : si pot mensuel baisse, la part baisse mécaniquement.

Cas 5

Calculé · Min fixe · SEPA imposé

Cotisation SEPA obligatoire au jour 5 du mois (jour imposé par la caisse). L'adhérent ne peut pas choisir son jour de prélèvement.

J-5mandat SEPA
→
J-2fichier SEPA banque
→
J5débit + crédit caisse

Sécurise les flux pour le trésorier. Nécessite d'autoriser le SEPA et la cotisation obligatoire pour cohérence.

Cas 6

Calculé · Choix restreints · auto-complément

4 options : 15/30/50/80€. Adhérent choisit 30€ mais n'a que 20€ sur son SSA.

Cotis prévue30€
→
SSA−20€
+
Principal−10€

Activer le secours compte principal côté caisse et côté adhérent. Sans double opt-in, échec et email à l'adhérent.

Quelle config choisir ? — l'arbre de décision

Trois questions, et vous avez votre configuration de départ.

1 — Voulez-vous garantir un montant minimum redistribué ?
Oui, montant fixe Choisissez le mode fixe, fixez le montant cible par participant et activez l'auto-abondement (si le manager est solvable).
Non, partage du pot Choisissez le mode calculé.
Adapté à la composition du foyer Choisissez le mode paliers et définissez le barème par tranche de foyer.
2 — Quelle latitude pour les cotisants ?
Totale Cotisation libre avec un plancher et un plafond larges.
Avec recommandation Cotisation suggérée avec une tolérance (ex. 20%).
Plancher imposé Cotisation minimum fixe avec l'option « cotisation obligatoire pour participer » activée.
Liste fermée Choix restreints (ex. « 15, 30, 50, 80 »).
3 — Quel niveau d'automatisme côté adhérent ?
Manuel aucune option. L'adhérent paye chaque mois lui-même.
Récurrent simple L'adhérent active la mensualisation. La cotisation est générée chaque mois automatiquement.
SEPA Autoriser le SEPA dans la caisse et fixer le jour de prélèvement. Le mandat fait tout.
Auto-pay SSA Activer le prélèvement automatique SSA côté caisse et côté adhérent.

3 préréglages prêts à l'emploi

Pour lancer rapidement, voici trois configurations testées que nous recommandons selon le profil de la caisse. Vous pourrez tout ajuster ensuite via l'admin Sonata.

🌱 Caisse débutante — simple et lisible

Une caisse de quartier qui démarre, peu de pilotage actif.

Cotisation
Libre, plancher 10€, plafond 100€
Redistribution
Calculée
Commission
5 %
Récurrence
Autorisée (libre choix)
Options auto
Aucune au démarrage
Exemple : 12 cotisations entre 15€ et 80€ → pot ~350€ → ~28€/pers redistribués.

🛡️ Caisse garantie — montant fixe assuré

Une caisse avec un fonds de roulement, qui veut garantir 40 €/pers tous les mois.

Cotisation
Min fixe à 25€
Redistribution
Fixe à 40€/pers
Auto-abondement
oui (manager solvable)
Cotis obligatoire
oui
Auto-complément
oui (caisse) — opt-in adhérent
Exemple : pot 280€ + 120€ abondement manager = 400€ → 10 × 40€.

👨‍👩‍👧 Caisse familiale — équité par foyer

Une caisse sociale qui pondère selon la composition du foyer.

Cotisation
Recommandée 30€ ±25%
Redistribution
Paliers (100/150/200€)
Foyer décimal
oui (garde alternée)
Don autorisé
oui
SEPA
oui, jour 5 imposé
Exemple : 4 solos + 3 couples + 3 familles → distribué 1450€ indépendamment du pot collecté.
⚠️ Points de vigilance avant lancement
  • Idempotence mensuelle : la mémoire du dernier mois prélevé garantit qu'un même engagement ne sera pas prélevé deux fois dans le même mois.
  • Mode fixe sans auto-abondement : si pot < cible, redistribution effective < cible. Vérifier en amont.
  • Mode paliers sans taille de foyer renseignée : retombe sur 1 personne par défaut. Pousser les adhérents à renseigner leur foyer.
  • Tolérance large + cotisation obligatoire : attention aux adhérents qui se croient à jour alors qu'ils sont sous le seuil minimal calculé.
  • SEPA imposé : nécessite un mandat valide ; un mandat annulé ou révoqué bloque la cotis.

Puis-je changer de config en cours de route ?

Oui — l'admin Sonata permet de modifier les paramètres à tout moment, mais :

Et après ?

Une fois la caisse paramétrée, regardez : le fonctionnement général d'une caisse SSA · le calendrier annuel · la doc développeur SSA pour les détails techniques (services, commandes, invariants).