Module Ultimateline FR: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
Tag: 2017 source edit
No edit summary
Tag: 2017 source edit
 
Line 10: Line 10:
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateline}}
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateline}}
|status=stable
|status=stable
|prerequisites=
|prerequisites=Dolibarr 25.0, PHP 8.2
|minversion=18.0.x - 24.0.x
|minversion=25.0.x
|note=
|note=
''[[#Sommaire|⬆ Retour au sommaire]]''
''[[#Sommaire|⬆ Retour au sommaire]]''
Line 17: Line 17:


=Fonctionnalités=
=Fonctionnalités=
Permet l'ajout automatique de lignes de service en tant que sous-lignes (lignes filles) d'une ligne produit dans les propales, commandes et factures, lors de l'ajout ou de la modification d'une ligne produit. Le module peut gérer plusieurs services à ajouter simultanément, chacun pouvant être calculé en pourcentage du montant de la ligne parente ou en montant fixe. Particulièrement adapté pour l'automatisation du calcul et de l'ajout de lignes telles que les taxes carbone, les écotaxes, 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.
 
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===
===Comportement dans les documents===


*La ligne de service est insérée automatiquement juste en dessous de sa ligne produit parente.
*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.
*Dans l'interface utilisateur, la ligne de service est indentée et regroupée visuellement avec sa ligne parente.
*Elle est recalculée quand la quantité ou le prix de la ligne parente change, et supprimée avec elle.
*Dans les PDF générés par le module UltimatePDF, la ligne de service est affichée avec une icône "└" pour marquer son rattachement à la ligne parente.
*Dans l'interface, la ligne finale est indentée et regroupée visuellement avec sa ligne parente.
*Dans le bloc des totaux des PDF, une ligne informative '''dont [nom du service]<span> </span>: [montant HT]''' est automatiquement ajoutée sous le Total HT, avec le même style visuel que les lignes TVA.
*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.
[[File:UltimateLine_demo_06-22.0.png|800px]]


===Compatibilité avec le module Milestone===
===Compatibilité avec le module Milestone===


UltimateLine est compatible avec le module [[Module_Jalon_FR|Milestone]], qui permet d'organiser les lignes de documents en jalons (sections). Lorsqu'une ligne produit appartient à un jalon, sa ligne de service UltimateLine est rendue correctement<span> </span>:
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 :


*Dans l'interface, la ligne de service s'affiche à l'intérieur du bloc jalon, juste après sa ligne produit parente, avant le sous-total du 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 de service est intégré dans le calcul du sous-total du jalon.
*le montant de la ligne finale est intégré au sous-total du jalon ;
*Dans les PDF, la ligne de service conserve l'icône "└" (et non l'icône enfant du jalon).
*dans les PDF, la ligne finale conserve l'icône « └ » (et non l'icône enfant du jalon) ;
*Les workflows de conversion '''propale → commande''', '''propale → facture''' et '''commande → facture''' maintiennent correctement le lien entre la ligne de service et sa ligne produit parente.
*les conversions '''proposition → commande''', '''proposition → facture''' et '''commande → facture''' conservent le lien entre la ligne finale et sa ligne produit parente.


==Prérequis==
==Prérequis==
'''Dolibarr<span> </span>:''' Versions supportées<span> </span>:
*'''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.


*'''20.x'''
''[[#Sommaire|⬆ Retour au sommaire]]''
*'''21.x'''
*'''22.x'''
*'''23.x'''
*'''24.x'''


=⚙️ Procédure d'installation=
=⚙️ Procédure d'installation=
===⚙️ Installation depuis l'interface===
#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'''.


===⚙️ Installation manuelle===
===⚙️ Installation manuelle===


#'''Télécharger''' le fichier archive du module (.zip).
#'''Télécharger''' le fichier archive du module (.zip).
#'''Placer''' le fichier dans le répertoire racine de Dolibarr.
#'''Décompresser''' le fichier zip : <code>unzip module_ultimateline-25.0.0.zip -d /tmp/ultimateline_zip</code>
#'''Décompresser''' le fichier zip avec la commande<span> </span>:
#'''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.
 
'''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.
 
''[[#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.


<code>unzip module_ultimateline-X.0.0.zip</code>
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.


#'''Vérifier''' que l'emplacement correct du module est<span> </span>:
La page de configuration comporte quatre onglets : '''Configuration des services de ligne finale''', '''Guide utilisateur''', '''À propos''' et '''Journal des modifications'''.


<code>htdocs/custom/ultimateline</code>
===Guide de démarrage===


#'''Le module est maintenant disponible''' et peut être activé depuis Dolibarr.
[[File:Ultimateline-v25-onboarding-fr.png|center|thumb|800px|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==
 
[[File:Ultimateline-v25-settings-fr.png|center|thumb|800px|Onglet Configuration des services 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==
 
[[File:Ultimateline-v25-details-fr.png|center|thumb|800px|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 :


''[[#Sommaire|⬆ Retour au sommaire]]''
*'''Produits associés''' (à gauche) : les produits et services qui déclenchent déjà cette ligne finale ;
=Configuration=
*'''Produits associables''' (à droite) : les produits et services qui peuvent être ajoutés.
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.
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.


==Configuration des services de ligne finale==
Sous les listes, '''Supprimer les associations sélectionnées''' retire uniquement les produits cochés de la liste des produits associés.


'''Page de configuration propre au module:'''
==Supprimer un service de ligne finale==


[[File:UltimateLine_demo_01-22.0.png|800px]]
[[File:Ultimateline-v25-confirm-delete-fr.png|center|thumb|800px|Confirmation de la suppression d'un service de ligne finale]]


Dans la page de configuration dédiée au module<span> </span>:
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.
- 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_demo_02-22.0.png|800px]]
Pour voir une formation en ligne sur YouTube : [https://www.youtube.com/watch?v=OBwRoyuBrPk https://www.youtube.com/watch?v=OBwRoyuBrPk]


- Choisissez le type d'action associée (taux appliqué sur le prix en %, ou montant fixe ajouté au prix).
''[[#Sommaire|⬆ Retour au sommaire]]''
=Utilisation=


[[File:Ultimateline_help-3.png|800px]]
[[File:Ultimateline-v25-propal-fr.png|center|thumb|800px|Lignes finales ajoutées sous chaque produit d'une proposition commerciale]]


- Renseignez le champ "Valeur à appliquer" par une valeur numérique... puis cliquez sur le bouton affecter.
*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.


[[File:Ultimateline_help-4.png|800px]]
[[File:Ultimateline-v25-pdf-fr.png|center|thumb|800px|PDF (modèle ultimate_propal) : lignes finales et lignes « Dont » sous le Total HT]]


- 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]]''
=Nouveautés de la version 25.0.0=


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


- Vous pouvez maintenant sélectionner dans la liste des Produits associables, ceux pour lesquels cette règle s'appliquera.
===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.


[[File:UltimateLine_demo_03-22.0.png|800px]]
===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é.


- Faites passer les produits sélectionnés d'une colonne à l'autre à l'aide des petites flèches, et cliquez sur appliquer.
==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.


[[File:UltimateLine_demo_04-22.0.png|800px]]
=FAQ=


[[File:UltimateLine_demo_05-22.0.png|800px]]
===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.


- Pour voir une formation en ligne sur Youtube<span> </span>: [[https://www.youtube.com/watch?v=OBwRoyuBrPk]]
===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.


=Utilisation=
===Les associations ne sont pas enregistrées===
Cliquez sur '''Appliquer''' après avoir déplacé des produits d'une liste à l'autre.


- Lorsqu'une ligne produit est '''ajoutée ou modifiée''', la ligne de service correspondante est automatiquement créée ou recalculée.
===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.


- Lorsqu'une ligne produit est '''supprimée''', sa ligne de service rattachée est automatiquement supprimée avec elle.
===Le module modifie-t-il le cœur de Dolibarr ?===
Non. UltimateLine fonctionne par triggers et par hooks, sans modifier les fichiers de Dolibarr.


- '''Workflows'''<span> </span>: Lors de la conversion d'une propale en commande, d'une propale en facture, ou d'une commande en facture, les lignes de service sont automatiquement rattachées à leur ligne produit parente dans le nouveau document. Aucune intervention manuelle n'est nécessaire.
=Autres langues=


- '''Avec le module Milestone'''<span> </span>: Les lignes de service restent correctement positionnées à l'intérieur de leur bloc jalon après conversion, et leur montant est inclus dans le sous-total du jalon.
* [[Module_Ultimateline_EN|English documentation for the UltimateLine module]]
* [[Module_Ultimateline_DE|Deutsche Dokumentation für das Modul UltimateLine]]
* [[Module_Ultimateline_ES|Documentación en español del módulo UltimateLine]]
* [[Module_Ultimateline_IT|Documentazione in italiano del modulo UltimateLine]]

Navigation menu