**Astuce :** La méthode d’envoi SMTP socket library est recommandée : elle évite les problèmes de compatibilité avec certains serveurs de réception (ex. Orange). Pour les systèmes Linux/BSD avec sendmail, ajoutez mail.force\_extra\_parameters = -ba dans php.ini si des mails ne sont pas reçus, ou définissez la constante MAIN\_FIX\_FOR\_BUGGED\_MTA à 1.
 **Figure 14.2 – Test de disponibilité du serveur SMTP** ### **Configuration du module Export de données** Le module se trouve dans la famille Outils multi-modules.  **Figure 14.3 – Configuration du module Export** ### **Configuration du module Import de données** Le module se trouve dans la famille Outils multi-modules.  **Figure 14.4 – Configuration du module Import — étape 1**  **Figure 14.5 – Configuration du module Import — étape 2** # 14.2 EMailings ### **Créer un nouvel emailing** Les fonctions de mailing sont accessibles depuis le menu Outils. Dans le menu de gauche, sous EMailings, choisissez Nouvel emailing.  **Figure 14.6 – Formulaire de création d’un emailing** Renseignez : - Description — titre qui apparaîtra dans la liste des emailings (ex. Renouvellement cotisation) - De et Errors-to — pré-remplis si vous avez configuré les adresses dans l’administration - Sujet du mail - Couleur de fond — personnalisable via l’outil Color Picker - Contenu de l’email — rédigez avec l’éditeur CKEditor en utilisant les variables de substitution (**\_\_LASTNAME\_\_** pour le Nom, **\_\_FIRSTNAME\_\_** pour le Prénom, etc.) Cliquez sur Créer emailing.  **Figure 14.7 – Choix des destinataires** Allez ensuite sur l’onglet Destinataires et cliquez sur les boutons Ajouter des listes prédéfinies. Exemple : module Adhérents, filtre validé (non à jour), Date fin adhésion entre deux dates, puis Ajouter. Depuis l’onglet Fiche emailing : - Cliquez sur Tester emailing pour un test vers une adresse personnelle - Ou cliquez sur Valider emailing puis sur Envoi emailing pour l’envoi en masse [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/728RmXLiFYf8kN7w-ab4.png) **Figure 14.8 – Envoi de l’emailing****Avertissement :** Seul un mail au statut **validé** peut être envoyé en masse. Pour des raisons de sécurité, l’envoi en masse depuis la ligne de commande est recommandé : php ./scripts/emailings/mailing-send.php
Le statut global du mailing et le résultat de l’envoi pour chaque destinataire sont mis à jour et consultables. ### **Modifier un emailing** Il est possible de cloner un emailing existant depuis la liste des emailings déjà créés et envoyés. Cliquez sur la référence (lien cliquable) puis sur Cloner. Seuls les emailings non validés sont encore modifiables. Le clone d’un emailing peut lui aussi être modifié. ### **Supprimer un emailing** Cliquez sur Supprimer emailing et confirmez. Un emailing peut être supprimé qu’il soit validé ou non. ### **Options cachées**| Constante | Effet |
|---|---|
| MAILING\_LIMIT\_SENDBYWEB | Nombre de mails à envoyer directement sans passer par la ligne de commande |
| MAIN\_MAIL\_DEBUG | Écrit le contenu et l'en-tête du dernier courriel dans dolibarr\_mail.log |
| MAIN\_SMS\_DEBUG | Écrit le contenu des SMS envoyés dans dolibarr\_sms.log |
| MAIN\_MAIL\_ALLOW\_SENDMAIL\_F | Ajoute l'option -f à la commande sendmail pour forcer l'expéditeur |
| MAIN\_MAIL\_SENDMAIL\_FORCE\_BA | Ajoute le paramètre -ba à sendmail pour que le destinataire soit fourni dans le contenu du mail |
| MAIN\_MAIL\_NO\_FULL\_EMAIL | Nettoie les adresses email au format <email> au lieu de Name <email> |
| MAIN\_FIX\_FOR\_BUGGED\_MTA | Corrige les problèmes d'agents MTA qui ajoutent des CR supplémentaires (utile pour Orange, Hotmail…) |
| MAIN\_MAIL\_DO\_NOT\_USE\_SIGN | N'ajoute pas la signature utilisateur à la fin des emails |
| MAIL\_FORCE\_DELIVERY\_RECEIPT\_INVOICE / \_ORDER / \_PROPAL | Force la réception de livraison à « Oui » sur le formulaire d'envoi |
| MAIN\_EMAIL\_USECCC | Affiche le champ BCC dans les formulaires d'email |
| MAIN\_MAIL\_AUTOCOPY\_PROPOSAL\_TO / \_ORDER\_TO / \_INVOICE\_TO | Email à utiliser en BCC lors de l'envoi d'une proposition, commande ou facture |
| Constante | Effet |
|---|---|
| MAIN\_EMAIL\_ADD\_TRACK\_ID | Ajoute un identifiant de suivi dans l'en-tête SMTP pour tracer l'origine des emails |
| MAIN\_INFO\_SOCIETE\_MAIL\_ALIASES | Permet d'utiliser plusieurs identités dans l'origine des emails |
| MAIL\_MAX\_NB\_OF\_RECIPIENTS\_IN\_SAME\_EMAIL | Limite le nombre de destinataires par message (défaut : 10) |
| MAIN\_MAIL\_FORCE\_CONTENT\_TYPE\_TO\_HTML | Force tous les emails en format HTML |
| MAIN\_MAIL\_ADD\_INLINE\_IMAGES\_IF\_IN\_MEDIAS | Remplace les images stockées dans /medias par des images inline dans les emails (attention au risque SPAM) |
| MAIN\_COPY\_FILE\_IN\_EVENT\_AUTO | Ajoute le document en pièce jointe sur les événements générés automatiquement (v6.0+) |
| MAIN\_EXTERNAL\_SMTP\_CLIENT\_IP\_ADDRESS | Adresse IP publique du serveur, affichée dans l'aide de configuration |
| MAIN\_MAIL\_ENABLED\_USER\_DEST\_SELECT | Affiche également les utilisateurs internes dans la liste des destinataires (v8.0+) |
| MAIN\_EMAIL\_SUPPORT\_ACK | Restaure la case à cocher accusé de lecture (fonctionnalité abandonnée) |
| Constante | Valeur substituée |
|---|---|
| \_\_USER\_SIGNATURE\_\_ | Signature de l'utilisateur expéditeur |
| \_\_USER\_ID\_\_ | Identifiant de l'utilisateur |
| \_\_USER\_LOGIN\_\_ | Login de l'utilisateur |
| \_\_USER\_LASTNAME\_\_ | Nom de l'utilisateur |
| \_\_USER\_FIRSTNAME\_\_ | Prénom de l'utilisateur |
| \_\_USER\_FULLNAME\_\_ | Nom complet de l'utilisateur |
| \_\_MYCOMPANY\_NAME\_\_ | Nom de votre société |
| \_\_MYCOMPANY\_EMAIL\_\_ | Email de votre société |
| \_\_MYCOMPANY\_FULLADDRESS\_\_ | Adresse complète de votre société |
| \_\_DAY\_\_ / \_\_DAY\_TEXT\_\_ | Jour (numérique / texte) |
| \_\_MONTH\_\_ / \_\_MONTH\_TEXT\_\_ | Mois (numérique / texte) |
| \_\_YEAR\_\_ | Année |
| \_\_PREVIOUS\_DAY\_\_ / \_\_PREVIOUS\_MONTH\_\_ / \_\_PREVIOUS\_YEAR\_\_ | Jour/mois/année précédent |
| \_\_NEXT\_DAY\_\_ / \_\_NEXT\_MONTH\_\_ / \_\_NEXT\_YEAR\_\_ | Jour/mois/année suivant |
| Constante | Valeur substituée |
|---|---|
| \_\_DOL\_MAIN\_URL\_ROOT\_\_ | URL racine de Dolibarr |
| \_\_(AnyTranslationKey)\_\_ | Traduction de la clé |
| \_\_\[AnyConstantKey\]\_\_ | Valeur de la constante |
| \_\_ID\_\_ | Identifiant de l'enregistrement |
| \_\_EMAIL\_\_ | Email du destinataire |
| \_\_LASTNAME\_\_ / \_\_FIRSTNAME\_\_ | Nom / Prénom du destinataire |
| \_\_CHECK\_READ\_\_ | Lien de suivi d'ouverture de l'email |
| \_\_UNSUBSCRIBE\_\_ | Lien de désinscription |
| \_\_ONLINE\_SIGN\_URL\_\_ | Lien de signature en ligne d'une proposition commerciale |
| Constante | Effet |
|---|---|
| **EXPORT\_CSV\_SEPARATOR\_TO\_USE** | Délimiteur CSV (défaut : ,). Ex. EXPORT\_CSV\_SEPARATOR\_TO\_USE=; |
| **EXPORT\_CSV\_FORCE\_CHARSET** | Encodage du fichier CSV (défaut : UTF-8). Ex. EXPORT\_CSV\_FORCE\_CHARSET=ISO-8859-1 |
| **EXPORTTOOL\_CATEGORIES** | Permet d'exporter des catégories (plusieurs lignes) dans une colonne avec le profil d'exportation produit |
| **USE\_STRICT\_CSV\_RULES** | Utilise le format CSV strict : ne remplace pas CR+LF par \\n mais les cite avec le caractère d'échappement CSV " |
**Astuce :** Téléchargez un exemple vierge en cliquant sur Télécharger un exemple vierge de fichier pour créer votre fichier d'import dans le bon format.
 **Figure 14.15 – Étape 2 — Choix du format de fichier** **Étape 3** — Envoyer le fichier Choisissez le fichier sur votre ordinateur et cliquez sur Ajouter pour l'envoyer sur Dolibarr. Cliquez ensuite sur le pictogramme en fin de ligne.  **Figure 14.16 – Étape 3 — Envoi du fichier** **Étape 4** — Mapper les champs La colonne de gauche affiche les champs du fichier importé ; la colonne de droite affiche les champs Dolibarr. Déplacez les champs par drag and drop (en saisissant la flèche) pour aligner chaque champ du fichier avec le champ Dolibarr correspondant. Les champs à ne pas importer doivent être déplacés sous la ligne Champs du fichier source non importé.**Astuce :** Si un champ du fichier ne correspond à aucun champ Dolibarr, utilisez la ligne Aucun champ en face. En passant la souris sur le point d'interrogation en fin de ligne, vous obtenez les informations sur les valeurs attendues, contraintes et exemples.
 **Figure 14.17 – Étape 4 — Correspondance des champs** **Étape 5** — Simulation puis import Cochez ou décochez Ne pas importer la première ligne du fichier source (si elle contient les en-têtes), puis cliquez sur Lancer la simulation de l'import. La simulation tente d'insérer en base en annulant toutes les opérations à la fin. Un rapport des erreurs est affiché.**Avertissement :** Les erreurs lors de la simulation proviennent souvent de la première ligne si celle-ci correspond aux intitulés des champs. Décochez l'import de la première ligne dans ce cas.
Si aucune erreur n'est détectée, cliquez sur Lancer import final (définitif). Les données importées s'ajoutent aux données existantes.  **Figure 14.18 – Étape 5 — Simulation de l'import**  **Figure 14.19 – Résultat de la simulation**  **Figure 14.20 – Résultat de l'import final****Astuce :** **Pays** : pensez à ajouter une colonne pays avec la valeur 1 (France) car l'import ne met pas de pays par défaut. Traçabilité : toutes les données importées reçoivent le champ import\_key avec la date de l'import. En cas de problème, retrouvez facilement les lignes dans votre éditeur SQL.
### **Options cachées**  **Figure 14.21 – Options cachées de l'import**| Constante | Effet |
|---|---|
| IMPORT\_CSV\_SEPARATOR\_TO\_USE | Délimiteur CSV (défaut : ,). Ex. IMPORT\_CSV\_SEPARATOR\_TO\_USE=; |
| IMPORT\_CSV\_FORCE\_CHARSET | Encodage du fichier CSV (défaut : UTF-8). Ex. IMPORT\_CSV\_FORCE\_CHARSET=ISO-8859-1 |
**Astuce :** Icônes Octicons : vous pouvez utiliser les icônes Octicons au format SVG dans vos modèles de mails ou vos pages web. Dans Configuration > Emails > Modèles des courriels, éditez un modèle, cliquez sur l'icône image dans l'éditeur, puis sur Parcourir le serveur → dossier octicons → choisissez une icône.
 **Figure 14.26 – Octicons disponibles dans la GED — vue 1**  **Figure 14.27 – Octicons disponibles dans la GED — vue 2**