View source for Module Auto Reminder FR

<!-- BEGIN interlang links -->
[[en:Module_Auto_Reminder]]
<!-- END interlang links -->

[[Category:Modules complémentaires]]
{{TemplateDocUtil}}
=Informations=
{{TemplateModuleInfo
|modulename=Auto Reminder
|editor=Stéphane Mallet Informatique
|web=https://web-pilot.fr/offres/rsi
|webbuy=https://www.dolistore.com/product.php?id=2770
|status=stable
|prerequisites=Dolibarr 19 ou supérieur
|note=Testé sur Dolibarr 23. Module gratuit, GPLv3.
}}

'''Auto Reminder''' envoie et relance automatiquement les factures et les devis dans Dolibarr. Tout est déclenché par une tâche planifiée quotidienne.

= Fonctionnalités =

== Factures ==

* Envoi automatique des factures validées par email, avec le PDF de la facture en pièce jointe et le modèle d'email de votre choix.
* Relance automatique des factures impayées, par paliers configurables. Chaque palier définit un délai en jours par rapport à la date d'échéance (ou à la date de facture s'il n'y a pas d'échéance) et son modèle d'email. Les délais négatifs sont acceptés, pour une relance préventive avant l'échéance.
* Option pour inclure ou exclure les factures partiellement payées.

== Devis (depuis la 1.3.0) ==

* Envoi automatique des devis validés par email, avec le PDF du devis en pièce jointe.
* Relance automatique des devis restés sans réponse (ni signés, ni refusés, ni facturés). Les paliers sont comptés à partir de la date de fin de validité du devis, ou de sa date s'il n'en a pas.
* Réglages entièrement séparés de ceux des factures : la page de configuration a un onglet Factures et un onglet Devis, chacun avec ses interrupteurs, son modèle d'email et ses paliers.

== Seul le palier le plus élevé atteint est envoyé ==

Pour chaque document, seul le palier de relance le plus élevé atteint est retenu. Les paliers inférieurs manqués ne sont jamais rattrapés : un document déjà en retard au moment où le module est activé reçoit une seule relance, celle qui correspond à son retard réel, avec le bon modèle d'email. Jamais une rafale de relances sur plusieurs jours.

== Destinataire des emails ==

Le destinataire est déterminé dans cet ordre, aussi bien pour l'envoi que pour les relances :

# Le contact rattaché au document (onglet Contacts de la facture ou du devis), quel que soit son rôle. Si plusieurs contacts sont rattachés : facturation, puis prestation, puis livraison pour une facture ; suivi, puis facturation, puis livraison pour un devis.
# Sinon le contact par défaut du tiers pour ce type de document (onglet Contacts/Adresses du tiers).
# Sinon le premier contact actif du tiers ayant une adresse email.
# Sinon l'adresse email du tiers.

Depuis la 1.3.1, tous les contacts à égalité sur le rôle le plus prioritaire sont retenus, et non plus seulement le premier : deux ou trois contacts de facturation rattachés à la même facture reçoivent tous l'email, en un seul envoi. L'ordre de priorité est inchangé, un contact de facturation l'emporte toujours sur un contact de livraison. Les étapes 1 et 2 ci-dessus fonctionnent ainsi ; l'étape 3 ne retient qu'un seul destinataire, puisque sans rôle rien n'indique qui s'occupe des factures.

Les contacts désactivés et les contacts sans email ne sont jamais utilisés. Si aucun destinataire n'est trouvé, rien n'est envoyé et un événement est enregistré dans l'agenda du document.

== Garde-fou contre l'envoi en masse ==

Seuls les documents validés après l'activation de l'option d'envoi sont envoyés : activer le module sur une base existante n'envoie jamais l'historique. La date de référence est enregistrée au moment où vous activez l'option, affichée dans les réglages, et modifiable : vous pouvez la reculer en connaissance de cause pour inclure une partie de l'historique. Un avertissement explicite est affiché à côté du champ : tout document validé à partir de cette date et jamais envoyé partira au prochain passage de la tâche planifiée.

== Exclusions ==

Une case à cocher « Exclure des relances automatiques » est disponible :
* sur la fiche tiers : ne jamais relancer ce client (factures et devis),
* sur la fiche facture : ne jamais relancer cette facture (litige, échéancier négocié...),
* sur la fiche devis : ne jamais relancer ce devis.

L'envoi initial des documents n'est pas concerné par ces cases.

== Quand un document ne peut pas être traité ==

Quand un document ne peut pas être traité (aucun destinataire valide, PDF introuvable, modèle d'email introuvable, échec d'envoi), le module enregistre un événement dans l'agenda du document avec la raison en clair, une seule fois par document et par raison. En regardant la facture ou le devis, vous voyez immédiatement pourquoi rien n'est parti.

= Installation =

# Télécharger le fichier zip du module.
# Se connecter à Dolibarr en administrateur, aller dans ''Accueil - Configuration - Modules/Applications'', onglet ''Déployer/installer un module externe'', et envoyer le zip.
# Activer '''Auto Reminder''' dans la section ''Modules financiers''.

Le module crée automatiquement sa table en base, ses champs complémentaires et une tâche planifiée quotidienne. Lors d'une mise à jour depuis une version 1.x, les paliers existants sont conservés en tant que paliers de factures.

= Configuration =

Avant de configurer le module, créez vos modèles d'email dans ''Accueil - Configuration - Emails - Modèles d'emails'' : type ''Envoi facture'' pour les factures, type ''Envoi proposition commerciale'' pour les devis. Un modèle pour l'envoi initial, un par palier de relance.

Ouvrez ensuite les réglages du module. Il y a un onglet par type de document (Factures, Devis), chacun avec :

* l'interrupteur d'envoi automatique et son modèle d'email. À l'activation, la date du jour est enregistrée : seuls les documents validés à partir de cette date seront envoyés. La date est modifiable (avec un avertissement),
* l'interrupteur de relance automatique (et, pour les factures uniquement, l'option des factures partiellement payées),
* le tableau des paliers de relance : délai en jours + modèle d'email, autant de paliers que vous voulez.

La tâche planifiée ''AutoReminderJob'' s'exécute une fois par jour par défaut (voir ''Accueil - Configuration - Tâches planifiées'').

= Historique des versions =

* '''1.3.1''' (2026-08-02, bêta) : tous les contacts à égalité sur le rôle le plus prioritaire reçoivent le document et les relances (plusieurs contacts de facturation sur la même facture), ordre de priorité inchangé, rien à activer. La 1.3.0 reste la version release.
* '''1.3.0''' (2026-07-21) : gestion des devis (envoi automatique et relances sur la fin de validité, onglets de réglages séparés, moteur unique), date du garde-fou modifiable avec avertissement, nouvelle règle de destinataire commune, exclusion par devis.

Changelog complet, toutes les versions depuis la première : [https://framagit.org/Steph501/dolibarr-mod-autoreminder/-/blob/main/ChangeLog.md ChangeLog.md]

= Support =

contact@stephane-mallet.fr

{{DEFAULTSORT:Auto Reminder}}