Platinum uniquement
L’accès à la Public API nécessite le plan Platinum sur une boutique en production, ou Enterprise sur un ancien plan. Une clé par boutique.
BSS B2B Solution : Public API
Intégration ERP avec la Public API de BSS B2B Solution : clés, points d’accès et limites
La Public API de BSS B2B Solution permet à votre ERP, votre PIM ou votre outil maison de créer, mettre à jour et supprimer des règles Custom Pricing, Volume Pricing, Price List et Discount Code, de gérer les formulaires d’inscription, et de rechercher des clients, produits et collections. Elle nécessite le plan Platinum sur une boutique en production et une clé API par boutique. Il n’existe aucun point d’accès pour les commandes.
Installer BSS B2B Solution Retour à BSS B2B Solution Nécessite le plan Plan Platinum. BSS B2B Solution propose un essai gratuit de 14 jours (plans payants). 4,9 sur 5, d’après 1 190 avis sur le Shopify App Store (au 19 octobre 2026).
Comment obtenir une clé API et faire le premier appel ?
Vous créez la clé dans l’app. Les appels eux-mêmes sont faits par votre développeur ou votre partenaire d’intégration, à partir des pages de points d’accès du guide utilisateur.
-
Vérifier le plan
La Public API nécessite le plan Platinum, ou le plan Enterprise sur un ancien plan. La clé ne peut pas être créée sur les autres plans.
-
Ouvrir la carte Public API
Dans le menu de l’app, cliquez sur Integrations et repérez la carte Public API. Cliquez sur Get API key.
-
Générer la clé et la conserver
Générez la clé, puis cliquez tout de suite sur Copy ou Download. L’app ne l’affiche qu’une fois. Traitez-la comme un mot de passe : quiconque la possède peut lire vos données B2B et appeler les points d’accès d’écriture.
-
Activer la fonction Public API
La page qui contient la clé comporte une commande Public API function avec un bouton Enable. Les requêtes, en version 1 comme en version 2, ne sont acceptées que lorsque la fonction est active.
-
Envoyer la clé avec chaque requête
Pour la version 1, passez `accessKey` dans le corps de la requête ou l’en-tête `x-bss-b2b-api-key`, avec le `domain` de votre boutique. La version 2 utilise l’en-tête `x-api-key`. Quelques points d’accès de la version 1 lisent la clé dans le corps uniquement : les points d’envoi Custom Pricing, Volume Pricing et Price List, `PUT /rule/delete-items`, `PUT /pl/delete-items` et `PUT /pl/update-items`. Le point d’envoi Discount Code lit la clé dans l’en-tête `x-bss-b2b-api-key` uniquement.
-
Écrire les règles, puis les envoyer
Créez ou mettez à jour les règles avec les points d’accès Custom Pricing, Volume Pricing ou Price List. Appelez ensuite le point d’envoi du module pour que les règles activées atteignent le thème en ligne.
-
Contrôler Logs and usage
Sur la carte Public API, cliquez sur Logs and usage. La liste affiche les requêtes récentes avec leur statut, leur méthode et leur chemin, et vous pouvez ouvrir une ligne pour voir la requête et la réponse complètes.
Générez une clé API et faites votre premier appel avec le plan Platinum. La fiche de l’app affiche un essai gratuit de 14 jours (plans payants).
Ce que couvre la Public API
Voici ce que documentent le guide utilisateur et le code de l’app, regroupé par module. Le guide utilisateur contient une page avec les charges utiles des groupes Custom Pricing, Volume Pricing, Price List, Registration Form et envoi.
| Module | Ce que vous pouvez faire | Remarques |
|---|---|---|
| Custom Pricing | Lire les règles par domaine ou par ID, enregistrer, enregistrer en masse, supprimer, supprimer en masse, envoyer, et rechercher des règles par produits ou par clients. | Version 1, chemin /rule/*. |
| Volume Pricing | Le même ensemble que Custom Pricing, sans les recherches par produits et par clients, et sans delete-items. La version 2 ajoute GET /vp/rules. | Version 1, chemin /qb/*. |
| Price List | L’ensemble Custom Pricing plus update status, update, delete items et update items. | Version 1, chemin /pl/*. |
| Discount Code | Lire, créer et supprimer des règles, plus un point d’envoi. | Version 1, chemin /dc/*. |
| Registration Form | Récupérer le schéma d’un formulaire, soumettre une inscription de grossiste, filtrer les demandes et changer le statut des demandes en attente. | Les changements de statut ne fonctionnent que sur les comptes en attente. Les formulaires en plusieurs étapes exigent toujours un e-mail. |
| Order Limit | Lire les règles et mettre à jour une règle. | Version 1, chemin /ol/*. |
| Clients, produits, collections | Rechercher les tags client, chercher des clients, obtenir des clients par ID ou par tags, lister les produits et les collections. | Lecture seule. Vous ne pouvez pas créer ni modifier des clients ou des produits par l’API. |
| Commandes | Non disponible. | Il n’existe aucun point d’accès pour les commandes. |
Source : code de la Public API de BSS B2B Solution et guide utilisateur BSS pour les Public APIs, vérifiés le 9 octobre 2026.
Clés, en-têtes et versions de l’API
Chaque boutique a une seule clé API. Si une clé existe déjà, l’app n’en crée pas une deuxième. Pour la changer, supprimez la clé sur la carte Public API, ce qui arrête immédiatement tous les clients qui l’utilisent, puis générez-en une nouvelle.
Les deux versions de l’API utilisent des noms d’en-tête différents. La version 1 (`/api/v1/...`) lit `x-bss-b2b-api-key`, ou `accessKey` dans le corps. La version 2 (`/api/v2/...`) lit `x-api-key`. Si vous intégrez plusieurs groupes, vérifiez l’en-tête point d’accès par point d’accès. N’envoyez pas la clé sous la forme `Authorization: Bearer`. La version 2 répond à cela par `401 ACCESS_KEY_MISSING`. La version 1 répond par HTTP 200 et `success: false`, donc lisez le champ `success` et pas seulement le statut HTTP.
- Version 1 : Custom Pricing, Volume Pricing, Price List, Discount Code, Registration Form, Order Limit, recherches.
- Version 2 : GET /vp/rules pour Volume Pricing (le point d’accès documenté).
- Les résultats partiels d’envoi reviennent aussi avec HTTP 200 : vérifiez `status` ou `success`.
Quelles sont les limites de la Public API ?
Limite de débit de la version 2
60 requêtes par 60 secondes et par boutique, avec les en-têtes X-RateLimit. Au-delà, la réponse est 429.
Envoi : une fois toutes les 5 minutes
Chaque point d’envoi autorise une requête par module toutes les 5 minutes. Regroupez vos modifications, puis envoyez une seule fois.
Les écritures en masse s’exécutent une à la fois
Pendant qu’un appel d’enregistrement en masse, de suppression en masse, delete-items ou update-items s’exécute pour une boutique, les autres écritures en masse de Custom Pricing, Price List et Volume Pricing renvoient 429 avec le message que le domaine exécute un autre processus. Après une erreur serveur, attendez jusqu’à 3 minutes.
Plafond de stockage du thème
Les règles envoyées sont stockées dans des metafields Shopify : 10 clés, 2 000 000 de caractères par clé, soit environ 20 000 000 au total. Les règles au-delà du plafond sont ignorées et listées dans un rapport partial_success. Seules les règles activées sont envoyées.
Aucun point d’accès pour les commandes
L’API gère les règles, les inscriptions et les recherches. Elle ne peut pas créer, lire ni modifier des commandes.
Clients et produits en lecture seule
Vous pouvez les rechercher et les lire. Pour modifier un tag client selon un événement, utilisez Auto Tag dans l’app.
Contrôler le corps de la réponse
La version 1 renvoie HTTP 200 pour certains échecs, et les envois partiels renvoient aussi 200. Testez le champ success dans votre tâche.
Comment elle s’intègre au reste de l’app
L’API écrit les mêmes types de règles que ceux que vous créez dans l’admin, donc les règles Custom Pricing, Volume Pricing et Price List suivent l’ordre habituel dans le panier. Les règles Price List sont vérifiées en premier, puis Custom Pricing, Volume Pricing s’appliquant par-dessus. Les règles créées par l’API apparaissent dans les listes de l’app à côté des règles créées à la main.
Envoyer des règles pour des acheteurs taggés se combine bien avec Auto Tag, qui ajoute les tags client visés par ces règles. Si votre liste de prix change quelques fois par an, un import CSV est plus simple qu’une intégration.
Qui doit l’utiliser
Les distributeurs et fabricants dont les prix, classes de prix ou groupes de clients se trouvent déjà dans un ERP, un PIM ou un pipeline de données, et qui ont un développeur ou un partenaire d’intégration pour écrire une tâche planifiée. L’API convient aux grands catalogues où modifier les règles à la main prend trop de temps.
Si personne dans votre équipe n’écrit de code, utilisez plutôt les écrans d’administration ou l’import CSV. Le guide utilisateur décrit l’API comme une boîte à outils pour développeurs et partenaires d’intégration, et non comme un connecteur pour un ERP précis.
Quel plan inclut la Public API ?
La Public API est incluse dans le plan Platinum. Sur la fiche de l’App Store Shopify, au 9 octobre 2026, Platinum coûte 99 $ US par mois, soit 1 069,20 $ US par an avec 10 % de réduction pour un abonnement annuel. La fiche affiche un essai gratuit de 14 jours sur les plans payants.
Cas d’usage pour la Public API
Chaque cas d’usage montre une configuration avec des captures d’écran. Voir tous les cas d’usage.
Synchroniser les règles B2B et les clients avec votre ERP via API
Utilisez la Public API de BSS B2B Solution pour créer et mettre à jour les règles Custom Pricing, Price List, Volume Pricing et les données d'inscription depuis votre ERP ou PIM, avec une clé API, au lieu de modifier les règles à la main.
Explorer le cas d'usage: Synchroniser les règles B2B et les clients avec votre ERP via API
Importer les prix de gros depuis un CSV
Exportez vos règles de prix, modifiez les prix dans un tableur et réimportez le fichier. Le même flux CSV fonctionne pour Custom Pricing, Price Lists et Volume Pricing, pour que les grands catalogues et les nombreux groupes de clients restent gérables.
Explorer le cas d'usage: Importer les prix de gros depuis un CSVGuides et glossaire
Lisez ensuite ces pages pour tous les détails.
Auto Tag
Taguez les acheteurs selon un événement pour que les règles fondées sur les tags s’appliquent.
Manual Orders
Les commandes se prennent dans l’admin, pas par l’API.
Tarification de gros
Montrez aux acheteurs professionnels leurs propres prix avec des listes de prix, des prix personnalisés et des paliers de quantité.
Intégration des clients
Transformez les candidats en acheteurs de gros approuvés grâce aux formulaires d'inscription, à l'approbation et aux tags client.
Glossaire
Intégration ERPListe de prixTag client
Guides d’utilisation sur docs.bss-b2b.solutions
Plus de fonctionnalités de BSS B2B Solution
Chaque fonctionnalité a sa propre page. Voir aussi toutes les fonctionnalités de BSS B2B Solution.
Auto Tag
Ajoutez ou retirez des tags client et commande lorsqu’un événement Shopify correspond à vos règles, pour que les prix et accès basés sur les tags suivent l’acheteur.
Discount codes
Donnez aux acheteurs grossistes un code privé qu’ils saisissent dans le panier, avec des règles sur qui peut l’utiliser, ce qu’il couvre et à quelle fréquence.
Frais de traitement et tarifs de livraison
Ajoutez des frais de traitement selon la quantité ou le montant, et fixez des tarifs de livraison de gros par client, produit, marché et poids.
Manual Orders
Créez une commande provisoire Shopify pour un client dans l’admin, avec ses prix de gros déjà appliqués.
Multi-currency display
Affichez les prix de gros dans la devise de l’acheteur avec un sélecteur. Le paiement reste dans la devise de votre boutique ou de Markets.
Shopify POS pricing
La tuile B2B Price dans Shopify POS affiche la remise de gros pour le panier. Le personnel l’applique ou la retire depuis la tuile.
Reliez votre ERP à vos prix de gros
Installez BSS B2B Solution depuis l’App Store Shopify, avec un essai gratuit de 14 jours (plans payants).
Aussi : BSS B2B Lock pour prix cachés pour les visiteurs et BSS B2B Quote pour devis et commande rapide.
Questions fréquentes
Quel plan inclut la Public API de BSS B2B Solution ?
Le plan Platinum, ou Enterprise sur un ancien plan. Au 9 octobre 2026, la fiche App Store affiche Platinum à 99 $ US par mois. Une boutique reçoit une clé API, que l’app n’affiche qu’une fois.
Que puis-je envoyer à la Public API ?
Des règles Custom Pricing, Volume Pricing, Price List et Discount Code, des soumissions de formulaire d’inscription et des changements de statut, ainsi que des mises à jour de Order Limit. Les clients, produits et collections peuvent être lus et recherchés, mais pas modifiés.
La Public API peut-elle créer ou lire des commandes ?
Non. Il n’existe aucun point d’accès pour les commandes. L’API gère les règles de prix, les inscriptions et les recherches. Pour passer une commande pour un acheteur, utilisez Manual Orders dans l’admin de l’app, qui crée une commande provisoire Shopify avec les prix de l’acheteur.
Quelles sont les limites de débit ?
La version 2 autorise 60 requêtes par 60 secondes et par boutique. Chaque point d’envoi autorise une requête par module toutes les 5 minutes. Les écritures en masse d’une boutique s’exécutent une à la fois, et les appels en trop reçoivent une réponse 429.
Comment m’authentifier, et puis-je utiliser un jeton Bearer ?
Envoyez la clé sous la forme `accessKey` dans le corps ou dans un en-tête : x-bss-b2b-api-key pour la version 1, x-api-key pour la version 2. Les jetons Bearer ne sont pas pris en charge : Authorization: Bearer échoue avec une erreur 401 sur la version 2.
Que se passe-t-il si je perds la clé API ou si elle fuite ?
Supprimez la clé sur la carte Public API. Les clients qui l’utilisent cessent de fonctionner immédiatement. Générez ensuite une nouvelle clé et copiez-la aussitôt, car elle n’est affichée qu’une fois.
Sources, méthode et journal des mises à jour
Le comportement des fonctionnalités suit notre revue du code de l’app BSS B2B Solution le 3 octobre 2026 et les guides utilisateur BSS. Les prix et notes viennent de la fiche App Store à la date indiquée. Nous éditons BSS B2B Solution, BSS B2B Lock et BSS B2B Quote.
Sources
- Guide utilisateur BSS : Public APIs, consulté le . Plan, étapes de la clé, en-têtes, limites de débit, journaux, plafonds des metafields.
- Guide utilisateur BSS : Public APIs pour l’envoi, consulté le . Points d’envoi, capacité et rapport partiel.
- Guide utilisateur BSS : Public APIs pour le formulaire d’inscription, consulté le . Points d’accès du formulaire et des grossistes, changements de statut sur les demandes en attente seulement.
- Fiche App Store Shopify : BSS B2B Wholesale Pricing, consulté le . Prix des plans et essai.
Journal des mises à jour
- : Première version.
- : Ajout d’un bouton d’installation au milieu de la page.
Installer BSS B2B Solution essai gratuit de 14 jours (plans payants)