Quelles sont les erreurs d’intégration Etsy les plus fréquentes et comment les résoudre ?
La plupart des erreurs d’intégration Etsy proviennent des propres règles d’Etsy concernant les listes et les boutiques, ou d’une incompatibilité temporaire entre votre boutique Etsy et votre Tableau de bord Printful. Vous trouverez ci-dessous les erreurs les plus fréquentes de connexion, de synchronisation, de publication, d’importation de commandes et de livraison, regroupées par catégorie, ainsi que la façon de les résoudre. Si vous débutez, consultez d’abord comment connecter Etsy à Printful.
Dans cet article :
- Problèmes de connexion/synchronisation
- Erreurs de publication de produits
- Échec de l’importation de commandes
- Erreur de livraison
Problèmes de connexion/synchronisation
Pourquoi est-ce que j’obtiens « Shop not found » ou « This account has no associated etsy.com stores » ?
Ce message s’affiche lorsque vous essayez de connecter un compte Etsy personnel au lieu d’un compte vendeur. Seules les boutiques Etsy peuvent être connectées à Printful. Vérifiez que vous possédez une boutique active, et pas seulement un compte acheteur, puis déconnectez-vous d’Etsy et reconnectez-vous avec le bon compte lors de l’étape « Allow access ». Si vous n’avez pas encore de boutique, allez à etsy.com/sell et sélectionnez Get started.
Pourquoi ma boutique Etsy ne parvient-elle pas à se connecter à Printful ?
Suivez ces étapes dans l’ordre :
- Vérifiez si la boutique est déjà connectée à un autre compte Printful (si c’est le cas, supprimez-la d’abord depuis ce compte via Paramètres → Paramètres de la boutique → Général → Supprimer la boutique ; le Support Printful ne peut pas le faire pour vous).
- Vérifiez que vous avez terminé l’intégralité du processus d’inscription des vendeurs Etsy sur etsy.com/sell.
- Videz le cache et les cookies de votre navigateur ou essayez une fenêtre de navigation privée ; puis suivez à nouveau les étapes de connexion à Etsy.
Pourquoi ma boutique Etsy s’affiche-t-elle comme « Unavailable Shop » ?
Cela signifie qu’Etsy indique que votre boutique est inaccessible.
- Cliquez sur Reconnecter si cette option apparaît à côté de votre boutique dans Printful (Boutiques → Voir la boutique ou Mes produits → Publié).
- Ouvrez directement l’URL de votre boutique Etsy pour confirmer qu’elle se charge et qu’elle n’est pas en mode vacances ni suspendue, puis cliquez sur Actualiser les données sur votre boutique dans Printful.
Si la boutique se charge correctement sur Etsy mais que l’erreur persiste, il s’agit probablement d’un problème temporaire du côté d’Etsy ; si cela dure plus d’une journée, contactez notre Service client.e.
Que signifie « refresh_token is revoked » ou « oauth_problem: token_revoked » ?
Cela se produit généralement après avoir modifié le mot de passe de votre compte Etsy, ce qui révoque tous les jetons API existants. Cliquez sur Reconnecter sur votre boutique dans le Tableau de bord Printful pour vous réautoriser avec un nouveau jeton ; cela n’affectera pas vos produits ni vos paramètres existants.
Pourquoi est-ce que j’obtiens le message « system error while syncing store » ?
Affichée sous la forme « Something went wrong with sync on [store name] », cette erreur se produit généralement lorsqu’une boutique comporte un très grand nombre de variantes.
Désactiver Importer les produits non synchronisés depuis Etsy et sélectionner Supprimer dans les paramètres d’importation de votre boutique résout souvent le problème.
Erreurs de publication de produits
Pourquoi la publication sur Etsy échoue-t-elle ?
Une erreur générique « Publishing failed » peut avoir plusieurs causes.
- Vérifiez que votre boutique s’affiche comme Actif dans Printful sous Boutiques (si une erreur de synchronisation s’affiche à la place, résolvez-la d’abord en suivant les étapes indiquées ci-dessus).
- Vérifiez si le produit comporte plus de 100 variantes, car Etsy limite les listes à 100 variantes. Si vous avez publié depuis un modèle, dupliquez le modèle et réessayez ; si vous avez publié directement depuis le catalogue, recréez le produit, enregistrez-le comme modèle, puis publiez-le.
Pourquoi est-ce que j’obtiens « Product was not added! Unknown Etsy client exception » ?
Il s’agit presque toujours d’un problème de longueur de balise. Etsy limite chaque balise à 20 caractères, et cette erreur apparaît lorsqu’au moins une balise dépasse cette limite. Raccourcissez vos balises et essayez à nouveau de publier. Consultez les limitations des balises Etsy pour connaître l’ensemble des règles.
Pourquoi la modification de mon fichier d’impression ne met-elle pas à jour la maquette sur Etsy ?
Si une liste comporte déjà 20 images du côté d’Etsy (le maximum d’Etsy par liste), Printful ne peut pas envoyer automatiquement une nouvelle maquette, car il n’existe aucun moyen fiable de déterminer quelle image appartient à quelle variante.
Utilisez Modifier le fichier d’impression et sélectionnez toutes les variantes afin que toutes les maquettes soient mises à jour ensemble, ou chargez manuellement la nouvelle maquette sur Etsy. Renvoyer la liste fonctionne également, mais Etsy facturera de nouveaux frais de liste.
Pourquoi mes produits Etsy se désynchronisent-ils continuellement ?
Définir une Couleur principale dans les paramètres de votre liste Etsy peut faire disparaître d’autres variantes de couleur et désynchroniser le produit. Modifier directement Size ou Primary color sur Etsy peut également supprimer d’autres options de taille ou de couleur.
La plupart de ces problèmes sont des limitations du côté d’Etsy plutôt que des conséquences de vos actions. Malheureusement, la solution consiste à resynchroniser manuellement les produits concernés dans votre Tableau de bord Printful.
Pourquoi est-ce que j’obtiens une erreur concernant plusieurs variantes ayant la même identité ?
Etsy n’autorise pas les valeurs d’option (comme la couleur ou la taille) de plus de 20 caractères, et l’importation peut échouer si cette limite est dépassée ou si deux variantes finissent par avoir des valeurs identiques.
Essayez d’ajouter à nouveau le produit à votre boutique ; si cela ne fonctionne pas, publiez d’abord la liste sur Etsy, puis importez-la dans Printful.
Pourquoi le titre de mon produit ou ma liste est-il rejeté ?
Etsy applique des règles spécifiques aux titres et aux descriptions. Si un ajout ou une synchronisation échoue à cause de cela, le message d’erreur indiquera la partie de la liste qui doit être ajustée.
Consultez notre guide du manuel des listes Etsy et l’article sur les limitations des balises pour connaître les exigences actuelles d’Etsy.
Échec de l’importation de commandes
Pourquoi mes commandes Etsy n’apparaissent-elles pas dans Printful ?
Si une commande est confirmée et payée sur Etsy, mais qu’elle n’apparaît pas dans votre Tableau de bord Printful :
- Consultez notre guide général sur la marche à suivre si votre commande n’apparaît pas dans Printful.
- Vérifiez que la commande est marquée comme Paid, qu’elle possède un numéro de commande unique et qu’elle comprend une adresse de livraison.
- Vérifiez que la variante du produit s’affiche comme synchronisée dans votre Tableau de bord Printful ; si elle s’affiche comme Pas synchronisé, activez Importer les commandes non synchronisées. Cliquez ensuite sur Actualiser les données sur votre boutique.
Si la variante du produit n’existe pas dans Printful, la commande ne sera pas importée et vous devrez la recréer manuellement dans votre Tableau de bord Printful.
Erreur de livraison
Pourquoi mon profil de livraison Etsy ne s’enregistre-t-il pas correctement ?
Une erreur telle que « Object has validation errors: shipping_profile_name... already exists » signifie généralement que votre profil de livraison généré par Printful a été dupliqué du côté d’Etsy. Printful utilise un identifiant unique (une chaîne comme « PF-FRG2 ») dans le nom du profil pour le suivre, et avoir deux profils de livraison avec ce même identifiant crée un conflit.
Pour résoudre ce problème, allez aux paramètres de votre profil de livraison Etsy, supprimez le texte de l’identifiant dupliqué du nom du profil, puis enregistrez vos modifications.
Vous avez encore besoin d’aide ? Notre équipe d’assistance est là pour vous — contactez-nous à tout moment via notre formulaire de contact ou démarrez un chat avec nous.