> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Configurateur de produit
> Référence pour la création de produits configurables avec des groupes d'options, des règles et des formules.
## Vue d'ensemble
Le configurateur de produit transforme un produit du catalogue en un produit avec options. Vous associez une configuration à un produit de base, puis ajoutez des **groupes** ordonnés qui permettent au commercial ou au client de choisir des produits, de répondre à des questions ou de consulter des valeurs calculées.
Au fur et à mesure des sélections, les règles affichent, masquent, rendent obligatoires ou excluent des éléments en temps réel, et les formules recalculent le prix, la quantité et tous les champs calculés. Le résultat est un ensemble validé de lignes ajoutées au devis.
Utilisez le configurateur de produit lorsqu'un produit dispose de nombreuses options interdépendantes. Pour un ensemble fixe de produits vendus ensemble à un seul prix, utilisez plutôt un [Bundle](/user-guide/catalog/reference/bundle).
## Fonctionnement
Une configuration est toujours associée à un seul produit de base. Vous y ajoutez des **groupes** dans l'ordre, et chaque groupe contient soit des options sélectionnables, soit une valeur calculée. Certains groupes peuvent rester masqués jusqu'à ce qu'une règle les révèle.
```mermaid theme={null}
flowchart TD
A[Base product] --> B{Has variants?}
B -->|Yes| C[Variant selection step]
B -->|No| D[Group A]
C --> D
D --> E[Group B]
E --> F[Group C, D, E...]
F --> G[Rules evaluate in real time]
G --> H[Price and quantity recalculate]
H --> I[Validate and add to quote]
```
Si le produit de base possède des variantes, le commercial sélectionne une variante avant de voir les groupes. Ensuite, les groupes apparaissent dans l'ordre que vous avez défini (A, B, C, etc.). À chaque changement de sélection, seules les règles et formules des groupes situés **en dessous** du groupe modifié sont réévaluées.
## Les 3 types de groupes
Ajoutez un groupe depuis le panneau **Configuration** en cliquant sur **+ Ajouter**, puis en choisissant l'un des trois types.
| Type de groupe | Objectif | Génère une ligne de devis |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
| **Élément** | Le commercial ou le client choisit un ou plusieurs produits du catalogue ou des attributs personnalisés. | Oui |
| **Question** | Le commercial ou le client répond à une question. La réponse peut piloter des règles et des formules, et peut éventuellement être enregistrée dans un champ. | Non |
| **Calculé** | Affiche une ou plusieurs valeurs calculées automatiquement à partir d'une formule. Aucune option à sélectionner. | Non, sauf si la valeur est enregistrée dans un champ |
Un groupe Élément ou Question vous permet de choisir un **type de sélection** : Boutons radio, Cases à cocher, Liste déroulante, Sélection multiple, Cartes (choix unique) ou Cartes (choix multiple). Les groupes Question en ajoutent trois autres : Bascule, Saisie numérique, Texte libre et Date.
Un groupe Calculé peut contenir plusieurs formules. Chaque formule possède son propre nom, format d'affichage et visibilité, ce qui permet à un seul groupe d'afficher plusieurs valeurs liées (par exemple, le poids d'un châssis et le poids total).
## Types d'options
Dans un groupe **Élément**, chaque option est l'une des suivantes :
* **Produit du catalogue** — lié à un produit existant. Son prix peut être hérité du catalogue de prix.
* **Attribut personnalisé** — un choix sans produit du catalogue sous-jacent (par exemple, "Finition standard" sans valeur de ligne séparée). Il possède son propre nom, image et description, et ne peut pas utiliser le prix hérité du catalogue de prix.
Dans un groupe **Question**, chaque option est une réponse possible avec un nom et une valeur, plus une image optionnelle pour l'affichage en style carte.
Chaque option de produit du catalogue ou d'attribut personnalisé configure son propre prix et sa propre quantité :
| Paramètre | Modes |
| ------------ | --------------------------------------------------- |
| **Prix** | Hérité du catalogue de prix, Formule, Montant fixe |
| **Quantité** | Identique au produit de base, Formule, Montant fixe |
Un prix ou une quantité basé sur une formule peut être une valeur fixe (`350`) ou une expression faisant référence à d'autres parties de la configuration (`[Price] * 0.35`). Chaque option peut également être marquée comme modifiable par le commercial, et le détail de son prix peut être masqué dans le devis.
## Règles
Une règle suit le schéma **SI \[condition] → ALORS \[action]**, avec une action **SINON** facultative. Les règles s'attachent à un groupe ou à une option individuelle, et s'évaluent en temps réel au fil des sélections.
Une règle ne peut référencer que des groupes qui la **précèdent** dans l'ordre. Une règle sur le groupe D peut utiliser les groupes A, B et C, mais jamais E ou les suivants.
### Actions
| Action | Disponible sur les groupes | Disponible sur les options |
| ------------------------------------------------- | -------------------------- | ------------------------------------------ |
| **Afficher** | Oui | Oui |
| **Masquer** | Oui | Oui |
| **Obligatoire** | Non | Oui (options de groupe Élément uniquement) |
| **Exclure** | Non | Oui (options de groupe Élément uniquement) |
| **Alerte** (Bannière d'avertissement ou d'erreur) | Oui | Non |
### Exemples
| Règle | Effet |
| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| SI **Alimentation** est `480V` ALORS Afficher **Transformateur** | Le groupe transformateur n'apparaît que pour les installations 480V. |
| SI **Environnement** est `Extérieur` ALORS Obligatoire **Châssis en acier inoxydable** | L'acier inoxydable est imposé pour les installations extérieures. |
| SI **Châssis** est `Carbone` ALORS Exclure **Gravure** | La gravure est grisée lorsque le carbone est sélectionné, car elle n'est pas compatible. |
### Résolution des conflits
Lorsque deux règles ciblent le même élément avec des actions contradictoires :
* **Masquer** l'emporte sur **Afficher**.
* **Obligatoire** l'emporte sur **Exclure**.
## Formules
Une formule est une expression qui produit un nombre. L'éditeur de formules propose trois contextes :
| Contexte | Utilisé pour | Résultat |
| ----------------- | ------------------------------------------ | ------------------------------------------------------------------------------ |
| **Prix unitaire** | Le prix d'une option | Un montant en devise |
| **Quantité** | La quantité d'une option | Un nombre entier |
| **Calculé** | Une valeur affichée dans un groupe Calculé | Un nombre, un montant en devise ou un pourcentage, selon le format d'affichage |
### Variables
Cliquez sur **INSÉRER UNE VARIABLE** dans l'éditeur de formules pour insérer une variable sans la saisir manuellement.
| Source | Variables |
| --------------------- | -------------------------------------------------------------------------------------------------------- |
| **Produit de base** | Price, Quantity |
| **Groupe d'options** | Value (la sélection actuelle), Total (prix × quantité pour l'ensemble du groupe), Price, Quantity, Count |
| **Option spécifique** | Selection, Total, Price |
### Fonctions
| Fonction | Description |
| ---------------------------------------------- | ----------------------------------------------------- |
| `IF(condition, value if true, value if false)` | Retourne l'une de deux valeurs selon une condition. |
| `AND(a, b, ...)` | Vrai uniquement si toutes les conditions sont vraies. |
| `OR(a, b, ...)` | Vrai si au moins une condition est vraie. |
| `ROUND(value, decimals)` | Arrondit un nombre à un nombre de décimales donné. |
Il n'existe pas de fonction "somme" séparée. Pour totaliser les prix ou les quantités d'un groupe d'options, insérez la variable **Total** de ce groupe.
### Exemples
| Formule | Résultat |
| ------------------------------------------------------------- | ------------------------------------------------------------------- |
| `350` | Un supplément fixe de 350. |
| `[Price] * 0.35` | 35 % du prix du produit de base. |
| `IF([Selection] = "Premium chassis", [Price] * 0.9, [Price])` | Une remise de 10 % lorsque le châssis premium est sélectionné. |
| `ROUND([Total] + [Total], 1)` | Le total combiné de deux groupes d'options, arrondi à une décimale. |
## Comportement dans le DealRoom
Lorsqu'un produit configuré atteint le DealRoom, le client voit les mêmes groupes et sélections que le commercial, avec quelques différences :
* Les conseils commerciaux sont masqués — ils sont réservés à votre équipe.
* Les valeurs calculées marquées comme masquées restent masquées.
* Une option marquée comme facultative peut être ajoutée ou supprimée par le client.
* Une option marquée comme présélectionnée est cochée par défaut, mais le client peut la décocher si elle est également facultative.
* Une option avec une quantité modifiable permet au client de l'ajuster dans les limites minimales et maximales configurées.
Si aucun de ces paramètres ne s'applique à une option, le client la voit en lecture seule.
## Quand utiliser le Configurateur plutôt que le Bundle
| | Configurateur de produit | Bundle |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Idéal pour | Les produits avec de nombreuses options interdépendantes, une logique conditionnelle et des valeurs calculées | Un ensemble fixe ou légèrement personnalisable de produits vendus ensemble |
| Tarification | Par option, souvent basée sur des formules | Généralement un prix forfaitaire avec des compléments simples |
| Règles conditionnelles | Oui — afficher, masquer, rendre obligatoire, exclure, alerter | Non |
| Champs calculés | Oui | Non |
| Effort de configuration | Élevé — adapté aux produits complexes et configurables | Faible — adapté aux regroupements simples |
## Questions fréquentes
Non. Les règles et les formules ne peuvent référencer que des groupes qui les précèdent dans l'ordre. Si vous avez besoin de la relation inverse, déplacez le groupe référencé plus tôt.
Masquer l'emporte toujours sur Afficher, et Obligatoire l'emporte toujours sur Exclure.
Non. Les groupes Question ne créent jamais de ligne de devis par eux-mêmes. Ils collectent une réponse qui peut piloter des règles et des formules, et peuvent éventuellement être enregistrés dans un champ.
Oui. Un groupe Calculé peut contenir plusieurs formules, chacune avec son propre nom, format d'affichage et visibilité.
Oui. Désactivez le paramètre d'affichage du champ calculé pour l'utiliser uniquement comme variable interne dans d'autres formules, sans l'afficher sur l'écran de configuration.
## Ressources associées
Guide pas à pas pour créer une configuration de zéro.
Regrouper un ensemble fixe de produits sous un seul prix.
Gérer les prix dont les produits configurés peuvent hériter.
Découvrez comment les clients interagissent avec un produit configuré en ligne.