Lors d’une utilisation de Dolibarr ERP/CRM version 23, un incident critique est survenu empêchant l’envoi de factures par email avec pièce jointe. Le problème provenait d’une incohérence entre le code applicatif et la base de données suite à une migration incomplète.

Cet article décrit le diagnostic, les erreurs rencontrées et la solution appliquée.

Symptômes rencontrés

Plusieurs erreurs SQL successives sont apparues lors de l’accès aux fonctionnalités d’envoi d’emails :

• Unknown column 'email_from' in 'field list'
• Unknown column 'email_to'
• Unknown column 'email_tocc'
• Unknown column 'email_tobcc'

Ces erreurs empêchaient :

• l’accès aux modèles d’emails
• l’ouverture du formulaire d’envoi de facture
• l’envoi de factures par email avec pièce jointe

Pages impactées

Deux écrans principaux étaient concernés :

• Administration des modèles d’emails
  /htdocs/admin/mails_templates.php
• Envoi de facture client
  /htdocs/societe/card.php?action=presend

Cause du problème

L’analyse a montré un problème classique dans Dolibarr après mise à jour :

désynchronisation entre le code et la base de données

Origine probable :

• migration Dolibarr 23 incomplète
• scripts SQL de mise à jour non exécutés totalement
• table système llx_c_email_templates partiellement mise à jour

Solution mise en œuvre

La correction a consisté à compléter manuellement la structure de la table :

Table concernée

llx_c_email_templates

Colonnes ajoutées

ALTER TABLE llx_c_email_templates
ADD COLUMN email_from VARCHAR(255) DEFAULT NULL,
ADD COLUMN email_to VARCHAR(255) DEFAULT NULL,
ADD COLUMN email_tocc VARCHAR(255) DEFAULT NULL,
ADD COLUMN email_tobcc VARCHAR(255) DEFAULT NULL,
ADD COLUMN defaultfortype TINYINT(1) NOT NULL DEFAULT 0;

Résultat après correction

Après mise à jour de la structure de la base :

✔ Accès rétabli à l’administration des modèles d’emails
✔ Formulaire d’envoi de facture fonctionnel
✔ Sélection des modèles d’emails opérationnelle
✔ Envoi des factures par email avec pièce jointe rétabli

Résultat fonctionnel clé

Avant correction :

❌ Impossible d’envoyer une facture par email
❌ Erreurs SQL bloquantes sur les champs email

Après correction :

✔ Envoi des factures par email fonctionnel
✔ Pièces jointes PDF correctement envoyées
✔ Interface Dolibarr totalement utilisable

Analyse technique

Ce type d’incident survient généralement lorsque :

• une mise à jour Dolibarr est interrompue
• les fichiers sont mis à jour sans exécuter les migrations SQL
• la base de données n’est pas alignée avec la version du code