CustomProduct/en

CustomProduct allows you to create customizable product options: Define your own options for each product Associate an additional amount for each option The product's selling price is automatically modified based on the options Transfer the selected options between documents (quote, order, invoice)

Overview

CustomProduct adds options management at the product level.

These are not variants/declinations with their own stock but rather products or services to which we associate options which may or may not be chargeable.

These can also be services that we want to add to a product without necessarily keeping a stock of them.

Additional text added by customProduct on a customer order will naturally be passed on to the purchase order

Example

Consider the sale of a laptop.

This computer has a base price and a set of options that can be added or not.

When getting a quote, you select the options you want to add to the computer. The price of the computer will change depending on the options you select or not.

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.

How it works

The module allows you to define a set of options for each product.

For each option it is possible to define a set of properties that will condition its operation.

When entering a document (quote, order, customer invoice), you select the different products and their quantity.

Once this product entry is complete, we move to the customproduct tab of the document.

The product options appear and can then be entered (as long as the document is in draft state).

At the end of the entry of the options, all the selected options are validated, an update of the product prices is then carried out according to the defined options.

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

• 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

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

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

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

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

	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 pourcentage	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 parmi la liste, les choix sont saisis dans le paramètre d'option séparé d'un point virgule ; Il est possible d'appliquer un coeficient multiplicateur avec un # sur la liste multipliant le montant de l'option. Exemple: on saisit dans la zone "selection coef3#3", pour un montant d'option de 5€, le prix du produit passera à 5,5€
	Liste de radio-bouton pourcentage	Une liste de case à cocher, un seul choix possible parmi la liste, les choix sont saisis dans le paramètre d'option séparé d'un point virgule ; Il est possible d'appliquer un coeficient multiplicateur avec un # sur la liste multipliant le montant de l'option. Exemple: on saisit dans la zone "selection coef3#3", pour un montant d'option de 5€, le prix du produit passera à 5,5€
	Liste déroulante	Idem que "liste radio-bouton" mais avec une présentation plus compacte sous la forme d'une liste déroulante (combobox)
	Liste déroulante pourcentage	Idem que "liste radio-bouton pourcentage" mais avec une présentation plus compacte sous la forme d'une liste déroulante (combobox)
	Pourcentage	une valeur numérique multipliant le montant de l'option. Exemple: on saisit dans la zone le chiffre 10 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 (coefficient multiplicateur)
• 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

Saisie des options d'un produit

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.

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.