Connecter Lowe's : recevoir les commandes, renvoyer le fulfillment
Trouvez l’URL de base de l’API Mirakl dans la documentation API de votre portail vendeur Mirakl Lowe's, copiez votre clé API depuis nom d’utilisateur → API Key, collez les deux dans Integration, testez, mappez, activez.
Le connecteur Lowe's importe les commandes de votre boutique sur la marketplace Lowe's dans OMS via Mirakl et renvoie le fulfillment vers Lowe's. Il peut aussi pousser les mises à jour produits et stock, pour que commandes, expéditions et stock restent synchronisés des deux côtés. Une connexion pointe vers un seul environnement Mirakl Lowe's — l’URL de base de l’API et la clé API doivent appartenir à ce même environnement.
Prérequis#
- Un compte vendeur sur la marketplace Lowe's, avec accès au portail vendeur Mirakl Lowe's de cette boutique.
- Le droit, dans le portail vendeur Mirakl, de consulter la documentation API et de générer une clé API pour votre utilisateur — le connecteur s’authentifie avec cette clé.
- Votre propre environnement Mirakl Lowe's prêt à copier : l’URL de base de l’API est propre à votre environnement et n’est pas la même pour toutes les marketplaces Mirakl, n’empruntez donc pas l’adresse d’une autre boutique Mirakl.
Obtenir les identifiants#
- Connectez-vous au portail vendeur Mirakl Lowe's et ouvrez la documentation API de votre portail vendeur. Trouvez-y l’URL racine de l’API — elle ressemble à https://<your-env>/api. Copiez l’adresse complète exactement telle qu’affichée pour votre environnement.
- Dans le même portail vendeur, cliquez sur votre nom d’utilisateur en haut à droite, puis ouvrez API Key.
- Sur la page API Key, choisissez Generate New Key si vous n’avez pas encore de clé, ou Copy pour copier celle que vous avez déjà. Conservez la clé en lieu sûr — vous la collerez dans Integration à l’étape suivante, et elle est envoyée comme valeur de l’en-tête Authorization à chaque requête.
Remplir dans Integration#
- Ouvrez Integration → Marketplace → Lowe's → Nouvelle connexion.
- URL de base de l’API Mirakl : collez l’URL racine de l’API trouvée dans la documentation API de votre portail vendeur Mirakl Lowe's, par exemple https://<your-env>/api. Collez uniquement l’adresse de votre propre environnement Lowe's — une adresse d’une autre instance Mirakl joindra la mauvaise marketplace, même si le format semble correct.
- Clé API : collez la clé API copiée depuis le portail vendeur Mirakl Lowe's → votre nom d’utilisateur (en haut à droite) → API Key. Ce champ est obligatoire, il est envoyé comme valeur de l’en-tête Authorization, chiffré au repos et jamais réaffiché.
Tester la connexion#
Cliquez sur Tester la connexion. Le test utilise l’URL de base de l’API Mirakl et la clé API saisies pour joindre votre environnement Mirakl Lowe's et vérifier que la clé est acceptée comme en-tête Authorization. Un succès signifie que l’adresse a joint le bon environnement et que la clé fonctionne. En cas d’échec, notez l’erreur et consultez la FAQ avant de changer autre chose — la plupart des échecs viennent de la clé ou d’une URL de base pointant vers la mauvaise instance Mirakl.
Mapping / choisir un modèle#
Choisissez le modèle standard Lowe's. Il mappe numéro de commande, SKU des lignes, quantités, adresse de livraison et statut de fulfillment entre Lowe's (Mirakl) et la commande standard, et il porte les champs produits et stock utilisés lors des envois de mises à jour. Vérifiez l’aperçu avant d’activer, surtout que chaque SKU Lowe's est associé au bon produit OMS.
Activer#
Après activation, Integration récupère les nouvelles commandes Lowe's selon la fréquence définie, renvoie le fulfillment avec numéros de suivi vers Lowe's et pousse les mises à jour produits et stock. Surveillez les premières commandes dans Runs / Logs avant de le laisser sans surveillance.
FAQ#
Le test échoue : la clé API n’est pas acceptée
La clé API de la connexion est incorrecte ou n’est plus valide — par exemple elle a été copiée de façon incomplète, elle appartient à un autre utilisateur, ou une nouvelle clé a été générée et l’ancienne gardée dans la connexion n’est plus l’actuelle. Comme la clé est envoyée comme en-tête Authorization à chaque requête, Mirakl rejette chaque requête à l’entrée quand il ne reconnaît pas la clé.
Allez dans le portail vendeur Mirakl Lowe's, cliquez sur votre nom d’utilisateur en haut à droite → API Key, et copiez la clé actuelle en entier — ou choisissez Generate New Key s’il vous en faut une nouvelle — puis collez-la dans le champ API key de la connexion. Enregistrez puis testez à nouveau.
Le test échoue ou joint la mauvaise boutique : l’URL de base Mirakl est incorrecte
Le champ URL de base de l’API Mirakl contient une adresse qui n’appartient pas à votre environnement Lowe's. La cause la plus fréquente est d’avoir collé l’adresse d’une autre instance Mirakl — une autre marketplace ou un autre environnement qui tourne aussi sur Mirakl. Cette adresse peut sembler parfaitement valide, mais elle pointe ailleurs, donc votre clé API Lowe's n’y correspond pas et le test ne peut pas joindre votre boutique Lowe's.
Allez dans le portail vendeur Mirakl Lowe's et rouvrez la documentation API de votre portail vendeur. Copiez l’URL racine de l’API affichée là pour votre environnement — elle ressemble à https://<your-env>/api — remplacez l’URL de base de l’API Mirakl de la connexion par cette adresse exacte, enregistrez puis testez à nouveau. Ne réutilisez pas une adresse copiée depuis une autre boutique Mirakl.
Connecté mais aucune commande n’arrive
La connexion est bonne — le test passe — mais votre boutique Lowe's n’a pas encore de nouvelles commandes, donc il n’y a rien à importer.
Vérifiez d’abord le portail vendeur Mirakl Lowe's pour confirmer si une nouvelle commande a bien été émise pour votre boutique. Si c’est le cas, lancez une extraction manuelle et vérifiez Runs / Logs. Si le portail n’affiche pas non plus de nouvelle commande, attendez la prochaine commande client — les nouvelles commandes apparaissent dans Integration dès que Lowe's les émet.