Medusa Explained · Pricing · 1/4
Le module Pricing dans Medusa : enregistrer les prix d’une variante
Medusa est organisé en modules : chacun prend en charge un domaine de la boutique, avec ses propres données et ses propres opérations. Le catalogue décrit ce que l’on vend ; le module Pricing tient les montants. En suivant une seule paire de baskets, de son premier prix en euros jusqu’à un tarif pour les achats en nombre, nous verrons comment ces montants sont rangés, rattachés à l’article et choisis au moment de vendre.
Dans cet article
Une pointure, un premier prix
Une boutique vend la basket Runner en plusieurs pointures. Un client n’achète pas « la Runner » en général : il met dans son panier une paire en pointure 42. Cette déclinaison précise d’un produit, celle que l’on commande réellement, s’appelle une variante.
La boutique vend la Runner en 42 à 90 € la paire. Ce prix tient en deux informations : un montant, 90, et une devise, l’euro. Sans la devise, le chiffre ne veut rien dire.
Une seconde devise, choisie à part
La boutique ouvre ses ventes aux États-Unis. Elle fixe le prix de la même paire à 110 $. Ce montant n’est pas obtenu en convertissant les 90 € au taux du jour : le marchand le choisit lui-même, comme il a choisi les 90 €. Chaque devise porte donc son propre montant.
La pointure 42 a maintenant deux prix :
| Devise | Prix de la paire |
|---|---|
| Euro | 90 € |
| Dollar | 110 $ |
Regrouper les prix d’une même variante
Au moment de vendre, la boutique doit pouvoir répondre à une question simple : « quels sont tous les prix de la Runner en 42 ? ». Pour cela, les deux montants sont rangés ensemble, dans une même collection propre à cette variante. Le jour où la boutique ajoute une devise, le nouveau prix rejoint la même collection.
Medusa donne un nom à chacun de ces deux éléments :
- un
Priceest un prix : un montant et sa devise, avec parfois des conditions d’application que nous verrons plus loin ; - un
PriceSetest la collection qui réunit tous les prix d’une variante.
La collection contient les prix ; chaque prix appartient à une seule collection.
Associer la collection à la variante
La variante fait partie du catalogue, le module Product. La collection de prix fait partie du module Pricing. Ces deux domaines restent distincts : le catalogue ne garde pas les montants, et le module des prix ne sait pas ce qu’est une pointure ou une basket.
Il faut pourtant savoir que telle collection contient les prix de la Runner en 42. Medusa conserve donc cette association en dehors des deux modules, comme une fiche de correspondance qui dit simplement : cette variante, cette collection de prix. Ni le catalogue ni le module des prix n’ont à connaître l’autre pour que l’association existe.
C’est tout l’intérêt de la collection : une seule association suffit à relier la variante à tous ses prix, présents et à venir. Aucun prix n’a besoin d’être relié séparément.
Une association de ce type, tenue par Medusa entre deux modules, s’appelle un lien de module.
Ce que montre l’Admin
Dans l’Admin, la fiche de la variante 42, ouverte depuis le produit Basket Runner, affiche ses prix dans un bloc à droite, intitulé Prices. On y retrouve les deux montants de la collection : 90 € en euros et 110 $ en dollars. Ce sont les prix standard de la variante ; pour l’instant, aucun ne dépend du nombre de paires achetées.
Le menu de ce bloc ouvre une grille d’édition. Elle présente une case par devise : on y lit ou on y change le prix de la paire en euros et en dollars.
Un prix qui dépend de la quantité
Des clubs de course achètent par lots. La boutique décide qu’à partir de 5 paires, la paire coûte 80 € au lieu de 90 €.
Un prix peut donc porter une condition de quantité : un nombre minimal de paires, et éventuellement un nombre maximal. La boutique ajoute le prix à 80 €, à partir de 5 paires et sans plafond. En même temps, elle choisit de réserver le prix à 90 € aux achats de 1 à 4 paires : c’est elle qui fixe cette limite, le module ne la déduit pas. Les bornes sont incluses : 4 paires sont encore à 90 €, 5 paires passent à 80 €. Le prix en dollars, lui, n’a pas de condition de quantité : il vaut 110 $ quel que soit le nombre de paires.
Ces trois prix appartiennent tous à la même collection, celle de la Runner en 42 :
| Devise | Quantité | Prix de la paire |
|---|---|---|
| Euro | de 1 à 4 paires | 90 € |
| Euro | à partir de 5 paires | 80 € |
| Dollar | toute quantité | 110 $ |
Choisir le bon prix au moment de vendre
Quand un client achète des Runner en 42, la collection propose plusieurs prix. Le module retient celui qui correspond à la devise et au nombre de paires. Ce qu’il donne est un prix unitaire : le prix d’une paire.
Le montant des paires s’obtient ensuite en multipliant ce prix par la quantité :
- 3 paires en euros : le prix retenu est 90 €, soit 270 € pour les trois paires ;
- 5 paires en euros : le prix retenu est 80 €, soit 400 €.
Dans le second cas, toutes les paires passent à 80 €, pas seulement la cinquième. Le montant n’est pas 4 × 90 € + 1 × 80 €, mais 5 × 80 €.
Ce que fait le module, et comment l’application s’en sert
Le reste de l’application n’écrit pas directement les prix. Le module Pricing lui propose un ensemble d’opérations prêtes à l’emploi, et c’est par elles que tout passe. Cet ensemble d’opérations offert aux autres parties de l’application s’appelle un service.
Pour les prix d’une variante, ce service sait :
- créer une collection avec ses premiers prix ;
- lire les prix d’une collection ;
- ajouter un prix, en modifier un, en retirer un ;
- choisir le bon prix unitaire pour une devise et une quantité.
Créer une collection ne suffit pourtant pas : le module des prix ne connaît pas les variantes, et la nouvelle collection n’est encore associée à rien. Enregistrer les prix de la Runner en 42 demande donc plusieurs opérations enchaînées. Si la variante n’a pas encore de collection, il faut en créer une avec ses prix, puis poser l’association avec la variante. Si elle en a déjà une, il faut la retrouver grâce à l’association, puis mettre ses prix à jour.
Une suite d’opérations coordonnées de cette façon, qui s’appuie sur plusieurs modules pour accomplir une tâche complète, s’appelle un workflow. Medusa en fournit un pour ce cas : upsertVariantPricesWorkflow. Il prend en charge à la fois la collection, ses prix et l’association avec la variante.
Les paliers de quantité et la fiche de la variante
Une fois les paliers enregistrés, la fiche de la variante 42 affiche dans son bloc Prices trois lignes : 90 € en euros, 80 € en euros et 110 $ en dollars. Rien n’y indique que 90 € vaut de 1 à 4 paires et 80 € à partir de 5. La grille d’édition, elle, ne garde qu’une case par devise : 80 en euros et 110 en dollars. Le prix à 90 € n’y apparaît plus, et aucune case ne permet de saisir un nombre minimal ou maximal de paires. Les bornes restent consultables dans l’inspection technique de la fiche, mais pas dans la présentation des prix.
Le module, lui, sait enregistrer ces paliers et choisir le prix qui convient. Sur une variante, c’est donc un développeur qui les met en place, en passant par les opérations du module ou par le workflow. Il peut aussi ajouter un encart à la fiche de la variante pour lire et modifier ces paliers.
Ce qu’il faut retenir
Un prix, c’est un montant dans une devise, parfois réservé à certaines quantités. Tous les prix d’une variante sont rangés dans une même collection. Le catalogue et le module des prix restent séparés, et Medusa garde à part l’association entre la variante et sa collection. Au moment de vendre, la devise et le nombre de paires désignent le prix d’une paire ; le montant des paires en découle. Enfin, une suite d’opérations coordonnées crée ou met à jour la collection et l’associe à la bonne variante.
Le prochain article montre comment une même variante peut coûter un montant différent selon la situation de vente.