Sync Etsy pour PrestaShop — Documentation

Sync Etsy relie votre boutique PrestaShop à votre shop Etsy : il exporte vos produits en listings, synchronise vos stocks et importe automatiquement vos commandes Etsy dans PrestaShop. Ce guide couvre l’installation, la connexion à Etsy, les réglages et le fonctionnement au quotidien.

Prérequis

• Une boutique PrestaShop 8 ou 9 fonctionnelle, avec accès au back-office.
• Un shop Etsy actif.
• Une application enregistrée sur le portail développeur Etsy (gratuite) — voir l’étape suivante.
• Un cron serveur (ou un service de cron externe) pour automatiser la synchronisation des stocks et l’import des commandes.

Installation

1. Dans le back-office PrestaShop, allez dans Modules > Gestionnaire de modules.
2. Cliquez sur Installer un module et déposez le fichier dfetsy.zip.
3. Une fois installé, cliquez sur Configurer. Vous arrivez sur la page d’administration du module, organisée en onglets : Connexion, Produits, Commandes, Réglages, Cron, Logs.

Créer votre application Etsy

Le module se connecte à Etsy via votre propre application développeur. La procédure est gratuite et prend quelques minutes.

1. Rendez-vous sur le portail développeur Etsy (etsy.com/developers) et créez une nouvelle application.
2. Etsy vous fournit une clé d’API, appelée keystring (c’est votre Client ID).
3. Dans la configuration de votre application Etsy, déclarez l’URL de redirection (Callback URL) exactement telle qu’elle est affichée dans l’onglet Connexion du module.

Connexion à Etsy

Dans l’onglet Connexion :

1. Collez votre keystring dans le champ prévu et cliquez sur Enregistrer.
2. Cliquez sur Connecter ma boutique Etsy. Un onglet Etsy s’ouvre et vous demande d’autoriser l’application.
3. Après autorisation, vous êtes redirigé vers une page de confirmation. Revenez au back-office et rechargez la page : le bandeau doit afficher Connecté avec le nom et l’identifiant de votre shop.
4. Utilisez le bouton Tester la connexion pour vérifier que tout fonctionne.

Le jeton d’accès est rafraîchi automatiquement par le module. Le bouton Déconnecter supprime les jetons et l’association au shop.

Réglages

L’onglet Réglages regroupe le comportement de synchronisation et les attributs Etsy par défaut.

Synchronisation

• Pousser les stocks PS vers Etsy : chaque changement de quantité est mis en file d’attente et envoyé au prochain passage du cron.
• Mettre à jour le listing à chaque sauvegarde produit : réexporte automatiquement le listing quand vous modifiez un produit lié.
• Importer les commandes Etsy : active l’import automatique des commandes payées.
• Envoyer les images produit : joint les images du produit au listing lors de l’export.
• Synchroniser les prix : envoie le prix PrestaShop vers Etsy.
• Majoration prix Etsy (%) : applique un pourcentage au prix exporté pour absorber les frais Etsy, sans toucher au prix PrestaShop.
• Langue d’export : langue utilisée pour le titre et la description des listings.

Attributs Etsy par défaut

• Qui l’a fabriqué / Quand : valeurs Etsy obligatoires (who_made / when_made) appliquées aux nouveaux listings.
• Taxonomy ID : catégorie Etsy par défaut des listings (référez-vous à la Seller Taxonomy d’Etsy).
• Profil de livraison et Politique de retours : listes chargées automatiquement depuis votre shop Etsy une fois connecté.
• État du listing à l’export : Brouillon (recommandé — vous relisez avant de publier) ou Actif (publication immédiate, des frais de mise en ligne Etsy s’appliquent).

Import des commandes

• État de commande : statut PrestaShop attribué aux commandes importées.
• Transporteur : transporteur associé par défaut.
• Envoyer les emails PrestaShop à l’import : désactivé par défaut, car Etsy notifie déjà l’acheteur. À laisser désactivé dans la plupart des cas.

Exporter des produits vers Etsy

Dans l’onglet Produits, recherchez un article par nom, référence ou identifiant.

• Exporter vers Etsy crée un listing avec le titre, la description, les tags, les images et le prix du produit. Le listing est créé en brouillon (ou actif selon vos réglages), puis l’inventaire (SKU, prix, quantité) est envoyé.
• Mettre à jour renvoie les informations vers un listing déjà lié.
• Lier (listing ID) associe manuellement un produit PrestaShop à un listing Etsy existant, en saisissant l’identifiant du listing.
• Délier supprime l’association (le listing Etsy n’est pas supprimé).

Synchronisation des stocks

Quand la quantité d’un produit lié change dans PrestaShop, un travail de synchronisation est ajouté à une file d’attente dédupliquée. Aucun appel à Etsy n’est fait pendant la navigation : la file est traitée par le cron, ce qui évite tout ralentissement du front et du back-office. Vous pouvez aussi déclencher le traitement manuellement depuis l’onglet Cron.

Import des commandes

Les commandes Etsy payées sont importées comme commandes PrestaShop :

• Un client invité est créé (ou réutilisé s’il existe déjà pour cet email).
• L’adresse de livraison Etsy est reprise. Si le pays n’est pas reconnu, la commande est ignorée et un message apparaît dans les logs.
• Le prix payé est appliqué à l’euro près : le total de la commande PrestaShop correspond au montant réglé sur Etsy.
• La note laissée par l’acheteur est attachée en message dans le fil SAV de la commande.
• Un anti-doublon par identifiant de commande Etsy (receipt) évite tout import en double.

Configurer le cron

L’onglet Cron affiche une URL sécurisée par un token. Appelez-la toutes les 5 à 15 minutes pour traiter la file d’attente (stocks et produits) et importer les nouvelles commandes.

*/10 * * * * curl -s "https://votre-boutique/index.php?fc=module&module=dfetsy&controller=cron&token=VOTRE_TOKEN" > /dev/null

Le bouton Exécuter la file d’attente maintenant permet de lancer un traitement manuel pour tester.

Logs et diagnostic

L’onglet Logs affiche le journal des événements (export, stock, import, erreurs). En cas de problème sur une synchronisation, consultez-le en priorité : chaque erreur Etsy y est enregistrée avec son message. Les entrées de plus de 30 jours sont purgées automatiquement.

Limites de la version 1.0

• Un produit = un listing en référence unique (pas de variations Etsy natives).
• Mono-boutique Etsy (un shop connecté à la fois).
• Le suivi d’expédition n’est pas encore renvoyé vers Etsy.
• La ventilation détaillée des frais de port par ligne n’est pas reconstituée (le total payé Etsy fait foi).

Questions fréquentes

Mes listings sont-ils publiés automatiquement ?

Par défaut non : ils sont créés en brouillon pour que vous les relisiez avant publication sur Etsy. Vous pouvez choisir l’état « Actif » dans les réglages pour publier immédiatement.

Comment éviter la survente entre les deux canaux ?

Activez la synchronisation des stocks et un cron régulier : chaque vente ou modification de quantité dans PrestaShop met à jour la quantité Etsy au passage suivant du cron.

Où trouver le code source ?

Le code complet est inclus dans le ZIP, non chiffré (PSR-4, autoloader SPL), pour audit ou personnalisation.