Connecter Etsy : recevoir les commandes, renvoyer le fulfillment
Trouvez votre Shop ID numérique dans l’URL d’administration de votre boutique Etsy, copiez la clé API dans Etsy Developers, collez les deux avec votre jeton d’accès OAuth dans Integration, testez, mappez, activez.
Le connecteur Etsy importe les commandes de votre boutique Etsy dans OMS et renvoie le fulfillment vers Etsy. 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 Etsy, avec accès à son administration pour voir l’URL d’administration de la boutique.
- Accès à Etsy Developers → Your apps, où s’affiche la clé API (KEYSTRING) de votre application.
- Possibilité d’achever le flux d’autorisation OAuth pour cette boutique : le jeton d’accès ne s’obtient qu’après la fin de ce flux.
Obtenir les identifiants#
- Trouvez votre Shop ID : ouvrez l’administration de votre boutique Etsy et regardez l’URL d’administration : le Shop ID est l’ID numérique de cette URL, par exemple 12345678. Copiez uniquement le nombre, pas le nom de la boutique.
- Copiez la clé API : allez dans Etsy Developers → Your apps → copiez la clé API (KEYSTRING) de votre application. Conservez-la en lieu sûr : vous la collerez dans le champ API key d’Integration.
- Obtenez le jeton d’accès OAuth : achevez le flux d’autorisation OAuth pour votre boutique, puis copiez le jeton d’accès obtenu après le flux. Vous le collerez dans le champ OAuth access token d’Integration.
Remplir dans Integration#
- Ouvrez Integration → Marketplace → Etsy → Nouvelle connexion.
- Shop ID : saisissez l’ID numérique de l’URL d’administration de votre boutique Etsy, par exemple 12345678. Ne saisissez pas le nom de la boutique : le champ ne prend que le nombre.
- API key, obligatoire : collez la clé API (KEYSTRING) copiée depuis Etsy Developers → Your apps. Elle est chiffrée au repos et jamais réaffichée.
- OAuth access token : collez le jeton d’accès obtenu après le flux d’autorisation OAuth. Il doit correspondre à la même boutique que le Shop ID ci-dessus : un jeton d’une autre boutique ne correspondra pas.
Tester la connexion#
Cliquez sur Tester la connexion. Le test vérifie ensemble le Shop ID, la clé API et le jeton d’accès OAuth, 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 Etsy : 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 Etsy. 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 Etsy 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 Etsy et pousse les changements de produits et de stock vers Etsy. Surveillez les premières commandes dans Runs / Logs avant de le laisser sans surveillance.
FAQ#
Le test échoue : boutique introuvable
Le Shop ID est incorrect. Le plus souvent, le nom de la boutique a été saisi à la place de l’ID numérique, la connexion cherche donc une boutique qui ne correspond à aucun Shop ID réel.
Ouvrez l’administration de votre boutique Etsy, lisez l’ID numérique dans l’URL d’administration (par exemple 12345678), remplacez le champ Shop ID par ce nombre uniquement, puis retestez.
Le test échoue avec une erreur d’identifiant API
La clé API ne correspond pas à votre application. Elle a été copiée incomplète, avec un espace en trop, ou c’est la clé d’une autre application dans Etsy Developers, Etsy rejette donc l’appel.
Allez dans Etsy Developers → Your apps, recopiez la clé API (KEYSTRING) de la bonne application telle qu’affichée, collez-la dans le champ API key sans espaces supplémentaires, puis retestez.
L’autorisation a expiré
Le jeton d’accès OAuth n’est plus valide. L’autorisation derrière lui a expiré, les appels qui ont besoin de ce jeton sont donc refusés jusqu’à une nouvelle autorisation de la boutique.
Achevez à nouveau le flux d’autorisation OAuth pour la même boutique, copiez le nouveau jeton d’accès obtenu après le flux, remplacez le champ OAuth access token, puis retestez.
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 Etsy, 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.