Retenues de garantie : vous cherchez une constante qui n'existe plus
Les constantes citées sur le web pour la retenue de garantie ont été renommées en version 12. Le réglage est aujourd'hui dans les factures de situation.
Vous cherchez à paramétrer la retenue de garantie dans Dolibarr, et vous tombez sur des noms de constantes à saisir dans la configuration avancée. Vous les saisissez : rien ne se passe. C’est normal. Ces noms sont des vestiges, renommés en version 12, en 2020.
Pourquoi le web vous égare
Dolibarr existe depuis longtemps et les réponses de forums restent en ligne indéfiniment. Une réponse de 2018 continue de remonter dans les moteurs de recherche en 2026, alors que le réglage qu’elle décrit a été renommé depuis. Personne n’a menti : le temps a passé.
C’est un piège permanent avec Dolibarr, et il vaut la peine d’avoir le réflexe : avant d’appliquer une réponse trouvée en ligne, regardez sa date, puis regardez si le nom qu’elle cite existe encore dans votre version.
Où est le réglage aujourd’hui
La retenue de garantie n’est pas un réglage isolé : elle vit dans les factures de situation, c’est-à-dire le mécanisme des factures d’avancement de travaux. C’est là qu’il faut aller, dans la configuration du module Factures, et pas dans la liste des constantes.
Une fois les factures de situation activées et réglées, la retenue s’applique dans le cadre prévu, et elle apparaît sur les documents PDF générés — ce qui est bien l’objectif, puisque c’est le document que reçoit le maître d’ouvrage.
Comment cela a été vérifié
- Lecture du code source d’une version 24 : le script de migration qui renomme l’ancienne constante, le modèle de document des situations, et l’écran d’administration des factures de situation.
- Écran de configuration ouvert sur une instance 24, pour confirmer que le réglage s’y trouve bien, et sous quel libellé.
Si vous êtes dans le bâtiment
Factures de situation, retenues de garantie, avancement par lot : ce sont trois sujets sur lesquels Dolibarr demande un vrai paramétrage avant d’être utilisable au quotidien. Une fois réglés, ils tiennent tout seuls. Mal réglés, ils produisent des factures fausses pendant des mois sans que rien ne signale l’erreur. Vérifiez-les sur un cas complet avant de les mettre en production.