Cotisations en masse

Un montant par adhérent

Le module ajoute sur la fiche adhérent un champ « Montant de cotisation personnalisé ». Le formulaire « Nouvelle cotisation » de Dolibarr propose alors ce montant au lieu de celui du type.

Sans montant personnalisé, le formulaire propose le montant de la dernière cotisation de l’adhérent (réglage activé par défaut), sinon celui de son type.

Le renouvellement en masse

Le menu Adhérents« Renouveler en masse » ouvre la page de renouvellement. On peut aussi y arriver depuis la liste des adhérents, par l’action de masse « Renouveler les cotisations (montant de chaque adhérent) ».

• Choix des adhérents validés : par type, par tag, par « cotisation finie avant le », et en option les adhérents sans cotisation.
• Pour chacun : fin de la cotisation actuelle, tiers lié ou non, montant proposé et sa provenance — l’adhérent, sa dernière cotisation ou son type —, nouvelle période. Le montant se modifie ligne par ligne.
• Début de la nouvelle cotisation : à la suite de la précédente, avec les mêmes règles que le formulaire natif (début au premier jour du mois ou de l’année, fin au 31 décembre), ou à une date fixe pour tous, pour une campagne annuelle.
• Action complémentaire, comme sur le formulaire natif : écriture bancaire directe, facture seule, ou facture avec paiement. Le tiers des adhérents qui n’en ont pas peut être créé, ce qui est nécessaire pour facturer.
• Email de confirmation avec le modèle choisi dans la configuration des adhérents, facture jointe si le modèle le prévoit.

Un résumé (nombre de cotisations, total, action) demande confirmation. Puis un compte rendu liste, adhérent par adhérent, la cotisation et la facture créées, avec leurs liens, et l’état de l’email.

Les fonctions de Dolibarr

Le module enregistre chaque cotisation et ses actions complémentaires avec les fonctions de Dolibarr, celles du formulaire natif. La numérotation, la TVA, le produit des cotisations et le PDF de la facture sont ceux de votre configuration.

Les garde-fous

• Tout ou rien par adhérent : si la facture ou le paiement échoue, la cotisation de cet adhérent n’est pas enregistrée. Les autres continuent, et la raison est affichée.
• Un adhérent déjà couvert jusqu’à la fin de la période proposée est ignoré.
• Un renouvellement ne s’exécute qu’une fois : un double clic ou un retour arrière du navigateur est refusé, et rien n’est refait.
• Un montant négatif est refusé ; un montant manquant aussi, si le type exige une cotisation.
• L’envoi d’email est désactivé, avec une explication, si aucun modèle ou aucune adresse d’expédition n’est configuré.

La page « Renouvellement des cotisations », sous Dolibarr 24.0.1 : filtres et options en haut, action complémentaire « facture avec paiement », email de confirmation coché. Six adhérents, chacun avec son montant, de 15,00 à 50,00 : trois montants viennent de l’adhérent, deux de sa dernière cotisation, un de son type. L’adhérent sans cotisation commence le 12/10/2026 ; les autres reprennent au 01/01/2026, à la suite de leur cotisation finie le 31/12/2025.

Le compte rendu après confirmation : « 6 sur 6 créée(s) », 185,00 au total. Pour chaque adhérent, la cotisation créée, sa facture (FA2610-0026 à FA2610-0031) et l’email « Envoyé ».

La page de configuration du module est réservée aux administrateurs.

Les autres réglages sont ceux du module Adhérents, appliqués tels quels : modèle d’email de confirmation, produit utilisé sur les factures, TVA des cotisations, début forcé au premier jour, fin au 31 décembre. La page de configuration les rappelle, avec un lien vers la configuration du module Adhérents.

• Deux droits dédiés, non accordés par défaut : « Voir la page de renouvellement des cotisations » ouvre la page et l’action de masse ; « Renouveler les cotisations en masse » affiche le bouton de renouvellement.
• Le droit de Dolibarr en plus : pour renouveler, l’utilisateur doit aussi avoir le droit de créer les cotisations. Sans lui, la page s’affiche sans bouton, et un envoi forcé est refusé.
• La page montre les adhérents validés avec leur email. N’accordez le droit « Voir la page » qu’aux personnes qui voient déjà les adhérents.
• Requêtes protégées : la confirmation et l’exécution n’acceptent qu’un envoi portant le jeton anti-CSRF de Dolibarr, de la part d’un utilisateur qui a le droit de renouveler et celui de créer les cotisations.
• Exécution unique : chaque renouvellement confirmé porte un identifiant à usage unique.
• Transactions : la cotisation et ses actions complémentaires sont enregistrées ensemble pour chaque adhérent, ou pas du tout.

• Le dossier du module, dolixcotisations, à déposer dans htdocs/custom/ ou à installer depuis le zip.
• Trois langues : français (fr_FR), anglais (en_US) et allemand (de_DE).
• Un README.md et un journal des versions (ChangeLog.md) dans le dossier du module.
• Licence GPL v3 ou ultérieure, code source complet et lisible.

• Aucune table n’est ajoutée. Le module ajoute aux adhérents un champ complémentaire, « Montant de cotisation personnalisé » (code dolixcot_amount), et enregistre un réglage, DOLIXCOT_USE_LAST_AMOUNT.
• Ce qui est écrit à chaque renouvellement, par les fonctions du cœur : la cotisation de chaque adhérent et, selon l’action choisie, l’écriture bancaire, ou la facture et son paiement. Le tiers est créé pour les adhérents qui n’en ont pas, si l’option est cochée. Dolibarr génère le PDF de la facture comme pour toute facture.
• Les emails partent par la configuration d’envoi de votre Dolibarr. Aucun fichier de Dolibarr n’est modifié.
• À la désactivation, la page, l’entrée de menu et l’action de masse disparaissent. Le champ et les montants saisis restent en base, masqués tant que le module est désactivé. Les cotisations, factures et paiements créés restent : ce sont des données de votre base.