Modèles d'e-mail dans Dolibarr : variables, destinataire et PDF joint

Un modèle d’e-mail évite de retaper le même message à chaque facture : « Bonjour Léa, voici la facture FA2611-0013 de 600 € à régler avant le… ». Dolibarr remplace des variables comme __REF__ par les valeurs de la facture. Sur le forum, les mêmes questions reviennent : la variable qui ne se remplace pas, le mauvais destinataire, et le PDF qui ne part plus.

Tout ce qui suit a été testé le 4 novembre 2026 sur Dolibarr 24.0.2, puis rejoué en 23.0.4 avec les mêmes résultats. Chaque e-mail a été réellement envoyé vers un serveur de messagerie de test, puis relu.

En bref

1. Créer le modèle

L’écran des modèles se trouve dans AccueilConfigurationEmails, onglet Modèles des courriels. Pour une facture, choisissez le type Factures clients. Mettez Défaut à Oui : le modèle sera sélectionné tout seul quand vous cliquerez Envoyer email sur une facture.

Mettez aussi Joindre le fichier à Oui. Le formulaire de création propose Non, et avec Non, l’e-mail est parti sans le PDF de la facture dans nos tests (en 24.0.2 comme en 23.0.4). L’envoi avec le modèle d’origine de Dolibarr, lui, joint bien le PDF.

2. Les variables qui servent pour une facture

Une variable s’écrit avec deux tirets bas de chaque côté, en majuscules : __REF__. Avec un seul tiret bas (_REF_), rien n’est remplacé : c’est l’erreur du fil 50534 du forum.

Valeurs obtenues dans l’e-mail reçu, pour une facture de 500 € HT (600 € TTC) envoyée à Léa Bernard, contact facturation du client « Boulangerie Dupont » :

Quelques précisions, toutes vérifiées dans les e-mails reçus :

• L’ancienne orthographe __AMOUNT_FORMATED__ (un seul T), encore citée sur le forum, fonctionne toujours en 23.0.4 et 24.0.2. La liste officielle donne __AMOUNT_FORMATTED__.
• Les variables de contact finissent par le code du rôle du contact sur la facture : _BILLING__ pour le contact facturation. Si la facture n’a pas de contact facturation, elles restent telles quelles dans le message (« Bonjour __CONTACT_LASTNAME_BILLING__ ») : réservez-les aux clients qui ont un contact par défaut.
• __CONTACTCIVNAME__ est toujours vide quand on envoie une facture : Dolibarr la vide avant de remplir le message.
• En 24, la civilité n’est plus affichée sur les fiches contact ; __CONTACT_TITLE_BILLING__ reste donc vide tant qu’elle n’est pas rétablie (voir le champ civilité disparu en 24).

La liste complète : dans le formulaire du modèle, cliquez sur le petit i à côté de Sujet ou de Contenu. En 24.0.2, elle compte 145 variables, avec la valeur de chacune quand elle est connue.

Les variables sont remplacées à l’ouverture du formulaire d’envoi : vous voyez le texte final et pouvez encore le retoucher avant d’envoyer. Une variable tapée à la main dans ce formulaire est encore remplacée à l’envoi pour __REF__ ou __THIRDPARTY_NAME__, mais pas pour les variables de contact : mettez-les dans le modèle.

3. Faire partir l’e-mail au bon contact

Le contact par défaut. Sur la fiche du contact, le champ Contact / adresse par défaut pour accepte le rôle Facture - Contact client facturation. Le contact est alors ajouté tout seul comme contact facturation de chaque nouvelle facture de ce client (vérifié en 23.0.4 et 24.0.2).

Le champ « Adressé à ». Dolibarr ne coche une adresse d’office que s’il n’y en a qu’une possible. Un client sans contact : son adresse est cochée, l’e-mail part chez lui. Un client avec des contacts : la liste propose ses contacts et l’adresse du client, rien n’est coché, et c’est à vous de choisir.

Les factures récurrentes (envoi automatique, nouveauté de la version 24) partent au contact facturation de la facture générée, sinon à l’adresse du client. D’où l’intérêt du contact par défaut : le contact posé sur une facture avant d’en faire un modèle n’est pas repris (testé en 24.0.2 pour une réponse sur le forum).

Comment cela a été vérifié

Le 4 novembre 2026, sur des installations neuves de Dolibarr 24.0.2 et 23.0.4 (images Docker officielles, MariaDB 11.4, société française, interface en français), pilotées par un navigateur comme un utilisateur. Un client sans contact, puis avec un contact « Facture - Contact client facturation » ; un modèle « Factures clients » par défaut, d’abord avec « Joindre le fichier » à Non, puis à Oui ; des factures envoyées par le bouton Envoyer email vers un serveur de messagerie de test, et chaque e-mail reçu relu : destinataire, objet, texte, pièce jointe. La liste des variables vient de l’aide de l’écran des modèles en 24.0.2. Non testé : les modèles des devis, commandes et expéditions, l’envoi en masse depuis la liste des factures, et l’éditeur de texte riche (WYSIWYG).

À lire aussi

• Dolibarr n’envoie pas les e-mails : configurer le SMTP et comprendre chaque message d’erreur
• Dolibarr 23 : le champ « Privé » des modèles de courriel a disparu de l’écran
• Corriger une facture validée dans Dolibarr 23 et 24 : une facture envoyée par e-mail ne repasse plus en brouillon.