Connecteur Odoo Etsy : Intégration du commerce fait main

Etsy héberge plus de 9 millions de vendeurs actifs et dessert un créneau qu'aucun autre marché ne reproduit : les produits faits à la main, vintage et artisanaux. Pour les vendeurs Etsy qui ont dépassé le simple suivi sur feuille de calcul, Odoo 19 Enterprise fournit les capacités de gestion des stocks, de comptabilité financière et de planification de la production dont une entreprise artisanale en pleine expansion a besoin.

Le connecteur ECOSIRE Odoo Etsy relie votre boutique Etsy avec Odoo, en synchronisant les annonces, les commandes, l'inventaire et les données clients. Ce guide couvre l'intégration complète depuis la configuration des informations d'identification de l'API Etsy jusqu'à la gestion des ordres de production et les rapports sur les vendeurs Etsy.

Points clés à retenir

• Le connecteur utilise l'API Etsy v3 avec l'authentification OAuth 2.0
• Synchronisation des annonces dans les deux sens : créer dans Odoo, publier sur Etsy
• L'importation des commandes inclut les détails de l'acheteur, les notes de personnalisation des articles et les indicateurs d'emballage cadeau
• L'inventaire est envoyé à Etsy dans les 5 minutes suivant les changements de stock dans Odoo
• L'intégration des ordres de production (MRP) suit la fabrication sur commande des produits artisanaux
• Les frais Etsy et les frais de traitement des paiements se rapprochent automatiquement des factures Odoo
• Plusieurs boutiques prises en charge : gérez plusieurs boutiques Etsy à partir d'une seule instance Odoo
• Le renouvellement de l'annonce Etsy (renouvellement automatique 20 ¢ par annonce) est suivi dans les coûts Odoo

---

Pourquoi les vendeurs Etsy ont besoin de l'intégration d'Odoo

Le gestionnaire de boutique intégré d'Etsy gère le suivi de base des commandes, mais n'a pas la profondeur dont les entreprises artisanales en pleine croissance ont besoin :

Pour les vendeurs réalisant plus de 10 000 $ de revenus mensuels ou gérant plus de 50 SKU actifs dans le domaine de la fabrication artisanale et des matériaux, Odoo offre des capacités opérationnelles qui évoluent avec l'entreprise.

---

Configuration de l'API Etsy

Étape 1 : Créez un compte développeur Etsy

1. Accédez à developers.etsy.com et connectez-vous avec votre compte vendeur Etsy
2. Cliquez sur Créer une application sous Mes applications.
3. Nommez votre application (par exemple, « Intégration Odoo ») et décrivez son objectif
4. Acceptez les conditions d'utilisation de l'API Etsy
5. Etsy examinera votre candidature (généralement 1 à 3 jours ouvrables)

Étape 2 : Configurer les étendues OAuth

Votre application a besoin des étendues OAuth 2.0 suivantes :

listings_r      — Read active listings
listings_w      — Create/edit listings
listings_d      — Delete listings
transactions_r  — Read orders and transactions
transactions_w  — Update order status
shops_r         — Read shop data
billing_r       — Read payment and billing data

Étape 3 : Générer les informations d'identification de l'API

Après approbation :

• API Key (Keystring) : votre identifiant d'application
• Shared Secret : utilisé pour le flux OAuth PKCE
• URI de redirection : https://your-odoo.com/etsy/oauth/callback

Étape 4 : Terminez l'autorisation OAuth

Depuis la configuration du connecteur dans Odoo :

1. Cliquez sur Connecter la boutique Etsy
2. Autorisez le connecteur dans la popup Etsy OAuth
3. Le connecteur reçoit et stocke votre jeton d'accès et votre jeton d'actualisation

Les jetons OAuth d'Etsy n'expirent pas avec un délai fixe (contrairement aux jetons d'actualisation de 18 mois d'Amazon). Ils restent valables jusqu'à ce que vous les révoquiez.

---

Installation et configuration du connecteur

Installer depuis le marché ECOSIRE :

Disponible sur Produits ECOSIRE. Après l'achat :

1. Téléchargez et installez le module Etsy Connector via les applications
2. Accédez à Inventaire → Etsy ou Ventes → Boutiques Etsy.

Configuration de la boutique :

Cartographie des sections de la boutique Etsy :

Etsy organise les listes en sections de boutique (équivalentes aux catégories). Mapper les sections Etsy aux catégories de produits Odoo :

---

Gestion des annonces

Création de listes Etsy à partir de produits Odoo :

1. Ouvrez un formulaire de produit → onglet Etsy → Créer une annonce
2. Configurez les champs spécifiques à la liste :

• Titre : 140 caractères maximum, riche en mots clés pour le référencement Etsy
• Description : description complète avec matériaux, dimensions, instructions d'entretien
• Tags : jusqu'à 13 tags, essentiels pour l'algorithme de recherche Etsy
• Catégorie : parcourez l'arbre taxonomique d'Etsy
• Qui l'a fait : Je l'ai fait, un membre de ma boutique, quelqu'un d'autre
• Une fois fabriqué : Fabriqué sur commande, 2020-2025, 2010-2019, etc.
• Type : Article physique, téléchargement numérique
• Prix : prix catalogue (peut différer du prix catalogue d'Odoo)
• Quantité : inventaire disponible à lister
• Matériaux : jusqu'à 13 balises de matériaux
• Photos : jusqu'à 10 photos (la première image devient l'image de la liste principale)

3. Cliquez sur Publier sur Etsy

Listes de variantes (variantes de produits) :

Etsy prend en charge les « variantes » — Odoo les mappe aux attributs du produit :

Exemple : Une bague vendue en Or/Argent dans les tailles 5 à 10 crée une seule liste Etsy avec 12 combinaisons de variantes, chacune avec son propre prix et son propre suivi des stocks.

Listes de commandes personnalisées et personnalisées :

Etsy est célèbre pour ses articles personnalisés. Configurez la personnalisation dans le connecteur :

• Activez Personnalisation requise/facultatif sur la liste
• L'acheteur saisit le texte de personnalisation (nom, date, monogramme) à la caisse
• Ce texte apparaît dans le champ des notes client de la commande Odoo
• L'équipe de production voit la personnalisation lors de la fabrication de l'article

---

Synchronisation des commandes

Détails de l'importation de la commande :

Les commandes Etsy incluent des champs essentiels pour les vendeurs artisanaux :

Acheminement des commandes pour la fabrication sur commande :

Les vendeurs Etsy fabriquent souvent des articles après avoir reçu une commande (MTO). Configurez le connecteur :

1. Dans les paramètres du produit → onglet Ventes → Sur demande : « Fabriqué sur commande »
2. Lorsqu'une commande Etsy est importée, Odoo crée :

• Bon de commande (confirmé)
• Ordre de fabrication (projet) lié à la vente
• L'ordre de fabrication indique les matériaux nécessaires et le temps de main d'œuvre

3. L'équipe de production travaille sur l'ordre de fabrication
4. Une fois le MO terminé, les marchandises arrivent en stock → la livraison est confirmée
5. Détails de l'envoi renvoyés à Etsy

Traitement des commandes personnalisées :

Pour les commissions personnalisées (non répertoriées sur Etsy) :

1. Acceptez la commande personnalisée dans Etsy
2. Dans Odoo, créez manuellement une commande de vente « Produit personnalisé » avec le prix convenu
3. Lien vers la conversation Etsy dans les notes de commande
4. Marquer comme expédié dans Etsy manuellement ou via l'outil de commande personnalisé du connecteur

---

Synchronisation des stocks

Pour les produits physiques :

La synchronisation de l'inventaire s'exécute toutes les 5 minutes par défaut. Lorsque le stock Odoo change :

1. Quantité disponible recalculée (en stock moins réservée)
2. Quantité transmise à Etsy via l'API Listing Inventory
3. Si la quantité atteint 0 : l'annonce est définie sur épuisée (maintient l'annonce active)
4. Une fois réapprovisionné : listing réactivé automatiquement

Pour les produits sur commande :

Les produits MTO ne suivent pas l'inventaire physique au sens traditionnel du terme. Configurez la quantité de référencement Etsy comme indicateur de capacité de production :

• Définir une "quantité disponible" fixe (par exemple, 5) représentant la capacité de commande actuelle
• Ajustez manuellement à mesure que votre file d'attente de production se remplit

Pour les téléchargements numériques :

Les produits numériques ont un inventaire infini. Le connecteur définit la quantité Etsy sur 999 et ne synchronise jamais les modifications de stock. La livraison des fichiers numériques est gérée par le système de téléchargement numérique natif d'Etsy : le connecteur ne touche pas à la livraison des fichiers.

---

Rapprochement financier

Le traitement des paiements et la structure des frais d'Etsy nécessitent une configuration comptable minutieuse.

** Structure des frais Etsy Payments (pour référence) :**

• Frais d'inscription : 0,20 $ par annonce (facturés lors de l'inscription et tous les 4 mois lors du renouvellement automatique)
• Frais de transaction : 6,5% du prix de l'article + frais de port
• Frais de traitement des paiements : 3 % + 0,25 $ par transaction (US)
• Frais de publicités hors site : 12 à 15 % lorsqu'Etsy fait la publicité de votre article (si inscrit)

Configuration du rapprochement des frais dans Odoo :

1. Créez un journal Etsy Payments dédié (type banque)
2. Créez des comptes :

• Etsy Listing Fees (dépense)
• Etsy Transaction Fees (dépense)
• Etsy Payment Processing Fees (dépense)
• Etsy Payments Receivable (actif actuel)

3. Importez les relevés de paiement Etsy :

• Accédez à Etsy → Paiements → Relevé mensuel → Télécharger CSV
• Importer dans l'outil de réconciliation du connecteur
• Le connecteur crée des écritures de journal pour chaque type de transaction

Processus de rapprochement de fin de mois :

1. Téléchargez le paiement mensuel Etsy CSV
2. Importer via le connecteur : Etsy → Réconciliation → Déclaration d'importation
3. Examinez les entrées correspondantes automatiquement
4. Faites correspondre manuellement toutes les transactions non reconnues
5. Confirmer le rapprochement → écritures de journal publiées dans Odoo
6. Rapprocher le compte bancaire Etsy Payments du solde Odoo

---

Etsy SEO et suivi des performances

Synchronisation des performances de l'annonce :

Le connecteur importe les statistiques de la boutique Etsy vers Odoo :

• Vues par annonce et par jour
• Nombre de favoris
• Taux de conversion (vues en ventes)
• Revenus par inscription

Ces données apparaissent dans le tableau de bord d'analyse Etsy dans Odoo, vous permettant d'identifier les annonces les plus performantes et les moins performantes sans passer à l'interface de statistiques d'Etsy.

Suivi des balises et des mots clés :

Suivez les termes de recherche qui génèrent du trafic sur Etsy en extrayant les statistiques de l'API Shop Stats d'Etsy. Utilisez ces données pour :

• Identifiez les balises à fort taux de conversion à ajouter à des listes similaires
• Trouvez des annonces avec des vues élevées mais une faible conversion (problèmes de prix ou de photo)
• Repérez les tendances saisonnières dans votre catégorie de produits

---

Questions fréquemment posées

Le connecteur peut-il gérer le modèle d'Etsy (site Web personnalisé) en plus du marché Etsy ?

Non. Le connecteur s’intègre spécifiquement au marché Etsy. Etsy Pattern (leur créateur de site Web hébergé) partage le même inventaire mais utilise un traitement de paiement et de paiement distinct. Les commandes de modèles devraient être gérées séparément. Pour une intégration de site Web complète, le module de site Web d'Odoo ou une intégration Shopify est recommandé.

Comment le connecteur gère-t-il la réserve d'Etsy pour les transactions (paiement Etsy retenu) ?

Etsy place parfois une réserve sur les paiements des nouveaux vendeurs pour la gestion des risques. Le connecteur suit l'état de paiement de chaque commande. Les montants réservés apparaissent dans le solde Etsy Payments mais ne sont pas disponibles pour le retrait. Le connecteur marque ces factures comme « en attente de paiement » jusqu'à ce que la réserve soit libérée, puis se met à jour comme « payée » lorsque les fonds sont débloqués vers votre banque.

Puis-je gérer plusieurs boutiques Etsy (par exemple, une pour les bijoux, une pour la décoration intérieure) à partir d'une seule instance Odoo ?

Oui. Créez des configurations de boutique Etsy distinctes avec des informations d'identification OAuth indépendantes pour chaque boutique. Chaque boutique dispose de ses propres paramètres d'importation de commandes, d'allocation des stocks et de rapprochement des paiements. Les produits peuvent être répertoriés dans plusieurs boutiques avec des remplacements de prix spécifiques à chaque boutique.

Le connecteur prend-il en charge la fonctionnalité de vente en gros/B2B d'Etsy ?

Etsy n'a pas de programme natif de vente en gros/B2B. Si vous utilisez Etsy pour des demandes de vente en gros mais que vous gérez la transaction réelle hors ligne, le connecteur la gère de la même manière que n'importe quelle commande personnalisée : vous créerez manuellement la commande de vente Odoo avec un prix convenu et l'exécuterez via votre processus standard.

Comment le connecteur gère-t-il les ventes Etsy internationales et les exigences en matière de TVA/TPS ?

Etsy collecte et reverse la TVA/TPS au nom des vendeurs pour les acheteurs dans l'UE, au Royaume-Uni, en Australie et dans d'autres juridictions où Etsy agit en tant que facilitateur du marché. Le connecteur importe ces commandes avec une taxe de 0 $ (puisqu'Etsy les a collectées). Pour les marchés où vous êtes responsable de la collecte des taxes, configurez les positions fiscales appropriées dans Odoo en fonction du pays de l'acheteur.

---

Prochaines étapes

Le connecteur ECOSIRE Etsy transforme Etsy d'une place de marché autonome en un canal de vente entièrement intégré au sein d'Odoo 19 Enterprise. Pour les entreprises artisanales qui vont au-delà de la gestion de base d’un magasin, cette intégration constitue la base opérationnelle d’une croissance durable.

Obtenez le connecteur ECOSIRE Etsy pour Odoo 19 →

Le connecteur comprend une documentation de configuration, des outils d'importation pour les données de commande historiques et une assistance à la mise en œuvre pour intégrer rapidement et correctement votre boutique Etsy à Odoo.