Quelles sont les erreurs les plus fréquentes liées à l’intégration Etsy et comment les corriger ?

La plupart des erreurs liées à l’intégration Etsy proviennent des règles d’Etsy concernant les annonces et les boutiques, ou d’un décalage temporaire entre votre boutique Etsy et votre Tableau de bord Printful. Vous trouverez ci-dessous les erreurs de connexion, de synchronisation, de publication, d’importation de commandes et de livraison les plus fréquentes, regroupées par catégorie, ainsi que les solutions correspondantes. Si vous débutez, découvrez d’abord comment connecter Etsy à Printful.

Dans cet article :

• Problèmes de connexion et de synchronisation
• Erreurs de publication des produits
• Échec de l’importation des commandes
• Erreur de livraison

Problèmes de connexion et de synchronisation

Pourquoi le message « Boutique introuvable » ou « Ce compte n’a pas de boutiques etsy.com associées » s’affiche-t-il ?

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 avez 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 « Autoriser l’accès ». Si vous n’avez pas encore de boutique, rendez-vous sur etsy.com/sell et sélectionnez Guide de démarrage.

Pourquoi la connexion de ma boutique Etsy à Printful échoue-t-elle ?

Suivez ces étapes dans l’ordre : 

1. Vérifiez si la boutique est déjà connectée à un autre compte Printful (si c’est le cas, supprimez-la d’abord de ce compte via Paramètres → Paramètres de la boutique → Général → Supprimer la boutique ; le service client Printful ne peut pas le faire à votre place).
2. Vérifiez que vous avez terminé l’ensemble du processus d’inscription des vendeurs Etsy sur etsy.com/sell.
3. Videz le cache et les cookies de votre navigateur ou essayez d’utiliser une fenêtre de navigation privée, puis suivez à nouveau les étapes de connexion à Etsy.

Pourquoi ma boutique Etsy apparaît-elle comme « Boutique indisponible » ?

Cela signifie qu’Etsy indique que votre boutique est inaccessible. 

1. Cliquez sur Reconnecter si cette option apparaît à côté de votre boutique dans Printful (Boutiques → Voir la boutique, ou Mes produits → Publié). 
2. Ouvrez directement l’URL de votre boutique Etsy pour vérifier qu’elle se charge et qu’elle n’est ni en mode vacances ni suspendue, puis cliquez sur Actualiser les données pour votre boutique sur Printful. 

Si la boutique se charge correctement sur Etsy, mais que l’erreur persiste, le problème est probablement temporaire du côté d’Etsy ; s’il dure plus d’une journée, contactez notre service client.

Que signifient « refresh_token is revoked » ou « oauth_problem: token_revoked » ?

Ce problème survient généralement après la modification du mot de passe de votre compte Etsy, qui révoque tous les jetons API existants. Cliquez sur Reconnecter pour votre boutique dans le Tableau de bord Printful afin de vous réauthentifier à l’aide d’un nouveau jeton ; cela n’affectera ni vos produits ni vos paramètres existants.

Pourquoi le message « Erreur système lors de la synchronisation de la boutique » s’affiche-t-il ?

Ce message, qui s’affiche sous la forme « Un problème est survenu lors de la synchronisation de [nom de la boutique] », apparaît souvent 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 des produits

Pourquoi la publication sur Etsy échoue-t-elle ?

Une erreur générique « Échec de la publication » peut avoir plusieurs causes. 

1. Vérifiez que votre boutique apparaît comme Active sur Printful, dans Boutiques (si une erreur de synchronisation s’affiche à la place, résolvez d’abord ce problème en suivant les étapes indiquées ci-dessus). 
2. Vérifiez si le produit comporte plus de 100 variantes, car Etsy limite les annonces à 100 variantes. Si vous avez publié le produit à partir d’un modèle, dupliquez le modèle et réessayez ; si vous l’avez publié directement depuis le catalogue, recréez le produit, enregistrez-le en tant que modèle, puis publiez-le.

Pourquoi le message « Product was not added! Unknown Etsy client exception » s’affiche-t-il ?

Ce problème est presque toujours lié à la longueur des tags. Etsy limite chaque tag à 20 caractères et cette erreur apparaît lorsqu’au moins un tag dépasse cette limite. Raccourcissez vos tags et réessayez de publier. Consultez les limites des tags 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 annonce comporte déjà 20 images sur Etsy (le maximum autorisé par annonce), Printful ne peut pas envoyer automatiquement une nouvelle maquette, car il n’existe aucun moyen fiable de déterminer quelle image correspond à quelle variante. 

Utilisez Modifier le fichier d’impression et sélectionnez toutes les variantes afin que chaque maquette soit mise à jour en même temps, ou téléversez manuellement la nouvelle maquette sur Etsy. Republier l’annonce fonctionne également, mais Etsy facturera de nouveaux frais de mise en ligne.

Pourquoi mes produits Etsy se désynchronisent-ils sans cesse ?

Définir une Couleur principale dans les paramètres de votre annonce Etsy peut entraîner la disparition des autres variantes de couleur et la désynchronisation du produit. Modifier directement sur Etsy la Taille ou la Couleur principale peut également supprimer d’autres options de taille ou de couleur. 

La plupart de ces problèmes sont dus aux limitations d’Etsy et non à une action de votre part. Malheureusement, pour les résoudre, vous devez resynchroniser manuellement les produits concernés dans votre Tableau de bord Printful.

Pourquoi reçoit-on une erreur indiquant que plusieurs variantes ont la même identité ?

Etsy n’autorise pas les valeurs d’option (comme la couleur ou la taille) de plus de 20 caractères. 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 l’annonce sur Etsy, puis importez-la dans Printful.

Pourquoi le titre de mon produit ou mon annonce est-il refusé ?

Etsy applique des règles précises aux titres et aux descriptions. Si l’ajout ou la synchronisation échoue pour cette raison, le message d’erreur indiquera la partie de l’annonce à modifier. 

Consultez notre guide du manuel des annonces Etsy et notre article sur les limites des tags pour connaître les exigences actuelles d’Etsy.

Échec de l’importation des 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 :

1. Consultez notre guide général sur la marche à suivre si votre commande n’apparaît pas dans Printful. 
2. Vérifiez que la commande est marquée comme Payée, qu’elle possède un numéro de commande unique et qu’elle comprend une adresse de livraison.
3. Vérifiez que la variante du produit apparaît comme synchronisée dans votre Tableau de bord Printful ; si elle apparaît comme pas synchronisée, activez l’option Importer les commandes non synchronisées. Cliquez ensuite sur Actualiser les données pour votre boutique.

Si la variante du produit n’existe pas sur 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 le profil de livraison généré par Printful a été dupliqué sur Etsy. Printful utilise un identifiant unique (une chaîne telle que « PF-FRG2 ») dans le nom du profil pour le suivre. La présence de deux profils de livraison avec le même identifiant entraîne un conflit.

Pour résoudre le problème, accédez aux paramètres de vos profils de livraison Etsy, supprimez le texte correspondant à 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.