Aller au contenu principal
Shopee Marketplace Connector

Mise en route de Shopee Marketplace Connector (APAC) dans Odoo : champs, correspondances et première semaine

Pour mettre en route Shopee Marketplace Connector (APAC), vous créez dans Odoo un compte marketplace avec sa société, son entrepôt, le Partner ID / App Key, le Shop ID et la Partner Key de votre app Shopee, vous choisissez l'environnement et fixez à partir de quand les commandes deviennent des devis. Ensuite, vous faites correspondre les catégories et attributs d'Odoo avec ceux de Shopee et, la première semaine, vous surveillez les journaux de synchronisation, les conflits et la file d'attente. Voici les étapes dans l'ordre et la signification de chaque champ.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 4 novembre 2026

L'essentiel

Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du module, version 20.0 · dans les sources citées à la fin
Lecture
5 min

Ce qu'il faut préparer avant d'ouvrir Odoo

Le compte marketplace du module demande des données issues de Shopee et d'autres issues de votre propre organisation. Mieux vaut les réunir avant de commencer :

  • Le partner_id de votre app Shopee et sa partner key, que vous trouvez dans Shopee Open Platform > App list.
  • Le shop_id de la boutique à connecter.
  • Si vous voulez d'abord tester, le partner ID et la clé de test de votre app ainsi qu'une boutique de test Shopee.
  • La société Odoo qui sera propriétaire du compte et l'entrepôt depuis lequel vous synchroniserez l'inventaire.
  • Les adresses e-mail qui doivent recevoir les alertes.

Le module est publié sur Odoo Apps pour les versions 17, 18, 19 et 20 et, d'après la fiche de chaque version, il est gratuit dans toutes (paiement unique par version, HT). Vous le trouverez sur la fiche Odoo Apps et sur la page du module.

Étapes pour créer le compte Shopee

Chaque étape correspond à un champ du compte marketplace. Les noms sont indiqués tels qu'ils apparaissent dans le module.

  1. Saisissez l'Account Name, le nom du compte.
  2. Choisissez la Company. Le module isole les comptes par société : chaque société possède ses propres configurations de marketplace.
  3. Indiquez le Default Fulfillment Warehouse. C'est l'entrepôt par défaut pour la synchronisation de l'inventaire, modifiable produit par produit.
  4. Sélectionnez le Shopee Environment. Avec Sandbox, ce sont le partner ID et la clé de test de votre app et les boutiques de test Shopee qui sont utilisés.
  5. Renseignez Partner ID / App Key avec le partner_id de Shopee et Shop ID avec le shop_id de votre boutique.
  6. Collez dans Partner Key la partner key de votre app. D'après la description du champ, c'est elle qui signe chaque appel.
  7. Utilisez le lien Connect Shopee shop. Le module enregistre dans Authorization State une valeur aléatoire du dernier lien généré et la vérifie quand Shopee renvoie le vendeur. Le compte comporte aussi les champs OAuth Access Token, OAuth Refresh Token et Access Token Expires.
  8. Définissez Create Sales Orders From. Les commandes passées sur Shopee avant ce moment sont retenues (Held Orders) au lieu de devenir des devis.
  9. Réglez Sync Frequency (minutes), l'intervalle d'interrogation pour les commandes et l'inventaire, entre 5 et 60 minutes.
  10. Fixez un Low Stock Threshold (units) : sous ce niveau, le module déclenche une alerte de stock bas. Si vous cochez aussi Auto-Create PO on Low Stock, il crée un bon de commande fournisseur en brouillon quand le stock passe sous le seuil.
  11. Saisissez dans Alert Email Recipients les adresses, séparées par des virgules, qui recevront les alertes de synchronisation, le récapitulatif et les notifications d'erreur.
  12. Choisissez la stratégie d'Auto-Conflict Resolution pour les conflits détectés et le Conflict Detection Threshold (%), le pourcentage d'écart à partir duquel un conflit est détecté.
  13. Une fois tout cela vérifié, cochez Enable Sync, qui active ou désactive toutes les synchronisations du compte.

Le champ API Key figure sur le compte, mais sa propre description indique que Shopee ne l'utilise pas.

Faire correspondre catégories, attributs et produits

Le compte comporte trois relations entre Odoo et Shopee : Category Mappings, Attribute Mappings et Product Mappings.

Catégories

Dans Category Mappings, vous associez une catégorie Odoo à une catégorie Shopee. Chaque ligne contient Marketplace Account, Odoo Category, Marketplace Category ID (le category_id de Shopee) et Marketplace Category Name, un nom lisible que le module conserve pour l'affichage. La colonne Created indique quand la ligne a été créée.

Liste des correspondances de catégories avec les colonnes Marketplace Account, Odoo Category, Marketplace Category ID, Marketplace Category Name et Created
La liste des correspondances de catégories, encore vide, avec le bouton Nouveau et la barre de recherche.

Attributs

Dans Attribute Mappings, vous associez un attribut Odoo (Odoo Attribute, par exemple couleur, taille ou marque) à la clé d'attribut de la marketplace dans Marketplace Attribute Key. Chaque ligne porte aussi son Marketplace Account et sa date Created.

Produits

Product Mappings regroupe les liens entre chaque produit Odoo et son ID produit sur la marketplace. La séquence ci-dessous montre un enregistrement d'exemple du compte Shopee SG avec le statut Synced.

Liste des correspondances de produits avec un enregistrement Shopee SG au statut Synced, liste des comptes marketplace et liste vide des correspondances d'attributs
Parcours de la correspondance de produit d'exemple, de la liste des comptes avec des données de test et de la liste des correspondances d'attributs, encore vide.

Pour voir comment ces éléments s'articulent en interne, nous l'expliquons dans le fonctionnement interne du connecteur.

Ce qu'il faut vérifier la première semaine

Une fois la synchronisation activée, voici les points du compte à regarder chaque jour au début :

  • Sync Logs : la piste d'audit des échanges avec l'API.
  • Sync Conflicts : les conflits détectés en attente de résolution. Examinez les conflits en suspens et ajustez la stratégie d'Auto-Conflict Resolution ou le Conflict Detection Threshold (%) si besoin.
  • Sync Queue : la file interne des tâches de synchronisation asynchrones.
  • Commandes retenues : si des commandes apparaissent dans Held Orders, vérifiez que la date de Create Sales Orders From est bien celle que vous vouliez.
  • Jeton : contrôlez la date d'Access Token Expires sur le compte.
  • Stock bas : si vous avez activé Auto-Create PO on Low Stock, repérez les bons de commande fournisseur en brouillon et vérifiez que le Low Stock Threshold (units) est cohérent pour vos produits.
  • E-mail : vérifiez que les adresses de Alert Email Recipients sont bien orthographiées et séparées par des virgules.

Le module propose aussi des listes de synthèse et de rapports de performance. Sur les captures, elles sont encore vides :

Liste de synthèse du tableau de bord marketplace avec les colonnes Company, Total Reve…, Total Or…, Critical… et Major E…
La liste de synthèse du tableau de bord, encore sans données.
Liste des rapports de performance avec les colonnes Company, Marketplace, Product Category, Date From et Date To
La liste des rapports de performance, encore vide.

Si un message incompréhensible apparaît pendant ces jours-là, vous trouverez les textes exacts et leur solution dans les messages d'erreur du connecteur.

Comment FlexigoTech vous accompagne

Chez FlexigoTech, nous déployons Odoo 17, 18, 19 et 20 et développons des connecteurs et intégrations sur mesure. Si vous souhaitez que nous examinions la configuration de votre compte Shopee, vos correspondances ou une intégration que le module ne couvre pas, contactez-nous depuis la page du module.

À lire aussi

Erreurs de Shopee Marketplace Connector (APAC) : quand chaque message apparaît et que faireCe que signifie chaque message d'erreur de Shopee Marketplace Connector (APAC) dans Odoo, quand il apparaît et que faire, avec un cas fictif et les textes exacts.Comment fonctionne Leroy Merlin Connector dans Odoo : menus, actions planifiées et visiteLes menus que Leroy Merlin Connector ajoute à Odoo, les dix actions planifiées qu'il exécute et à quelle fréquence, et ce qui passe par FlexigoTech Cloud.
Vérifié dans le code du module (version 20.0) et dans les sources citées

Sources