Connecter Overstock : recevoir les commandes, renvoyer le fulfillment
Prenez l’URL de base de l’API et la clé API dans votre documentation d’intégration partenaire Overstock, collez-les dans Integration, testez, mappez, activez.
Le connecteur Overstock importe les commandes d’Overstock — opérant désormais comme la plateforme Bed Bath & Beyond — dans OMS et renvoie le fulfillment vers la plateforme. 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.
Prérequis#
- Un compte partenaire Overstock vendant sur la plateforme désormais sous la marque Bed Bath & Beyond.
- Votre documentation d’intégration partenaire Overstock. L’URL de base de l’API et les chemins des endpoints viennent de cette documentation — Overstock ne publie pas de spécification REST, les endpoints ne peuvent donc être vérifiés nulle part ailleurs.
- La clé API partenaire émise pour votre compte, telle que décrite dans cette même documentation d’intégration. Gardez-la prête à copier — vous la collerez dans Integration, ne la saisissez pas de mémoire.
Obtenir les identifiants#
- Ouvrez la documentation d’intégration partenaire Overstock de votre compte. Les deux valeurs nécessaires — l’URL de base de l’API et la clé API — viennent de cette documentation ; il n’existe pas de spécification REST publique pour les y chercher à la place.
- Dans cette documentation, trouvez l’URL racine de l’API et copiez-la exactement. C’est la valeur du champ URL de base de l’API — elle commence par https://. Copiez l’URL racine telle qu’elle est écrite et confirmez les chemins des endpoints avec la même documentation.
- Dans la même documentation, trouvez votre clé API partenaire et copiez-la. Conservez-la en lieu sûr : c’est un secret, elle est envoyée comme en-tête x-api-key à chaque requête et Integration ne la réaffiche jamais après l’enregistrement.
Remplir dans Integration#
- Ouvrez Integration → Marketplace → Overstock → Nouvelle connexion.
- URL de base de l’API (obligatoire) : collez l’URL racine de l’API copiée depuis votre documentation d’intégration partenaire Overstock, sous la forme https://… . Collez l’URL racine telle qu’elle figure dans la documentation — ne saisissez pas l’adresse de la boutique de la plateforme et ne devinez pas d’adresse : Overstock ne publie pas de spécification REST, la documentation est donc la seule source pour cette valeur.
- Clé API (obligatoire) : collez la clé API partenaire issue de la même documentation. Elle est envoyée comme en-tête x-api-key, chiffrée au repos et jamais réaffichée — après l’enregistrement, le champ ne montrera plus la clé, conservez donc votre propre copie tirée de la documentation.
Tester la connexion#
Cliquez sur Tester la connexion. Le test utilise votre URL de base de l’API et envoie votre clé API comme en-tête x-api-key pour vérifier la connectivité, puis affiche un aperçu au niveau document avec une commande réelle, les champs de la plateforme à côté de la commande standard. Si votre compte n’a pas encore de commandes, la connectivité peut quand même réussir — attendez ou préparez une vraie commande avant de juger l’aperçu, et consultez la FAQ si le test échoue.
Mapping / choisir un modèle#
Choisissez le modèle standard Overstock. Il mappe numéro de commande, SKU des lignes, quantités et adresse de livraison dans la commande standard, et renvoie le fulfillment au format de la plateforme. Vérifiez l’aperçu avant d’activer, surtout que chaque SKU de la plateforme est associé au bon produit, pour que les push produits et stock signalent les bons articles.
Activer#
Après activation, Integration récupère les nouvelles commandes Overstock selon la fréquence définie et renvoie le fulfillment avec suivi, ainsi que les mises à jour produits et stock, vers la plateforme. Surveillez les premières commandes dans Runs / Logs avant de laisser le processus sans surveillance.
FAQ#
Le test échoue : la clé API est rejetée
La clé API est incorrecte. Chaque requête transmet la clé comme en-tête x-api-key : une clé copiée avec un caractère manquant, une clé d’un autre compte ou une valeur qui n’est pas la clé API partenaire sera rejetée dès le premier appel — l’URL de base n’a même pas le temps de jouer un rôle.
Retournez dans votre documentation d’intégration partenaire Overstock, recopiez la clé API partenaire depuis là, remplacez la valeur de la clé API dans la connexion, enregistrez puis testez à nouveau. Collez-la, ne la retapez pas.
Le test échoue : la plateforme est injoignable à l’URL de base de l’API
L’URL de base de l’API est mal remplie. Le champ exige l’URL racine de l’API issue de votre documentation d’intégration ; l’adresse de la boutique de la plateforme, une adresse de page copiée du navigateur ou une adresse devinée pointent là où l’API ne répond pas. Overstock ne publiant pas de spécification REST, une URL d’apparence plausible peut quand même être fausse — seule la documentation définit la bonne, chemins des endpoints compris.
Ouvrez votre documentation d’intégration, recopiez l’URL racine de l’API exactement comme elle est écrite, remplacez l’URL de base de l’API dans la connexion et confirmez les chemins des endpoints avec la même documentation. Enregistrez puis testez à nouveau.
Connecté mais aucune commande n’arrive
La connexion est bonne — le test passe — mais la plateforme n’a pas encore de nouvelles commandes pour votre compte, donc il n’y a rien à importer. Une connexion qui fonctionne avec une liste de commandes vide ressemble exactement à cela jusqu’à la prochaine commande.
Attendez la prochaine vraie commande sur la plateforme, puis lancez une extraction manuelle et vérifiez Runs / Logs. Les nouvelles commandes apparaissent dès que la plateforme les émet — s’il existe des commandes sur la plateforme et qu’elles n’apparaissent toujours pas après une extraction manuelle, revérifiez d’abord l’URL de base de l’API et la clé API par rapport à votre documentation d’intégration.