Après une mise à jour de Dolibarr, ce qui change pour vous (21 à 24)
Chiffre d'affaires différent après la mise à jour, facture qui ne repasse plus en brouillon, champ disparu : les changements de comportement de Dolibarr 22, 23 et 24 qui surprennent les utilisateurs, testés version par version, avec le réglage qui rétablit l'ancien fonctionnement quand il existe.
Besoin qu’on regarde votre instance ? Diagnostic, prix fixe 90 €.
Ce qui a été vérifié (versions, tests, code lu)
Tests du 04/11/2026 sur des installations neuves de Dolibarr 21.0.4, 22.0.5, 23.0.4 et 24.0.2 (images Docker officielles, MariaDB 11.4, société française) : facture du 15 octobre payée le 4 novembre, rapports de chiffre d'affaires et de résultat ouverts sans rien régler ; retour en brouillon d'une facture envoyée par e-mail et d'une facture dont le PDF a été ouvert. Valeur par défaut du mode de calcul relue dans le code (conf.class.php) de la 21.0.4 et de la 22.0.5. Les autres points renvoient à des guides testés auparavant.
Après une mise à jour, certains écrans ne se comportent plus comme avant, sans message d’erreur. Le cas le plus parlant du forum : un utilisateur passé de la 16 à la 22 a cru avoir perdu des données, parce que son chiffre d’affaires n’était plus le même (fil « Données perdues après MAJ »). Rien n’était perdu : le mode de calcul par défaut avait changé.
Ce guide ne liste que ces changements de comportement, visibles au quotidien, testés le 4 novembre 2026 sur des installations neuves de chaque version. Pour la méthode de mise à jour et les changements qui touchent les modules, voir Mettre à jour Dolibarr sans rien casser.
En bref
| Version | Ce qui change | Revenir à l’ancien fonctionnement |
|---|---|---|
| 22 | Chiffre d’affaires et résultat calculés par date de facture au lieu de la date d’encaissement | Oui, un réglage |
| 23 | Une facture envoyée par e-mail ne repasse plus en brouillon | Non : avoir + nouvelle facture |
| 23.0.x | Avec les journaux inaltérables, ouvrir le PDF suffit à bloquer la facture | Corrigé en 24.0.2 |
| 23 | La case « Privé » disparaît des modèles d’e-mail | Corrigé en 24.0.2 |
| 23 | Champs calculés : certaines fonctions refusées | Une liste blanche dans conf.php |
| 24 | La civilité (M., Mme) disparaît des fiches contact | Oui, une constante |
| 24 | Envoi automatique des factures récurrentes par e-mail | Nouveauté |
22 : le chiffre d’affaires passe à la date de facture
Le test. Une facture de 1 000 € HT (1 200 € TTC) datée du 15 octobre, payée le 4 novembre. On ouvre les rapports sans rien régler, sur une installation neuve où le mode de calcul n’a jamais été enregistré :
| Version | Rapport proposé par défaut | Octobre | Novembre |
|---|---|---|---|
| 21.0.4 | « Chiffre d’affaires encaissé » (date de paiement) | rien | 1 200 € TTC |
| 22.0.5 et 23.0.4 | « Chiffre d’affaires facturé » (date de facture) | 1 000 € HT | rien |
| 24.0.2 | « Revenus facturés » (date de facture) | 1 000 € HT | rien |
La page ComptabilitéRapportsRésultat / Exercice suit le même réglage. En 24.0.2, elle coche « Analyse des documents enregistrés connus » :
Pourquoi. Dans le code, la valeur par défaut du réglage ACCOUNTING_MODE est passée de « recettes-dépenses »
(encaissements) en 21 à « créances-dettes » (factures) en 22. Elle ne joue que si le réglage n’a jamais été
enregistré, ce qui est le cas de beaucoup d’installations anciennes.
Revenir aux encaissements. Ouvrez la page Configuration du module Comptabilité (AccueilConfigurationModules, réglages du module « Comptabilité (simplifié) »), choisissez Option Encaissements-Décaissements et enregistrez. Testé en 22.0.5, 23.0.4 et 24.0.2 : la facture d’octobre repasse en novembre dans le résultat et dans le chiffre d’affaires. Pour un coup d’œil ponctuel, le menu Rapports propose aussi les deux vues côte à côte : Revenus facturés et Recettes perçues (libellés de la 24.0.2).
Les libellés de cet écran sont trompeurs en 24.0.2 : l’option par date de facture s’appelle « Option Recettes-Dépenses ». Fiez-vous à la description à droite de chaque option.
23 : une facture envoyée ne repasse plus en brouillon
Testé : en 22.0.5, une facture validée puis envoyée par e-mail depuis Dolibarr repasse encore en brouillon avec Modifier. En 23.0.4 et 24.0.2, le clic est refusé (« Désactivé car facture a déjà été envoyé par e-mail au moins une fois »). Un paiement bloque aussi, en 22, 23 et 24.
En 23.0.4, avec le module Journaux inaltérables activé, un simple aperçu ou téléchargement du PDF suffit à bloquer. Ce n’est plus le cas en 24.0.2.
La correction passe par un avoir puis une nouvelle facture : la marche à suivre est dans Corriger une facture validée dans Dolibarr 23 et 24.
23 : deux changements déjà détaillés sur ce site
- Modèles d’e-mail : la colonne « Privé » a disparu de l’écran, mais le réglage agit toujours. Corrigé en 24.0.2. Voir le champ « Privé » des modèles de courriel.
- Champs calculés : certaines fonctions et la concaténation sont refusées. Voir champ calculé refusé depuis Dolibarr 23.
24 : la civilité disparaît, l’envoi automatique arrive
- Civilité des contacts : le champ M., Mme… n’est plus affiché sur les fiches contact. Une constante le rétablit :
le champ civilité a disparu des contacts. Tant qu’il est masqué, la
variable de modèle d’e-mail
__CONTACT_TITLE_BILLING__reste vide. - Factures récurrentes : un modèle de facture récurrente peut maintenant envoyer chaque facture générée par e-mail, avec un modèle d’e-mail au choix. Ce réglage n’existe pas en 23.0.4. L’e-mail part au contact facturation, sinon à l’adresse du client : voir les modèles d’e-mail dans Dolibarr.
Avant de mettre à jour
Rejouez la mise à jour sur une copie, puis comparez trois écrans avec la version actuelle : le rapport de chiffre d’affaires d’un mois passé, une facture validée (essayez Modifier) et l’envoi d’une facture par e-mail. Ce sont les trois endroits où les changements ci-dessus se voient. L’outil Votre chemin de mise à jour donne les étapes depuis votre version.
Comment cela a été vérifié
Le 4 novembre 2026, sur des installations neuves de Dolibarr 21.0.4, 22.0.5, 23.0.4 et 24.0.2 (images Docker
officielles, MariaDB 11.4, société française, interface en français), pilotées par un navigateur comme un
utilisateur : la même facture d’octobre payée en novembre, puis les rapports « chiffre d’affaires » et « résultat »
ouverts sans paramètre ; le retour en brouillon d’une facture envoyée par e-mail (vrai envoi vers un serveur de test),
et d’une facture dont le PDF a été ouvert, avec et sans les journaux inaltérables. La valeur par défaut
d’ACCOUNTING_MODE a été relue dans le code de la 21.0.4 et de la 22.0.5 ; le réglage d’envoi des factures
récurrentes a été cherché dans le code de la 23.0.4 et de la 24.0.2. Les changements « Privé », champs calculés et
civilité renvoient à des guides testés en octobre 2026. Une vraie migration d’une base ancienne n’a pas été rejouée
pour ce guide.
À lire aussi
Questions fréquentes
Pourquoi mon chiffre d'affaires Dolibarr a changé après la mise à jour en version 22 ?
Depuis la version 22, si le mode de calcul n'a jamais été enregistré, Dolibarr calcule le chiffre d'affaires par date de facture, et non plus par date d'encaissement. Une facture d'octobre payée en novembre compte donc en octobre, et non plus en novembre. Rien n'est perdu : choisissez « Option Encaissements-Décaissements » dans les réglages du module Comptabilité, ou ouvrez le rapport « Recettes perçues ».
Pourquoi ma facture ne repasse plus en brouillon depuis Dolibarr 23 ?
Depuis la 23, une facture validée déjà envoyée par e-mail depuis Dolibarr ne peut plus repasser en brouillon ; en 22.0.5, elle le pouvait. On la corrige par un avoir puis une nouvelle facture.