Extraprice

Ce module permet de définir une règle de calcul pour la détermination du prix de vente unitaire (par exemple en prenant des paramètres supplémentaires - extrafields), cette version premium ajoute le paramétrages de valeurs personnalisées par catégories (client et produit)

Présentation

• • Extraprice** est un module permettant de calculer les prix d'un produit en fonction d'un ensemble de paramètres et d'une formule de calcul personnalisables

Pré-requis d'installation

Le module **Extraprice** fonctionne avec Dolibarr à partir de la version 3.5.x et une version de php minimum 5.3.

Il s'installe comme n'importe quel module Dolibarr en décompressant e zip dans le dossier /htdocs/custom.

Préambule – Avant de commencer

Avant de lancer la création d'une formule **d'Extraprice** , il convient d'avoir des notions de langage php et de connaître la structuration des tables de Dolibarr. Si vous n'avez pas ce genre de compétence, vous pouvez nous contactez sur notre site ([www.patas-monkey.fr](http://www.patas-monkey.fr/)) afin que nous vous proposions une prestation d'intégration de ce module selon vos spécifications.

Configuration du module Extraprice de base

La configuration du module **Extraprice** se fait à partir de l'écran d'administration accessible depuis la liste des modules.

Elle permet de saisir la formule de calcul qui sera utilisée pour déterminer les prix de vente unitaires.

Principe de fonctionnement

Il n'est pas possible dans Dolibarr d'avoir un prix conditionné par autre chose que la quantité du produit vendu.

• • Extraprice** permet de modifier, lors de la création des lignes de pièces (commande, facture et proposition commerciale), le prix de vente unitaire.

Pour cela, **Extraprice** utilise :

- des valeurs présentes dans les différentes fiches (client, produit, pièces…) - des valeurs présentes dans des champs supplémentaires (« extrafields ») et en particulier ceux présents sur les lignes de pièces. - Une formule de calcul écrite en php dans le paramétrage du module.

Remarque

La version premium d'extraprice permet d'ajouter des variables aux formules de calculs selon la catégorie cliente ou produit.

Ex : il est possible de créer un coefficient de remise par catégorie client qui sera utilisé pour le calcul final du prix de vente unitaire. il faut pour cela créer des catégories produits, d'affecter sur l'onglet d'extraprice de la catégorie une valeur à une variable (ex $coef=0.55 ) et puis d'utiliser celle-ci dans le calcul final

Saisie d'une formule de calcul

Définition des variables utilisables dans la formule, les variables en rouges ne sont accessibles que dans la version premium (payante) d'extraprice.

| **$newprice** | Prix calculé par la formule | | --- | --- | | **$origineprice** | Prix d'origine du produit | | --- | --- | | **$objectvalue** | Objet contenant les champs supplémentaires associés à la ligne de la pièce

Ex : pour accéder à la valeur définie dans le champ 'lngr',
il faut utiliser la variable $objectvalue['options_longueur'] |

| **$product** | Objet contenant les valeurs associées au produit (référence, description...)Ex : price_min (prix minimum) sera récupéré par la variable $product->price_min Attention : cette objet n'est présent que si il s'agit d'un prix défini à partir d'un produit (pas une saisie libre) | | **$mainelement** | Object contenant les valeurs associées à la pièce (facture, commande, proposition commerciale) | | **$societe** | Objet contenant les valeurs associées à la société de la pièce (le destinataire de la facture) | | **$objet** | Objet contenant les valeurs associées à ligne de la pièce (facture, commande ou propale) | | **$elementextravalue** | Object contenant les champs supplémentaire associé à la pièce (facture, commande, proposition commerciale) | | **$societeextravalue** | Objet contenant les champs supplémentaires associés à la société

Ex : pour accéder à une valeur définie dans le champ "coeff",
il faut utiliser la variable $societeextravalue['options_coeff'] |

| **$productextravalue** | Objet contenant les champs supplémentaires associés au produit

Ex : pour accéder à une valeur définie dans le champ "coeff",
il faut utiliser la variable $productextravalue['options_coeff'] |

Exemple d'utilisation - Détermination du prix d'un produit selon la surface vendue

Un produit a un prix fixé au mètre carré.

Nous ajoutons 2 champs supplémentaires (extrafields) nommés « longueur » et « largeur » correspondant aux dimensions de la surface vendue.

Dans ce cas, le prix de vente du produit correspond au prix au m² multiplié par la longueur et la largeur

Pour un produit à 100 € le mètre carré, si on vend une surface de 50 cm de long par 25 cm de large, le prix sera de 12,50 € l'unité (100 x 0,25 x 0,50)

Il est possible de rajouter un coût spécifique de découpe par produit selon, par exemple, sa matière : plastique, verre…

Dans ce cas, il sera nécessaire de rajouter un « extrafield » sur le produit pour stocker la donnée du coût unitaire de la découpe qui sera ajouté au prix de vente unitaire dans la formule.

Pour un produit à 100 € le mètre carré, et une découpe à 20, si on vend une surface de 50 cm de long par 25 cm de large, le prix sera de 32,50 € l'unité (20 + 100 x 0,25 x 0,50)