Intégration Odoo TikTok Shop : ce qui se synchronise
Découvrez l’intégration Odoo TikTok Shop : données synchronisées, fréquence, configuration, limites et solutions pour Odoo Community.
Long Nguyen
Développeur fullstack · Ingénieur IA · Chercheur
Odoo s’intègre-t-il à TikTok Shop ?
Oui. Odoo propose un connecteur TikTok Shop natif. Il importe dans Odoo les commandes TikTok Shop expédiées par le vendeur, renvoie vos stocks disponibles vers TikTok Shop et associe les étiquettes d’expédition ainsi que les numéros de suivi aux bons de livraison correspondants.
Trois éléments déterminent son adéquation avec votre boutique :
- Version : Odoo documente le connecteur pour la version 19.0 et les versions suivantes. La documentation d’Odoo 18 ne contient aucune page consacrée à TikTok Shop.
- Édition : le connecteur ne fait pas partie du code open source Community. La branche 19.0 du dépôt public d’Odoo ne contient aucun module TikTok (vérification effectuée le ) : prévoyez donc Odoo Enterprise.
- Périmètre : il s’agit d’une synchronisation des commandes et des stocks, pas d’un back-office TikTok Shop complet. Les remboursements, litiges et rapports de frais restent gérés côté TikTok.
La suite de ce guide détaille les données synchronisées et leur fréquence, la configuration, les limites parfois faciles à manquer, ainsi que les solutions disponibles avec Community ou une version plus ancienne.
Que synchronise le connecteur Odoo TikTok Shop, et à quelle fréquence ?
La synchronisation n’est pas en temps réel. Odoo exécute chaque type de transfert selon son propre calendrier :
| Données | Sens | Fréquence | Fonctionnement |
|---|---|---|---|
| Commandes (expédiées par le vendeur) | TikTok Shop → Odoo | Toutes les 5 minutes | Seules les commandes au statut AWAITING_SHIPMENT ou AWAITING_COLLECTION sont importées. Odoo crée une commande client, un transfert dans Inventaire et, si aucun contact correspondant n’existe, une fiche contact. |
| Changements de statut des commandes (webhooks) | TikTok Shop → Odoo | Traités toutes les 5 minutes | Une annulation effectuée sur TikTok Shop met à jour la commande dans Odoo. |
| Étiquettes d’expédition et numéros de suivi | TikTok Shop → Odoo | Toutes les 15 minutes | Ils sont récupérés lorsque la commande passe au statut Awaiting Collection, puis associés au bon de livraison. Si le PDF ne peut pas être généré, Odoo conserve un lien vers l’étiquette. |
| Quantités en stock | Odoo → TikTok Shop | Toutes les 30 minutes | Uniquement lorsque la synchronisation des stocks est activée sur la boutique, et uniquement à partir des entrepôts définis dans le champ FBS Warehouse. |
| Catalogue produits | TikTok Shop → Odoo | À la demande (Sync Catalog) | Récupère les produits TikTok Shop actifs et les associe aux produits Odoo à partir du SKU. |
Les commandes, étiquettes, stocks et catalogues peuvent également être synchronisés manuellement à l’aide des boutons présents sur la fiche de la boutique. Ces intervalles sont indiqués dans la documentation Odoo sur la gestion des commandes TikTok Shop.
Deux formulations de la documentation officielle peuvent prêter à confusion :
- FBS et FBM désignent la même chose ici. Une page parle de Fulfilled By Seller, une autre de Fulfilled By Merchant. Dans les deux cas, c’est vous qui expédiez le colis.
- Partner Center est le portail développeur. C’est là que vous créez l’application API. Les opérations quotidiennes du vendeur, comme organiser une expédition ou modifier des produits en masse, s’effectuent dans Seller Center, sur les sites seller-xx.tiktok.com indiqués par la documentation pour chaque pays.
Quels marchés TikTok Shop sont pris en charge par Odoo ?
Odoo répertorie 16 marketplaces TikTok Shop compatibles avec le connecteur :
| Région | Marketplaces |
|---|---|
| Amériques | États-Unis, Mexique, Brésil |
| Europe | Royaume-Uni, Allemagne, France, Espagne, Italie, Irlande |
| Asie | Indonésie, Japon, Malaisie, Philippines, Singapour, Thaïlande, Vietnam |
Le connecteur accepte plusieurs comptes vendeurs, avec un marketplace par compte. Une marque qui vend en Allemagne, en France et en Espagne devra donc configurer trois fiches boutique dans Odoo, chacune avec sa propre règle d’entrepôt et son équipe commerciale.
Comment connecter TikTok Shop à Odoo ?
Vous avez besoin d’un compte vendeur TikTok Shop, d’un compte séparé TikTok Shop Partner Center, d’une brève description de l’utilisation prévue de l’intégration, ainsi que de l’URL de votre base Odoo et d’un identifiant de test.
- Inscrivez-vous dans Partner Center. Choisissez Add category and market, sélectionnez App developers (ISV) comme catégorie d’activité, indiquez la région et le marché cible, puis cliquez sur Get app key now et attendez l’approbation.
- Créez l’application. Dans App & Service, définissez le type sur Custom et la catégorie de service sur eCommerce Management / Connectors. Activez Enable API.
- Définissez l’URL de redirection sur
https://<your database url>.odoo.com/tiktok/return_from_authorization. - Activez les huit autorisations API dans Manage API : Finance Information, Fulfillment Basic, Logistics Basic, Order Information, Product Basic, Product Modify, Shop Authorized Information, Global Shop Information.
- Publiez l’application et copiez le Service ID, l’App key et l’App secret.
- Installez le connecteur dans Odoo. Dans Applications, recherchez TikTok Shop Connector et activez-le.
- Connectez la boutique. Accédez à Ventes → Configuration → Boutiques, cliquez sur Connect New Shop et saisissez les trois identifiants. Connectez-vous avec le compte vendeur que vous souhaitez associer.
- Réautorisez la boutique. De retour dans Odoo, cliquez sur Re-authorize Shop pour obtenir un nouveau refresh token.
- Configurez la boutique avant le lancement. Définissez le FBS Warehouse, exécutez Sync Catalog, puis activez seulement ensuite la synchronisation des stocks.
Les noms des champs et les captures d’écran sont disponibles dans le guide de configuration du connecteur TikTok Shop d’Odoo.
Points à anticiper lors de la configuration
- L’approbation prend du temps. L’inscription au portail partenaire est examinée et les nouveaux comptes peuvent également devoir soumettre l’application à une validation avant que l’API fonctionne. Commencez cette étape en amont, pas la semaine du lancement.
- Utilisez le bon compte vendeur. L’autorisation associe la boutique sur laquelle vous êtes connecté. Les agences et vendeurs multi-boutiques ont intérêt à utiliser une session de navigation privée et vierge.
- Activez la synchronisation des stocks en dernier. Les stocks vont d’Odoo vers TikTok Shop. Si les quantités disponibles dans Odoo sont incorrectes ou encore à zéro au moment de l’activation, ce sont ces valeurs que TikTok Shop recevra.
Correspondance des SKU : la règle qui garantit des stocks fiables
Le Seller SKU de TikTok Shop doit correspondre exactement à la Internal Reference du produit ou de la variante dans Odoo. Un espace final ou une différence de casse suffit à créer une incohérence.
L’erreur passe inaperçue. Lorsqu’Odoo ne trouve pas le produit, il enregistre la ligne de commande sur un produit par défaut. La commande apparaît bien, rien ne semble cassé, mais le stock de l’article réel n’est pas décrémenté et l’envoi de stock suivant peut transmettre à TikTok Shop une quantité trop élevée.
Vérifiez vos références avant la première synchronisation. Sur une base auto-hébergée ou Odoo.sh, exécutez ceci dans le shell Odoo :
from collections import Counter
products = env['product.product'].search([('sale_ok', '=', True)])
refs = products.mapped('default_code')
missing = [p.display_name for p in products if not p.default_code]
duplicates = [r for r, n in Counter(r for r in refs if r).items() if n > 1]
padded = [r for r in refs if r and r != r.strip()]
print('No Internal Reference:', len(missing))
print('Duplicate references:', duplicates)
print('References with stray spaces:', padded)
Sur Odoo Online, regroupez la liste des variantes par Internal Reference pour obtenir le même résultat. Les trois listes doivent être vides pour tous les articles vendus sur TikTok Shop.
La méthode de démarrage dépend de l’emplacement actuel de votre catalogue :
- Produits déjà présents dans Odoo : exécutez Sync Catalog pour associer les fiches TikTok Shop actives aux produits existants.
- Produits présents uniquement sur TikTok Shop : exportez le catalogue avec la fonction de modification en masse de TikTok, importez-le dans Odoo, puis associez le TikTok Shop Item ID à l’identifiant externe du produit.
Limites du connecteur Odoo TikTok Shop
Chaque limite ci-dessous provient de la documentation d’Odoo. La colonne consacrée aux solutions de contournement correspond à notre recommandation.
| Limite | Conséquence pour vous | Solution de contournement |
|---|---|---|
| Le stock est envoyé toutes les 30 minutes | Lors d’un live ou d’une vente flash, TikTok Shop peut vendre des unités qu’Odoo a déjà promises ailleurs. | Conservez un stock de réserve dans un entrepôt qui n’est pas sélectionné dans FBS Warehouse, afin que TikTok Shop ne voie jamais vos dernières unités. |
| Seules les commandes en attente d’expédition ou de collecte sont importées | Les commandes UNPAID, SHIPPED, CANCEL et COMPLETED sont ignorées. L’historique antérieur à la connexion n’est pas importé. |
Considérez la date de mise en production comme le début de votre historique de reporting. Importez séparément les ventes plus anciennes si vous en avez besoin dans Odoo. |
| Seules les commandes expédiées par le vendeur sont couvertes | La documentation décrit uniquement les commandes et les stocks FBS. Les commandes traitées par TikTok ne sont pas mentionnées comme synchronisées. | Validez le fonctionnement sur une commande de test avant de vous appuyer sur Odoo pour les revenus FBT. |
| L’annulation est à sens unique | Annuler une commande dans Odoo ne l’annule pas sur TikTok Shop. | Effectuez toujours l’annulation sur TikTok Shop et laissez le statut remonter vers Odoo. |
| Les remboursements, litiges et rapports de frais ne sont pas gérés | Ils restent accessibles dans les portails TikTok. | Enregistrez manuellement les remboursements dans Odoo sous forme d’avoirs, ou automatisez-les avec un module personnalisé. |
| Les factures ne peuvent pas être envoyées par e-mail | TikTok Shop ne transmet pas l’adresse e-mail de l’acheteur, Odoo ne peut donc pas envoyer la facture. | Générez la facture dans Odoo et téléversez-la côté TikTok lorsqu’un acheteur en a besoin. |
| Les versements arrivent par lots | Une seule ligne bancaire couvre plusieurs commandes. | Utilisez un journal bancaire dédié avec un compte d’attente, puis effectuez le rapprochement à partir des paiements groupés. |
| Un numéro de suivi est obligatoire | TikTok Shop exige une référence de suivi pour chaque livraison. | Si le transporteur n’en fournit pas, saisissez-la manuellement côté TikTok. |
Autre point à retenir : la documentation couvre l’import et l’association du catalogue depuis TikTok Shop, mais pas la publication ou la modification des fiches depuis Odoo. Pour envoyer des produits Odoo vers TikTok Shop, elle renvoie au téléversement en masse dans Seller Center. Les titres, images et prix restent gérés sur TikTok.
Intégration TikTok Shop avec Odoo Community, 17 ou 18
Si vous n’utilisez pas Odoo 19 Enterprise ou une version ultérieure, le connecteur natif n’est pas disponible. Quatre options s’offrent à vous :
| Option | À privilégier si | Coût principal |
|---|---|---|
| Passer à Odoo 19+ Enterprise | Le périmètre natif couvre vos besoins et vous envisagiez déjà une montée de version. | Licences Enterprise, plus la migration de chaque module personnalisé déjà utilisé. |
| Module tiers de l’Odoo Apps Store | Vous restez sur Community ou une ancienne version et le module prend en charge votre marché. | Prix du module et dépendance envers un éditeur pour suivre les évolutions de l’API TikTok. |
| Module Odoo personnalisé basé sur l’API TikTok Shop | Vous avez besoin de fonctions absentes des solutions prêtes à l’emploi : remboursements, lignes de règlement, commandes FBT, mises à jour de stock plus rapides ou gestion des fiches produits. | Développement et maintenance. |
| Outil multicanal intermédiaire | Vous vendez également sur Amazon, eBay ou Shopify et souhaitez centraliser la gestion des fiches. | Abonnement mensuel et système supplémentaire à maintenir synchronisé. |
Avant d’installer un connecteur tiers, vérifiez cinq points :
- Licence. Les modules payants sont souvent distribués sous la licence propriétaire Odoo (OPL-1). Vérifiez que vous pouvez modifier le code et le déployer sur toutes les bases nécessaires.
- Emplacement de vos identifiants. Votre App secret et vos tokens doivent rester dans votre propre base de données. Un module qui fait transiter les appels par le serveur de l’éditeur lui donne accès à votre boutique.
- Code source lisible. Vous-même, ou le développeur que vous mandatez, devez pouvoir l’auditer et le corriger.
- Marchés et version d’Odoo. Vérifiez que votre pays et votre version exacte d’Odoo sont pris en charge, et pas seulement TikTok Shop en général.
- Historique de maintenance. Consultez la date de la dernière mise à jour. Une intégration qui n’est plus maintenue cesse de fonctionner lorsque TikTok modifie son API.
Un module personnalisé utilise les mêmes briques que la configuration native : une application Custom dans Partner Center, les autorisations activées et l’autorisation du vendeur. La différence est que vous choisissez les données synchronisées et le calendrier. Netalith développe ce type de connecteur dans le cadre de son service de développement Odoo et de modules personnalisés, pour Community comme pour Enterprise.
Le connecteur natif suffit-il pour votre boutique ?
| Votre situation | Verdict |
|---|---|
| Odoo 19+ Enterprise, un ou deux marchés, expédition depuis votre propre entrepôt | Utilisez le connecteur natif. Il couvre le cycle quotidien des commandes et des stocks. |
| Vous organisez des ventes en direct ou détenez peu de stock par SKU | La solution native convient si vous conservez un stock de réserve hors de l’entrepôt FBS. Sinon, des mises à jour de stock plus rapides sont nécessaires. |
| Vous utilisez Fulfilled by TikTok | Testez d’abord. Le périmètre documenté concerne les commandes expédiées par le vendeur. |
| La finance veut comptabiliser les frais, remboursements et versements par commande | La solution native ne suffit pas. Les données financières nécessitent un développement personnalisé. |
| Odoo Community, 17 ou 18 | La solution native n’est pas disponible. Choisissez un module tiers vérifié ou faites développer un module personnalisé. |
| Votre marché TikTok Shop ne figure pas parmi les 16 marchés listés | La solution native n’est pas disponible pour cette boutique. |
Dans la pratique, procédez dans cet ordre : nettoyez vos Internal References, lancez rapidement l’inscription à Partner Center, connectez une boutique, synchronisez le catalogue, vérifiez qu’aucun produit ne reste sans correspondance, puis activez la synchronisation des stocks.
Si les limites ci-dessus concernent des fonctions dont vous avez besoin, ou si vous utilisez Community, indiquez-nous votre version d’Odoo, vos marchés TikTok Shop et votre volume mensuel de commandes. Le service d’intégration de l’API TikTok Shop de Netalith adapte le connecteur à l’usage réel de votre boutique, avec un tarif défini selon le périmètre.
FAQ
Questions fréquentes
Odoo propose-t-il une intégration TikTok Shop native ?
Oui. Odoo documente un connecteur TikTok Shop natif pour Odoo 19.0 et les versions suivantes. Il importe les commandes expédiées par le vendeur dans Odoo, envoie les stocks disponibles vers TikTok Shop, récupère les étiquettes d’expédition et les numéros de suivi, et synchronise ou associe le catalogue produits.
Le connecteur TikTok Shop est-il disponible dans Odoo Community ?
Non. Le code open source Community d’Odoo 19 ne contient pas de module TikTok. Le connecteur natif nécessite donc Odoo Enterprise. Avec Community, vous devez utiliser un module tiers de l’Odoo Apps Store ou un module personnalisé basé sur l’API TikTok Shop.
À quelle fréquence Odoo se synchronise-t-il avec TikTok Shop ?
Les commandes et les webhooks de statut sont traités toutes les 5 minutes, les étiquettes d’expédition toutes les 15 minutes et les stocks toutes les 30 minutes. Chacune de ces synchronisations peut également être déclenchée manuellement depuis la fiche de la boutique, dans Ventes, Configuration, Boutiques.
Quels pays TikTok Shop sont pris en charge par le connecteur Odoo ?
Odoo répertorie 16 marketplaces : les États-Unis, le Mexique et le Brésil ; le Royaume-Uni, l’Allemagne, la France, l’Espagne, l’Italie et l’Irlande ; ainsi que l’Indonésie, le Japon, la Malaisie, les Philippines, Singapour, la Thaïlande et le Vietnam.
Puis-je connecter plusieurs boutiques TikTok Shop à une seule base Odoo ?
Oui. Le connecteur prend en charge plusieurs comptes vendeurs, avec un marketplace TikTok Shop par compte. Chaque boutique possède sa propre fiche dans Odoo, où vous pouvez définir son entrepôt et lui attribuer une équipe commerciale dédiée pour obtenir un reporting séparé.
Odoo gère-t-il les remboursements et retours TikTok Shop ?
Non. Odoo indique que l’émission des remboursements, la gestion des litiges et le téléchargement des rapports mensuels de frais doivent être effectués côté TikTok. Le connecteur se limite aux commandes clients et aux stocks : les remboursements doivent donc être enregistrés manuellement dans Odoo ou via un développement personnalisé.
Ai-je besoin d’un compte développeur pour connecter TikTok Shop à Odoo ?
Oui. Vous avez besoin d’un compte TikTok Shop Partner Center, distinct de votre compte vendeur. Vous y créez une application Custom, activez les autorisations API nécessaires, puis copiez le Service ID, l’App key et l’App secret dans Odoo.