Module Ultimateline FR: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
No edit summary
Tag: 2017 source edit
 
(25 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Sommaire=
[[Category:Modules complémentaires]]
[[Category:Modules complémentaires]]
[[Category:Ultimateline]]
[[Category:Ultimateline]]
{{TemplateDocDev}}
{{TemplateDocDev}}
{{TemplateDocUtil}}
{{TemplateDocUtil}}
= Informations =
=Informations=
{{TemplateModuleInfo
{{TemplateModuleInfo
|modulename=UltimateLine
|modulename=UltimateLine
|editor=Atoo.Net
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|web=http://www.atoo-net.com
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateline}}
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateline}}
|status=stable
|status=stable
|prerequisites=
|prerequisites=Dolibarr 25.0, PHP 8.2
|minversion=3.5.0 - 3.5.8
|minversion=25.0.x
|note=
|note=
''[[#Sommaire|⬆ Retour au sommaire]]''
}}
}}


= Fonctionnalités =
=Fonctionnalités=
Permet l'ajout automatique de lignes finales aux propales, commandes et factures lors de l'ajout ou la modification d'une ligne. Il peut gérer plusieurs lignes à ajouter, en fonction de produits ou services définis ensemble ou indépendamment. Particulièrement adapté pour l'automatisation du calcul et de l'ajout de lignes telles que les taxes carbones, les écotaxe, les réductions spécifiques...
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.


= Prérequis =
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 €.
Dolibarr 3.5.x, 3.6.x, 3.7.x, 3.8.x


= Installation =
===Comportement dans les documents===


* Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.
*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.
* Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)
*Elle est recalculée quand la quantité ou le prix de la ligne parente change, et supprimée avec elle.
* Décompressez le fichier par la commande unzip module_ultimateline-3.8.0.zip
*Dans l'interface, la ligne finale est indentée et regroupée visuellement avec sa ligne parente.
L'emplacement correct du module doit être du type : htdocs/custom/ultimateline
*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.


Le module est opérationnel et peut être activé.
===Compatibilité avec le module Milestone===


= Configuration =
UltimateLine est compatible avec le module [[Module_Jalon_FR|Milestone]], qui organise les lignes des documents en jalons. Lorsqu'une ligne produit appartient à un jalon :
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur,
allez sur la page "'''Accueil - Configuration - Modules'''".
Le module apparait dans "Modules principaux/Modules financiers (Compta/trésorerie)", cliquez sur "Activer".
Un pictogramme apparait à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.
Il vous faudra maintenant créer au moins un service dans le module Produits/Services.


Le module est alors opérationnel.  
*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.


== Configuration des services de ligne finale ==
==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.


'''Page de configuration propre au module:'''
Pour les versions 18 à 24 de Dolibarr, utilisez la version 24.0 du module.


[[File:Ultimateline_help-1.png|800px]]
''[[#Sommaire|⬆ Retour au sommaire]]''


Dans la page de configuration dédiée au module:
=⚙️ Procédure d'installation=
- Sélectionnez un service à utiliser comme service de ligne finale en choisissant dans la liste déroulante un des services créés précédemment.


[[File:Ultimateline_help-2.png|800px]]
===⚙️ Installation depuis l'interface===


- Choisissez le type d'action associée ( Taux appliqué sur le prix en %, ou montant fixe ajouté au prix.
#Allez dans '''Accueil → Configuration → Modules/Applications''', onglet '''Déployer/Installer un module externe'''.
#Choisissez le fichier <code>module_ultimateline-25.0.0.zip</code> puis cliquez sur '''Envoyer fichier'''.


[[File:Ultimateline_help-3.png|800px]]
===⚙️ Installation manuelle===


- Renseignez le champ "Valeur à appliquer" par une valeur numérique...puis cliquez sur le bouton affecter.
#'''Télécharger''' le fichier archive du module (.zip).
#'''Décompresser''' le fichier zip : <code>unzip module_ultimateline-25.0.0.zip -d /tmp/ultimateline_zip</code>
#'''Copier''' le dossier du module : <code>cp -r /tmp/ultimateline_zip/htdocs/ultimateline /chemin/vers/dolibarr/htdocs/custom/</code>
#'''Vérifier''' que l'emplacement du module est bien <code>htdocs/custom/ultimateline</code>.
#'''Le module est maintenant disponible''' et peut être activé depuis Dolibarr.


[[File:Ultimateline_help-4.png|800px]]
'''Mise à jour''' depuis une version antérieure : remplacez le dossier <code>ultimateline</code>, puis désactivez et réactivez le module. Les services de ligne finale et leurs associations sont conservés.


- Sélectionnez maintenant votre service de ligne finale qui apparait dans la liste déroulante du bloc suivant. Cliquez sur le bouton "Afficher"
''[[#Sommaire|⬆ Retour au sommaire]]''
=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.


[[File:Ultimateline_help-5.png|800px]]
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.


- Vous pouvez maintenant sélectionner dans la liste des Produits associables, ceux pour lesquels cette règle s'appliquera.
La page de configuration comporte quatre onglets : '''Configuration des services de ligne finale''', '''Guide utilisateur''', '''À propos''' et '''Journal des modifications'''.


[[File:Ultimateline_help-6.png|800px]]
===Guide de démarrage===


- Faites passez les produits sélectionnés d'une colonne à l'autre à l'aide des petites flèches, et cliquez sur appliquer.
[[File:Ultimateline-v25-onboarding-fr.png|center|thumb|800px|Guide de démarrage « Bienvenue dans UltimateLine ! »]]


[[File:Ultimateline_help-7.png|800px]]
À 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.


- Pour voir une formation en ligne:[[https://www.youtube.com/watch?v=OBwRoyuBrPk]]
==Définir un service comme de ligne finale==


== Onglet Options ==
[[File:Ultimateline-v25-settings-fr.png|center|thumb|800px|Onglet Configuration des services de ligne finale]]


[[File:Ultimatepdf_help-6.png|800px]]
Dans le bloc '''Définir un service comme de ligne finale''' :


Vous pouvez gérer ici les fonctionnalités suivantes :
#'''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'''.


'''Règles de fabrication des zones d'adresses''':
==Associer des produits au service==


- Afficher les coordonnées téléphonique, fax et email si adresse d'un contact utilisée
[[File:Ultimateline-v25-details-fr.png|center|thumb|800px|Configuration du service de ligne finale et produits associés]]


- Masquer le numéro de TVA intracommunautaire dans les blocs d'adresse
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'''.


'''Règle de fabrication des colonnes''':
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 :


- Afficher la colonne référence
*'''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.


- Masquer la colonne et les montants de TVA.
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.


- Masquer la description longue dans la colonne description.
Sous les listes, '''Supprimer les associations sélectionnées''' retire uniquement les produits cochés de la liste des produits associés.


- Masquer les références dans la colonne description.
==Supprimer un service de ligne finale==


- Masquer toutes les données dans les colonnes suivants la description ( TVA, Prix public, Qté, Remise, Total).
[[File:Ultimateline-v25-confirm-delete-fr.png|center|thumb|800px|Confirmation de la suppression d'un service de ligne finale]]


- Masquer les montants HT.
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.


- Masquer les Quantités.
Pour voir une formation en ligne sur YouTube : [https://www.youtube.com/watch?v=OBwRoyuBrPk https://www.youtube.com/watch?v=OBwRoyuBrPk]


- Masquer les montants TTC
''[[#Sommaire|⬆ Retour au sommaire]]''
=Utilisation=


'''Réglages divers'''
[[File:Ultimateline-v25-propal-fr.png|center|thumb|800px|Lignes finales ajoutées sous chaque produit d'une proposition commerciale]]
- ''Les réglages peuvent maintenant être faits indépendamment dans les propositions commerciales, les commandes, les factures et les expéditions''


- Ajouter une ligne pointillée entre les lignes de produits/services.
*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.


- Afficher une marque de pliage au tiers de la page
[[File:Ultimateline-v25-pdf-fr.png|center|thumb|800px|PDF (modèle ultimate_propal) : lignes finales et lignes « Dont » sous le Total HT]]


- Afficher les vignettes photos des produits dans vos Propales
''[[#Sommaire|⬆ Retour au sommaire]]''
=Nouveautés de la version 25.0.0=


- Afficher les vignettes photos des produits dans vos Commandes
===Compatibilité===
*Nécessite '''Dolibarr 25''' et '''PHP 8.2''', testé jusqu'à PHP 8.5. La vérification de mise à jour lit <code>versionmodules/ultimateline/v25/ultimateline.txt</code>.


- Afficher les vignettes photos des produits dans vos Factures
===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.


- Ne pas répéter l'entête s'il y a plusieurs pages
===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é.


- Afficher un autre logo que le logo de la société.
==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 <code>ChangeLog.md</code> livré avec le module.


- Affichez une image de fond sur vos documents.
=FAQ=


- Afficher le bloc : " Bon pour accord "
===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.


- Afficher la signature du représentant en charge dans le bloc note publique.
===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.


- Masquer la partie RIB du compte bancaire.
===Les associations ne sont pas enregistrées===
Cliquez sur '''Appliquer''' après avoir déplacé des produits d'une liste à l'autre.


- Afficher le code-barres du Tiers dans les Propales, Commandes, Expéditions et Factures.
===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.


- Afficher le QR-code du Tiers dans les Propales, Commandes, Factures et expéditions.
===Le module modifie-t-il le cœur de Dolibarr ?===
Non. UltimateLine fonctionne par triggers et par hooks, sans modifier les fichiers de Dolibarr.


- Afficher la mention : "Auto-liquidation régime de la sous-traitance"
=Autres langues=


- Afficher ou masquer les colonnes LS et LR sur les bons d'expédition.
* [[Module_Ultimateline_EN|English documentation for the UltimateLine module]]
 
* [[Module_Ultimateline_DE|Deutsche Dokumentation für das Modul UltimateLine]]
- Ajouter et fusionner un ou plusieurs pdf à vos Propales, Factures ou Commandes.
* [[Module_Ultimateline_ES|Documentación en español del módulo UltimateLine]]
 
* [[Module_Ultimateline_IT|Documentazione in italiano del modulo UltimateLine]]
- Ajouter une ligne personnalisée à l'aide des dictionnaires et des extrafields dans vos Propales, Factures ou Commandes.
 
- Choisir le compte bancaire à afficher sur les factures.
 
== Onglet Propositions commerciales ==
 
[[File:Ultimatepdf_help-7.png|800px]]
 
- Les réglages peuvent maintenant être faits indépendamment dans les propositions commerciales
 
== Onglet Commandes ==
 
[[File:Ultimatepdf_help-8.png|800px]]
 
- Les réglages peuvent maintenant être faits indépendamment dans les commandes
 
== Onglet Factures ==
 
[[File:Ultimatepdf_help-9.png|800px]]
- Les réglages peuvent maintenant être faits indépendamment dans les factures
 
== Onglet Expéditions ==
 
[[File:Ultimatepdf_help-10.png|800px]]
 
- Les réglages peuvent maintenant être faits indépendamment dans les expéditions
 
== Onglet Commande fournisseur ==
 
[[File:Ultimatepdf_help-11.png|800px]]
 
- Les réglages peuvent maintenant être faits indépendamment dans les Commandes fournisseur
 
== Onglet Facture fournisseur ==
 
 
[[File:Ultimatepdf_help-12.png|800px]]
 
- Les réglages peuvent maintenant être faits indépendamment dans les factures fournisseur
 
== Onglet Contrats ==
 
[[File:Ultimatepdf_help-13.png|800px]]
 
- Les réglages peuvent maintenant être faits indépendamment dans les contrats
 
= Utilisation =
Utilisation facile, en quelques clics vos documents sont à vos couleurs et chacun de vos collaborateurs peut avoir ses documents personnalisés.
 
= Compatibilité et Synergies =
 
UltimatePdf est compatible avec :
- Le module Milestone/Jalon
- Le module de Gestion des unités de vente et d'achat (Affiche les résultats dans une colonne unités sur tous les modèles)
- Le module Incoterm
 
= Développement =
Ultimatepdf est un module suivi sur le Git de Framasoft :
https://git.framasoft.org/grandoc/ultimatepdf

Latest revision as of 08:54, 3 October 2026

Sommaire

Informations


Module name UltimateLine
Editor / Editeur Logo atoonet.jpg
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.

⬆ Retour au sommaire

⚙️ Procédure d'installation

⚙️ Installation depuis l'interface

  1. Allez dans Accueil → Configuration → Modules/Applications, onglet Déployer/Installer un module externe.
  2. Choisissez le fichier module_ultimateline-25.0.0.zip puis cliquez sur Envoyer fichier.

⚙️ Installation manuelle

  1. Télécharger le fichier archive du module (.zip).
  2. Décompresser le fichier zip : unzip module_ultimateline-25.0.0.zip -d /tmp/ultimateline_zip
  3. Copier le dossier du module : cp -r /tmp/ultimateline_zip/htdocs/ultimateline /chemin/vers/dolibarr/htdocs/custom/
  4. Vérifier que l'emplacement du module est bien htdocs/custom/ultimateline.
  5. 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.

⬆ Retour au sommaire

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

Guide de démarrage « Bienvenue dans UltimateLine ! »

À 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

Onglet Configuration des services de ligne finale

Dans le bloc Définir un service comme de ligne finale :

  1. Sélectionnez un service à utiliser comme service de ligne finale : choisissez un des services créés précédemment.
  2. 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.
  3. Valeur à appliquer : saisissez le pourcentage ou le montant.
  4. Cliquez sur Affecter.

Associer des produits au service

Configuration du service de ligne finale et produits associés

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

Confirmation de la suppression d'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

⬆ Retour au sommaire

Utilisation

Lignes finales ajoutées sous chaque produit d'une proposition commerciale
  • 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.
PDF (modèle ultimate_propal) : lignes finales et lignes « Dont » sous le Total HT

⬆ Retour au sommaire

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.md livré 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.

Autres langues