Module Auto Reminder FR: Difference between revisions
Tag: 2017 source edit |
No edit summary Tag: 2017 source edit |
||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 5: | Line 5: | ||
[[Category:Modules complémentaires]] | [[Category:Modules complémentaires]] | ||
{{TemplateDocUtil}} | {{TemplateDocUtil}} | ||
{{TemplateModuleInfo | {{TemplateModuleInfo | ||
|modulename=Auto Reminder | |modulename=Auto Reminder | ||
| Line 13: | Line 13: | ||
|status=stable | |status=stable | ||
|prerequisites=Dolibarr 19 ou supérieur | |prerequisites=Dolibarr 19 ou supérieur | ||
|note=Testé sur Dolibarr | |note=Testé sur Dolibarr 24. Module gratuit, GPLv3. | ||
}} | }} | ||
= Fonctionnalités = | |||
'''Auto Reminder''' envoie et relance automatiquement les factures et les devis dans Dolibarr. Tout est déclenché par une tâche planifiée quotidienne. | '''Auto Reminder''' envoie et relance automatiquement les factures et les devis dans Dolibarr. Tout est déclenché par une tâche planifiée quotidienne. | ||
== Factures == | == Factures == | ||
| Line 35: | Line 34: | ||
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. | 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. | ||
== Mode semi-automatique (depuis la 1.3.7) == | |||
Au lieu d'envoyer une relance, le module peut la préparer et vous laisser l'envoyer vous-même. Chaque relance à faire devient une alerte : | |||
* une cloche dans la barre du haut indique le nombre de factures et de devis à relancer, et mène à leur liste ; | |||
* les listes des factures et des devis ont une colonne ''Relance'' et un filtre ''À relancer'' ; | |||
* la fiche du document affiche l'alerte avec un bouton ''Relancer'', qui ouvre le formulaire d'envoi de Dolibarr prérempli avec le modèle du palier, dans la langue du client, et avec les destinataires du module. | |||
L'alerte se ferme quand un email est envoyé depuis la fiche ou programmé avec Doli Mail Later, quand un palier supérieur la remplace, ou quand vous l'annulez : seul ce palier est alors sauté. Le mode se choisit par type de document dans les réglages (''Mode semi-automatique par défaut''), et se change par tiers et par document avec le champ « Relances ». | |||
== Relances par tiers et par document (depuis la 1.3.7) == | |||
Le champ « Relances » est disponible sur la fiche tiers, la fiche facture, la facture modèle et la fiche devis : | |||
* '''Automatiques''' : la relance part toute seule ; | |||
* '''Semi-automatiques''' : le module prépare la relance et vous la signale ; | |||
* '''Aucune''' : la relance n'est ni envoyée ni préparée en alerte, et une alerte déjà ouverte disparaît. | |||
Laissé vide, c'est le niveau suivant qui décide : le choix de la facture ou du devis passe avant celui du tiers, qui passe avant le réglage du module. Exemple : un tiers en litige est sur « Aucune », une de ses factures sur « Automatiques » : seule cette facture est relancée. Une facture générée depuis une facture modèle reçoit le choix du modèle, modifiable ensuite sur la facture. | |||
L'envoi initial des documents n'est pas concerné par ce champ. Il remplace la case « Exclure des relances automatiques » des versions précédentes (voir l'installation pour la mise à jour). | |||
== Destinataire des emails == | == Destinataire des emails == | ||
| Line 51: | Line 70: | ||
== Langue des emails (depuis la 1.3.2) == | == Langue des emails (depuis la 1.3.2) == | ||
Un email part dans la langue du tiers, sinon dans la langue par défaut des emails choisie dans les réglages du module (depuis la 1.3.7), sinon dans la langue de votre Dolibarr. Le module prend la première de ces langues dans laquelle le modèle d'email existe, et envoie le modèle des réglages tel quel si aucune ne l'a. Le repli de langue (es_MX vers es_ES, puis modèle sans langue) est celui de Dolibarr. Les dates et les montants suivent la langue de l'email envoyé. Le PDF joint, lui, n'est pas régénéré : c'est le document tel qu'il existe. | |||
Traduire un modèle est un geste Dolibarr, pas un réglage du module : recréer le modèle avec le MÊME libellé, choisir la langue, puis traduire le sujet et le contenu. À noter, la | Exemple : dans un Dolibarr en français, avec l'anglais comme langue par défaut des emails, un tiers sans langue reçoit l'anglais, un tiers français le français, et un tiers allemand l'anglais s'il n'existe pas de modèle en allemand. | ||
Traduire un modèle est un geste Dolibarr, pas un réglage du module : recréer le modèle avec le MÊME libellé, choisir la langue, puis traduire le sujet et le contenu. À noter, la langue des tiers et des modèles n'apparaît que si l'option multilingue de Dolibarr est activée. | |||
== Garde-fou contre l'envoi en masse == | == 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. | 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. | ||
== Quand un document ne peut pas être traité == | == Quand un document ne peut pas être traité == | ||
| Line 75: | Line 87: | ||
Le module fonctionne avec le module Multicompany. Chaque société envoie et relance '''ses propres documents uniquement''', avec ses propres réglages, ses propres paliers et ses propres modèles d'email. Le partage de Multicompany donne un droit de lecture sur les documents d'une autre société, il ne change pas leur propriétaire : une facture partagée reste relancée par la société à laquelle elle appartient. Il n'y a rien à régler. Avant la 1.3.3, une société prenait aussi les factures et les devis des sociétés qu'elle avait le droit de voir, et les traitait avec ses propres réglages. | Le module fonctionne avec le module Multicompany. Chaque société envoie et relance '''ses propres documents uniquement''', avec ses propres réglages, ses propres paliers et ses propres modèles d'email. Le partage de Multicompany donne un droit de lecture sur les documents d'une autre société, il ne change pas leur propriétaire : une facture partagée reste relancée par la société à laquelle elle appartient. Il n'y a rien à régler. Avant la 1.3.3, une société prenait aussi les factures et les devis des sociétés qu'elle avait le droit de voir, et les traitait avec ses propres réglages. | ||
== Déclencheurs pour les développeurs (depuis la 1.3.5) == | |||
Après chaque email parti avec succès, le module lance un déclencheur (trigger) sur la facture ou le devis, pour qu'un autre module puisse y réagir : <code>AUTOREMINDER_SEND</code> après l'envoi automatique d'un document validé, <code>AUTOREMINDER_REMIND</code> après une relance. Le déclencheur reçoit le document dans <code>$object</code> et le détail dans <code>$object->context['autoreminder']</code> : <code>doctype</code>, <code>actioncomm_id</code> (l'événement d'agenda de cet email), <code>level_id</code> et <code>level_days</code> (le palier de relance, 0 et vide pour l'envoi initial), <code>email_to</code>, <code>email_from</code>, <code>email_subject</code>. Le module ne lance pas les déclencheurs natifs <code>BILL_SENTBYMAIL</code> et <code>PROPAL_SENTBYMAIL</code>, qui signifient qu'un utilisateur a envoyé le document depuis sa fiche. | |||
= Installation = | = Installation = | ||
| Line 83: | Line 99: | ||
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. | 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. | ||
Après une mise à jour depuis la 1.3.6 ou une version antérieure, désactivez puis réactivez le module : les cases « Exclure des relances automatiques » cochées deviennent « Aucune » dans le champ « Relances ». Vos réglages et vos paliers sont conservés. | |||
= Configuration = | = Configuration = | ||
| Line 88: | Line 106: | ||
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. | 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 : | Ouvrez ensuite les réglages du module. En haut de la page, commune aux deux types de documents, la ''Langue par défaut des emails'' fixe la langue des emails envoyés aux tiers dont la fiche n'indique aucune langue. Laissée vide, c'est la langue de votre Dolibarr. | ||
Il y a ensuite 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 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 | * l'interrupteur des relances, l'option ''Mode semi-automatique par défaut'' (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. | * le tableau des paliers de relance : délai en jours + modèle d'email, autant de paliers que vous voulez. | ||
| Line 98: | Line 118: | ||
= Historique des versions = | = Historique des versions = | ||
Changelog complet, toutes les versions depuis la première : [https://framagit.org/doli/modules/autoreminder/-/blob/main/ChangeLog.md ChangeLog.md] | |||
Changelog complet, toutes les versions depuis la première : [https://framagit.org/ | |||
= Support = | = Support = | ||
contact@stephane-mallet.fr | contact@stephane-mallet.fr | ||
Latest revision as of 10:19, 27 October 2026
| 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 |
| Status / Statut / Estado | Stable |
| Prerequisites / Prérequis | Dolibarr 19 ou supérieur
Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2026-10-27 |
| Note / Nota | Testé sur Dolibarr 24. Module gratuit, GPLv3. |
Fonctionnalités
Auto Reminder envoie et relance automatiquement les factures et les devis dans Dolibarr. Tout est déclenché par une tâche planifiée quotidienne.
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.
Mode semi-automatique (depuis la 1.3.7)
Au lieu d'envoyer une relance, le module peut la préparer et vous laisser l'envoyer vous-même. Chaque relance à faire devient une alerte :
- une cloche dans la barre du haut indique le nombre de factures et de devis à relancer, et mène à leur liste ;
- les listes des factures et des devis ont une colonne Relance et un filtre À relancer ;
- la fiche du document affiche l'alerte avec un bouton Relancer, qui ouvre le formulaire d'envoi de Dolibarr prérempli avec le modèle du palier, dans la langue du client, et avec les destinataires du module.
L'alerte se ferme quand un email est envoyé depuis la fiche ou programmé avec Doli Mail Later, quand un palier supérieur la remplace, ou quand vous l'annulez : seul ce palier est alors sauté. Le mode se choisit par type de document dans les réglages (Mode semi-automatique par défaut), et se change par tiers et par document avec le champ « Relances ».
Relances par tiers et par document (depuis la 1.3.7)
Le champ « Relances » est disponible sur la fiche tiers, la fiche facture, la facture modèle et la fiche devis :
- Automatiques : la relance part toute seule ;
- Semi-automatiques : le module prépare la relance et vous la signale ;
- Aucune : la relance n'est ni envoyée ni préparée en alerte, et une alerte déjà ouverte disparaît.
Laissé vide, c'est le niveau suivant qui décide : le choix de la facture ou du devis passe avant celui du tiers, qui passe avant le réglage du module. Exemple : un tiers en litige est sur « Aucune », une de ses factures sur « Automatiques » : seule cette facture est relancée. Une facture générée depuis une facture modèle reçoit le choix du modèle, modifiable ensuite sur la facture.
L'envoi initial des documents n'est pas concerné par ce champ. Il remplace la case « Exclure des relances automatiques » des versions précédentes (voir l'installation pour la mise à jour).
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.
Langue des emails (depuis la 1.3.2)
Un email part dans la langue du tiers, sinon dans la langue par défaut des emails choisie dans les réglages du module (depuis la 1.3.7), sinon dans la langue de votre Dolibarr. Le module prend la première de ces langues dans laquelle le modèle d'email existe, et envoie le modèle des réglages tel quel si aucune ne l'a. Le repli de langue (es_MX vers es_ES, puis modèle sans langue) est celui de Dolibarr. Les dates et les montants suivent la langue de l'email envoyé. Le PDF joint, lui, n'est pas régénéré : c'est le document tel qu'il existe.
Exemple : dans un Dolibarr en français, avec l'anglais comme langue par défaut des emails, un tiers sans langue reçoit l'anglais, un tiers français le français, et un tiers allemand l'anglais s'il n'existe pas de modèle en allemand.
Traduire un modèle est un geste Dolibarr, pas un réglage du module : recréer le modèle avec le MÊME libellé, choisir la langue, puis traduire le sujet et le contenu. À noter, la langue des tiers et des modèles n'apparaît que si l'option multilingue de Dolibarr est activée.
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.
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.
Multi-société (module Multicompany)
Le module fonctionne avec le module Multicompany. Chaque société envoie et relance ses propres documents uniquement, avec ses propres réglages, ses propres paliers et ses propres modèles d'email. Le partage de Multicompany donne un droit de lecture sur les documents d'une autre société, il ne change pas leur propriétaire : une facture partagée reste relancée par la société à laquelle elle appartient. Il n'y a rien à régler. Avant la 1.3.3, une société prenait aussi les factures et les devis des sociétés qu'elle avait le droit de voir, et les traitait avec ses propres réglages.
Déclencheurs pour les développeurs (depuis la 1.3.5)
Après chaque email parti avec succès, le module lance un déclencheur (trigger) sur la facture ou le devis, pour qu'un autre module puisse y réagir : AUTOREMINDER_SEND après l'envoi automatique d'un document validé, AUTOREMINDER_REMIND après une relance. Le déclencheur reçoit le document dans $object et le détail dans $object->context['autoreminder'] : doctype, actioncomm_id (l'événement d'agenda de cet email), level_id et level_days (le palier de relance, 0 et vide pour l'envoi initial), email_to, email_from, email_subject. Le module ne lance pas les déclencheurs natifs BILL_SENTBYMAIL et PROPAL_SENTBYMAIL, qui signifient qu'un utilisateur a envoyé le document depuis sa fiche.
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.
Après une mise à jour depuis la 1.3.6 ou une version antérieure, désactivez puis réactivez le module : les cases « Exclure des relances automatiques » cochées deviennent « Aucune » dans le champ « Relances ». Vos réglages et vos paliers sont conservés.
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. En haut de la page, commune aux deux types de documents, la Langue par défaut des emails fixe la langue des emails envoyés aux tiers dont la fiche n'indique aucune langue. Laissée vide, c'est la langue de votre Dolibarr.
Il y a ensuite 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 des relances, l'option Mode semi-automatique par défaut (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
Changelog complet, toutes les versions depuis la première : ChangeLog.md
Support
contact@stephane-mallet.fr