Prix interactifs

Votre client choisit dans le lien ce qu’il inclut, quelle alternative il veut et en quelle quantité, voit le total aussitôt et approuve ce qu’il a choisi.

De quoi s’agit-il

Avec les prix interactifs, un seul devis propose des options. Au lieu d’envoyer trois versions de la même proposition, vous laissez votre client décider dans le lien :

Option	Ce qu’elle fait dans le lien	Exemple
En option	Une case pour inclure ou retirer la ligne.	Formation, installation ou extension de garantie.
Au choix (groupe)	Les lignes d’un même groupe sont des alternatives : votre client en choisit exactement une.	Formule Essentielle, Professionnelle ou Premium.
Votre client ajuste la quantité	Un sélecteur avec − et + dans la plage que vous fixez.	Licences utilisateur de 5 à 50.

Une ligne peut combiner la quantité avec l’une des deux autres options : une ligne en option ou une alternative d’un groupe peuvent aussi laisser ajuster leur quantité. Une ligne ne peut pas, en revanche, être à la fois en option et dans un groupe.

Le total, les taxes, l’acompte et l’échéancier sont recalculés aussitôt dans le lien, avec le même moteur que celui qu’utilise Cord lors de l’enregistrement, et l’approbation signe ce que votre client a choisi. Le prix unitaire ne change jamais : votre client choisit quoi et combien, pas à quel prix.

Prérequis

Offre : toutes les offres. Aucune limite propre.
Droit : Devis.
Document : devis uniquement. Les factures n’ont pas d’options.
Pays : les 12 marchés.

Configurer les options dans l’éditeur

À l’étape 2 de l’éditeur, Que proposez-vous dans le devis ?, ajoutez les lignes comme d’habitude (voir Produits et prix).
Sur la ligne que votre client pourra choisir, cliquez sur le bouton Options pour votre client de la ligne, celui à l’icône de curseurs. Le panneau Ce que votre client peut choisir dans le lien s’ouvre.
Cochez ce que votre client peut décider : En option : votre client décide s’il l’inclut, Au choix (groupe) ou Votre client ajuste la quantité. Chacune est expliquée ci-dessous.
Cliquez sur Terminé. La ligne affiche ses étiquettes (par exemple En option, Au choix : Formule ou Quantité 5–50) et le lien Options pour votre client pour rouvrir le panneau.
Enregistrez ou envoyez le devis comme d’habitude.

Retirer les options, dans le même panneau, rend la ligne fixe à nouveau.

Sous le total du récapitulatif, l’éditeur précise : « Le total est celui de la sélection à l’ouverture du lien ; votre client peut le modifier. » Le total enregistré, l’acompte et l’échéancier se calculent avec cette sélection initiale. L’Aperçu, dans le même récapitulatif, vous montre le lien tel que le verra votre client, avec ses options et le total de la sélection à l’ouverture.

En option

Cochez En option : votre client décide s’il l’inclut. Incluse à l’ouverture du lien apparaît en dessous :

Cochée, la ligne s’ouvre incluse et votre client la retire s’il n’en veut pas.
Décochée, elle s’ouvre exclue et votre client l’ajoute s’il la veut. La ligne de l’éditeur l’indique par Non incluse à l’ouverture.

Au choix (groupe)

Saisissez le même nom dans Au choix (groupe) sur chaque alternative, par exemple « Formule ». Le champ suggère les groupes que vous utilisez déjà dans le devis et accepte jusqu’à 80 caractères. Sur l’alternative qui doit s’ouvrir choisie, cochez Sélectionnée à l’ouverture : Cord décoche les autres lignes du même groupe.

Pour constituer un groupe rapidement, utilisez Dupliquer la ligne sur une ligne qui a déjà un groupe : la copie est une autre alternative du même groupe et ne s’ouvre pas sélectionnée. Saisir un groupe sur une ligne en option lui retire En option, car une ligne d’un groupe est déjà un choix.

Votre client ajuste la quantité

Cochez Votre client ajuste la quantité et saisissez le Minimum et le Maximum. La quantité de la ligne est celle que vous proposez : le lien s’ouvre avec elle et elle doit rester dans la plage. Si le minimum, le maximum et la quantité sont des nombres entiers, votre client ajuste d’une unité à la fois ; si l’un d’eux a des décimales, il peut demander une quantité avec quatre décimales au plus.

Ce que Cord vérifie à l’enregistrement

Cord valide les options à l’enregistrement ou à l’envoi, avec la même règle dans l’éditeur, l’API et le lien, pour que votre client ne reçoive jamais un choix impossible. Si quelque chose ne va pas, l’éditeur ouvre le panneau de la ligne et vous dit quoi corriger :

Une ligne d’un groupe ne peut pas être aussi en option.
Un groupe demande au moins deux lignes et exactement une sélectionnée à l’ouverture.
Le minimum et le maximum vont ensemble. Le minimum est supérieur à zéro et ne dépasse pas le maximum, avec quatre décimales au plus.
La quantité de la ligne reste dans sa plage.
Une ligne qui n’est ni en option ni dans un groupe est toujours incluse.
Au moins une ligne reste incluse dans la sélection à l’ouverture du lien.

Ce que voit votre client dans le lien

Au-dessus des lignes, le lien indique « Choisissez ce que vous voulez : le total se met à jour aussitôt et c’est celui que vous approuvez. » Ensuite :

Ligne en option : une case à côté du nom et l’étiquette En option.
Groupe : le titre Choisissez-en une avec le nom du groupe et un bouton radio sur chaque alternative ; en choisir une désélectionne la précédente.
Quantité : un sélecteur avec − et + et la plage en dessous, par exemple « De 5 à 50 ». En quittant le champ, une quantité hors de la plage est ramenée au minimum ou au maximum.
Les autres lignes restent fixes : votre client ne peut pas les retirer.

Chaque changement recalcule aussitôt le montant de la ligne, le sous-total, la remise sur le document, les taxes, les retenues à la source, le total, l’acompte et l’échéancier. Si le devis a un échéancier avec intérêts de financement et que votre client change la sélection, le tableau n’affiche que le total et le détail reste dans le bloc de l’échéancier.

Ce qui se passe à l’approbation

À l’approbation, le lien envoie le choix de votre client et Cord le valide à nouveau sur le serveur par rapport à ce que vous avez permis, puis recalcule le total. Un choix hors de ce que vous avez permis n’est pas signé : le lien indique à votre client que la proposition a changé et recharge la page pour qu’il choisisse parmi les options en vigueur.

À la signature :

Le devis passe à Approuvé avec le total de ce qui a été choisi : sous-total, taxes par ligne, retenues à la source et remise sur le document, recalculés.
Chaque ligne est incluse ou non. Celles que votre client a laissées de côté sont marquées Non incluse dans le lien et dans le détail.
La quantité choisie est enregistrée sur la ligne, et celle que vous aviez proposée reste indiquée par « Proposé : 10 ».
L’activité enregistre, par exemple : « Signé par « Marie Dupont » avec les options choisies (8 400,00 EUR) (IP 203.0.113.24) ».
L’empreinte SHA-256 de la signature couvre les lignes signées avec leur quantité et la sélection. Voir Approbation et preuves.
L’acompte se calcule sur le total approuvé (voir Acompte et solde).
Un échéancier par jalons est recalculé avec le total approuvé, avec les mêmes proportions et les mêmes échéances. Sa ligne d’intérêts, s’il en a une, ne se choisit pas : Cord la recalcule avec ce que votre client approuve.
Le paiement et la facture ne reprennent que ce qui a été choisi.

Ce que vous voyez dans le détail et dans le PDF

Dans le détail du devis, chaque ligne avec options porte ses étiquettes : En option, Au choix : Formule, Quantité de 5 à 50 et, quand votre client a changé la quantité, Proposé : 10. Avant que votre client décide, les lignes qui ne s’ouvrent pas incluses indiquent Non choisie.

Sous les lignes, une note explique ce qu’il en est. Avant l’approbation : « Dans le lien, votre client choisit les lignes en option, une par groupe et la quantité là où vous le permettez. Le total est celui de la sélection à l’ouverture du lien. » Après : « Le client a approuvé avec les options qu’il a choisies : le total, le paiement et la facture ne reprennent que ce qui a été choisi. »

Le PDF du devis porte les mêmes étiquettes à côté de l’unité de chaque ligne.

Validations internes

Si votre organisation utilise les validations internes, Cord mesure le choix qui facture le plus : toutes les lignes en option incluses, l’alternative au montant le plus élevé de chaque groupe et chaque quantité à son maximum. Le plafond de montant est comparé au total de ce choix, et ceux de remise et de marge à ses lignes. Ainsi, votre client ne choisit jamais quelque chose que la direction n’a pas vu.

Versions, doublons et renouvellements

Modifier et renvoyer : la nouvelle version s’ouvre avec les options de la précédente et vous pouvez les modifier comme n’importe quelle ligne. Cord les valide à nouveau à l’envoi.
Dupliquer le devis : le brouillon conserve les options et part de la sélection enregistrée : celle de l’ouverture du lien ou, si votre client a déjà approuvé, celle qu’il a choisie, avec ses quantités.
Renouveler : comme le doublon, le renouvellement conserve les options et part de ce que votre client a choisi.

Sans options, un doublon ou un renouvellement reprend toutes les lignes, comme d’habitude.

Par l’API, le MCP et les webhooks

POST /api/v1/cotizaciones et PATCH /api/v1/cotizaciones/{id} (ce dernier sur un brouillon uniquement) acceptent sur chaque ligne opcional, grupo, cantidad_min, cantidad_max et incluida, qui indique si la ligne est sélectionnée à l’ouverture (par défaut true). Dans un groupe, une seule ligne porte incluida: true et les autres incluida: false ; sinon, la réponse est 400 invalid_options.
Des options que votre client ne pourrait pas choisir renvoient 400 invalid_options et rien n’est enregistré ; le message indique la ligne.
Le détail comporte sur chaque ligne son id, ses options, incluida et cantidad_propuesta : la quantité que vous aviez proposée si votre client l’a changée, sinon null.
Sur le serveur MCP, crear_cotizacion_borrador accepte les mêmes champs et detalle_cotizacion les renvoie.
Le webhook quote.approved comporte seleccion : chaque ligne avec id, descripcion, cantidad, cantidad_propuesta, incluida, opcional et grupo. Il vaut null si le devis ne laisse rien choisir. Si le devis est marqué approuvé depuis Cord, seleccion est la sélection à l’ouverture du lien.
Une clé publiable (pk_), celle qu’utilise Cord Elements, ne définit pas d’options : c’est vous qui décidez de ce que votre client peut choisir.

Le détail de chaque champ figure dans la Référence de l’API, l’API des devis et Webhooks.

Ce que la fonctionnalité ne fait pas

Elle ne change pas les prix. Votre client choisit quoi et combien, jamais à quel prix. Pour négocier le prix, il y a la contre-proposition.
Elle ne coexiste pas avec l’approbation partielle. Dès qu’une option est définie, les autres lignes restent fixes et votre client ne peut plus décocher n’importe quelle ligne. Sans options, le devis conserve l’approbation partielle habituelle.
Elle n’existe pas sur les factures. Uniquement sur les devis.

Limites par offre

Les prix interactifs sont inclus dans toutes les offres, sans limite propre. Chaque devis conserve sa limite de 200 lignes. Les validations internes demandent Scale ou Developer.

Problèmes courants

Je ne vois pas Options pour votre client. Vous êtes dans l’éditeur d’une facture : les options sont réservées aux devis.

« Le groupe « Formule » n’a qu’une ligne. » Ajoutez une autre alternative avec le même nom de groupe (Dupliquer la ligne en crée une) ou effacez le nom du groupe.

« Choisissez quelle ligne du groupe « Formule » est sélectionnée à l’ouverture. » Cochez Sélectionnée à l’ouverture sur l’une de ses alternatives.

« La quantité de la ligne 2 sort de la plage que vous laissez à votre client. » Modifiez la quantité de la ligne ou la plage.

Mon client ne peut pas approuver. Le bouton se désactive si une quantité sort de sa plage ou si, avec un échéancier, un paiement passe sous le montant minimum d’encaissement avec ce choix. Si vous avez modifié la proposition pendant qu’il la lisait, il doit d’abord cliquer sur Voir les modifications.

Le total du récapitulatif n’additionne pas toutes les lignes. C’est normal : c’est le total de la sélection à l’ouverture du lien.