Price Checker

Connecter Salesforce Commerce Cloud

L’écriture inverse met à jour vos prix Salesforce B2C Commerce par l’intermédiaire de l’API Commerce actuelle de Salesforce (SCAPI) — plus précisément l’API d’administration des carnets de prix (Price Books Admin API). L’ancienne Data API dont dépendait cette intégration est retirée et ne peut plus écrire de prix, si bien que chaque connexion utilise désormais SCAPI.

Ce dont vous avez besoin

Un accès à Account Manager Salesforce pour créer un client API.
Le code court de votre instance, l’identifiant d’organisation, et l’ID du carnet de prix que l’écriture inverse doit mettre à jour.
Le forfait Max ou Enterprise — l’écriture inverse vers Salesforce Commerce Cloud, comme les autres connecteurs de plateforme, est offerte sur les forfaits Max et Enterprise.

Créer un client API dans Account Manager

Connectez-vous à Account Manager avec un compte administrateur de votre organisation Salesforce.
Créez un client API (ou réutilisez-en un mis de côté à cette fin), et réglez son type d’octroi (grant type) sur client_credentials.
Ajoutez le rôle Salesforce Commerce API au client, et limitez ce rôle à votre locataire à l’aide de son filtre de locataire — restreignez-le au domaine (realm) et à l’instance auxquels vous vous connectez.
Accordez au client la portée sfcc.price-books.rw. C’est la seule portée dont l’écriture inverse a besoin : elle peut lire et mettre à jour les entrées du carnet de prix, et rien d’autre.
Enregistrez le client et notez son identifiant client et son secret client. Vous les saisirez tous les deux au moment de la connexion.

Trouver votre code court, votre identifiant d’organisation et votre carnet de prix

Code court — un code de 8 caractères propre à votre instance, par exemple kv7kzm78. C’est la partie qui précède .api.commercecloud.salesforce.com dans l’hôte API de votre instance. Vous le trouverez dans Business Manager ou dans les URL que votre équipe Salesforce utilise déjà pour cette instance.
Identifiant d’organisation — ressemble à f_ecom_zzte_053 (un code de domaine/instance ecommerce, utilisant prd, stg, dev, ou un suffixe de bac à sable numéroté). Business Manager affiche cette information avec les autres détails de votre instance.
ID du carnet de prix — l’ID du carnet de prix dont l’écriture inverse doit mettre à jour les prix. Il doit s’agir d’un carnet de prix standard avec une devise assignée — pas d’un carnet de prix alimenté par flux, qui ne prend pas en charge l’écriture d’entrées individuelles. Trouvez-le dans la liste des carnets de prix de Business Manager.

Connexion

Accédez à Paramètres → Intégrations.
Choisissez Salesforce Commerce Cloud.
Saisissez votre code court, votre identifiant d’organisation, l’ID du carnet de prix, l’identifiant client et le secret client.
Nous vérifions tout avant d’enregistrer quoi que ce soit : nous demandons un jeton avec vos identifiants, puis nous lisons le carnet de prix que vous avez nommé. La connexion n’est enregistrée que si les deux réussissent — si quelque chose ne va pas, rien n’est enregistré et vous voyez exactement quoi corriger.

Une fois connectée, l’intégration affiche votre code court, votre identifiant d’organisation, le carnet de prix et sa devise, pour que vous puissiez confirmer qu’elle pointe vers la bonne instance.

Quels prix l’écriture inverse peut mettre à jour

L’écriture inverse met à jour un prix par produit dans le carnet de prix choisi — un montant unique et sans échéance, sans palier de quantité, sans plage de dates et sans remise en pourcentage. C’est la forme que prend un « prix actuel » simple dans le modèle de carnet de prix de Salesforce.

Si l’entrée d’un produit dans le carnet de prix a déjà cette forme simple, l’écriture inverse peut la lire et la mettre à jour.
Si un produit n’a pas encore d’entrée dans le carnet de prix, l’écriture inverse ne peut pas en créer une — connectez d’abord le produit à votre carnet de prix dans Business Manager.
Si l’entrée d’un produit utilise une tarification par quantité, un changement de prix planifié ou une remise en pourcentage, l’écriture inverse la laisse telle quelle et la signale plutôt que de risquer d’écraser vos autres règles de tarification.
Les variantes de produit ont leurs propres entrées dans le carnet de prix, donc le prix de chaque variante est lu et écrit indépendamment de son produit parent.

Dépannage

Pendant la connexion :

Ce que vous voyez	Ce que cela signifie
Le code court, l’identifiant d’organisation ou l’ID du carnet de prix ne semble pas correct	La valeur saisie ne correspond pas au format attendu — vérifiez-la dans Business Manager.
Carnet de prix introuvable	L’ID du carnet de prix n’existe pas pour cette organisation, ou le client API ne peut pas le voir.
Le carnet de prix utilise une tarification externe	Le carnet de prix nommé est alimenté par flux; choisissez plutôt un carnet de prix standard avec une devise.
La devise ne correspond pas	La devise du carnet de prix ne correspond pas à la devise de votre espace de travail. Connectez un carnet de prix dans la devise de votre espace de travail, ou mettez à jour la devise de votre espace de travail pour qu’elle corresponde.
Impossible de vérifier vos identifiants	L’identifiant client, le secret client ou la portée a été rejeté. Assurez-vous que le client utilise le type d’octroi `client_credentials`, que le rôle Salesforce Commerce API est limité à ce locataire, et qu’il a la portée `sfcc.price-books.rw`.

Une fois connectée, lors de changements de prix individuels :

Ce que vous voyez	Ce que cela signifie
Reconnexion requise	Vos identifiants, votre rôle ou votre portée ne fonctionnent plus — reconnectez-vous avec un client API valide.
Produit introuvable dans le carnet de prix	Le produit n’a pas d’entrée dans ce carnet de prix, donc il n’y a rien à mettre à jour.
Le prix ne peut pas être lu clairement	L’entrée du produit dans le carnet de prix comporte des paliers de quantité, une plage de dates ou une remise en pourcentage, donc il n’y a pas de prix unique à mettre à jour automatiquement — vérifiez-la dans Business Manager.
Mise à jour rejetée	Salesforce a rejeté la mise à jour du prix, ou l’entrée du produit a été supprimée depuis notre dernière vérification.
Problème de connexion temporaire	Un problème réseau ou du côté de Salesforce a interrompu la requête. Il est généralement sécuritaire de réessayer sous peu.

Reconnexion depuis OCAPI

Si votre connexion Salesforce Commerce Cloud a été configurée avant cette mise à jour, elle utilise encore la Data API retirée et doit être reconnectée. Une bannière de reconnexion s’affiche sur l’intégration, et les changements de prix ne passeront pas tant que vous ne l’aurez pas fait. Comme l’ancienne et la nouvelle configuration utilisent des clients API Salesforce différents, la migration ne peut pas se faire automatiquement — suivez les sections Créer un client API dans Account Manager et Connexion ci-dessus pour vous reconnecter avec SCAPI.

Conseils

Testez une nouvelle connexion sur un seul produit à faible risque avant d’approuver un lot complet de recommandations par ce canal.
Gardez le filtre de locataire du client API limité à l’instance à laquelle vous vous connectez — un client qui couvre plusieurs locataires est plus difficile à auditer et à faire tourner.
Si la devise de votre espace de travail change un jour, reconnectez-vous avec un carnet de prix dans la nouvelle devise; une devise incompatible bloque les changements de prix plutôt que d’écrire le mauvais montant.

Pour aller plus loin

Poussez les prix acceptés vers votre boutique — comment l’écriture inverse et les approbations fonctionnent pour chaque connecteur.
Définissez vos politiques de tarification et garde-fous — les règles que l’écriture inverse respecte.
Invitez votre équipe et définissez les rôles — attribuez le rôle d’approbateur.