Récurrents

Les abonnements et prestations facturées à intervalle régulier. Vous définissez une fois le montant et la fréquence ; à chaque échéance, une facture brouillon est créée automatiquement.

/recurring /api/recurring recurring.view recurring.manage

À quoi sert ce module

Le module Récurrents gère les revenus répétitifs : abonnements, contrats de maintenance, forfaits mensuels, redevances. Au lieu de recréer la même facture chaque mois, vous enregistrez une fois l'abonnement (client, prestation, montant, fréquence) et le système se charge de produire la facture à chaque échéance.

Il s'adresse à l'administration des ventes et à la comptabilité. Chaque génération aboutit à une facture brouillon dans le module Factures, que vous pouvez relire avant de l'émettre. La génération peut être déclenchée à la main ou, en production, de façon entièrement automatique par une tâche planifiée.

Vue d'ensemble de l'écran

La liste des abonnements : les actifs d'abord, triés par prochaine échéance. Chaque ligne offre les actions Générer, modifier, mettre en pause et supprimer.

Créer un abonnement récurrent

Cliquez sur Nouveau récurrent pour ouvrir le formulaire. L'abonnement reçoit un identifiant du type REC-2026-0042 et démarre actif.

1. Client — destinataire des factures à venir (obligatoire).
2. Description de la prestation — libellé qui sera repris sur chaque facture, ex. « Abonnement maintenance mensuelle » (obligatoire).
3. Montant HT et TVA (%) — le montant TTC est calculé et mémorisé.
4. Fréquence — « Tous les N » suivi de l'unité : jour(s), semaine(s) ou mois.
5. Prochaine échéance — date de la première facture à générer.
6. Enregistrer.

Fréquence libre

La fréquence se compose d'un compteur (de 1 à 365) et d'une unité. Cela couvre aussi bien « tous les mois » que « toutes les 2 semaines » ou « tous les 12 mois ».

Activer / mettre en pause

L'action de bascule (toggle) active ou suspend un abonnement. Un abonnement en pause n'est plus pris en compte par la génération automatique : aucune facture ne sera produite tant qu'il n'est pas réactivé. Ses données restent intactes, prêtes à reprendre.

Générer une facture

L'action Générer produit immédiatement la facture de l'échéance courante, puis avance la prochaine échéance d'un intervalle. C'est l'action manuelle équivalente à ce que fait l'automatisation.

1. Une facture brouillon est créée pour le client, avec une ligne unique reprenant la description et le montant HT (la TVA est déduite du rapport TTC / HT mémorisé).
2. La date d'émission vaut la prochaine échéance ; l'échéance de paiement est fixée à +30 jours.
3. La facture porte la note « Facture récurrente (REC-…) » pour la tracer jusqu'à son abonnement d'origine.
4. La prochaine échéance de l'abonnement avance automatiquement selon la fréquence.

Génération automatique (cron / worker)

En production, vous n'avez pas à cliquer sur « Générer » : un planificateur et un worker s'en chargent. Le mécanisme repose sur une file de tâches alimentée par le cron de l'hôte.

1. Le planificateur (appelé chaque minute, ex. --schedule) repère tout abonnement actif dont la prochaine échéance est arrivée (date ≤ aujourd'hui) et l'enfile.
2. La file déduplique les échéances : une même échéance n'est jamais enfilée deux fois, même si le planificateur repasse avant le worker.
3. Le worker (appelé périodiquement, ex. --work) consomme la file : il crée la facture et avance l'échéance, le tout dans une transaction (pas de facture orpheline ni de doublon en cas d'incident).

Le même mécanisme de file gère aussi les rappels d'échéance (relance e-mail des factures impayées en retard) et la génération asynchrone des Factur-X des factures émises.

Colonnes & champs

Permissions

L'action Générer ajoute l'exigence de invoices.manage (création de facture). Voir Rôles & permissions pour la composition des rôles.

Liens utiles

• Factures — destination de chaque facture récurrente générée.
• Rôles & permissions — qui peut gérer les récurrents.