Pour synchroniser les prix B2B depuis un ERP vers Shopify, utilisez la Public API de BSS B2B Solution : générez une clé API sur le forfait Platinum, puis demandez à votre développeur ou à votre intégrateur de créer, mettre à jour et supprimer les règles Custom Pricing, Price List et Volume Pricing depuis votre système de référence, et d'appeler le point d'accès d'upload pour que les règles activées atteignent le thème en ligne. Votre équipe arrête de ressaisir les prix dans un écran d'administration.
Ce guide s'adresse aux distributeurs et aux fabricants dont les prix, les classes de prix ou les groupes de clients sont déjà gérés dans un ERP, un PIM ou un flux de données. Il explique qui en profite, ce que l'API couvre et ne couvre pas, un plan d'intégration en cinq étapes, un exemple détaillé et les limites à prendre en compte, notamment l'absence de point d'accès pour les commandes. Il s'adresse à la personne qui décide de créer l'intégration, et renvoie à la documentation développeur pour les formats exacts.
À qui s'adresse cette solution
La Public API vous convient si la plupart de ces points décrivent votre boutique :
- Vos prix sont gérés dans un ERP, un PIM ou un tableur maître, et la boutique Shopify n'est qu'une deuxième copie.
- Vous avez plusieurs classes de prix ou groupes de clients, et une modification de prix touche des centaines ou des milliers de variantes.
- Les prix changent chaque semaine ou chaque jour, si bien qu'une mise à jour manuelle prend du retard entre deux synchronisations.
- Vous avez un développeur, une agence ou un intégrateur capable d'écrire une tâche planifiée.
- Vous exportez déjà vos prix en CSV et voulez que ces données circulent sans que personne ouvre l'application.
Si votre liste de prix ne change que quelques fois par an, un import CSV est plus simple. Voir importer des prix de gros depuis un CSV.
Pourquoi c'est important
Deux copies d'une liste de prix finissent par diverger. Quelqu'un met à jour l'ERP le lundi, oublie la boutique, et un acheteur voit mardi le prix du trimestre précédent. Il commande alors au mauvais prix, et vous absorbez l'écart ou annulez la commande, ou il perd confiance dans le portail et appelle le service commercial. Plus le catalogue est grand et plus vous avez de classes de prix, plus cela arrive souvent.
Un flux de données traite la cause plutôt que le symptôme. L'ERP reste le système de référence, une tâche planifiée écrit les modifications dans BSS B2B Solution, et la vitrine suit. Les boutiques réelles veulent cette souplesse. Alpha Coffee, torréfacteur, indique qu'avec un accès API il peut garder Shopify comme couche commerciale centrale tout en se connectant à des plateformes ERP, CRM ou finance, et DermaplanePro signale moins de travail manuel grâce aux connexions API publiques avec des systèmes externes. Voir les études de cas Alpha Coffee et DermaplanePro.
Comment la mettre en place avec BSS B2B Solution
Cette section décrit l'intégration côté marchand. Votre développeur a besoin du guide de la Public API pour les points d'accès et les formats.
Étape 1 : vérifier le forfait
La Public API fait partie du forfait Platinum. Une boutique ne peut détenir qu'une clé API à la fois, et ce forfait débloque aussi les Price Lists, que de nombreuses intégrations ERP utilisent pour les prix propres à chaque client. Vérifiez le forfait avant de cadrer tout travail d'intégration.
Étape 2 : générer la clé API
Dans l'application, ouvrez Integrations, repérez la carte Public API et choisissez Get API key. La clé n'est affichée qu'une fois : copiez-la ou téléchargez-la à ce moment-là et conservez-la dans un gestionnaire de mots de passe ou une variable d'environnement serveur. En cas de fuite, supprimez-la sur la même carte, ce qui arrête tous les clients qui l'utilisent, puis générez-en une nouvelle.
Étape 3 : authentifier votre première requête
Les points d'accès de la version 1 reçoivent votre domaine `myshopify.com` et la clé, soit comme `accessKey` dans le corps de la requête, soit dans l'en-tête `x-bss-b2b-api-key`. Le point d'accès de volume pricing de la version 2 utilise l'en-tête `x-api-key`. Un jeton Bearer n'est pas pris en charge et renvoie une erreur 401, donc ne construisez pas votre client autour de l'en-tête `Authorization`.
Étape 4 : écrire les règles à partir de vos données ERP
Associez chaque classe de prix de l'ERP à une cible de règle, comme un tag de client, et appelez le groupe de points d'accès du module que vous utilisez. L'API gère les règles Custom Pricing, Price List et Volume Pricing, les règles de codes de remise, les enregistrements de formulaire d'inscription et les règles de limite de commande, avec création, mise à jour, suppression et opérations en lot là où le point d'accès le permet. Les points d'accès clients et produits sont des consultations en lecture seule qui vous aident à construire les charges utiles des règles, par exemple pour retrouver des clients par tag ou lister des produits et des collections. Les requêtes sont traitées une à la fois, donc votre client doit mettre ses appels en file d'attente.
Étape 5 : envoyer une fois, puis vérifier
Après un lot de modifications, appelez le point d'accès d'upload du module pour que toutes les règles activées soient écrites dans votre thème actif. Les points d'accès d'upload autorisent une requête par module toutes les cinq minutes. Envoyez donc une fois à la fin d'une synchronisation, et non après chaque ligne. Une requête au-delà de la limite renvoie `429`, et seules les règles activées sont envoyées. Si vos règles dépassent la capacité des métachamps, l'API enregistre ce qui tient et renvoie un rapport `partial_success` avec un code HTTP 200, donc lisez le corps de la réponse et pas seulement le code d'état. Vérifiez ensuite le résultat dans la carte Logs and usage sous Advanced Settings > Public API, qui liste les requêtes récentes avec l'heure, la méthode, le chemin et le statut, et affiche la requête et la réponse complètes en cas d'échec. L'API peut aussi renvoyer le prix qu'un client donné obtient pour certains produits, ce qui est utile pour comparer l'application avec l'ERP.
Exemple : un distributeur avec trois classes de prix
Cet exemple utilise des chiffres fictifs, pas des résultats d'une boutique réelle. Un distributeur gère trois classes de prix dans son ERP : Retail Partner, Trade et Key Account. Dans BSS B2B Solution, chaque classe est une règle Price List qui cible un tag de client. Une tâche nocturne exporte les lignes de prix modifiées, les regroupe par classe, et appelle le point d'accès d'enregistrement en lot pour chaque Price List. Quand les trois sont terminés, la tâche appelle une fois le point d'accès d'upload des Price Lists.
Un lundi, l'ERP affiche 3 200 prix modifiés. Au lieu qu'un analyste les ressaisisse, la tâche s'exécute à 02:00, envoie une fois, puis vérifie la carte Logs and usage pour détecter toute requête en échec. Le matin, un acheteur Trade qui se connecte voit les prix du lundi sur les pages produit et collection. Une requête en échec laisse une entrée dans le journal avec son statut et son corps, et la tâche la rejoue après une courte attente.
Se combine bien avec
L'API est une voie d'entrée pour le moteur de tarification. Les autres pages expliquent ce qui se passe avec ces règles une fois créées :
- CSV plutôt que code : importer des prix de gros depuis un CSV couvre la fenêtre d'import pour les catalogues plus petits.
- Listes de prix par groupe d'acheteurs : liste de prix B2B par groupe d'acheteurs présente le type de règle que la plupart des synchronisations ERP écrivent.
- Remises par quantité : tarification dégressive par quantité explique les règles Volume Pricing que l'API peut aussi gérer.
- Ordre des règles : quelle règle B2B l'emporte explique la priorité, pour qu'une règle synchronisée n'entre pas en conflit avec une règle créée à la main.
Le hub de tarification de gros regroupe les guides de tarification. Les entrées de glossaire utiles sont price list, prix de gros et tag client.
Limites et erreurs courantes
- Il n'existe pas de point d'accès pour les commandes. L'API gère les règles de prix et de remise, les enregistrements d'inscription et les règles de limite de commande, ainsi que des consultations en lecture seule des clients, produits et collections. Gardez la synchronisation des commandes dans votre connecteur ERP pour Shopify, et utilisez cette API pour les prix et les groupes de clients.
- Une clé par boutique. Supprimer la clé arrête tous les clients qui l'utilisent. Renouvelez-la donc depuis un forfait et mettez l'intégration à jour immédiatement.
- L'upload est limité en débit. Les points d'accès d'upload autorisent une requête par module toutes les cinq minutes. Le point d'accès de volume pricing de la version 2 autorise 60 requêtes par période de 60 secondes pour chaque boutique.
- Les données de tarification ont des plafonds. Les règles sont stockées dans des métachamps Shopify, avec au maximum 10 clés et 2 000 000 de caractères par clé. Le contenu au-delà des plafonds est ignoré et signalé comme `partial_success`. Élaguez donc les règles inactives ou divisez un jeu de règles très volumineux avant de renvoyer un upload.
- Les nouvelles tentatives demandent une pause. Les requêtes sont traitées une à la fois, et après une erreur serveur, le guide indique d'attendre jusqu'à trois minutes avant de réessayer.
- L'API ne remplace pas la conception des règles. Le ciblage, la priorité et les exclusions suivent les mêmes règles que les règles créées à la main. Testez donc d'abord une règle dans l'administration.
- L'API alimente une vitrine de thème. Les prix s'affichent par l'app embed de BSS B2B Solution dans votre thème Shopify. Vérifiez donc que l'embed est activé après chaque changement de thème.
Liste de contrôle de la configuration
- Vérifiez que la boutique est sur le forfait Platinum.
- Décidez du système de référence pour chaque classe de prix et du tag client auquel chaque classe correspond.
- Générez la clé API et conservez-la dans un gestionnaire de mots de passe ou une variable d'environnement.
- Construisez le client avec `accessKey` ou l'en-tête `x-bss-b2b-api-key`, et mettez les requêtes en file d'attente.
- Testez une règle de bout en bout sur une boutique de développement, puis vérifiez-la dans l'administration.
- Prévoyez un appel d'upload par module à la fin de chaque synchronisation.
- Ajoutez des alertes sur `429` et sur les erreurs serveur, et consultez la carte Logs and usage après les premières exécutions.
- Gardez la synchronisation des commandes dans un connecteur séparé.
Forfaits et prérequis
La Public API nécessite le forfait Platinum de BSS B2B Solution, une clé par boutique et l'app embed sur votre thème. Les autres forfaits et l'essai gratuit de 14 jours sur les forfaits payants figurent sur la page tarifs de BSS B2B. Les formats exacts se trouvent dans le guide de la Public API, le guide de l'API d'upload et le guide de l'API Custom Pricing. Installez BSS B2B Solution depuis la boutique d'applications Shopify et demandez à votre développeur de commencer par une seule Price List.
