Exporter des traductions

Configuration

Groupe

Langue

Format

Exporter pour une traduction hors-ligne

Exporter au format natif

Exporter au format CSV

<languages/>
<div lang="fr" dir="ltr" class="mw-content-ltr">
{| class="wikitable" 
|- style="vertical-align:top;" 
| [[File:Extraprice250x250.jpg]]
| 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)
|}
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
== Présentation ==
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
'''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
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
== Pré-requis d'installation ==
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Le module '''Extraprice''' fonctionne avec Dolibarr à partir de la version 3.5.x et une version de php minimum 5.3.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Il s'installe comme n'importe quel module Dolibarr en décompressant le fichier zip dans le dossier /htdocs/custom.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
== Préambule – Avant de commencer ==
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
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&#39;intégration de ce module selon vos spécifications.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
{{Note| Attention: La version 20.0.0 de Dolibarr contient une anomalie qui génère une erreur de calcul sur la TVA quand on utilise le bouton de recalcul des prix. Ce problème se règle en réalisant une mise à jour de dolibarr vers une version postérieur (20.0.4 ou 21.xx, ...) |warn}}
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
== Configuration du module Extraprice ==
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
La configuration du module '''Extraprice''' se fait à partir de l'écran d'administration accessible depuis la liste des modules.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
[[File:Extraprice-setting.png |900px]]
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
La première zone de saisie permet de paramétrer la formule de calcul qui sera utilisée pour déterminer les prix de vente unitaires.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Autre fonctionnalité du module, il est possible de définir un ou plusieurs produit/service pour saisir la TVA pour les société de transport
|}
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
== Fonctionnement du calcul du prix dynamique ==
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Il n'est pas possible dans Dolibarr d'avoir un prix conditionné par autre chose que la quantité du produit vendu.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
'''Extraprice''' permet de modifier, lors de la création des lignes de pièces (commande, facture et proposition commerciale), le prix de vente unitaire.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Pour cela, '''Extraprice''' utilise :
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
- 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.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:250px;" | '''Options en paramétrage du module'''
! style="vertical-align:top; width:250px;" | '''Résultat sur facture'''
|-
| style="vertical-align:top;" |
[[File:Extraprice-exemple_php_line_request.png |250px]]
| style="vertical-align:top;" |
[[File:Extraprice-exemple_result.png |250px]]
|}
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
=== Remarque ===
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
La version premium d'extraprice permet d'ajouter des variables aux formules de calculs selon la catégorie cliente ou produit.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
=== Saisie d'une formule de calcul ===
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Définition des variables utilisables dans la formule d'extraprice.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
{| class="wikitable" 
|- style="vertical-align:top;" 
| '''$newprice''' 
| Prix calculé par la formule 
|- style="vertical-align:top;" 
| '''$origineprice''' 
|  Prix d'origine du produit, ATTENTION si on est sur un produit ou service libre, cette valeur sera à zéro (il faudra saisir le prix de base pour le calcul ailleurs).
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
|- style="vertical-align:top;" 
| '''$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 'longueur',
il faut utiliser la variable $objectvalue['options_longueur'] 
|- style="vertical-align:top;" 
| '''$product''' 
| Objet contenant les valeurs associées au produit (référence, description...)
Exemple de valeurs : 
* $product['price_min'] (prix minimum) sera récupéré par la variable $product->price_min
* $product['ref'] pour récupérer/tester la référence du produit|
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)
|- style="vertical-align:top;" 
| '''$mainelement''' 
| Objet contenant les valeurs associées à la pièce (facture, commande, proposition commerciale) 
|- style="vertical-align:top;" 
| '''$societe''' 
| Objet contenant les valeurs associées à la société de la pièce (le destinataire de la facture) 
|- style="vertical-align:top;" 
| '''$object''' 
| Objet contenant les valeurs associées à ligne de la pièce (facture, commande ou propale) 
|- style="vertical-align:top;" 
| '''$elementextravalue''' 
| Objet contenant les champs supplémentaire associé à la pièce (facture, commande, proposition commerciale) 
|- style="vertical-align:top;" 
| '''$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']
|- style="vertical-align:top;" 
| '''$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']
|- style="vertical-align:top;" 
| '''$categsocieteid''' 
| contient l'identifiant de la catégorie de société auquel appartient la société
|- style="vertical-align:top;" 
| '''$categproductid''' 
| contient l'identifiant de la catégorie de produit auquel appartient le produit
|}
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
il est possible d'avoir des constantes en passant par la configuration/Divers de Dolibarr
il suffit pour cela de définir une variable et sa valeur
La valeur saisie peut être récupérée avec la $conf->global->LA_VARIABLE_DIVERSE
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
=== Exemple : Détermination du prix d'un produit selon la surface vendue ===
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Un produit a un prix fixé au mètre carré.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Nous ajoutons 2 champs supplémentaires (extrafields) nommés « longueur » et « largeur » correspondant aux dimensions de la surface vendue.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Dans ce cas, le prix de vente du produit correspond au prix au m² multiplié par la longueur et la largeur
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
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)
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Il est possible de rajouter un coût spécifique de découpe par produit selon, par exemple, sa matière : plastique, verre…
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
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)
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
== TVA transporteur sur facture fournisseur ==
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Il est également possible d’ajouter manuellement une TVA fournisseur en définissant le prix hors taxes (P.U. HT) correspondant à la TVA souhaitée.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Créer un nouveau service avec comme libellé la TVA souhaitée.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Une fois le service créé, l’ajouter dans le paramétrage du module.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Lors de la création d’une facture fournisseur, vous pourrez désormais ajouter ce service « TVA » et lui attribuer sa valeur monétaire exacte dans le champ P.U. HT.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
[[File:Extraprice-tva-transport.png|800px]]
</div>

Exporter des traductions

Menu de navigation

Rechercher