Module Ultimateline FR
Sommaire
Informations
| Module name | UltimateLine |
| Editor / Editeur | 
|
| Download or buy page / Page achat ou téléchargement | External module - www.dolistore.com |
| Status / Statut / Estado | Stable |
| Prerequisites / Prérequis | Dolibarr 25.0, PHP 8.2
Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2026-10-3 |
| Note / Nota | ⬆ Retour au sommaire |
Fonctionnalités
UltimateLine ajoute automatiquement une ligne finale (éco-participation, extension de garantie, frais fixes, remise...) juste sous une ligne de produit ou de service, sur les propositions commerciales, commandes et factures. La ligne finale est un service du catalogue, calculé en pourcentage du montant de la ligne parente ou en montant fixe par unité. Un même produit peut déclencher plusieurs lignes finales.
Exemple : un service « Extension de garantie » à 5 % et un service « Eco-contribution DEEE » à 3,50 € par unité, associés à une fenêtre vendue 2 × 389,00 €, ajoutent sous la fenêtre une ligne de 38,90 € et une ligne de 7,00 €.
Comportement dans les documents
- La ligne finale est insérée automatiquement juste en dessous de sa ligne produit parente, avec une quantité de 1 et le taux de TVA du service.
- Elle est recalculée quand la quantité ou le prix de la ligne parente change, et supprimée avec elle.
- Dans l'interface, la ligne finale est indentée et regroupée visuellement avec sa ligne parente.
- Dans les PDF des modèles UltimatePDF, la ligne finale est imprimée avec une icône « └ » qui marque son rattachement à la ligne parente, et une ligne Dont [nom du service] : [montant HT] est ajoutée par service sous le Total HT.
- Avec les modèles standard de Dolibarr (cyan, eratosthene, sponge...), un encadré Dont : sous les totaux indique le total de chaque service de ligne finale, dans la langue du document.
Compatibilité avec le module Milestone
UltimateLine est compatible avec le module Milestone, qui organise les lignes des documents en jalons. Lorsqu'une ligne produit appartient à un jalon :
- dans l'interface, la ligne finale s'affiche à l'intérieur du bloc jalon, juste après sa ligne produit parente, avant le sous-total du jalon ;
- le montant de la ligne finale est intégré au sous-total du jalon ;
- dans les PDF, la ligne finale conserve l'icône « └ » (et non l'icône enfant du jalon) ;
- les conversions proposition → commande, proposition → facture et commande → facture conservent le lien entre la ligne finale et sa ligne produit parente.
Prérequis
- Dolibarr 25.x ;
- PHP 8.2 ou supérieur (testé jusqu'à PHP 8.5) ;
- modules Services et Factures, activés automatiquement avec UltimateLine.
Pour les versions 18 à 24 de Dolibarr, utilisez la version 24.0 du module.
⚙️ Procédure d'installation
⚙️ Installation depuis l'interface
- Allez dans Accueil → Configuration → Modules/Applications, onglet Déployer/Installer un module externe.
- Choisissez le fichier
module_ultimateline-25.0.0.zippuis cliquez sur Envoyer fichier.
⚙️ Installation manuelle
- Télécharger le fichier archive du module (.zip).
- Décompresser le fichier zip :
unzip module_ultimateline-25.0.0.zip -d /tmp/ultimateline_zip - Copier le dossier du module :
cp -r /tmp/ultimateline_zip/htdocs/ultimateline /chemin/vers/dolibarr/htdocs/custom/ - Vérifier que l'emplacement du module est bien
htdocs/custom/ultimateline. - Le module est maintenant disponible et peut être activé depuis Dolibarr.
Mise à jour depuis une version antérieure : remplacez le dossier ultimateline, puis désactivez et réactivez le module. Les services de ligne finale et leurs associations sont conservés.
Configuration
Connecté avec un compte administrateur, allez sur la page Accueil → Configuration → Modules/Applications. Le module apparaît dans la famille AtooNet : cliquez sur le bouton d'activation, puis sur la roue crantée en fin de ligne pour ouvrir la page de configuration du module.
Créez d'abord, dans le module Produits/Services, le ou les services qui serviront de lignes finales (par exemple « Eco-contribution DEEE »). Leur taux de TVA est repris sur les lignes finales.
La page de configuration comporte quatre onglets : Configuration des services de ligne finale, Guide utilisateur, À propos et Journal des modifications.
Guide de démarrage
À la première ouverture, la fenêtre Bienvenue dans UltimateLine ! présente les trois étapes de la mise en route (créer un service de ligne finale, associer des produits au service, consulter le guide d'utilisation) et coche celles qui sont déjà faites. Le lien Ne plus afficher ce guide la masque définitivement.
Définir un service comme de ligne finale
Dans le bloc Définir un service comme de ligne finale :
- Sélectionnez un service à utiliser comme service de ligne finale : choisissez un des services créés précédemment.
- Associé aux produits/services comme : choisissez le type de calcul :
- Taux sur le prix (en pourcentage) : la ligne finale vaut un pourcentage du montant HT de la ligne parente ;
- Montant fixe ajouté au prix : la ligne finale vaut ce montant multiplié par la quantité de la ligne parente.
- Valeur à appliquer : saisissez le pourcentage ou le montant.
- Cliquez sur Affecter.
Associer des produits au service
Dans le bloc Sélection d'un service de ligne finale, choisissez le service dans Sélectionnez un service de ligne finale puis cliquez sur Afficher.
Le panneau Configuration du service de ligne finale affiche la référence, le Libellé du service, le Type du service et la Valeur du service, puis deux listes :
- Produits associés (à gauche) : les produits et services qui déclenchent déjà cette ligne finale ;
- Produits associables (à droite) : les produits et services qui peuvent être ajoutés.
Sélectionnez des produits dans une liste (ou utilisez Sélectionner tout / Tout désélectionner), déplacez-les avec les flèches ← et →, puis cliquez sur Appliquer pour enregistrer.
Sous les listes, Supprimer les associations sélectionnées retire uniquement les produits cochés de la liste des produits associés.
Supprimer un service de ligne finale
Le bouton Supprimer le service ouvre une boîte de confirmation Dolibarr. Après confirmation, le service de ligne finale et toutes ses associations de produits sont supprimés ; le service lui-même reste dans le catalogue.
Pour voir une formation en ligne sur YouTube : https://www.youtube.com/watch?v=OBwRoyuBrPk
Utilisation
- Lorsqu'une ligne produit est ajoutée ou modifiée, les lignes finales correspondantes sont automatiquement créées ou recalculées.
- Lorsqu'une ligne produit est supprimée, ses lignes finales sont supprimées avec elle.
- Les lignes libres (sans produit du catalogue) ne déclenchent aucune ligne finale.
- Conversions : lors de la conversion d'une proposition en commande, d'une proposition en facture ou d'une commande en facture, les lignes sont recopiées telles quelles et restent rattachées à leur ligne produit, sans être ajoutées une seconde fois.
- Avec le module Milestone : les lignes finales restent à l'intérieur de leur bloc jalon après conversion, et leur montant est inclus dans le sous-total du jalon.
Nouveautés de la version 25.0.0
Compatibilité
- Nécessite Dolibarr 25 et PHP 8.2, testé jusqu'à PHP 8.5. La vérification de mise à jour lit
versionmodules/ultimateline/v25/ultimateline.txt.
Corrections
- L'encadré Dont : sous les totaux des modèles PDF standard ne s'imprimait plus : il repère de nouveau les lignes finales, les regroupe par service, utilise la langue et la devise du document et n'est plus imprimé en double avec les modèles UltimatePDF et UltimatePDFLight.
- La suppression d'un service demande une confirmation dans une boîte de dialogue Dolibarr, protégée par un jeton de sécurité.
- Page de configuration : titre de l'onglet du navigateur, feuille de style du module, libellé « Réf. service » et texte de recherche des listes de produits traduits.
Traductions et documentation
- Interface, guide utilisateur et page wiki en français, anglais, allemand, espagnol et italien, avec de nouvelles copies d'écran.
- Bibliothèque Markdown embarquée retirée : Dolibarr affiche lui-même le guide et le journal des modifications.
- Tests automatiques (PHPUnit, PHPStan) et paquet DoliStore allégé.
Versions précédentes
- 24.0.1 (non publiée, intégrée à la 25.0.0) : jeton CSRF sur les formulaires d'administration, onglets Guide utilisateur et Journal des modifications.
- 24.0.0 : version compatible Dolibarr 24.
- Versions 18 à 23 : voir le fichier
ChangeLog.mdlivré avec le module.
FAQ
Aucune ligne finale n'est ajoutée
Vérifiez que le produit figure dans Produits associés du service de ligne finale, et que la ligne utilise bien un produit du catalogue : les lignes libres sont ignorées.
Le montant de la ligne finale semble faux
Vérifiez le type de calcul (pourcentage ou montant fixe) et la valeur affichés dans le panneau Configuration du service de ligne finale. Un montant fixe est multiplié par la quantité de la ligne parente.
Les associations ne sont pas enregistrées
Cliquez sur Appliquer après avoir déplacé des produits d'une liste à l'autre.
Les montants « Dont » apparaissent-ils deux fois sur le PDF ?
Non. Les modèles UltimatePDF et UltimatePDFLight impriment leurs propres lignes « Dont ... » sous le Total HT ; l'encadré Dont : d'UltimateLine n'est ajouté qu'avec les modèles standard de Dolibarr.
Le module modifie-t-il le cœur de Dolibarr ?
Non. UltimateLine fonctionne par triggers et par hooks, sans modifier les fichiers de Dolibarr.