Connecter Best Buy : recevoir les commandes, renvoyer le fulfillment

Copiez votre API Key depuis Best Buy Mirakl Seller Portal, collez-la dans Integration, testez, mappez, activez : les commandes entrent, le fulfillment, les produits et le stock reviennent.

Le connecteur Best Buy importe les commandes Best Buy dans OMS et renvoie le fulfillment vers Best Buy, en plus des mises à jour produits et stock. Une connexion utilise une API Key.

Prérequis#

• Un compte vendeur Best Buy pouvant se connecter à Best Buy Mirakl Seller Portal.
• Le droit d’ouvrir la page API Key depuis votre nom d’utilisateur, en haut à droite de ce portail.
• Une personne capable de conserver l’API Key en sécurité — la clé complète servira en cas de reconnexion ou de remplacement.

Obtenir les identifiants#

1. Connectez-vous à Best Buy Mirakl Seller Portal et cliquez sur votre nom d’utilisateur, en haut à droite.
2. Ouvrez API Key depuis ce menu.
3. Cliquez sur Generate / Copy et copiez l’API Key complète. S’il n’y en a pas encore, générez-en une d’abord, puis copiez-la.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Best Buy → Nouvelle connexion.
2. API key : collez l’API Key copiée depuis Best Buy Mirakl Seller Portal. C’est le seul champ d’identifiant et il est obligatoire. Elle est chiffrée au repos et jamais réaffichée.

Tester la connexion#

Cliquez sur Tester la connexion. Le test utilise votre API Key pour récupérer une page de commandes Best Buy et vérifier que la clé fonctionne. Un succès signifie que Best Buy a accepté la clé et renvoyé cette page de commandes. En cas d’échec, notez l’erreur et consultez la FAQ avant de changer autre chose.

Mapping / choisir un modèle#

Choisissez le modèle standard Best Buy. Il mappe numéro de commande, SKU des lignes, quantités, adresse de livraison et statut de fulfillment entre Best Buy et la commande standard. Vérifiez l’aperçu avant d’activer, surtout que chaque SKU Best Buy est associé au bon produit OMS.

Activer#

Après activation, Integration récupère les nouvelles commandes Best Buy selon la fréquence définie, renvoie le fulfillment vers Best Buy et pousse les mises à jour produits et stock. Surveillez les premières commandes dans Runs / Logs.

FAQ#

Le test échoue : l’API Key est rejetée

L’API Key est incorrecte ou a été révoquée, donc Best Buy ne l’accepte pas quand le test récupère une page de commandes.

Générez une nouvelle API Key dans Best Buy Mirakl Seller Portal → votre nom d’utilisateur (en haut à droite) → API Key → Generate / Copy, collez la nouvelle clé complète dans la connexion, enregistrez puis testez à nouveau.

Le test échoue juste après avoir collé la clé

La clé a été copiée de façon incomplète : il en manque une partie, donc la valeur collée ne correspond pas à l’API Key de Best Buy Mirakl Seller Portal.

Retournez dans Best Buy Mirakl Seller Portal → votre nom d’utilisateur (en haut à droite) → API Key → Copy, copiez la clé à nouveau en entier, remplacez la valeur dans la connexion, enregistrez puis testez à nouveau.

Connecté mais aucune commande n’arrive

La connexion est bonne — le test passe — mais Best Buy n’a pas encore de nouvelles commandes pour votre compte, donc il n’y a rien à importer.

Confirmez dans Best Buy Mirakl Seller Portal qu’une nouvelle commande est apparue, puis lancez une extraction manuelle et vérifiez Runs / Logs. Les nouvelles commandes apparaissent dès que Best Buy les émet.

Les SKU apparaissent non mappés

Le SKU du canal n’est pas encore associé à un produit dans OMS, donc les commandes portant ce SKU ne peuvent pas être rattachées à un produit.

Ouvrez l’onglet en attente dans Product Mapping, associez chaque SKU du canal à un produit OMS, puis vérifiez la prochaine commande importée dans Runs / Logs.