Référence client automatique pour les factures modèles
Description du besoin
CAP-REL propose des abonnements à différents services. Pour chaque abonnement, un contrat est créé dans Dolibarr ainsi qu'une facture modèle. Chaque mois, la facture modèle est utilisée pour générer automatiquement la facture du mois. Chaque client reçoit donc une facture chaque mois pour chaque contrat.
Le problème se pose plus précisément pour les clients qui ont plusieurs contrats actifs : la liste des factures ne permet pas de savoir rapidement ce qu'il en est :

Alors que si nous utilisons le champ "référence client", la liste est tout de suite plus facile à lire :

Le top du top serait d'avoir en plus la période concernée par l'abonnement, par exemple "DoliSCAN Janv. 2024".
Sur la facture client
Du côté de la facture client, c'est tout simplement le champ "Réf. Client" qui est renseigné. C'est un champ standard de Dolibarr.

Le module qui fait cela
La mission est très simple : ajouter un champ étendu sur les factures récurrentes et ensuite appliquer le contenu de ce champ lorsqu'une facture est automatiquement générée.

De ce fait, les factures générées bénéficient maintenant automatiquement d'une référence client.

Variables de substitution
Les variables normales de Dolibarr s'appliquent, en particulier :
__INVOICE_PREVIOUS_MONTH____INVOICE_MONTH____INVOICE_NEXT_MONTH____INVOICE_PREVIOUS_MONTH_TEXT____INVOICE_MONTH_TEXT____INVOICE_NEXT_MONTH_TEXT____INVOICE_PREVIOUS_YEAR____INVOICE_YEAR____INVOICE_NEXT_YEAR____INVOICE_DATE_NEXT_INVOICE_BEFORE_GEN____INVOICE_DATE_NEXT_INVOICE_AFTER_GEN____INVOICE_PREVIOUS_DATE_NEXT_INVOICE_AFTER_GEN____INVOICE_COUNTER_CURRENT____INVOICE_COUNTER_MAX__