CustomProduct : Différence entre versions

De Documentations Patas-monkey
Sauter à la navigation Sauter à la recherche
 
(45 révisions intermédiaires par le même utilisateur non affichées)
Ligne 10 : Ligne 10 :
  
 
=Présentation=
 
=Présentation=
−
CustomProduct ajoute une gestion d'options au niveau des produits. Il ne s'agit pas de variantes/déclinaisons avec un stock propres mais bien de produit ou service sur lequel on associe des options qui peuvent être ou non payant
+
CustomProduct ajoute une gestion d'options au niveau des produits. Il ne s'agit pas de variantes/déclinaisons avec un stock propres mais bien de produit ou service sur lequel on associe des options qui peuvent être ou non payantes.
 +
Cela peu être aussi des prestations que l'on souhaite ajouter à un produit sans forcément en tenir un stock.
 +
 
 
==Exemple==
 
==Exemple==
 
Prenons le cas de la vente d'un ordinateur portable.
 
Prenons le cas de la vente d'un ordinateur portable.
 +
 
Cet ordinateur à un prix de base et un ensemble d'options que l'on peu ajouter ou non.
 
Cet ordinateur à un prix de base et un ensemble d'options que l'on peu ajouter ou non.
 +
 
Lors du devis on sélectionne les options que l'on souhaite ajouter à l'ordinateur, le prix de l'ordinateur va évoluer au fur et à  mesure des options que l'on sélectionne ou non.
 
Lors du devis on sélectionne les options que l'on souhaite ajouter à l'ordinateur, le prix de l'ordinateur va évoluer au fur et à  mesure des options que l'on sélectionne ou non.
 +
 
Lors de la transformation du devis en commande ou facture, les options sont transférées sur le nouveau document et il est possible de changer celle-ci au denier moment.
 
Lors de la transformation du devis en commande ou facture, les options sont transférées sur le nouveau document et il est possible de changer celle-ci au denier moment.
 +
 
==Fonctionnement==
 
==Fonctionnement==
 
Le module permet de définir un ensemble d'option pour chaque produit.
 
Le module permet de définir un ensemble d'option pour chaque produit.
Ligne 28 : Ligne 34 :
  
 
A la fin de la saisie des options on valide la totalité des options sélectionnées, une mise à jour des prix des produit est alors réalisé selon les options définies.
 
A la fin de la saisie des options on valide la totalité des options sélectionnées, une mise à jour des prix des produit est alors réalisé selon les options définies.
 +
 +
=Paramétrage=
 +
CustomProduct permet de définir des options supplémentaires au niveau d'un produit
 +
Il est possible de faire apparaitre ou non les options sélectionnées sur la description du produit
 +
{| class="wikitable"
 +
|- style="vertical-align:top;"
 +
| [[File:customproduct_parametrage.png|800px]]
 +
|
 +
* Plusieurs switch permettent d'activer ou non des fonctionnalité, comme afficher ou non les options, le prix de l'option sur le détail du produit.
 +
 +
* Il est possible de personnaliser le texte qui séparera la description du produit et celle des options.
 +
 +
* Il est enfin possible de personnaliser le préfixe de l'option avec un tiret par défaut ou tout autres caractères
 +
|}
  
 
=Définition des options d'un Produit=
 
=Définition des options d'un Produit=
 
==Liste des options d'un produit==
 
==Liste des options d'un produit==
 +
L'onglet de customProduct d'un produit permet de gérer les options d'un produit.
 +
 +
Un badge numérique indique la présence d'options définies sur le produit
 
{| class="wikitable"  
 
{| class="wikitable"  
 
|- style="vertical-align:top;"  
 
|- style="vertical-align:top;"  
 
| [[File:customproduct_definitionoptionliste.png|600px]]
 
| [[File:customproduct_definitionoptionliste.png|600px]]
−
| L'onglet de customProduct d'un produit permet de gérer les options d'un produit.
+
|
 
Un tableau présente la liste des options déjà définies pour le produit.  
 
Un tableau présente la liste des options déjà définies pour le produit.  
−
 
  
 
Il est possible à partir de cet onglet :
 
Il est possible à partir de cet onglet :
Ligne 42 : Ligne 64 :
 
* modifier une option existante
 
* modifier une option existante
 
* supprimer une option existante
 
* supprimer une option existante
 +
* de cloner/transférer la liste des options sur un autre produit
 
|}
 
|}
 +
=== Clonage des options sur un autre produit ===
 +
{| class="wikitable"
 +
|- style="vertical-align:top;"
 +
|  [[File:customproduct_clonnage.png|600px]]
 +
|
 +
Lors du clonage des options vers un autre produit, la fenêtre de confirmation permet de préciser:
 +
* la sélection du produit destinataire des options clonées
 +
* si l'on souhaite remplacer les options existantes sur le produit destinataire
 +
|}
 +
 
==Création d'une option==
 
==Création d'une option==
 
L'appuie sur le bouton d'ajout ouvre une fenêtre pour saisir une nouvelle option
 
L'appuie sur le bouton d'ajout ouvre une fenêtre pour saisir une nouvelle option
Ligne 52 : Ligne 85 :
 
| style="vertical-align:top;" |  
 
| style="vertical-align:top;" |  
 
Texte qui sera présenté devant l'option, comme la couleur
 
Texte qui sera présenté devant l'option, comme la couleur
 +
|-
 +
| style="vertical-align:top;width:20%;" |
 +
keyref
 +
| style="vertical-align:top;" |
 +
référence produit complémentaire si la fonction est active
 
|-
 
|-
 
| style="vertical-align:top;" |
 
| style="vertical-align:top;" |
Ligne 65 : Ligne 103 :
 
|-
 
|-
 
| style="vertical-align:top;" |
 
| style="vertical-align:top;" |
−
Paramètre de l'option
+
Paramètre de l'option, texte de la description
 
| style="vertical-align:top;" |  
 
| style="vertical-align:top;" |  
−
Certaines options nécessite un ensemble de paramètre supplémentaire, comme la liste des choix pour un menu déroulant
+
Texte affiché au niveau de la description du produit dans la pièce ou certaines options nécessite un ensemble de paramètre supplémentaire, comme la liste des choix pour un menu déroulant.
 +
 
 +
Attention, les options sont affichées à la suite, si vous souhaitez les positionner à la ligne, il faut rajouter ici une balise <br> pour déclencher un saut de ligne
 
|-
 
|-
 
| style="vertical-align:top;" |
 
| style="vertical-align:top;" |
Ligne 78 : Ligne 118 :
 
| style="vertical-align:top;" |  
 
| style="vertical-align:top;" |  
 
L'ordre de placement des options
 
L'ordre de placement des options
 +
|-
 +
| style="vertical-align:top;" |
 +
Afficher l'option dans la description du produit
 +
| style="vertical-align:top;" |
 +
Si cette case à cocher n'est pas active, l'activation de l'option ne déclenchera pas d'affichage au niveau de la description du produit de la pièce
 
|}
 
|}
 +
 +
==Modification de l'option==
 +
l'appuie sur le stylo en debut de ligne permet de modifier l'option
 +
[[File:customproduct_editoption.png|800px]]
 +
 +
dans le cas d'une liste déroulante, il est possible de conditionner pour chacun des choix
 +
* un prix spécifique
 +
* une référence produit complémentaire spécifique
 +
dans ce cas on utilise le # comme séparateur entre ses données (cf-image)
  
 
==Types d'options disponibles==
 
==Types d'options disponibles==
Ligne 84 : Ligne 138 :
 
{| class="wikitable"  
 
{| class="wikitable"  
 
|- style="vertical-align:top;"  
 
|- style="vertical-align:top;"  
−
| [[File:customproduct_listeoption.png|300px]]
+
| [[File:customproduct_listeoption.png|250px]]
 
|  
 
|  
 
{| class="wikitable"
 
{| class="wikitable"
Ligne 126 : Ligne 180 :
 
| style="vertical-align:top;" |  
 
| style="vertical-align:top;" |  
 
Le fait de saisir du texte dans cette zone augmente le prix du produit, ce type d'option peu servir dans le cas d'une gravure ou le fait de saisir  le texte à graver augmente le prix du produit forfaitairement
 
Le fait de saisir du texte dans cette zone augmente le prix du produit, ce type d'option peu servir dans le cas d'une gravure ou le fait de saisir  le texte à graver augmente le prix du produit forfaitairement
 +
Attention, il doit y avoir une option de texte pour afficher le texte saisie et %s afin de préciser la position du texte saisie
 +
|}
 
|}
 
|}
 +
=== Paramétrages des listes d'options ===
 +
Comme indiqué précédemment chaque option est séparé d'un point virgule ";"
 +
pour chaque ligne d'option, il est possible de définir 3 valeurs séparées par un #
 +
* le texte de la ligne d'option
 +
* le montant propre à la ligne d'option
 +
* le composant de la référence du produit pour l'option
  
−
|}
+
=== Saisie de texte libre ===
 +
pour afficher la saisie libre dans la description, il faut ajouter un % dans les options, sinon le texte ne sera pas affiché sur le document PDF
 +
 
 +
[[File:customproduct_saisilibre.png|600px]]
  
 
=Saisie des options d'un produit=
 
=Saisie des options d'un produit=
−
Une fois les lignes de produits saisies sur l'onglet principal, on se positionne sur l'onglet customProduct pour saisir les options présentes sur chaque produits ayant des options.  
+
{| class="wikitable"
−
Sur l'écran si dessous
+
|- style="vertical-align:top;"
−
* le produit 2 ne possède pas d'option
+
| [[File:customproduct_InfoBadge.png|400px]]
−
* le produit 3 présente la totalité des type d'options possible.
+
|
 +
Une fois les lignes de produits saisies sur l'onglet principal, un indicateur numérique (badge) indique si il y a ou non des options saisissables pour les produits que l'on a saisie.
 +
|}
 +
On se positionne sur l'onglet customProduct pour saisir les options présentes sur chaque produits ayant des options.  
 +
Sur l'écran si dessous:
 +
* Le produit 1 est saisie à deux reprises et peu avoir deux groupes d'options saisie différent
 +
* Le produit 2 ne possède pas d'option
 +
* Le produit 3 présente la totalité des type d'options possible.
  
 
[[File:custompproduct_SaisieOptions.png|800px]]
 
[[File:custompproduct_SaisieOptions.png|800px]]
 +
 +
Le bouton '''[Enregistrer]''' n'est présent que lorsque le document est à l'état brouillon
 +
 +
Une fois enregistrée, si le paramètre a été activé, les options sélectionnées sont ajoutés à la description du produit (et sont naturellement mise à jour si on les change). Cela permet de faire apparaitre sur les documents les options sélectionnées pour le produit.
 +
[[File:customproduct_editionoption.png|800px]]

Version actuelle datée du 9 juin 2024 à 09:17

Customproduct 250x250.png CustomProduct permet de créer des options de produits personnalisables :
  • définissez vos propres options pour chaque produits
  • associez un montant supplémentaire pour chacunes des options
  • le prix de vente du produit est automatiquement modifié en fonction des options
  • transférez les options choisies entre les pièces (devis, commande, facture)

Présentation

CustomProduct ajoute une gestion d'options au niveau des produits. Il ne s'agit pas de variantes/déclinaisons avec un stock propres mais bien de produit ou service sur lequel on associe des options qui peuvent être ou non payantes. Cela peu être aussi des prestations que l'on souhaite ajouter à un produit sans forcément en tenir un stock.

Exemple

Prenons le cas de la vente d'un ordinateur portable.

Cet ordinateur à un prix de base et un ensemble d'options que l'on peu ajouter ou non.

Lors du devis on sélectionne les options que l'on souhaite ajouter à l'ordinateur, le prix de l'ordinateur va évoluer au fur et à mesure des options que l'on sélectionne ou non.

Lors de la transformation du devis en commande ou facture, les options sont transférées sur le nouveau document et il est possible de changer celle-ci au denier moment.

Fonctionnement

Le module permet de définir un ensemble d'option pour chaque produit.

Pour chaque option il est possible de définir en ensemble de propriété allant conditionner son fonctionnement.

Lors de la saisie d'un document (devis, commande, facture client), on sélectionne les différents produits ainsi que leur quantité.

Une fois cette saisie de produit terminée, on passe sur l'onglet customproduct du document.

Les options du produit apparaissent et sont alors saisissables (tant que le document est à l'état brouillon).

A la fin de la saisie des options on valide la totalité des options sélectionnées, une mise à jour des prix des produit est alors réalisé selon les options définies.

Paramétrage

CustomProduct permet de définir des options supplémentaires au niveau d'un produit Il est possible de faire apparaitre ou non les options sélectionnées sur la description du produit

Customproduct parametrage.png
  • Plusieurs switch permettent d'activer ou non des fonctionnalité, comme afficher ou non les options, le prix de l'option sur le détail du produit.
  • Il est possible de personnaliser le texte qui séparera la description du produit et celle des options.
  • Il est enfin possible de personnaliser le préfixe de l'option avec un tiret par défaut ou tout autres caractères

Définition des options d'un Produit

Liste des options d'un produit

L'onglet de customProduct d'un produit permet de gérer les options d'un produit.

Un badge numérique indique la présence d'options définies sur le produit

Customproduct definitionoptionliste.png

Un tableau présente la liste des options déjà définies pour le produit.

Il est possible à partir de cet onglet :

  • créer une nouvelle option
  • modifier une option existante
  • supprimer une option existante
  • de cloner/transférer la liste des options sur un autre produit

Clonage des options sur un autre produit

Customproduct clonnage.png

Lors du clonage des options vers un autre produit, la fenêtre de confirmation permet de préciser:

  • la sélection du produit destinataire des options clonées
  • si l'on souhaite remplacer les options existantes sur le produit destinataire

Création d'une option

L'appuie sur le bouton d'ajout ouvre une fenêtre pour saisir une nouvelle option Customproduct nouveloption.png

Libelle (obligatoire)

Texte qui sera présenté devant l'option, comme la couleur

keyref

référence produit complémentaire si la fonction est active

Description

Texte qui sera présenté comme un tooltip d'explication de l'option (vous pouvez y préciser certaines choses)

Type d'option (obligatoire)

Sélectionner le type de l'option que vous souhaitez utiliser, la liste de ses options sera détaillée plus bas

Paramètre de l'option, texte de la description

Texte affiché au niveau de la description du produit dans la pièce ou certaines options nécessite un ensemble de paramètre supplémentaire, comme la liste des choix pour un menu déroulant.

Attention, les options sont affichées à la suite, si vous souhaitez les positionner à la ligne, il faut rajouter ici une balise
pour déclencher un saut de ligne

Montant HT

Le montant à ajouter au prix du produit si l'option a été sélectionnée

Position

L'ordre de placement des options

Afficher l'option dans la description du produit

Si cette case à cocher n'est pas active, l'activation de l'option ne déclenchera pas d'affichage au niveau de la description du produit de la pièce

Modification de l'option

l'appuie sur le stylo en debut de ligne permet de modifier l'option Customproduct editoption.png

dans le cas d'une liste déroulante, il est possible de conditionner pour chacun des choix

  • un prix spécifique
  • une référence produit complémentaire spécifique

dans ce cas on utilise le # comme séparateur entre ses données (cf-image)

Types d'options disponibles

Il y a actuellement six choix possible d'options

Customproduct listeoption.png

Case à cocher

une simple case à cocher permettant la sélection ou non de l'option le texte saisie dans le paramètre de l'option est affiché à droite de la case à cocher

Liste de case à cocher

Une liste de case à cocher, les choix possibles sont saisis dans le paramètre d'option séparé d'un point virgule ;

Liste de case à cocher multiplicatrice

Se présente et se paramètre comme l'option précédente, le fait de cocher plusieurs choix multiplie le montant de l'option.

Exemple: on sélectionne deux options pour un montant d'option à 5€, le prix du produit augmentera de 10€

Liste de radio-bouton

Une liste de case à cocher, un seul choix possible parmis la liste, les choix sont saisis dans le paramètre d'option séparé d'un point virgule ;

Liste déroulante

Une liste déroulante (combobox), un seul choix possible parmis la liste, les choix sont saisis dans le paramètre d'option séparé d'un point virgule ;

Multiplicateur

une valeur numérique multipliant le montant de l'option.

Exemple: on saisit dans la zone le chiffre 3 pour un montant d'option de 5€, le prix du produit augmentera de 15€

Saisie libre

Le fait de saisir du texte dans cette zone augmente le prix du produit, ce type d'option peu servir dans le cas d'une gravure ou le fait de saisir le texte à graver augmente le prix du produit forfaitairement Attention, il doit y avoir une option de texte pour afficher le texte saisie et %s afin de préciser la position du texte saisie

Paramétrages des listes d'options

Comme indiqué précédemment chaque option est séparé d'un point virgule ";" pour chaque ligne d'option, il est possible de définir 3 valeurs séparées par un #

  • le texte de la ligne d'option
  • le montant propre à la ligne d'option
  • le composant de la référence du produit pour l'option

Saisie de texte libre

pour afficher la saisie libre dans la description, il faut ajouter un % dans les options, sinon le texte ne sera pas affiché sur le document PDF

Customproduct saisilibre.png

Saisie des options d'un produit

Customproduct InfoBadge.png

Une fois les lignes de produits saisies sur l'onglet principal, un indicateur numérique (badge) indique si il y a ou non des options saisissables pour les produits que l'on a saisie.

On se positionne sur l'onglet customProduct pour saisir les options présentes sur chaque produits ayant des options. Sur l'écran si dessous:

  • Le produit 1 est saisie à deux reprises et peu avoir deux groupes d'options saisie différent
  • Le produit 2 ne possède pas d'option
  • Le produit 3 présente la totalité des type d'options possible.

Custompproduct SaisieOptions.png

Le bouton [Enregistrer] n'est présent que lorsque le document est à l'état brouillon

Une fois enregistrée, si le paramètre a été activé, les options sélectionnées sont ajoutés à la description du produit (et sont naturellement mise à jour si on les change). Cela permet de faire apparaitre sur les documents les options sélectionnées pour le produit. Customproduct editionoption.png

Récupérée de « https://wiki.patas-monkey.com/index.php?title=CustomProduct&oldid=2632 »