Module Auto Reminder: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
(Création de la page)
Tag: 2017 source edit
 
(Traduction en anglais)
Tag: 2017 source edit
Line 1: Line 1:
{{DISPLAYTITLE:Auto Reminder module by Stéphane Mallet Informatique}}
{{DISPLAYTITLE:Auto Reminder module by Stéphane Mallet Informatique}}
[[Category:Complementary modules]]
[[Category:Modules complémentaires]]
[[Category:Modules complémentaires]]


=Informations=
=Information=
{{TemplateModuleInfo
{{TemplateModuleInfo
|modulename=Auto Reminder
|modulename=Auto Reminder
Line 8: Line 9:
|web=https://web-pilot.fr/offres/rsi
|web=https://web-pilot.fr/offres/rsi
|status=stable
|status=stable
|prerequisites=Dolibarr 19 minimum - PHP 7.1 minimum - Module Tâches planifiées activé
|prerequisites=Dolibarr 19 minimum - PHP 7.1 minimum - Scheduled jobs module enabled
|webbuy=https://www.dolistore.com/product.php?id=2770&l=fr
|webbuy=https://www.dolistore.com/product.php?id=2770&l=en
|note=Module gratuit, licence GPLv3. Code source et zip : https://framagit.org/Steph501/dolibarr-mod-autoreminder
|note=Free module, GPLv3 license. Source code and zip: https://framagit.org/Steph501/dolibarr-mod-autoreminder
}}
}}


'''Description courte :''' Envoie automatiquement les factures dès leur validation, et relance les factures impayées par paliers configurables. Un module, deux automatismes, une seule tâche planifiée quotidienne.
'''Short description:''' Automatically sends invoices as soon as they are validated, and reminds unpaid invoices through configurable levels. One module, two automations, a single daily scheduled job.


=Fonctionnalités=
=Features=


==Envoi automatique des factures validées==
==Automatic sending of validated invoices==
* Chaque facture validée part par email, sans intervention, avec son PDF en pièce jointe.
* Every validated invoice is emailed without any action, with its PDF attached.
* Le modèle d'email est choisi parmi les modèles Dolibarr existants.
* The email template is picked among the existing Dolibarr templates.
* Chaque facture n'est envoyée qu'une seule fois : le module en garde la trace dans l'agenda.
* Each invoice is sent only once: the module keeps track of it in the agenda.
* Le destinataire est trouvé automatiquement : contact de facturation, sinon contact du tiers, sinon email du tiers.
* The recipient is resolved automatically: billing contact, then third party contact, then third party email.


==Relance des factures impayées==
==Reminders for unpaid invoices==
* Les relances reposent sur des paliers que vous définissez : un délai en jours et un modèle d'email par palier.
* Reminders rely on levels you define: a delay in days and an email template for each level.
* Le nombre de paliers est libre.
* Any number of levels.
* Un délai négatif permet de relancer '''avant''' l'échéance, en prévention.
* A negative delay sends the reminder '''before''' the due date, as a preventive notice.
* Option pour inclure ou non les factures partiellement payées.
* Option to include or exclude partially paid invoices.
* Une facture n'est jamais relancée deux fois pour le même palier.
* An invoice is never reminded twice for the same level.
* Le délai se compte à partir de la date d'échéance, ou de la date de facturation si l'échéance est absente.
* The delay is counted from the due date, or from the invoice date when no due date is set.


==Exclure un client ou une facture des relances==
==Excluding a customer or an invoice from reminders==
* Une case "Exclure des relances automatiques" est ajoutée sur la '''fiche tiers''' : ce client ne reçoit plus aucune relance, les autres continuent normalement.
* An "Exclude from automatic reminders" checkbox is added on the '''third party card''': this customer receives no reminder at all, while every other customer keeps being reminded.
* La même case est ajoutée sur la '''fiche facture''' : utile pour une facture en litige ou un échéancier négocié, sans couper les relances des autres factures du même client.
* The same checkbox is added on the '''invoice card''': useful for a disputed invoice or a negotiated payment schedule, without stopping the reminders of the other invoices of that customer.
* Ces exclusions ne concernent que les relances. L'envoi initial de la facture n'est pas affecté.
* These exclusions only apply to reminders. The initial invoice sending is not affected.


==Divers==
==Miscellaneous==
* Traduit en français, anglais, espagnol, allemand et italien.
* The module interface is translated into English, French, Spanish, German and Italian.
* Les deux automatismes sont portés par une seule tâche planifiée quotidienne, créée à l'activation du module.
* Both automations are carried by a single daily scheduled job, created when the module is enabled.


=Prérequis=
=Prerequisites=
* Dolibarr 19 ou supérieur.
* Dolibarr 19 or above.
* PHP 7.1 ou supérieur.
* PHP 7.1 or above.
* Le module '''Tâches planifiées''' de Dolibarr activé, et un cron système appelant Dolibarr (chez la plupart des hébergeurs mutualisés, cette tâche est à créer dans le panneau d'administration de l'hébergement). Sans cela, aucun envoi automatique n'a lieu.
* The Dolibarr '''Scheduled jobs''' module enabled, and a system cron calling Dolibarr (on most shared hosting, this task has to be created in the hosting control panel). Without it, no automatic sending happens.
* Un envoi d'emails fonctionnel dans Dolibarr (Accueil - Configuration - Emails).
* A working email setup in Dolibarr (Home - Setup - Emails).


=Installation=
=Installation=
{{InstallModuleFr}}
{{InstallModuleEn}}


Le zip est téléchargeable gratuitement sur le Dolistore : https://www.dolistore.com/product.php?id=2770&l=fr
The zip is available for free on Dolistore: https://www.dolistore.com/product.php?id=2770&l=en


Le code source est public : https://framagit.org/Steph501/dolibarr-mod-autoreminder
The source code is public: https://framagit.org/Steph501/dolibarr-mod-autoreminder


=Configuration=
=Configuration=
{{ActivationModuleFr}}
{{ActivationModuleEn}}


Une fois le module activé, sa page de configuration permet de :
Once the module is enabled, its setup page allows you to:
* activer l'envoi automatique des factures validées, et choisir le modèle d'email utilisé ;
* enable the automatic sending of validated invoices, and choose the email template used;
* activer les relances, et décider si les factures partiellement payées sont concernées ;
* enable the reminders, and decide whether partially paid invoices are concerned;
* créer les paliers de relance : pour chaque palier, un délai en jours et un modèle d'email.
* create the reminder levels: for each level, a delay in days and an email template.


Sans aucun palier configuré, aucune relance n'est envoyée : le module le signale sur sa page de configuration.
With no level configured, no reminder is sent: the module says so on its setup page.


=Utilisation=
=Usage=


Il n'y a rien à faire au quotidien : la tâche planifiée s'occupe des envois.
There is nothing to do on a daily basis: the scheduled job takes care of the sendings.


Pour ne plus relancer un client, ouvrir sa fiche tiers, la modifier, et cocher '''Exclure des relances automatiques'''. Pour ne pas relancer une facture précise, cocher la même case sur la fiche de cette facture.
To stop reminding a customer, open the third party card, edit it, and tick '''Exclude from automatic reminders'''. To skip one specific invoice, tick the same checkbox on that invoice card.


=Mise à jour=
=Upgrade=


Déposer le nouveau zip par-dessus l'ancien (Accueil - Configuration - Modules - Déployer un module externe), puis '''désactiver et réactiver le module'''. Cette dernière étape est nécessaire pour que les nouveaux champs soient créés. Depuis la version 1.1.0, vos réglages et vos paliers sont conservés lors de cette opération.
Upload the new zip over the previous one (Home - Setup - Modules - Deploy external module), then '''disable and enable the module again'''. This last step is required for the new fields to be created. Since version 1.1.0, your settings and your reminder levels are kept during this operation.


=Historique des versions=
=Version history=
* '''1.1.1''' : traduction du module en espagnol, allemand et italien.
* '''1.1.1''': module translated into Spanish, German and Italian.
* '''1.1.0''' : exclusion des relances par tiers et par facture. Correction : les réglages ne sont plus perdus lors d'une désactivation du module.
* '''1.1.0''': exclusion of reminders per third party and per invoice. Fix: settings are no longer lost when the module is disabled.
* '''1.0.0''' : version initiale (envoi automatique des factures validées, relance des impayés par paliers).
* '''1.0.0''': initial release (automatic sending of validated invoices, reminders for unpaid invoices by levels).


=Support=
=Support=


Par email : contact@stephane-mallet.fr
By email: contact@stephane-mallet.fr


{{DEFAULTSORT:Auto Reminder}}
{{DEFAULTSORT:Auto Reminder}}

Revision as of 22:23, 16 July 2026


Information


Module name Auto Reminder
Editor / Editeur Stéphane Mallet Informatique - https://web-pilot.fr/offres/rsi
Download or buy page / Page achat ou téléchargement External module - https://www.dolistore.com/product.php?id=2770&l=en
Status / Statut / Estado Stable
Prerequisites / Prérequis Dolibarr 19 minimum - PHP 7.1 minimum - Scheduled jobs module enabled

Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2026-07-16
Note / Nota Free module, GPLv3 license. Source code and zip: https://framagit.org/Steph501/dolibarr-mod-autoreminder

Short description: Automatically sends invoices as soon as they are validated, and reminds unpaid invoices through configurable levels. One module, two automations, a single daily scheduled job.

Features

Automatic sending of validated invoices

  • Every validated invoice is emailed without any action, with its PDF attached.
  • The email template is picked among the existing Dolibarr templates.
  • Each invoice is sent only once: the module keeps track of it in the agenda.
  • The recipient is resolved automatically: billing contact, then third party contact, then third party email.

Reminders for unpaid invoices

  • Reminders rely on levels you define: a delay in days and an email template for each level.
  • Any number of levels.
  • A negative delay sends the reminder before the due date, as a preventive notice.
  • Option to include or exclude partially paid invoices.
  • An invoice is never reminded twice for the same level.
  • The delay is counted from the due date, or from the invoice date when no due date is set.

Excluding a customer or an invoice from reminders

  • An "Exclude from automatic reminders" checkbox is added on the third party card: this customer receives no reminder at all, while every other customer keeps being reminded.
  • The same checkbox is added on the invoice card: useful for a disputed invoice or a negotiated payment schedule, without stopping the reminders of the other invoices of that customer.
  • These exclusions only apply to reminders. The initial invoice sending is not affected.

Miscellaneous

  • The module interface is translated into English, French, Spanish, German and Italian.
  • Both automations are carried by a single daily scheduled job, created when the module is enabled.

Prerequisites

  • Dolibarr 19 or above.
  • PHP 7.1 or above.
  • The Dolibarr Scheduled jobs module enabled, and a system cron calling Dolibarr (on most shared hosting, this task has to be created in the hosting control panel). Without it, no automatic sending happens.
  • A working email setup in Dolibarr (Home - Setup - Emails).

Installation

From the application

  • Download the archive file of module (.zip file)
  • Go on menu Home -> Setup -> Modules -> Deploy external module and submit the file.
  • Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.

Manually

  • Download the archive file of module (.zip file)
  • Put the file into the root directory of Dolibarr.
  • Uncompress the archive file, for example with command
unzip modulefile.zip
  • Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.

The zip is available for free on Dolistore: https://www.dolistore.com/product.php?id=2770&l=en

The source code is public: https://framagit.org/Steph501/dolibarr-mod-autoreminder

Configuration

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears Cog circle.svg on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

Once the module is enabled, its setup page allows you to:

  • enable the automatic sending of validated invoices, and choose the email template used;
  • enable the reminders, and decide whether partially paid invoices are concerned;
  • create the reminder levels: for each level, a delay in days and an email template.

With no level configured, no reminder is sent: the module says so on its setup page.

Usage

There is nothing to do on a daily basis: the scheduled job takes care of the sendings.

To stop reminding a customer, open the third party card, edit it, and tick Exclude from automatic reminders. To skip one specific invoice, tick the same checkbox on that invoice card.

Upgrade

Upload the new zip over the previous one (Home - Setup - Modules - Deploy external module), then disable and enable the module again. This last step is required for the new fields to be created. Since version 1.1.0, your settings and your reminder levels are kept during this operation.

Version history

  • 1.1.1: module translated into Spanish, German and Italian.
  • 1.1.0: exclusion of reminders per third party and per invoice. Fix: settings are no longer lost when the module is disabled.
  • 1.0.0: initial release (automatic sending of validated invoices, reminders for unpaid invoices by levels).

Support

By email: contact@stephane-mallet.fr