Connecter DHgate : recevoir les commandes, renvoyer le fulfillment
Copiez l’URL de la passerelle API et l’App Key depuis la console développeur DHgate, obtenez le jeton d’accès via le flux OAuth DHgate, collez-les dans Integration, testez, mappez, activez.
Le connecteur DHgate importe les commandes de votre compte vendeur DHgate dans OMS et renvoie le fulfillment vers DHgate. Il peut aussi pousser produits et stock, pour garder commandes, annonces, stock et expéditions synchronisés des deux côtés.
Prérequis#
- Un compte vendeur DHgate : le jeton d’accès est émis pour ce compte vendeur.
- Accès à la console développeur DHgate, où s’affichent votre application, son App Key et l’URL de la passerelle API.
- Possibilité d’achever le flux d’autorisation OAuth DHgate pour ce compte vendeur : le jeton d’accès vient de ce flux.
Obtenir les identifiants#
- Copiez l’URL de la passerelle API : dans la console développeur DHgate, copiez l’URL de la passerelle API telle qu’affichée. Ne la saisissez pas de mémoire : elle n’est pas codée en dur, et un caractère erroné casse tous les appels.
- Copiez l’App Key : dans la console développeur DHgate, ouvrez votre application et copiez l’App Key.
- Obtenez le jeton d’accès : achevez le flux d’autorisation OAuth DHgate pour votre compte vendeur, puis copiez le jeton d’accès de ce flux. Conservez-le en lieu sûr : vous le collerez dans le champ Access token d’Integration.
- Notez les chemins d’endpoint que vous utiliserez : les chemins commandes, produits, stock, fulfillment et sonde sont dans la documentation DHgate Open Platform, relatifs à l’URL de la passerelle. Vous n’en avez besoin que si vous modifiez les champs d’endpoint avancés à l’étape suivante.
Remplir dans Integration#
- Ouvrez Integration → Marketplace → DHgate → Nouvelle connexion.
- URL de la passerelle API (base_url), obligatoire : collez l’URL de la passerelle copiée depuis la console développeur DHgate, telle qu’affichée, par exemple https://… . N’ajoutez pas de chemin d’endpoint à la fin : les champs d’endpoint ci-dessous sont relatifs à cette URL.
- App Key (app_key), obligatoire : collez l’App Key depuis la console développeur DHgate → votre application.
- Jeton d’accès (token), obligatoire : collez le jeton d’accès de votre compte vendeur DHgate obtenu via le flux d’autorisation OAuth. Il est stocké comme secret et jamais réaffiché après l’enregistrement.
- Ruta de commandes (ep_orders), facultatif, avancé : le chemin de l’API « lister les commandes non expédiées », relatif à l’URL de la passerelle, par exemple /order/list, selon la documentation DHgate Open Platform. Laissez la valeur fournie sauf si la documentation de votre application dit le contraire : un chemin erroné empêche toute importation de commandes.
- Ruta de produits (ep_products), facultatif, avancé : le chemin de l’API de liste de produits, relatif à l’URL de la passerelle, selon la documentation DHgate Open Platform. Il sert à pousser ou lire les produits.
- Ruta de stock (ep_inventory), facultatif, avancé : le chemin de l’API de mise à jour du stock, relatif à l’URL de la passerelle, selon la documentation DHgate Open Platform. Il sert à pousser le stock vers DHgate.
- Ruta de fulfillment (ep_fulfillment), facultatif, avancé : le chemin de l’API d’envoi / de suivi, relatif à l’URL de la passerelle, selon la documentation DHgate Open Platform. Il sert à renvoyer le fulfillment vers DHgate.
- Ruta de sonde (ep_me), facultatif, avancé : le chemin d’une API de lecture légère utilisée pour le test « tester la connexion », relatif à l’URL de la passerelle, selon la documentation DHgate Open Platform. Si ce chemin est erroné, le test peut échouer même avec des identifiants corrects.
Tester la connexion#
Cliquez sur Tester la connexion. Le test utilise le chemin de sonde pour vérifier ensemble l’URL de la passerelle, l’App Key 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. S’il n’y a pas encore de commandes non expédiées, passez d’abord une commande test : 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 DHgate. 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 DHgate 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 non expédiées selon la fréquence définie, renvoie le fulfillment avec numéros de suivi vers DHgate et pousse les changements de produits et de stock vers DHgate. Surveillez les premières commandes dans Runs / Logs avant de le laisser sans surveillance.
FAQ#
Le test échoue avec une erreur d’authentification
L’App Key ou le jeton d’accès est incorrect ou n’est plus valide. L’App Key a pu être copié depuis une autre application, ou le jeton d’accès du flux OAuth a expiré, DHgate rejette donc l’appel.
Dans la console développeur DHgate, ouvrez votre application et recopiez l’App Key. Achevez ensuite à nouveau le flux d’autorisation OAuth DHgate, collez le nouveau jeton d’accès dans le champ Access token, puis retestez.
Connecté mais aucune commande n’est importée
La connexion va bien. Le compte vendeur n’a simplement pas de nouvelles commandes non expédiées dans la plage d’extraction, il n’y a donc encore rien à importer.
Passez une commande test qui apparaîtra comme non expédiée, 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.
Le test échoue ou aucune donnée ne revient après la modification d’un chemin d’endpoint
Un chemin d’endpoint avancé ne correspond plus à la documentation DHgate Open Platform. L’URL de la passerelle et les identifiants peuvent être corrects, mais si le chemin de sonde est erroné le test échoue, et si le chemin des commandes est erroné aucune commande ne peut être importée.
Restaurez chaque champ d’endpoint modifié au chemin de la documentation DHgate Open Platform pour votre application (commandes, produits, stock, fulfillment et sonde sont relatifs à l’URL de la passerelle), enregistrez, puis retestez. Ne modifiez qu’un chemin à la fois pour identifier celui qui était erroné.
Les commandes entrent mais fulfillment, produits ou stock ne repartent pas
L’import et le renvoi utilisent des chemins d’endpoint distincts. Les commandes peuvent fonctionner alors que le chemin fulfillment, produits ou stock est erroné, cette direction échoue donc seule.
Vérifiez la direction en échec dans la connexion : comparez les champs Ruta de fulfillment, Ruta de produits et Ruta de stock à la documentation DHgate Open Platform, corrigez celui qui est erroné, puis vérifiez Runs / Logs lors du prochain envoi.