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 :

Exemple de liste de factures sans référence client

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

Liste avec référence client renseignée

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.

Référence client sur la facture

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.

Champ étendu pour renseigner la référence à appliquer, avec utilisation de variables de substitution

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

Factures générées avec référence client automatique

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__