Medusa Explained · Pricing · 3/4
Le module Pricing dans Medusa : organiser des tarifs clients
Le module Pricing ne conserve pas seulement le prix public de chaque variante : il peut aussi porter des tarifs réservés à certains clients. Cet article montre comment une liste de prix applique des montants négociés à un groupe de revendeurs, sans modifier les prix de base.
Dans cet article
Un tarif négocié sur plusieurs variantes
Une marque vend sa basket 90 EUR au public, dans toutes les pointures. Elle travaille aussi avec des revendeurs, à qui elle a consenti 75 EUR sur cette basket et sur quelques autres modèles. Ces revendeurs sont regroupés dans Medusa dans un groupe de clients, « Revendeurs ».
Une PriceRule, la règle attachée à un prix, pourrait poser la condition « groupe Revendeurs » sur chaque prix à 75 EUR. Mais elle serait répétée sur chaque variante, et changer le périmètre du tarif obligerait à reprendre tous ces prix un par un. Ce qu'il faut ici, c'est un tarif : un ensemble de montants qui s'active d'un seul tenant pour une catégorie de clients.
Une liste de prix n'est pas un ensemble de prix
Les deux noms se ressemblent, mais ils ne rangent pas les prix dans le même sens.
- Un
PriceSetappartient à une ressource : c'est l'ensemble des prix d'une variante, toutes devises et conditions confondues. - Une
PriceListtraverse plusieurs ensembles : elle réunit des prix de plusieurs variantes autour d'une même intention commerciale.
Voici la liste du tarif revendeurs, réduite à ses champs utiles :
{
"id": "plist_revendeurs",
"title": "Tarifs revendeurs",
"type": "override",
"status": "active",
"rules_count": 1
}
Et l'un de ses prix :
{
"id": "price_rev_42",
"amount": 75,
"currency_code": "eur",
"price_set_id": "pset_basket_42",
"price_list_id": "plist_revendeurs"
}
Champs omis : description, dates, bornes de quantité, dates techniques.
Ce prix a deux rattachements. Par price_set_id, il appartient à l'ensemble de la variante, à côté du 90 EUR public. Par price_list_id, il appartient au tarif revendeurs. Le prix n'est pas copié : c'est une seule ligne, vue de deux côtés.
| Variante | PriceSet | Prix public | Prix de plist_revendeurs |
|---|---|---|---|
| Basket 41 | pset_basket_41 | 90 EUR | 75 EUR |
| Basket 42 | pset_basket_42 | 90 EUR | 75 EUR |
| Basket 43 | pset_basket_43 | 90 EUR | 75 EUR |
Les prix publics ne changent pas.
Deux rattachements pour un même prix
PriceSetLes prix d’une seule variantePrice75 EURprice_set_id : son ensembleprice_list_id : sa listePriceListLes tarifs revendeurs de plusieurs variantesLa condition d'accès à la liste
Reste à dire à qui ce tarif s'adresse. C'est le rôle de la PriceListRule, une condition posée sur la liste entière :
{
"id": "prule_rev",
"price_list_id": "plist_revendeurs",
"attribute": "customer.groups.id",
"value": ["cusgrp_revendeurs"]
}
Là où une PriceRule porte sur un seul prix, la PriceListRule ouvre ou ferme tous les prix de la liste d'un coup. Sa value contient la liste des identifiants de groupes autorisés. Il suffit que l'un des groupes du client figure dans cette valeur pour que la condition soit remplie. Si la liste porte plusieurs conditions, toutes doivent l'être, comme pour les règles de prix.
Deux réglages complètent la liste. Son status vaut active ou draft : une liste en brouillon n'est jamais appliquée. Elle peut aussi avoir une date de début starts_at et une date de fin ends_at, hors desquelles elle est ignorée. Notre tarif revendeurs, permanent, n'en a pas besoin.
Créer et modifier le tarif
Le service Pricing offre une méthode par geste. La création de la liste peut inclure d'emblée sa condition et ses prix :
await pricingModuleService.createPriceLists([
{
title: "Tarifs revendeurs",
description: "Tarifs négociés pour les revendeurs",
type: "override",
status: "active",
rules: { "customer.groups.id": ["cusgrp_revendeurs"] },
prices: [
{ amount: 75, currency_code: "eur", price_set_id: "pset_basket_41" },
{ amount: 75, currency_code: "eur", price_set_id: "pset_basket_42" },
],
},
])
Comme pour les prix, rules est un paramètre d'entrée ; le module en tire les PriceListRule et tient rules_count à jour. Chaque prix indique son price_set_id : c'est ainsi qu'il rejoint l'ensemble de sa variante.
Ensuite :
addPriceListPricesajoute des prix à une liste existante, par exemple la pointure 43 oubliée ;setPriceListRuleschange la condition. Il remplace la valeur des attributs fournis et laisse en place les autres ;removePriceListRulesretire une condition.
Qui appartient au groupe
Le module compare des groupes ; il ne sait pas qui est le client. Ce sont les routes Store qui l'établissent : quand le client est authentifié, le backend charge son compte et ses groupes, puis les place dans le contexte de calcul. Le navigateur n'envoie pas lui-même « je suis revendeur » ; sinon n'importe qui pourrait se l'attribuer.
Dans le contexte, le groupe arrive sous une forme imbriquée que le module aplatit en customer.groups.id :
{
"currency_code": "eur",
"customer": { "groups": { "id": ["cusgrp_revendeurs"] } }
}
Le calcul avec un tarif override
Pour un client du groupe Revendeurs, deux prix de la basket 42 sont candidats : 90 EUR public et 75 EUR de la liste. La liste est active, sa condition est remplie. La réponse de calculatePrices, réduite :
{
"calculated_amount": 75,
"original_amount": 75,
"is_calculated_price_price_list": true
}
Deux montants apparaissent ici. calculated_amount est le montant unitaire retenu pour ce client. original_amount est le prix de référence, auquel on peut comparer ce montant ; l'afficher ou non relève de la boutique. Avec une liste override, les deux valent 75 : le tarif négocié n'est pas une réduction affichée, il devient le prix normal de ce client. La boutique n'a rien à barrer.
Pour un client hors du groupe, la condition de la liste échoue : son prix est exclu, et le calcul renvoie 90 et 90.
Un override peut aussi être plus élevé que le prix public. La liste remplace le montant ; elle ne cherche pas le moins cher.
Un autre usage : la liste sale
Le second type répond à un besoin différent. Imaginons, sans lien avec les revendeurs, que la marque écoule un ancien coloris de sa basket, vendu 90 EUR. Elle crée une liste de type sale, sans condition de groupe, avec un prix de 70 EUR pour cette variante.
Pour tout client, le calcul renvoie alors :
{
"calculated_amount": 70,
"original_amount": 90
}
Cette fois, le prix de référence reste 90. La boutique peut afficher 90 EUR barré et 70 EUR : c'est l'intérêt d'une sale, qui valorise l'écart avec le prix habituel. Deux précisions évitent les malentendus. Le 70 EUR est un montant saisi, pas une remise calculée : le module n'applique aucun pourcentage. Et un prix sale n'est retenu que s'il est inférieur ou égal au prix de référence ; sinon, c'est la référence qui s'applique.
Quand plusieurs listes valent pour le même client, le module les classe puis tient compte de leur type. Ce cas croisé est décrit dans la documentation du calcul des prix ; les deux exemples ci-dessus suffisent pour l'usage courant.
Dans l'application
Une application Medusa ne crée généralement pas ses listes en appelant le service directement. Elle passe par createPriceListsWorkflow, que la route Admin de création utilise. La saisie s'y fait par variante : le workflow vérifie que chaque variante possède bien son ensemble de prix, puis appelle le module.
Côté Admin, le menu Price Lists ouvre ce même parcours. Le formulaire de création se déroule en trois étapes : Details, où l'on choisit le type Sale ou Override, le titre, le statut, les dates éventuelles et les groupes de clients concernés ; Products, où l'on coche les produits ; Prices, où l'on saisit les montants.
La capture montre cette première étape remplie dans une boutique de démonstration, sans enregistrement : on y voit le titre, le statut et, en bas, le contrôle qui réserve la liste à des groupes de clients. Aucune liste n'existant dans cette boutique, l'écran ne montre aucun prix à 75 EUR.
Ce que les listes ne font pas
Une liste fixe des montants ; les réductions en pourcentage et les codes promotionnels relèvent du module Promotion. Une opération saisonnière peut s'appuyer sur l'un ou l'autre, puisqu'une liste peut elle aussi être bornée par des dates.
Ce qu'on sait faire maintenant
Une PriceList réunit des prix de plusieurs variantes, chacun restant rattaché au PriceSet de sa variante. Une PriceListRule en réserve l'accès, par exemple à un groupe de clients identifié par le backend. Avec override, le tarif négocié devient le prix normal du client ; avec sale, un montant plus bas peut être affiché face au prix de référence. On peut ainsi organiser, activer ou suspendre un tarif client en entier, par statut ou par dates, sans toucher aux prix publics des variantes.
Sources
- Documentation Medusa : modèles
PriceListetPriceListRule, calcul des prix,createPriceListsWorkflow, créer une liste de prix dans l’Admin.