Cette procédure explique comment utiliser la Client Key et le Client Secret de Metro Markets pour connecter une boutique Metro à AtomicSeller.
Avant de commencer #
- Votre compte vendeur Metro ou MAKRO Marketplace est approuvé et actif en production.
- Vous pouvez générer des clés API dans le Seller Office.
- Vous disposez des droits de gestion des boutiques dans AtomicSeller.
- Vous connaissez la période de commandes à reprendre lors de la première synchronisation.
Générer les clés API Metro #
- Connectez-vous au Seller Office de votre environnement de production.
- Ouvrez la section de génération des API Keys.
- Générez une nouvelle paire de clés dédiée à AtomicSeller.
- Copiez la Client Key et le Client Secret dès leur affichage. Le secret ne pourra plus être consulté ensuite.
- Conservez les deux valeurs dans un gestionnaire de secrets. Les clés du bac à sable et les clés de production sont différentes : n’utilisez pas une paire issue de l’environnement de test pour la boutique réelle.
Configurer la boutique dans AtomicSeller #
- Dans AtomicSeller, ouvrez Boutiques, sélectionnez Ajouter une boutique, puis Metro.
- Dans Paramètres principaux, renseignez Boutique ecommerce et un Store key court et unique.
- Collez la Client Key Metro dans Clé API.
- Collez le Client Secret Metro dans Clé secrète de l’API.
- Définissez le Nombre de jours à reprendre lors de la première synchronisation.
- Laissez les réglages avancés à leur valeur par défaut, sauf instruction de votre administrateur ou du support AtomicSeller.
- Sélectionnez Enregistrer, puis Tester la connexion.
- Lorsque le test réussit, sélectionnez Importer les commandes de la boutique et contrôlez-les dans Commandes à traiter.
Résultat attendu. AtomicSeller authentifie les requêtes Metro à l’aide de la Client Key et du Client Secret et récupère les commandes éligibles.
Dépannage #
Erreur 401. Vérifiez que la Client Key et le Client Secret appartiennent à la même paire, qu’ils proviennent de la production et que le secret n’a pas été tronqué.
Secret perdu. Metro ne permet pas de réafficher le Client Secret. Générez une nouvelle paire de clés, remplacez les deux valeurs dans AtomicSeller et retestez la connexion.
Aucune commande n’apparaît. Vérifiez le nombre de jours, l’existence de commandes récentes et les paramètres d’acceptation des commandes. Ne modifiez pas l’option d’acceptation automatique sans connaître l’impact opérationnel.
Échecs intermittents. Les requêtes Metro sont signées avec une date et une signature HMAC. Si le problème persiste avec des clés valides, contactez le support AtomicSeller avec l’heure du test et le message d’erreur, sans joindre le secret.