Medusa Extend · Cas pratique
Penser le B2B dans Medusa
Vendre aux professionnels peut commencer par des coordonnées de facturation. Lorsque l’entreprise devient un compte acheteur, comment organiser ses relations et ses achats dans Medusa ?
Ajouter des coordonnées professionnelles à un client peut suffire à certains commerces. Le cas le plus simple se présente au moment de payer : la personne renseigne le nom de son entreprise, son adresse et son numéro de TVA pour obtenir une facture au nom de l’entreprise.
Le marchand peut aussi proposer d’enregistrer ces informations sur la fiche du client, pour les réutiliser à chaque commande. Cette solution convient, par exemple, à un artisan qui achète toujours pour son activité : les coordonnées de son entreprise restent enregistrées sur sa fiche client.
Le besoin change lorsque le marchand veut gérer l’entreprise comme un client à part entière. Les interlocuteurs de l’entreprise évoluent, mais ses achats doivent lui rester rattachés, et ses conditions commerciales ne sont pas nécessairement celles des personnes qui commandent. La relation commerciale doit donc se poursuivre même lorsque les contacts changent.
Plusieurs usages peuvent alors se présenter :
- Vendre aux particuliers et aux entreprises dans la même boutique. Une personne peut y faire un achat personnel, puis un achat pour son entreprise. Les deux achats doivent rester distincts, chacun avec ses adresses et ses conditions commerciales.
- Permettre à plusieurs personnes d’acheter pour une même entreprise. Chacune se connecte avec ses propres identifiants ; les achats effectués pour l’entreprise doivent pouvoir être retrouvés même si l’une de ces personnes part.
- Permettre à une personne d’acheter pour plusieurs entreprises. À chaque achat, elle choisit l’entreprise concernée ; chaque entreprise peut avoir ses propres adresses et conditions commerciales.
Ces usages demandent de distinguer la personne qui agit du compte pour lequel elle achète. Comment représenter cette relation dans Medusa, puis rattacher au bon compte les commandes, les adresses et les conditions commerciales ? Pour construire une réponse, partons d’un cas concret : un fournisseur de tissus.
Un fournisseur, plusieurs façons d’acheter
Alice achète du tissu chez Maison Trame, un fournisseur qui vend en ligne avec Medusa. Elle y commande parfois pour ses projets personnels. Elle achète aussi pour Atelier Rivage, un atelier de tapisserie, et pour Studio Boréal, un cabinet d’architecture intérieure. Chez Maison Trame, elle achète donc pour trois comptes différents, avec une seule connexion.
Atelier Rivage a un autre acheteur : Karim. Alice prépare un panier pour l’atelier, Karim le reprend et passe la commande. La livraison part à l’atelier, et Maison Trame facture l’entreprise au tarif convenu avec l’atelier. Quelques mois plus tard, Alice quitte Atelier Rivage. Karim doit pouvoir poursuivre les achats sans perdre les commandes précédentes ni les adresses de l’atelier. Alice, elle, continue d’acheter pour Studio Boréal et pour elle-même.
Maison Trame veut réunir dans une même installation Medusa les trois usages décrits plus haut. Dans le cas retenu, les acheteurs d’une entreprise partagent ses paniers, ses commandes et son carnet d’adresses. Chaque entreprise peut avoir ses propres conditions commerciales.
Ce partage est un choix de Maison Trame. Un autre fournisseur pourrait garder des paniers individuels tout en partageant les commandes de l’entreprise. Dans les deux cas, la boutique doit savoir qui prépare le panier, pour quelle entreprise, et qui peut le reprendre.
Pour un achat personnel, Alice est à la fois la personne qui commande et la cliente à qui revient l’achat. Pour l’atelier, elle agit au nom d’un autre compte : le compte entreprise d’Atelier Rivage. Son rattachement à l’atelier ne doit ni donner à Karim accès aux commandes personnelles d’Alice, ni appliquer le tarif de l’atelier à un panier destiné à Studio Boréal.
Aliceune seule connexion
-
Alice
Panier d’Alice
Adresses d’Alice
-
Atelier Rivage
Paniers de l’atelier
Adresses de l’atelier
-
Studio Boréal
Paniers du studio
Adresses du studio
Ce que Medusa gère déjà
Les achats d’Atelier Rivage suivent en grande partie le même parcours que les achats personnels d’Alice : choisir des produits, remplir un panier, obtenir un prix, passer une commande, payer et recevoir une livraison. Medusa dispose déjà des modules nécessaires à ces opérations.
Le module Customer gère les fiches clients. Dans notre conception, la fiche d’Alice représente la personne connue de la boutique, et Alice se connecte avec l’authentification native de Medusa. Elle garde cette même fiche lorsqu’elle achète pour une entreprise : elle n’a pas à créer une nouvelle identité pour chacun de ses usages.
Les produits restent gérés par Product, les paniers par Cart et les commandes par Order. Les calculs de prix restent confiés à Pricing. Les paiements restent gérés par Payment, les réservations de stock par Inventory et les livraisons par Fulfillment. Une commande d’Atelier Rivage reste ainsi une commande Medusa, que le marchand traite avec ses outils habituels.
La recette B2B de Medusa explique comment utiliser les groupes de clients, les listes de prix et les canaux de vente pour proposer des offres professionnelles. Elle prévoit aussi la création d’un module personnalisé avec des entreprises et des employés. Le starter B2B officiel fournit déjà une gestion des entreprises et de leurs employés.
Dans notre cas, il faut préciser pour quel compte chaque achat est effectué. Savoir qu’Alice appartient à un groupe de clients professionnels ne dit pas si son panier est personnel, destiné à Atelier Rivage ou à Studio Boréal. Nous allons donc représenter les rattachements d’Alice à ces entreprises, puis enregistrer l’entreprise concernée par chaque panier et chaque commande. Maison Trame pourra ainsi conserver les achats d’une entreprise quand ses acheteurs changent, tout en gardant séparés les autres achats d’Alice.
Les entités du module Company
Nous regroupons les informations propres aux entreprises clientes dans un module Company. Nous allons utiliser quatre de ses entités : Company, Buyer, CompanyAddress et CompanyGroup.
Une entité Company représente une entreprise cliente. Atelier Rivage et Studio Boréal ont chacun leur fiche, qui indique le nom de l’entreprise.
La fiche comporte aussi un statut. Une entreprise peut être active ou suspendue. Maison Trame peut suspendre les achats d’Atelier Rivage sans supprimer sa fiche ni les commandes déjà passées.
Le lien entre une personne et une entreprise devient lui aussi une information à part entière. Nous le représentons par une entité Buyer : elle relie un Customer à une Company et indique si ce rattachement est actif. Alice a un rattachement à Atelier Rivage et un autre à Studio Boréal. Karim a le sien à Atelier Rivage.
Buyer ne remplace donc pas la fiche d’Alice. Il représente sa qualité d’acheteuse pour une entreprise donnée. Désactiver son rattachement à Atelier Rivage lui retire l’accès aux données et aux achats de l’atelier ; sa fiche client et son rattachement à Studio Boréal restent en place. Si elle revient travailler pour l’atelier, ce même rattachement peut être réactivé.
Un module link relie chaque Buyer à la fiche Customer de la personne concernée. Le rattachement d’Alice à Atelier Rivage et son rattachement à Studio Boréal renvoient ainsi vers la même fiche client. Alice est enregistrée une seule fois dans le module Customer ; ses deux rattachements sont enregistrés dans le module Company.
Les adresses de facturation et de livraison d’Atelier Rivage sont enregistrées dans des entités CompanyAddress, rattachées à sa fiche Company. Elles forment le carnet d’adresses de l’entreprise. Dans notre exemple, Alice et Karim peuvent tous deux y choisir une adresse lorsqu’ils préparent un panier pour l’atelier.
Les adresses personnelles d’Alice restent enregistrées avec sa fiche dans le module Customer. Pour un achat personnel, la boutique lui propose ces adresses ; pour un achat destiné à Atelier Rivage, celles de l’atelier. Les adresses de Studio Boréal sont conservées dans le carnet de cette autre entreprise.
Pour appliquer les mêmes conditions commerciales à plusieurs entreprises, nous ajoutons une entité CompanyGroup. Maison Trame crée, par exemple, un groupe « Ateliers partenaires » auquel appartient Atelier Rivage. Une liste de prix pourra viser ce groupe, plutôt que chaque atelier séparément.
Le module Company enregistre les entreprises qui appartiennent à chaque groupe. Une entreprise peut être rattachée à plusieurs groupes, et un tarif peut aussi lui être réservé directement. Ces groupes d’entreprises sont distincts des groupes de clients du module Customer, qui réunissent des personnes.
Il reste une décision importante : que permet le rattachement Buyer d’un acheteur à son entreprise ? Chez Maison Trame, les acheteurs dont le rattachement est actif peuvent consulter les commandes et reprendre les paniers de leur entreprise. C’est la politique d’accès choisie pour cette boutique. Une autre boutique pourrait limiter un panier à son créateur, ou répartir les accès par service. Le rattachement d’Alice à l’atelier sert de base à ces règles ; leur contenu dépend de chaque projet.
Alice quitte Atelier Rivage
| Acheteur | Avant | Après |
|---|---|---|
Alice | Buyer actif | Accès retiré |
Karim | Buyer actif | Buyer actif |
Atelier Rivage
Ses commandesrestent en place.
Appliquer les prix de l’entreprise
Maison Trame propose les mêmes tissus à plusieurs clientèles. Un rouleau peut être acheté au prix public par Alice, au tarif des ateliers partenaires par Atelier Rivage ou au tarif négocié avec Studio Boréal.
Medusa calcule déjà les prix avec le module Pricing. Chaque variante possède des prix de base, par devise. Des listes de prix ajoutent des montants réservés aux acheteurs qui remplissent les conditions de la liste, avec éventuellement des paliers de quantité. Nous utilisons ces conditions pour cibler une entreprise ou un CompanyGroup.
Dans notre exemple fictif, Maison Trame fixe le prix public du rouleau à 100 €. Une liste réservée au groupe « Ateliers partenaires » propose 80 €, puis 70 € à partir de dix rouleaux. Une autre liste réserve un prix de 65 € à Studio Boréal.
Pour choisir le bon prix, le moteur de prix doit connaître l’entreprise pour laquelle l’achat est effectué et les groupes auxquels elle appartient. Avec ces informations, douze rouleaux commandés pour Atelier Rivage sont calculés à 70 € l’unité, puisque le palier de dix rouleaux est atteint ; pour Studio Boréal, ils sont calculés à 65 €. Dans son panier personnel, Alice garde ses conditions personnelles : ici, le prix public de 100 €.
Maison Trame vend aux particuliers et aux entreprises : ses prix publics servent de base, et ses listes ajoutent les conditions professionnelles. Un fournisseur qui ne vend qu’aux professionnels peut fixer directement ses prix de base B2B, sans référence à un prix grand public.
Le même tissu, trois tarifs
AliceAchat personnelPrix public
100 €par rouleau
Atelier RivageAchat pour l’atelierCompanyGroupAteliers partenaires
Studio BoréalAchat pour le studioTarif réservé au studio
65 €par rouleauProposer des catalogues différents
Maison Trame décide de réserver certains rouleaux de grand format aux professionnels. D’autres tissus restent vendus à tout le monde. Les canaux de vente de Medusa permettent d’organiser ces deux offres.
Maison Trame crée un canal pour sa boutique grand public et un canal pour son espace professionnel. Les rouleaux réservés aux professionnels sont associés uniquement au second. Les tissus vendus aux deux clientèles sont associés aux deux canaux : ils restent les mêmes produits, avec les mêmes variantes et leurs stocks.
Le canal détermine le catalogue proposé. Les listes de prix déterminent les tarifs applicables. Atelier Rivage et Studio Boréal peuvent ainsi partager le même catalogue professionnel tout en bénéficiant de prix différents.
Un catalogue commun, une offre réservée aux professionnels
| Produits | Canalgrand public | ![]() ![]() professionnel |
|---|---|---|
Tissu commun | Disponible | Disponible |
Rouleau grand format | Absent | Disponible |
Faire fonctionner l’ensemble avec l’API B2B
Dans la boutique, Alice indique pour qui elle achète : pour elle-même, pour Atelier Rivage ou pour Studio Boréal. Ce choix définit son contexte d’achat : la personne qui agit et le compte pour lequel elle agit. Il permet d’afficher le bon catalogue, les bons prix et les bonnes adresses.
Ce contexte accompagne chaque parcours d’achat. Alice peut préparer un panier pour l’atelier, puis un autre pour le studio : choisir Studio Boréal pour le second ne modifie pas le premier.
Des routes dédiées aux entreprises
Pour afficher des produits, consulter des commandes ou créer un panier, la boutique envoie des demandes à l’API de Medusa. Chaque route d’API donne accès à une action ou à des informations.
Pour les achats personnels, la boutique utilise les routes Store habituelles de Medusa. Pour agir au nom d’une entreprise, nous ajoutons des routes Store B2B dédiées, regroupées sous /store/b2b/companies/:company_id. L’identifiant présent dans la route indique l’entreprise concernée.
Le module expose notamment deux routes :
GET /store/b2b/companies/:company_id/productspour consulter les produits et leurs prix ;POST /store/b2b/companies/:company_id/cartspour créer un panier destiné à cette entreprise.
Ces routes permettent de consulter le catalogue et les prix d’une entreprise, de créer ses paniers et de retrouver ses commandes. Lorsqu’Alice choisit Atelier Rivage, la boutique appelle les routes B2B avec l’identifiant de l’atelier. Alice reste la personne connectée.
Vérifier qu’Alice peut agir pour Atelier Rivage
Dans cette conception, nous plaçons les contrôles à l’entrée des routes d’entreprise, dans des middleware : des fonctions exécutées avant l’action demandée. L’authentification native de Medusa identifie d’abord Alice à partir de sa connexion.
Le contrôle B2B vérifie ensuite deux choses :
- Atelier Rivage est une entreprise active ;
- un rattachement
Buyeractif autorise Alice à agir pour Atelier Rivage.
Ces vérifications s’appliquent à toutes les routes d’entreprise, pour afficher des produits et leurs prix comme pour créer un panier ou passer une commande.
Pour consulter une commande dans l’espace d’Atelier Rivage, Alice doit avoir le droit d’agir pour l’atelier. La commande demandée doit également appartenir à Atelier Rivage. Le serveur vérifie ces deux conditions avant de l’afficher.
Si Maison Trame retire Alice des acheteurs autorisés d’Atelier Rivage, Alice perd l’accès aux paniers et aux commandes de l’atelier. Ces achats restent disponibles pour Karim. Alice conserve ses achats personnels et son accès à Studio Boréal.
Afficher les produits et leurs prix
Alice consulte d’abord le catalogue d’Atelier Rivage. Une fois les contrôles passés, la route B2B lit les produits avec le mécanisme natif de Medusa, limité au canal professionnel. Elle enrichit le contexte de calcul des prix avec l’identifiant de l’atelier et les groupes d’entreprises auxquels il appartient.
La boutique peut alors afficher les produits de ce catalogue avec les tarifs des ateliers partenaires. Si Alice choisit Studio Boréal, la boutique demande les produits dans le contexte du studio, et les prix affichés suivent ses conditions commerciales.
Créer un panier avec les hooks natifs
Pour créer le panier d’Atelier Rivage, la route B2B appelle le workflow natif createCartWorkflow. Ce workflow propose des hooks : des points prévus pour y ajouter notre propre logique. Nous en utilisons deux pour les achats d’entreprise :
- Dans
setPricingContext, nous fournissons l’identifiant d’Atelier Rivage et ses groupes d’entreprises. Le moteur de prix peut ainsi appliquer les listes de prix décrites plus haut. - Dans
cartCreated, une fois le panier créé, nous enregistrons qu’il appartient à Atelier Rivage et qu’Alice en est la créatrice.
Quand Alice ajoute ensuite un produit, le workflow natif addToCartWorkflow propose lui aussi setPricingContext. Nous lui fournissons les mêmes informations pour calculer le prix du produit ajouté.
Deux hooks pour adapter le panier natif
Aliceachète pourAtelier Rivage
createCartWorkflowsetPricingContextAtelier Rivage + ses groupesCalculer le tarif applicablecartCreatedEntreprise : Atelier RivageCréatrice : AliceRattacher le panier
Panier de l’atelierTarif de l’atelierCréé par Alice
Confirmer la commande
Karim reprend ensuite le panier de l’atelier. La boutique appelle la route B2B correspondante ; les contrôles vérifient cette fois que Karim peut agir pour Atelier Rivage.
Nous réutilisons completeCartWorkflow pour passer la commande. Dans son hook validate, nous vérifions que l’entreprise est toujours active et que les coordonnées nécessaires à la commande sont renseignées.
Le résultat est une commande Medusa ordinaire. Nous enregistrons qu’elle a été passée pour Atelier Rivage et confirmée par Karim ; Alice reste identifiée comme la créatrice du panier.
Alice
Karim
Atelier Rivage
compte entreprise
Panier, puis commande
interventions
Alice prépare le panier
Karim confirme la commande
La commande garde les coordonnées utilisées pour cet achat. Si l’atelier déménage ensuite, son carnet d’adresses peut être mis à jour sans modifier les adresses des commandes déjà passées.
Ajouter les workflows propres au compte entreprise
Les opérations qui ne concernent que le module Company peuvent avoir leurs propres workflows. Un workflow d’inscription peut, par exemple, créer une entreprise, enregistrer son adresse de facturation si elle est fournie, puis y rattacher un premier acheteur.
Dans cet exemple, le premier acheteur possède déjà une fiche Customer : le workflow ne crée pas de nouvelle personne, il crée le rattachement Buyer qui relie cette fiche à la nouvelle entreprise. Ajouter ensuite un autre acheteur, ou retirer l’accès d’un acheteur, passe aussi par les opérations du module Company, appelées depuis les routes réservées à la gestion des entreprises.
Le B2B prend forme dans Medusa
Voici comment gérer les entreprises, leurs acheteurs, leurs tarifs et leurs commandes dans Medusa.
L’entreprise et ses acheteurs
La fiche d’Atelier Rivage présente ses deux acheteurs, Alice et Karim, ainsi que le carnet d’adresses de l’atelier.

Un tarif réservé aux ateliers partenaires
La liste de prix reprend nos deux montants : 80 € par rouleau, puis 70 € à partir de dix rouleaux. Elle cible le groupe d’entreprises « Ateliers partenaires ».

Une commande au nom d’Atelier Rivage
La commande B2B affiche douze rouleaux à 70 €, soit 840 € de produits. Son panneau Company réunit Atelier Rivage, Karim — qui a passé la commande — et les adresses de livraison et de facturation.

Un socle pour plusieurs organisations B2B
Alice peut maintenant acheter chez Maison Trame pour elle-même, pour Atelier Rivage ou pour Studio Boréal. Chaque panier conserve le compte concerné, ses adresses et ses conditions commerciales. Karim peut reprendre le panier de l’atelier et confirmer la commande ; après le départ d’Alice, la désactivation de son rattachement lui ferme l’accès à l’atelier sans interrompre les achats de l’entreprise.
Pour construire ce fonctionnement, nous avons ajouté les entreprises, leurs rattachements aux personnes, leurs adresses et leurs groupes d’entreprises. Les paniers, les commandes et les calculs de prix restent ceux de Medusa. Les contrôles d’accès vérifient qui peut agir ; les hooks apportent le contexte d’entreprise aux opérations natives.
Ce socle peut servir une boutique mixte, un commerce exclusivement professionnel ou un portail de revendeurs avec un catalogue réservé. Les acheteurs peuvent intervenir pour une seule entreprise ou pour plusieurs, selon les rattachements qui leur sont accordés.
Il permet aussi de concevoir des organisations plus détaillées, en ajoutant les relations et les règles nécessaires. Une société mère et ses filiales pourraient avoir des comptes distincts, avec des achats ou des conditions négociées à coordonner. Des départements pourraient disposer de leurs propres accès et budgets. Ces relations supplémentaires devraient être modélisées : le seul rattachement d’une personne à une entreprise ne les définit pas.
On peut également distinguer les rôles dans une même entreprise. Alice pourrait préparer des propositions d’achat et repérer des tissus, tandis que Karim serait seul autorisé à engager la dépense. Un comptable pourrait consulter les documents de facturation sans acheter. Des plafonds de dépenses, des circuits d’approbation ou des demandes de devis ajouteraient leurs propres données et étapes à ces parcours.
Ces extensions prolongeraient le modèle présenté ici sans en changer les principes : le choix du compte acheteur reste explicite, les personnes gardent leur identité et les opérations commerciales s’appuient sur les mécanismes de Medusa. C’est à partir de ces distinctions que l’on peut adapter le B2B au fonctionnement réel de chaque marchand.

