Renovación de afiliaciones en bloque

Un importe por miembro

El módulo añade un campo «Cuota personalizada» a la ficha del miembro. El formulario «Nueva afiliación» de Dolibarr propone entonces este importe en lugar del importe del tipo.

Sin importe personalizado, el formulario propone el importe de la última afiliación del miembro (ajuste activado por defecto) o, si no, el de su tipo.

La renovación en bloque

El menú Miembros«Renovación en bloque» abre la página de renovación. También se llega a ella desde el listado de miembros, con la acción masiva «Renovar las afiliaciones (importe de cada miembro)».

• Elección de los miembros validados: por tipo, por etiqueta, por «afiliación terminada antes del» y, como opción, los miembros sin ninguna afiliación.
• Para cada uno: fin de la afiliación actual, tercero vinculado o no, importe propuesto y de dónde viene (el miembro, su última afiliación o su tipo), nuevo periodo. El importe se puede cambiar línea por línea.
• Inicio de la nueva afiliación: a continuación de la anterior, con las mismas reglas que el formulario nativo (inicio el primer día del mes o del año, fin el 31 de diciembre), o en una fecha fija para todos, para una campaña anual.
• Acción complementaria, como en el formulario nativo: asiento bancario directo, solo factura, o factura con pago. Se puede crear el tercero de los miembros que no lo tienen, lo que es necesario para facturar.
• Correo de confirmación con la plantilla elegida en la configuración de los miembros, con la factura adjunta si la plantilla lo prevé.

Un resumen (número de afiliaciones, total, acción) pide confirmación. Después, un informe lista, miembro por miembro, la afiliación y la factura creadas, con sus enlaces, y el estado del correo.

Las propias funciones de Dolibarr

El módulo registra cada afiliación y sus acciones complementarias con las propias funciones de Dolibarr, las del formulario nativo. La numeración, el IVA, el producto de las afiliaciones y el PDF de la factura siguen su configuración.

Las salvaguardas

• Todo o nada por miembro: si la factura o el pago fallan, la afiliación de ese miembro no se registra. Los demás siguen, y se muestra el motivo.
• Un miembro ya cubierto hasta el final del periodo propuesto se omite.
• Una renovación se ejecuta una sola vez: un doble clic o el botón de retroceso del navegador se rechazan, y no se vuelve a hacer nada.
• Un importe negativo se rechaza; un importe ausente también, si el tipo exige una afiliación.
• El envío del correo se desactiva, con una explicación, si no hay ninguna plantilla o ninguna dirección de remitente configurada.

La página «Renouvellement des cotisations» (renovación de las afiliaciones), en Dolibarr 24.0.1: filtros y opciones arriba, acción complementaria «factura con pago», correo de confirmación marcado. Seis miembros, cada uno con su propio importe, de 15,00 a 50,00: tres importes vienen del miembro («l’adhérent»), dos de su última afiliación («sa dernière cotisation»), uno de su tipo («son type»). El miembro sin afiliación empieza el 12/10/2026; los demás continúan el 01/01/2026, tras terminar su afiliación el 31/12/2025.

El informe tras la confirmación: «6 sur 6 créée(s)» (6 de 6 creadas), 185,00 en total. Para cada miembro, la afiliación creada, su factura (FA2610-0026 a FA2610-0031) y el correo marcado como «Envoyé» (enviado).

La página de configuración del módulo está reservada a los administradores.

Los demás ajustes son los del módulo Miembros, aplicados tal cual: plantilla del correo de confirmación, producto usado en las facturas, IVA de las afiliaciones, inicio forzado al primer día, fin el 31 de diciembre. La página de configuración los recuerda, con un enlace a la configuración del módulo Miembros.

• Dos permisos propios, no concedidos por defecto: «Ver la página de renovación de afiliaciones» abre la página y la acción masiva; «Renovar las afiliaciones en bloque» muestra el botón de renovación.
• Además, el permiso de Dolibarr: para renovar, el usuario también necesita el permiso para crear afiliaciones. Sin él, la página se muestra sin botón, y se rechaza un envío forzado.
• La página muestra los miembros validados con su correo: también exige el permiso de Dolibarr para leer los miembros.
• Peticiones protegidas: la confirmación y la ejecución solo aceptan un envío que lleve el token anti-CSRF de Dolibarr, por parte de un usuario que tenga el permiso para renovar y el de crear afiliaciones.
• Ejecución única: cada renovación confirmada lleva un identificador de un solo uso.
• Transacciones: para cada miembro, la afiliación y sus acciones complementarias se registran juntas, o no se registran.

• La carpeta del módulo, dolixcotisations, para colocar en htdocs/custom/ o para instalar desde el zip.
• Cuatro idiomas: francés (fr_FR), inglés (en_US), alemán (de_DE) y español (es_ES).
• Un README.md y un historial de versiones (ChangeLog.md) en la carpeta del módulo.
• Licencia GPL v3 o posterior, código fuente completo y legible.

• No se añade ninguna tabla. El módulo añade un campo complementario a los miembros, «Cuota personalizada» (código dolixcot_amount), y guarda un ajuste, DOLIXCOT_USE_LAST_AMOUNT.
• Lo que se escribe en cada renovación, mediante las funciones del núcleo: la afiliación de cada miembro y, según la acción elegida, el asiento bancario, o la factura y su pago. El tercero se crea para los miembros que no lo tienen, si la opción está marcada. Dolibarr genera el PDF de la factura como para cualquier factura.
• Los correos salen con la configuración de envío de su Dolibarr. No se modifica ningún archivo de Dolibarr.
• Al desactivarlo, la página, la entrada de menú y la acción masiva desaparecen. El campo y los importes introducidos se quedan en la base de datos, ocultos mientras el módulo esté desactivado. Las afiliaciones, facturas y pagos creados se quedan: son datos de su base de datos.