Notification Email après Signature en Ligne

1. Contexte du problème

Dolibarr permet l'envoi d'un devis (proposition commerciale) par email au client, avec un lien de signature en ligne. Le client ouvre le lien, signe dans son navigateur, et le devis passe automatiquement au statut « Signé ».

Ce qui fonctionne :

• L'envoi initial du devis avec le lien de signature (tracé dans dolibarr_mail.log)
• La signature elle-même (changement de statut, stockage de la signature PNG, génération du PDF signé)
• Le déclenchement du trigger PROPAL_CLOSE_SIGNED (vérifié dans les logs)

Ce qui ne fonctionne pas : l'étape d'envoi de l'email de notification après le trigger.

2. Analyse technique

2.1 Flux de la signature en ligne

2.2 Trois mécanismes de notification dans Dolibarr

La méthode Notify::send() dans core/class/notify.class.php gère trois types de destinataires :

3. Cause racine

3.1 Comment Dolibarr gère réellement les emails fixes

Pour les emails fixes globaux, le code ne cherche pas dans llx_notify_def mais dans les constantes de la table llx_const, avec un format précis :

NOTIFICATION_FIXEDEMAIL_{CODE_TRIGGER}_THRESHOLD_HIGHER_{SEUIL}

Le code parcourt toutes les constantes $conf->global et cherche celles qui matchent le pattern NOTIFICATION_FIXEDEMAIL_PROPAL_CLOSE_SIGNED_THRESHOLD_HIGHER_*.

La valeur de la constante contient l'adresse email du destinataire. Le suffixe numérique représente le seuil minimum de montant HT du devis pour déclencher la notification.

4. Solution

4.1 Prérequis

CopierSELECT value FROM llx_const WHERE name = 'MAIN_MODULE_NOTIFICATION';

4.2 Notification quand un devis est signé

CopierINSERT IGNORE INTO llx_const (name, value, type, visible, entity)
VALUES (
    'NOTIFICATION_FIXEDEMAIL_PROPAL_CLOSE_SIGNED_THRESHOLD_HIGHER_0',
    'destinataire@example.com',
    'chaine', 0, 1
);

4.3 Notification quand un devis est refusé

CopierINSERT IGNORE INTO llx_const (name, value, type, visible, entity)
VALUES (
    'NOTIFICATION_FIXEDEMAIL_PROPAL_CLOSE_REFUSED_THRESHOLD_HIGHER_0',
    'destinataire@example.com',
    'chaine', 0, 1
);

4.4 Plusieurs destinataires

Pour envoyer la notification à plusieurs adresses, les séparer par une virgule dans la valeur :

CopierUPDATE llx_const
SET value = 'secretariat@example.com, direction@example.com'
WHERE name = 'NOTIFICATION_FIXEDEMAIL_PROPAL_CLOSE_SIGNED_THRESHOLD_HIGHER_0'
  AND entity = 1;

4.5 Seuil de montant

Le chiffre à la fin du nom de la constante définit le seuil minimum de montant HT. _0 signifie « tous les devis avec un montant HT supérieur à 0 ».

Exemples de seuils :

5. Configuration Multicompany

Dans un environnement Multicompany, chaque entité (société) a ses propres constantes dans llx_const différenciées par le champ entity.

Lors de la signature en ligne, Dolibarr charge les constantes de l'entité associée au devis. Il suffit donc d'insérer une constante par entité avec l'email correspondant.

5.1 Identifier les entités

CopierSELECT rowid, label, active FROM llx_entity ORDER BY rowid;

Résultat type :

5.2 Insérer une constante par entité

Copier-- Entité 1 : Société A
INSERT IGNORE INTO llx_const (name, value, type, visible, entity)
VALUES ('NOTIFICATION_FIXEDEMAIL_PROPAL_CLOSE_SIGNED_THRESHOLD_HIGHER_0',
        'secretariat@societe-a.com', 'chaine', 0, 1);

-- Entité 2 : Société B
INSERT IGNORE INTO llx_const (name, value, type, visible, entity)
VALUES ('NOTIFICATION_FIXEDEMAIL_PROPAL_CLOSE_SIGNED_THRESHOLD_HIGHER_0',
        'admin@societe-b.com', 'chaine', 0, 2);

-- Répéter pour chaque entité active

5.3 Même logique pour les devis refusés

Copier-- Entité 1
INSERT IGNORE INTO llx_const (name, value, type, visible, entity)
VALUES ('NOTIFICATION_FIXEDEMAIL_PROPAL_CLOSE_REFUSED_THRESHOLD_HIGHER_0',
        'secretariat@societe-a.com', 'chaine', 0, 1);

-- Entité 2
INSERT IGNORE INTO llx_const (name, value, type, visible, entity)
VALUES ('NOTIFICATION_FIXEDEMAIL_PROPAL_CLOSE_REFUSED_THRESHOLD_HIGHER_0',
        'admin@societe-b.com', 'chaine', 0, 2);

6. Vérification post-déploiement

CopierSELECT name, value, entity
FROM llx_const
WHERE name LIKE 'NOTIFICATION_FIXEDEMAIL_PROPAL%'
ORDER BY entity, name;

CopierSELECT name, value FROM llx_const
WHERE name = 'MAIN_MODULE_NOTIFICATION';

CopierSELECT * FROM llx_notify ORDER BY rowid DESC LIMIT 10;

Copier-- Activer le log mail (niveau debug)
INSERT IGNORE INTO llx_const (name, value, type, visible, entity)
VALUES ('MAIN_MAIL_DEBUG', '1', 'chaine', 0, 0);

-- Désactiver après le test
UPDATE llx_const SET value = '0' WHERE name = 'MAIN_MAIL_DEBUG';

7. Résumé