Dolibarr ERP CRM Wiki - User contributions [en]

Module Prix dynamiques

2025-07-09T21:32:11Z

Ted75: /* Exemples de formules fonctionnelles */

[[en:Module_Dynamic_Prices]]


[[Category:Prix Dynamiques]]
{{TemplateDocUtil}}
{{TemplateModFR}}
{{BasculeDevUser|
nom=Prix Dynamiques|
num=2200|
devdoc=[[Module Prix Dynamiques (développeur)]]|
userdoc=Cette page|}}

=Introduction=
Ce module permet d'avoir un prix de produit qui se calcule dynamiquement au moment de l'ajout du produit dans un un document (devis, commande, facture,).

=Installation=
{{NoInstallModuleFr}}

Par contre, ce module étant au statut expérimental, pour pouvoir l'utiliser, il est nécessaire d'activer '''MAIN_FEATURES_LEVEL=1''' dans Accueil -> Configuration -> Divers :

Level of features to show:

*-1 = stable + deprecated
*0 = stable only (default)
*'''1 = stable + experimental'''
*2 = stable + experimental + development

Attention, des bugs peuvent être présents.

=Configuration=
{{ActivationModuleFr}}

=Utilisation=

Reconnaissons-le, c'est probablement le module le plus cryptique de Dolibarr. Mais il a titillé votre curiosité, car vous sentez bien qu'il peut faire des choses très particulières...

Et c'est le cas en effet : le concept est de calculer le prix unitaire en fonction des paramètres du produit. Exemple type : une barre en acier dont le prix sera calculé au mètre (information entrée sur le devis/commande/facture) mais indexé sur un prix au volume (ou au poids, ce qui revient au même).

Mais comment qu'on fait ? Il faut déjà accéder à l'éditeur d'expression de prix (la formule, quoi). Pour cela, une fois le module activé, se rendre sur le produit concerné, puis l'onglet "prix de vente" et demander à modifier le prix par défaut, on a alors le bouton "Editeur d'expression de prix" tant attendu.

On clique dessus et pis si la formule a déjà été rentrée, on la sélectionne, sinon, on choisit 'Nouveau', on lui donne un nom et on tape la formule (qui peut se faire sur plusieurs lignes pour des calculs intermédiaires).

Là bien sûr on pleure un peu car si le dictionnaire des calculs est simple (caractères standards =*/+-), il faut encore connaître les noms des variables d'intérêt qui sont les champs de l'objet produit concerné (classe Product, oui il faut aller voir le code). Autant dire que si cette fonctionnalité vous intéresse, ou vous avez du temps, ou il est raisonnable de faire appel à un prestataire Dolibarr...

Le calcul doit commencer par un price=, cependant ne rien indiquer fonctionne aussi.

Exemple, indexer le prix de vente sur le coût de revient :

price = #global_coefvente# * #cost_price#

où #global_coefvente# fait référence à la variable coefvente définie dans la configuration du module, tandis que #cost_price# est le champ du produit définissant son prix de revient (défini manuellement dans l'onglet prix d'achat du produit). Remplacer par #pmp# si vous préférez le prix moyen pondéré. Vous aurez compris que # encadrant un nom de variable se réfère à un paramètre du produit, sauf s'il commence par global_ où il se réfère à un paramètre configuré pour le module.

Ce module est donc très puissant. Il ne lui manque que la gestion des tests conditionnels (accessible en remplaçant la librairie support evalmath par celle de Moodle (https://github.com/moodle/moodle/blob/master/lib/evalmath/evalmath.class.php)). Lorsque les calculs deviennent complexes (en tout cas longs et verbeux), il peut également être utile de modifier le champ expression de la table llx_c_price_expression qui a une longueur maximale de 80 caractères par défaut.

==Opérateurs==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
|+
!
!
! colspan="2" |Fonctionne dans :
!
|-
!Caractère
!Rôle
!Editeur d'expression de prix
!Attributs supplémentaires
!Exemple
|-
|price =
|A toujours placer au début de l'expression (correspond à la variable calculée).
En alternative, ne rien indiquer fonctionne aussi.
|X
|
|price = #supplier_min_price#
<nowiki>#</nowiki>supplier_min_price#
|-
|'''#'''nomvar'''#'''
|Pour signaler une variable où nomvar est le nom de la variable dans le code (à placer au début et à la fin du nom de variable sans espace)
|X
|
|#supplier_min_price#
|-
| +
|Addition
|X
|X
|3 + 2
|-
| -
|Soustraction
|X
|X
|3 - 2
|-
|*
|Multiplication
|X
|X
|3 * 2
|-
|/
|Division
|X
|X
|3 / 2
|-
|( )
|Parenthèses à utiliser pour la priorité entre multiplication et addition.
|X
|X
|(2+3)*2
|-
|( )
|Parenthèses à utiliser autour d'une condition pour la délimiter si elle est imbriquée dans une autre condition.
|
|X
|($object->weight > 0 ? 20 : 0 ) > 0 ? 'jaune' : 'rouge'
|-
|'''$'''nomtable'''->'''nomvar
|A utiliser si la variable nomvar est dans une table nomtable du code pouvant être appelée (ex : Attributs supplémentaires du module Produits)
|
|X
|$object->weight
|-
|;
|Pour séparer les expressions s'il y en a plusieurs dans la même formule
|
|X
|
|-
|A + B
|"OU" logique (la condition A ou la condition B ou les deux doivent être vrais)
|
|X
|isset($object->weight) && $object->weight > 0
|-
|A && B
|"ET" logique (les conditions A et B doivent être vraies)
|
|X
|
|-
|A == B
|Egalité logique (A doit être égal à B pour valider la condition)
|
|X
|
|-
|A > B
|A doit être strictement plus grand que B
|
|X
|
|-
|A < B
|A doit être strictement plus petit que B
|
|X
|
|-
|X ? Y : Z
|Equivaut respectivement au "then" et au "else" de l'expression "if X then Y else Z".
|
|X
|$object->weight > 0 ? 20 : 0
|}

==Fonctions==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
|+
!Fonction
!Rôle
!Exemple
|-
|X ? Y : Z
|If X Then Y Else Z : si la condition X est satisfaite, appliquer Y, sinon appliquer Z.
|weight > 0 ? 2 * weight : 0 (si le poids est supérieur à zéro, renvoyer deux fois le poids, sinon renvoyer zéro).
|-
|isset(X)
|Vérifie si la variable X a une valeur définie.
|Si Poids = "" et Volume = 500 mL, le poids n'a pas de valeur définie -> isset(Poids) = 0.
|-
|round(X,2)
|Arrondit la variable X à 2 chiffres après la virgule.
|round(2.564,2) = 2.56
|}

==Liste des variables utilisables==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
|+
!Nom de la variable dans le code
!Chemin IHM correspondant
!Onglet IHM correspondant
!Champ IHM correspondant
!Testé dans la version Dolibarr
|-
|#global_NOMVARIABLE#
|Accueil -> Configuration -> Modules/Applications
|PRIX CALCULES DYN.
|Variable globale NOMVARIABLE
|v20.0.2
|-
|#supplier_min_price#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Prix quantité min.
|v20.0.2
|-
|#supplier_min_price_with_discount#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Prix quantité min. * ( 1 - Remise pour cette qté. )
|v20.0.2
|-
|#pmp#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Prix moyen pondéré (PMP)
|v20.0.2
|-
|#supplier_quantity#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Qté achat minimum
|v20.0.2
|-
|#supplier_tva_tx#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Taux TVA (pour ce produit/fournisseur)
|v20.0.2
|-
|#tva_tx#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix de vente
|Taux de taxe par défaut
|v20.0.2
|-
|#weight#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Produit
|Poids
|v20.0.2
|-
|#localtax1_tx#
|Factures -> Factures fournisseur -> Liste -> choisir une facture
|Facture fournisseur
|Montant TVA calculé dans le Mode 1
|v20.0.2
|-
|#localtax2_tx#
|Factures -> Factures fournisseur -> Liste -> choisir une facture
|Facture fournisseur
|Montant TVA calculé dans le Mode 2
|v20.0.2
|}

==Liste des variables en erreur==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
!Nom de la variable dans le code
!Chemin IHM correspondant
!Onglet IHM correspondant
!Champ IHM correspondant
!Testé dans la version Dolibarr
|-
|#cost_price#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Prix de revient
|Erreur inconnue '24' en v20.0.2
|-
|#price_min#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix de vente
|Prix min
|Erreur inconnue '24' en v20.0.2
|-
|#length#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Produit
|Longueur
|Erreur inconnue '24' en v20.0.2
|-
|#surface#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Produit
|Surface
|Erreur inconnue '24' en v20.0.2
|}

==Exemples de formules fonctionnelles==
Ne pas hésiter à compléter la liste.

'''Note importante''' : pour le calcul d'un prix TTC, il ne faut pas ajouter la TVA dans le calcul, car la multiplication est déjà faite implicitement par Dolibarr (on multiplierait sinon deux fois par la TVA).
{| class="wikitable"
|+
!Formule
!Chemin IHM correspondant
!Onglet IHM correspondant
!Champ IHM correspondant
!Usage
!Testé dans la version Dolibarr
|-
|price = #supplier_min_price_with_discount# * #global_coefvente#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix de vente
|Modifier prix par défaut -> Editeur d'expression de prix
|Calcul du prix de vente TTC à partir du prix d'achat HT, de la remise produit, de la marge globale et de la TVA.
|v20.0.2
|-
|price = #supplier_min_price# * #global_coefvente#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix de vente
|Modifier prix par défaut -> Editeur d'expression de prix
|Calcul du prix de vente TTC à partir du prix d'achat HT, de la marge globale et de la TVA.
|v20.0.2
|-
|price = #cost_price# * #global_coefvente#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix de vente
|Modifier prix par défaut -> Editeur d'expression de prix
|Calcul du prix de vente TTC à partir du prix de revient, de la marge globale et de la TVA.
|v20.0.2
|-
|isset($object->weight) && $object->weight > 0 ?
round($object->price_ttc / ($object->weight_units == '-3' ? $object->weight / 1000 : $object->weight), 2) :

(isset($object->volume) && $object->volume > 0 ?

round($object->price_ttc / ($object->volume_units == '0' ? $object->volume / 1000 : $object->volume), 2) :

0)
|Accueil -> Configuration -> Modules/Applications -> PRODUITS
|Attributs supplémentaires
|Nouvel attribut
|Cette formule calcule le Prix au kg ou au L du produit. Elle permet de gérer si le produit est solide (au poids) ou liquide (au volume), gère aussi si l’unité est g (-3) ou kg (0), ou bien millilitre (0) ou litre (98), et fait un arrondi à 2 chiffres après la virgule.
|v20.0.2
|}

==Limitations==
Lorsque le prix d'achat HT est modifié (par exemple suite à une évolution tarifaire), dans Dolibarr v19.0.2 et v20.0.2 on peut constater que :

*le prix de vente TTC dans l'onglet Prix de vente du produit se recalcule bien
*le prix de vente TTC dans la liste des produits, dans les commandes en cours et dans les nouvelles commandes ne se recalcule pas.

Pour provoquer le recalcul, il faut manuellement, sur chaque produit dont le prix d'achat change, aller dans Prix de vente -> Modifier prix par défaut -> cliquer sur Enregistrer sans rien changer.

Une évolution du module pour prendre en compte ce recalcul serait la bienvenue.

Module Prix dynamiques

2025-07-08T18:08:39Z

Ted75: Ajout des opérateurs et fonctions connus

[[en:Mahnwesen]]


[[Category:Prix Dynamiques]]
{{TemplateDocUtil}}
{{TemplateModFR}}
{{BasculeDevUser|
nom=Prix Dynamiques|
num=2200|
devdoc=[[Module Prix Dynamiques (développeur)]]|
userdoc=Cette page|}}

=Introduction=
Ce module est expérimental. Pour pouvoir l'utiliser, il est nécessaire d'activer '''MAIN_FEATURES_LEVEL=2''' dans Accueil -> Configuration -> Divers :

Level of features to show:

*-1 = stable + deprecated
*0 = stable only (default)
*1 = stable + experimental
*'''2 = stable + experimental + development'''

Attention, des bugs peuvent être présents.

=Installation=
{{NoInstallModuleFr}}

=Configuration=
{{ActivationModuleFr}}

=Utilisation=

Reconnaissons-le, c'est probablement le module le plus cryptique de Dolibarr. Mais il a titillé votre curiosité, car vous sentez bien qu'il peut faire des choses très particulières...

Et c'est le cas en effet : le concept est de calculer le prix unitaire en fonction des paramètres du produit. Exemple type : une barre en acier dont le prix sera calculé au mètre (information entrée sur le devis/commande/facture) mais indexé sur un prix au volume (ou au poids, ce qui revient au même).

Mais comment qu'on fait ? Il faut déjà accéder à l'éditeur d'expression de prix (la formule, quoi). Pour cela, une fois le module activé, se rendre sur le produit concerné, puis l'onglet "prix de vente" et demander à modifier le prix par défaut, on a alors le bouton "Editeur d'expression de prix" tant attendu.

On clique dessus et pis si la formule a déjà été rentrée, on la sélectionne, sinon, on choisit 'Nouveau', on lui donne un nom et on tape la formule (qui peut se faire sur plusieurs lignes pour des calculs intermédiaires).

Là bien sûr on pleure un peu car si le dictionnaire des calculs est simple (caractères standards =*/+-), il faut encore connaître les noms des variables d'intérêt qui sont les champs de l'objet produit concerné (classe Product, oui il faut aller voir le code). Autant dire que si cette fonctionnalité vous intéresse, ou vous avez du temps, ou il est raisonnable de faire appel à un prestataire Dolibarr...

Le calcul doit commencer par un price=, cependant ne rien indiquer fonctionne aussi.

Exemple, indexer le prix de vente sur le coût de revient :

price = #global_coefvente# * #cost_price#

où #global_coefvente# fait référence à la variable coefvente définie dans la configuration du module, tandis que #cost_price# est le champ du produit définissant son prix de revient (défini manuellement dans l'onglet prix d'achat du produit). Remplacer par #pmp# si vous préférez le prix moyen pondéré. Vous aurez compris que # encadrant un nom de variable se réfère à un paramètre du produit, sauf s'il commence par global_ où il se réfère à un paramètre configuré pour le module.

Ce module est donc très puissant. Il ne lui manque que la gestion des tests conditionnels (accessible en remplaçant la librairie support evalmath par celle de Moodle (https://github.com/moodle/moodle/blob/master/lib/evalmath/evalmath.class.php)). Lorsque les calculs deviennent complexes (en tout cas longs et verbeux), il peut également être utile de modifier le champ expression de la table llx_c_price_expression qui a une longueur maximale de 80 caractères par défaut.

==Opérateurs==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
|+
!
!
! colspan="2" |Fonctionne dans :
!
|-
!Caractère
!Rôle
!Editeur d'expression de prix
!Attributs supplémentaires
!Exemple
|-
|price =
|A toujours placer au début de l'expression (correspond à la variable calculée).
En alternative, ne rien indiquer fonctionne aussi.
|X
|
|price = #supplier_min_price#
<nowiki>#</nowiki>supplier_min_price#
|-
|'''#'''nomvar'''#'''
|Pour signaler une variable où nomvar est le nom de la variable dans le code (à placer au début et à la fin du nom de variable sans espace)
|X
|
|#supplier_min_price#
|-
| +
|Addition
|X
|X
|3 + 2
|-
| -
|Soustraction
|X
|X
|3 - 2
|-
|*
|Multiplication
|X
|X
|3 * 2
|-
|/
|Division
|X
|X
|3 / 2
|-
|( )
|Parenthèses à utiliser pour la priorité entre multiplication et addition.
|X
|X
|(2+3)*2
|-
|( )
|Parenthèses à utiliser autour d'une condition pour la délimiter si elle est imbriquée dans une autre condition.
|
|X
|($object->weight > 0 ? 20 : 0 ) > 0 ? 'jaune' : 'rouge'
|-
|'''$'''nomtable'''->'''nomvar
|A utiliser si la variable nomvar est dans une table nomtable du code pouvant être appelée (ex : Attributs supplémentaires du module Produits)
|
|X
|$object->weight
|-
|;
|Pour séparer les expressions s'il y en a plusieurs dans la même formule
|
|X
|
|-
|A + B
|"OU" logique (la condition A ou la condition B ou les deux doivent être vrais)
|
|X
|isset($object->weight) && $object->weight > 0
|-
|A && B
|"ET" logique (les conditions A et B doivent être vraies)
|
|X
|
|-
|A == B
|Egalité logique (A doit être égal à B pour valider la condition)
|
|X
|
|-
|A > B
|A doit être strictement plus grand que B
|
|X
|
|-
|A < B
|A doit être strictement plus petit que B
|
|X
|
|-
|X ? Y : Z
|Equivaut respectivement au "then" et au "else" de l'expression "if X then Y else Z".
|
|X
|$object->weight > 0 ? 20 : 0
|}

== Fonctions ==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
|+
!Fonction
!Rôle
!Exemple
|-
|X ? Y : Z
|If X Then Y Else Z : si la condition X est satisfaite, appliquer Y, sinon appliquer Z.
|weight > 0 ? 2 * weight : 0 (si le poids est supérieur à zéro, renvoyer deux fois le poids, sinon renvoyer zéro).
|-
|isset(X)
|Vérifie si la variable X a une valeur définie.
|Si Poids = "" et Volume = 500 mL, le poids n'a pas de valeur définie -> isset(Poids) = 0.
|-
|round(X,2)
|Arrondit la variable X à 2 chiffres après la virgule.
|round(2.564,2) = 2.56
|}

==Liste des variables utilisables==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
|+
!Nom de la variable dans le code
!Chemin IHM correspondant
!Onglet IHM correspondant
!Champ IHM correspondant
!Testé dans la version Dolibarr
|-
|#global_NOMVARIABLE#
|Accueil -> Configuration -> Modules/Applications
|PRIX CALCULES DYN.
|Variable globale NOMVARIABLE
|v20.0.2
|-
|#supplier_min_price#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Prix quantité min.
|v20.0.2
|-
|#supplier_min_price_with_discount#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Prix quantité min. * ( 1 - Remise pour cette qté. )
|v20.0.2
|-
|#pmp#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Prix moyen pondéré (PMP)
|v20.0.2
|-
|#supplier_quantity#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Qté achat minimum
|v20.0.2
|-
|#supplier_tva_tx#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Taux TVA (pour ce produit/fournisseur)
|v20.0.2
|-
|#tva_tx#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix de vente
|Taux de taxe par défaut
|v20.0.2
|-
|#weight#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Produit
|Poids
|v20.0.2
|-
|#localtax1_tx#
|Factures -> Factures fournisseur -> Liste -> choisir une facture
|Facture fournisseur
|Montant TVA calculé dans le Mode 1
|v20.0.2
|-
|#localtax2_tx#
|Factures -> Factures fournisseur -> Liste -> choisir une facture
|Facture fournisseur
|Montant TVA calculé dans le Mode 2
|v20.0.2
|}

==Liste des variables en erreur==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
!Nom de la variable dans le code
!Chemin IHM correspondant
!Onglet IHM correspondant
!Champ IHM correspondant
!Testé dans la version Dolibarr
|-
|#cost_price#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix d'achat
|Prix de revient
|Erreur inconnue '24' en v20.0.2
|-
|#price_min#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix de vente
|Prix min
|Erreur inconnue '24' en v20.0.2
|-
|#length#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Produit
|Longueur
|Erreur inconnue '24' en v20.0.2
|-
|#surface#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Produit
|Surface
|Erreur inconnue '24' en v20.0.2
|}

==Exemples de formules fonctionnelles==
Ne pas hésiter à compléter la liste.

'''Note importante''' : pour le calcul d'un prix TTC, il ne faut pas ajouter la TVA dans le calcul, car la multiplication est déjà faite implicitement par Dolibarr (on multiplierait sinon deux fois par la TVA).
{| class="wikitable"
|+
!Formule
!Chemin IHM correspondant
!Onglet IHM correspondant
!Champ IHM correspondant
!Usage
!Testé dans la version Dolibarr
|-
|price = #supplier_min_price_with_discount# * #global_coefvente#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix de vente
|Modifier prix par défaut -> Editeur d'expression de prix
|Calcul du prix de vente TTC à partir du prix d'achat HT, de la remise produit, de la marge globale et de la TVA.
|v20.0.2
|-
|price = #supplier_min_price# * #global_coefvente#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix de vente
|Modifier prix par défaut -> Editeur d'expression de prix
|Calcul du prix de vente TTC à partir du prix d'achat HT, de la marge globale et de la TVA.
|v20.0.2
|-
|price = #cost_price# * #global_coefvente#
|<nowiki>Produits | Services -> Produits -> Liste -> choisir le produit</nowiki>
|Prix de vente
|Modifier prix par défaut -> Editeur d'expression de prix
|Calcul du prix de vente TTC à partir du prix de revient, de la marge globale et de la TVA.
|v20.0.2
|-
|isset($object->weight) && $object->weight > 0 ?
round($object->price_ttc / ($object->weight_units == '-3' ? $object->weight / 1000 : $object->weight), 2) :

(isset($object->volume) && $object->volume > 0 ?

round($object->price_ttc / ($object->volume_units == '0' ? $object->volume / 1000 : $object->volume), 2) :

0)
|Accueil -> Configuration -> Modules/Applications -> PRODUITS
|Attributs supplémentaires
|Nouvel attribut
|Cette formule calcule le Prix au kg ou au L du produit. Elle permet de gérer si le produit est solide (au poids) ou liquide (au volume), gère aussi si l’unité est g (-3) ou kg (0), ou bien millilitre (0) ou litre (98), et fait un arrondi à 2 chiffre après la virgule.
|v20.0.2
|}

==Limitations==
Lorsque le prix d'achat HT est modifié (par exemple suite à une évolution tarifaire), dans Dolibarr v19.0.2 et v20.0.2 on peut constater que :

*le prix de vente TTC dans l'onglet Prix de vente du produit se recalcule bien
*le prix de vente TTC dans la liste des produits, dans les commandes en cours et dans les nouvelles commandes ne se recalcule pas.

Pour provoquer le recalcul, il faut manuellement, sur chaque produit dont le prix d'achat change, aller dans Prix de vente -> Modifier prix par défaut -> cliquer sur Enregistrer sans rien changer.

Une évolution du module pour prendre en compte ce recalcul serait la bienvenue.
{{ToComplete}}

Module Prix dynamiques

2025-07-08T16:43:37Z

Ted75: /* Exemples de formules fonctionnelles */

Module Prix dynamiques

2025-07-08T16:42:34Z

Ted75: /* Utilisation */

[[en:Mahnwesen]]


[[Category:Prix Dynamiques]]
{{TemplateDocUtil}}
{{TemplateModFR}}
{{BasculeDevUser|
nom=Prix Dynamiques|
num=2200|
devdoc=[[Module Prix Dynamiques (développeur)]]|
userdoc=Cette page|}}

=Introduction=
Ce module est expérimental. Pour pouvoir l'utiliser, il est nécessaire d'activer '''MAIN_FEATURES_LEVEL=2''' dans Accueil -> Configuration -> Divers :

Level of features to show:

*-1 = stable + deprecated
*0 = stable only (default)
*1 = stable + experimental
*'''2 = stable + experimental + development'''

Attention, des bugs peuvent être présents.

=Installation=
{{NoInstallModuleFr}}

=Configuration=
{{ActivationModuleFr}}

=Utilisation=

Reconnaissons-le, c'est probablement le module le plus cryptique de Dolibarr. Mais il a titillé votre curiosité, car vous sentez bien qu'il peut faire des choses très particulières...

Et c'est le cas en effet : le concept est de calculer le prix unitaire en fonction des paramètres du produit. Exemple type : une barre en acier dont le prix sera calculé au mètre (information entrée sur le devis/commande/facture) mais indexé sur un prix au volume (ou au poids, ce qui revient au même).

Mais comment qu'on fait ? Il faut déjà accéder à l'éditeur d'expression de prix (la formule, quoi). Pour cela, une fois le module activé, se rendre sur le produit concerné, puis l'onglet "prix de vente" et demander à modifier le prix par défaut, on a alors le bouton "Editeur d'expression de prix" tant attendu.

On clique dessus et pis si la formule a déjà été rentrée, on la sélectionne, sinon, on choisit 'Nouveau', on lui donne un nom et on tape la formule (qui peut se faire sur plusieurs lignes pour des calculs intermédiaires).

Là bien sûr on pleure un peu car si le dictionnaire des calculs est simple (caractères standards =*/+-), il faut encore connaître les noms des variables d'intérêt qui sont les champs de l'objet produit concerné (classe Product, oui il faut aller voir le code). Autant dire que si cette fonctionnalité vous intéresse, ou vous avez du temps, ou il est raisonnable de faire appel à un prestataire Dolibarr...

Le calcul doit commencer par un price=, cependant ne rien indiquer fonctionne aussi.

Exemple, indexer le prix de vente sur le coût de revient :

price = #global_coefvente# * #cost_price#

où #global_coefvente# fait référence à la variable coefvente définie dans la configuration du module, tandis que #cost_price# est le champ du produit définissant son prix de revient (défini manuellement dans l'onglet prix d'achat du produit). Remplacer par #pmp# si vous préférez le prix moyen pondéré. Vous aurez compris que # encadrant un nom de variable se réfère à un paramètre du produit, sauf s'il commence par global_ où il se réfère à un paramètre configuré pour le module.

Ce module est donc très puissant. Il ne lui manque que la gestion des tests conditionnels (accessible en remplaçant la librairie support evalmath par celle de Moodle (https://github.com/moodle/moodle/blob/master/lib/evalmath/evalmath.class.php)). Lorsque les calculs deviennent complexes (en tout cas longs et verbeux), il peut également être utile de modifier le champ expression de la table llx_c_price_expression qui a une longueur maximale de 80 caractères par défaut.

==Règles syntaxiques==
{| class="wikitable"
|+
!Caractère
!Rôle
|-
|price =
|A toujours placer au début de l'expression (correspond à la variable calculée).
En alternative, ne rien indiquer fonctionne aussi.
|-
|#
|Pour signaler une variable (à placer au début et à la fin du nom de variable sans espace)
|-
|*
|Multiplication
|-
|/
|Division
|-
| +
|Addition
|-
| -
|Soustraction
|-
|;
|Pour séparer les expressions s'il y en a plusieurs dans la même formule
|}

==Liste des variables utilisables==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
|+
!Nom de la variable dans le code
!Chemin IHM correspondant
!Onglet IHM correspondant
!Champ IHM correspondant
!Testé dans la version Dolibarr
|-
|#global_NOMVARIABLE#
|Accueil -> Configuration -> Modules/Applications
|PRIX CALCULES DYN.
|Variable globale NOMVARIABLE
|v20.0.2
|-
|#supplier_min_price#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Prix quantité min.
|v20.0.2
|-
|#supplier_min_price_with_discount#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Prix quantité min. * ( 1 - Remise pour cette qté. )
|v20.0.2
|-
|#pmp#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Prix moyen pondéré (PMP)
|v20.0.2
|-
|#supplier_quantity#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Qté achat minimum
|v20.0.2
|-
|#supplier_tva_tx#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Taux TVA (pour ce produit/fournisseur)
|v20.0.2
|-
|#tva_tx#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix de vente
|Taux de taxe par défaut
|v20.0.2
|-
|#weight#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Produit
|Poids
|v20.0.2
|-
|#localtax1_tx#
|Factures -> Factures fournisseur -> Liste -> choisir une facture
|Facture fournisseur
|Montant TVA calculé dans le Mode 1
|v20.0.2
|-
|#localtax2_tx#
|Factures -> Factures fournisseur -> Liste -> choisir une facture
|Facture fournisseur
|Montant TVA calculé dans le Mode 2
|v20.0.2
|}

==Liste des variables en erreur==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
!Nom de la variable dans le code
!Chemin IHM correspondant
!Onglet IHM correspondant
!Champ IHM correspondant
!Testé dans la version Dolibarr
|-
|#cost_price#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Prix de revient
|Erreur inconnue '24' en v20.0.2
|-
|#price_min#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix de vente
|Prix min
|Erreur inconnue '24' en v20.0.2
|-
|#length#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Produit
|Longueur
|Erreur inconnue '24' en v20.0.2
|-
|#surface#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Produit
|Surface
|Erreur inconnue '24' en v20.0.2
|}

==Exemples de formules fonctionnelles==
Ne pas hésiter à compléter la liste.

'''Note importante''' : pour le calcul d'un prix TTC, il ne faut pas ajouter la TVA dans le calcul, car la multiplication est déjà faite implicitement par Dolibarr (on multiplierait sinon deux fois par la TVA).
{| class="wikitable"
|+
!Formule
!Usage
!Testé dans la version Dolibarr
|-
|price = #supplier_min_price_with_discount# * #global_coefvente#
|Calcul du prix de vente TTC à partir du prix d'achat HT, de la remise produit, de la marge globale et de la TVA.
|v20.0.2
|-
|price = #supplier_min_price# * #global_coefvente#
|Calcul du prix de vente TTC à partir du prix d'achat HT, de la marge globale et de la TVA.
|v20.0.2
|-
|price = #cost_price# * #global_coefvente#
|Calcul du prix de vente TTC à partir du prix de revient, de la marge globale et de la TVA.
|v20.0.2
|-
|price = #pmp# * #cost_price#
|Calcul du prix de vente TTC à partir du prix moyen pondéré, de la marge globale et de la TVA.
|Erreur inconnue '24' en v20.0.2
|}

==Limitations==
Lorsque le prix d'achat HT est modifié (par exemple suite à une évolution tarifaire), dans Dolibarr v19.0.2 et v20.0.2 on peut constater que :

*le prix de vente TTC dans l'onglet Prix de vente du produit se recalcule bien
*le prix de vente TTC dans la liste des produits, dans les commandes en cours et dans les nouvelles commandes ne se recalcule pas.

Pour provoquer le recalcul, il faut manuellement, sur chaque produit dont le prix d'achat change, aller dans Prix de vente -> Modifier prix par défaut -> cliquer sur Enregistrer sans rien changer.

Une évolution du module pour prendre en compte ce recalcul serait la bienvenue.
{{ToComplete}}

Module Prix dynamiques

2025-07-08T16:41:24Z

Ted75: /* Règles syntaxiques */

[[en:Mahnwesen]]


[[Category:Prix Dynamiques]]
{{TemplateDocUtil}}
{{TemplateModFR}}
{{BasculeDevUser|
nom=Prix Dynamiques|
num=2200|
devdoc=[[Module Prix Dynamiques (développeur)]]|
userdoc=Cette page|}}

=Introduction=
Ce module est expérimental. Pour pouvoir l'utiliser, il est nécessaire d'activer '''MAIN_FEATURES_LEVEL=2''' dans Accueil -> Configuration -> Divers :

Level of features to show:

*-1 = stable + deprecated
*0 = stable only (default)
*1 = stable + experimental
*'''2 = stable + experimental + development'''

Attention, des bugs peuvent être présents.

=Installation=
{{NoInstallModuleFr}}

=Configuration=
{{ActivationModuleFr}}

=Utilisation=

Reconnaissons-le, c'est probablement le module le plus cryptique de Dolibarr. Mais il a titillé votre curiosité, car vous sentez bien qu'il peut faire des choses très particulières...

Et c'est le cas en effet : le concept est de calculer le prix unitaire en fonction des paramètres du produit. Exemple type : une barre en acier dont le prix sera calculé au mètre (information entrée sur le devis/commande/facture) mais indexé sur un prix au volume (ou au poids, ce qui revient au même).

Mais comment qu'on fait ? Il faut déjà accéder à l'éditeur d'expression de prix (la formule, quoi). Pour cela, une fois le module activé, se rendre sur le produit concerné, puis l'onglet "prix de vente" et demander à modifier le prix par défaut, on a alors le bouton "Editeur d'expression de prix" tant attendu.

On clique dessus et pis si la formule a déjà été rentrée, on la sélectionne, sinon, on choisit 'Nouveau', on lui donne un nom et on tape la formule (qui peut se faire sur plusieurs lignes pour des calculs intermédiaires).

Là bien sûr on pleure un peu car si le dictionnaire des calculs est simple (caractères standards =*/+-), il faut encore connaître les noms des variables d'intérêt qui sont les champs de l'objet produit concerné (classe Product, oui il faut aller voir le code). Autant dire que si cette fonctionnalité vous intéresse, ou vous avez du temps, ou il est raisonnable de faire appel à un prestataire Dolibarr...

Mais en gros le calcul doit finir par un price=

Exemple, indexer le prix de vente sur le coût de revient :
price=#global_coefvente#*#cost_price#

où #global_coefvente# fait référence à la variable coefvente définie dans la configuration du module, tandis que #cost_price# est le champ du produit définissant son prix de revient (défini manuellement dans l'onglet prix d'achat du produit). Remplacer par #pmp# si vous préférez le prix moyen pondéré. Vous aurez compris que # encadrant un nom de variable se réfère à un paramètre du produit, sauf s'il commence par global_ où il se réfère à un paramètre configuré pour le module.

Ce module est donc très puissant. Il ne lui manque que la gestion des tests conditionnels (accessible en remplaçant la librairie support evalmath par celle de Moodle (https://github.com/moodle/moodle/blob/master/lib/evalmath/evalmath.class.php)). Lorsque les calculs deviennent complexes (en tout cas longs et verbeux), il peut également être utile de modifier le champ expression de la table llx_c_price_expression qui a une longueur maximale de 80 caractères par défaut.

==Règles syntaxiques==
{| class="wikitable"
|+
!Caractère
!Rôle
|-
|price =
|A toujours placer au début de l'expression (correspond à la variable calculée).
En alternative, ne rien indiquer fonctionne aussi.
|-
|#
|Pour signaler une variable (à placer au début et à la fin du nom de variable sans espace)
|-
|*
|Multiplication
|-
|/
|Division
|-
| +
|Addition
|-
| -
|Soustraction
|-
|;
|Pour séparer les expressions s'il y en a plusieurs dans la même formule
|}

==Liste des variables utilisables==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
|+
!Nom de la variable dans le code
!Chemin IHM correspondant
!Onglet IHM correspondant
!Champ IHM correspondant
!Testé dans la version Dolibarr
|-
|#global_NOMVARIABLE#
|Accueil -> Configuration -> Modules/Applications
|PRIX CALCULES DYN.
|Variable globale NOMVARIABLE
|v20.0.2
|-
|#supplier_min_price#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Prix quantité min.
|v20.0.2
|-
|#supplier_min_price_with_discount#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Prix quantité min. * ( 1 - Remise pour cette qté. )
|v20.0.2
|-
|#pmp#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Prix moyen pondéré (PMP)
|v20.0.2
|-
|#supplier_quantity#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Qté achat minimum
|v20.0.2
|-
|#supplier_tva_tx#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Taux TVA (pour ce produit/fournisseur)
|v20.0.2
|-
|#tva_tx#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix de vente
|Taux de taxe par défaut
|v20.0.2
|-
|#weight#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Produit
|Poids
|v20.0.2
|-
|#localtax1_tx#
|Factures -> Factures fournisseur -> Liste -> choisir une facture
|Facture fournisseur
|Montant TVA calculé dans le Mode 1
|v20.0.2
|-
|#localtax2_tx#
|Factures -> Factures fournisseur -> Liste -> choisir une facture
|Facture fournisseur
|Montant TVA calculé dans le Mode 2
|v20.0.2
|}

==Liste des variables en erreur==
Ne pas hésiter à compléter la liste.
{| class="wikitable"
!Nom de la variable dans le code
!Chemin IHM correspondant
!Onglet IHM correspondant
!Champ IHM correspondant
!Testé dans la version Dolibarr
|-
|#cost_price#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix d'achat
|Prix de revient
|Erreur inconnue '24' en v20.0.2
|-
|#price_min#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Prix de vente
|Prix min
|Erreur inconnue '24' en v20.0.2
|-
|#length#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Produit
|Longueur
|Erreur inconnue '24' en v20.0.2
|-
|#surface#
|<nowiki>Produits | Services -> Produit -> choisir le produit</nowiki>
|Produit
|Surface
|Erreur inconnue '24' en v20.0.2
|}

==Exemples de formules fonctionnelles==
Ne pas hésiter à compléter la liste.

'''Note importante''' : pour le calcul d'un prix TTC, il ne faut pas ajouter la TVA dans le calcul, car la multiplication est déjà faite implicitement par Dolibarr (on multiplierait sinon deux fois par la TVA).
{| class="wikitable"
|+
!Formule
!Usage
!Testé dans la version Dolibarr
|-
|price = #supplier_min_price_with_discount# * #global_coefvente#
|Calcul du prix de vente TTC à partir du prix d'achat HT, de la remise produit, de la marge globale et de la TVA.
|v20.0.2
|-
|price = #supplier_min_price# * #global_coefvente#
|Calcul du prix de vente TTC à partir du prix d'achat HT, de la marge globale et de la TVA.
|v20.0.2
|-
|price = #cost_price# * #global_coefvente#
|Calcul du prix de vente TTC à partir du prix de revient, de la marge globale et de la TVA.
|v20.0.2
|-
|price = #pmp# * #cost_price#
|Calcul du prix de vente TTC à partir du prix moyen pondéré, de la marge globale et de la TVA.
|Erreur inconnue '24' en v20.0.2
|}

==Limitations==
Lorsque le prix d'achat HT est modifié (par exemple suite à une évolution tarifaire), dans Dolibarr v19.0.2 et v20.0.2 on peut constater que :

*le prix de vente TTC dans l'onglet Prix de vente du produit se recalcule bien
*le prix de vente TTC dans la liste des produits, dans les commandes en cours et dans les nouvelles commandes ne se recalcule pas.

Pour provoquer le recalcul, il faut manuellement, sur chaque produit dont le prix d'achat change, aller dans Prix de vente -> Modifier prix par défaut -> cliquer sur Enregistrer sans rien changer.

Une évolution du module pour prendre en compte ce recalcul serait la bienvenue.
{{ToComplete}}

Module Prix dynamiques

2025-07-08T16:33:52Z

Ted75: /* Liste des variables utilisables */

Module Prix dynamiques

2025-07-08T16:31:55Z

Ted75: Ajout de variables utilisables et précision des variables en erreur

Module Prix dynamiques

2025-07-08T16:02:37Z

Ted75: /* Limitations */

Module Prix dynamiques

2025-07-08T16:01:02Z

Ted75: /* Exemples de formules fonctionnelles */

Module Prix dynamiques

2025-07-08T15:59:23Z

Ted75: /* Exemples de formules fonctionnelles */

Module Prix dynamiques

2025-07-08T15:55:14Z

Ted75:

Module Prix dynamiques

2025-07-08T15:53:49Z

Ted75: /* Exemples de formules fonctionnelles */

Module Prix dynamiques

2025-07-08T15:53:28Z

Ted75: Précision d'une limitation

Module Prix dynamiques

2025-07-08T15:34:36Z

Ted75: Ajout des noms de variables dans le code et de quelques exemples fonctionnels

File:Accueil - Configuration - Divers.png

2025-07-08T15:02:29Z

Ted75:

Accueil - Configuration - Divers