Connecter Wish : recevoir les commandes, renvoyer le fulfillment
Obtenez un jeton d’accès OAuth2 marchand Wish, collez-le avec l’URL de base de l’API dans Integration, testez, mappez, activez.
Le connecteur Wish importe les commandes de votre boutique Wish dans OMS et renvoie le fulfillment vers Wish. Il peut aussi pousser produits et stock, pour garder annonces, stock et expéditions synchronisés des deux côtés.
Prérequis#
- Une boutique marchande Wish, avec accès de connexion au compte marchand Wish de cette boutique.
- Possibilité d’achever l’autorisation OAuth2 marchande Wish pour cette boutique : le jeton d’accès s’obtient via cette autorisation.
- Sachez quelle URL de base de l’API s’applique à votre boutique avant de commencer : l’adresse par défaut, l’adresse Chine ou l’adresse bac à sable pour les tests. Les adresses exactes figurent à l’étape Remplir dans Integration.
Obtenir les identifiants#
- Connectez-vous au compte marchand Wish de la boutique à connecter et achevez l’autorisation OAuth2 pour cette boutique. Vérifiez que vous êtes connecté à la bonne boutique avant d’autoriser : un jeton autorisé pour une autre boutique ne correspondra pas à cette connexion.
- Copiez le jeton d’accès obtenu après l’autorisation. C’est le jeton d’accès OAuth2 marchand Wish : vous le collerez dans le champ Access token d’Integration.
- Notez la date d’obtention du jeton : il est valide 30 jours. À l’expiration, refaites l’autorisation OAuth2 pour obtenir un nouveau jeton et mettez la connexion à jour.
Remplir dans Integration#
- Ouvrez Integration → Marketplace → Wish → Nouvelle connexion.
- URL de base de l’API : saisissez l’adresse de votre boutique. Par défaut : https://merchant.wish.com/api/v2 . Chine : https://china-merchant.wish.com/api/v2 . Bac à sable : https://sandbox.merchant.wish.com/api/v2 . N’utilisez l’adresse bac à sable que pour les tests, puis passez à l’adresse par défaut ou Chine avant la mise en production.
- Jeton d’accès, obligatoire : collez le jeton d’accès OAuth2 marchand Wish obtenu à l’étape précédente. Il est valide 30 jours, chiffré au repos et jamais réaffiché.
Tester la connexion#
Cliquez sur Tester la connexion. Le test vérifie ensemble l’URL de base de l’API et le jeton d’accès, puis affiche un aperçu au niveau document avec une commande réelle, champs de la plateforme à côté de la commande standard. Si la boutique n’a pas encore de commandes, passez d’abord une commande test dans Wish : l’aperçu a besoin d’un document réel. 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 Wish. Il mappe numéro de commande, SKU de ligne, quantités, adresse de livraison et statut de fulfillment. Vérifiez l’aperçu du mapping avec une commande réelle avant d’activer, surtout que chaque SKU Wish est associé à un produit OMS, pour aligner commandes, produits et stock des deux côtés.
Activer#
Après activation, Integration récupère les nouvelles commandes selon la fréquence définie, renvoie le fulfillment avec numéros de suivi vers Wish et pousse les changements de produits et de stock vers Wish. Surveillez la date d’expiration du jeton d’accès : il est valide 30 jours, renouvelez-le avant l’expiration pour que les commandes continuent d’arriver. Surveillez les premières commandes dans Runs / Logs avant de le laisser sans surveillance.
FAQ#
Le test échoue : le jeton d’accès est incorrect ou expiré
Le jeton d’accès de la connexion ne fonctionne pas. Il a été copié incomplet ou avec un espace en trop, il appartient à une autorisation plus ancienne, ou ses 30 jours sont écoulés, Wish rejette donc l’appel.
Refaites l’autorisation OAuth2 marchande Wish pour la même boutique, copiez le nouveau jeton d’accès tel qu’obtenu, remplacez le champ Access token sans espaces supplémentaires, vérifiez que l’URL de base de l’API correspond à votre boutique, puis retestez.
Vous avez autorisé une autre boutique
Le jeton fonctionne, mais il a été autorisé alors que vous étiez connecté à une autre boutique Wish. La connexion parle donc à cette autre boutique, les commandes de cette boutique n’apparaissent pas — ou ce sont celles de l’autre boutique qui apparaissent.
Connectez-vous au compte marchand Wish de la boutique à laquelle cette connexion correspond, refaites l’autorisation OAuth2, remplacez le Access token par le nouveau jeton de cette boutique, puis retestez. Utilisez une connexion par boutique : ne partagez pas un même jeton entre boutiques.
Connecté mais aucune commande n’est importée
La connexion va bien. La boutique n’a simplement pas de nouvelles commandes dans la plage d’extraction, il n’y a donc encore rien à importer.
Passez une commande test dans votre boutique Wish, vérifiez que son heure est dans la plage d’extraction, lancez une extraction manuelle et confirmez que la commande apparaît dans l’aperçu ou dans Runs / Logs.