# Connecteur TikTok Shop et Catalogue Pinterest : installation et configuration
> Présentation Le module relie votre boutique PrestaShop 8 ou 9 à deux canaux : TikTok Shop : création et mise à jour des annonces par l'API Partner, envoi du stock…
- Page:
- Langue: fr
- Mis à jour le: 2026-09-24
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dftiktokpinterest/index.md), [es](https://www.datafirefly.com/es/documentation/dftiktokpinterest/index.md), [de](https://www.datafirefly.com/de/documentation/dftiktokpinterest/index.md), [it](https://www.datafirefly.com/it/documentation/dftiktokpinterest/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftiktokpinterest/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftiktokpinterest/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftiktokpinterest/index.md)
- Index:
## Présentation
Le module relie votre boutique PrestaShop 8 ou 9 à deux canaux :
- **TikTok Shop** : création et mise à jour des annonces par l'API Partner, envoi du stock et des prix, import des commandes, envoi des numéros de suivi.
- **Pinterest** : flux catalogue TSV et, en option, mises à jour en temps réel par l'API Catalogs.
Un flux CSV pour les catalogues publicitaires TikTok Ads est aussi fourni. Le module se trouve dans **Catalogue > TikTok & Pinterest**. L'onglet _Vue d'ensemble_ affiche une checklist de mise en route qui liste les étapes restantes.
## Installation
1. Dans **Modules > Gestionnaire de modules**, cliquez sur _Téléverser un module_ et choisissez le fichier ZIP.
2. Ouvrez **Catalogue > TikTok & Pinterest**.
3. Dans l'onglet _Réglages_, vérifiez la langue, la devise et le pays utilisés pour les prix (les prix sont envoyés TTC pour ce pays), puis la taille d'image. TikTok Shop exige au moins 600 x 600 pixels.
En multiboutique, sélectionnez une boutique dans le sélecteur de contexte : les réglages des canaux sont enregistrés par boutique.
## Pinterest
### Flux seul, sans app
1. Onglet _Pinterest_ : activez Pinterest et copiez l'URL du flux.
2. Dans Pinterest Business Hub, ouvrez **Catalogues > Sources de données**, ajoutez une source et collez l'URL. Pinterest importe le flux toutes les 24 heures.
### Mises à jour en temps réel par l'API
1. Sur [developers.pinterest.com](https://developers.pinterest.com/), créez une app et ajoutez l'URI de redirection affichée dans l'onglet Pinterest du module.
2. Saisissez l'App ID et l'App secret, laissez _Mises à jour en temps réel_ sur Oui et cliquez sur _Enregistrer et connecter Pinterest_.
3. Une fois connecté, cliquez sur _Créer la source de données sur Pinterest_ : le module déclare lui-même le flux avec la devise et le pays des réglages.
Les changements de stock, de prix et les retraits partent alors en quelques minutes. Deux minutes après chaque envoi, le module relit le résultat de Pinterest. Un article refusé passe en erreur dans l'onglet _Produits_ avec le message de Pinterest, par exemple « image_link: Image could not be downloaded ».
## TikTok Shop
### Créer l'app TikTok Shop
1. Sur [partner.tiktokshop.com](https://partner.tiktokshop.com/), créez une app de type vendeur personnalisée ou service tiers.
2. Activez les scopes **Product**, **Order**, **Fulfillment** et **Logistics**.
3. Indiquez comme URL de redirection celle affichée dans l'onglet _TikTok Shop_ du module.
4. Récupérez l'App key, l'App secret et, si l'app en a un, le Service ID.
### Connecter la boutique
1. Onglet _TikTok Shop_ : activez TikTok, choisissez la région (Europe et reste du monde, ou États-Unis), saisissez les identifiants, puis cliquez sur _Enregistrer et connecter TikTok Shop_.
2. Autorisez l'app sur la page TikTok. Le module récupère la boutique et l'entrepôt par défaut.
3. Choisissez l'entrepôt si vous en avez plusieurs, puis le fabricant et la personne responsable pour l'UE. Créez-les d'abord dans le Seller Center si les listes sont vides, puis cliquez sur _Actualiser les listes_.
4. Cliquez sur _Charger les catégories_ pour récupérer l'arbre des catégories TikTok.
### Réglages des annonces
- **Prix envoyé** : prix après réductions PrestaShop, ou prix normal si vous gérez les promotions dans TikTok.
- **Colis par défaut** : poids et dimensions utilisés pour les produits qui n'en ont pas.
- **Créer les nouvelles annonces** : désactivé, le module ne met à jour que le stock et le prix des annonces déjà en ligne.
## Annonces déjà présentes sur TikTok Shop
Si vous vendez déjà sur TikTok Shop, lancez _Relier les annonces existantes_ dans l'onglet TikTok Shop **avant la première synchronisation**. Le module parcourt vos annonces et les relie à vos produits par SKU vendeur :
- référence de la déclinaison ;
- référence du produit, pour un produit sans déclinaison ;
- format PS12 ou PS12-34 utilisé par le module.
Une annonce reliée garde son titre, ses images et sa description TikTok : le module ne gère que son stock et son prix. Pour lui appliquer le contenu PrestaShop, ouvrez l'aperçu du produit dans l'onglet Produits et cliquez sur _Remplacer son contenu par les données PrestaShop_. Une annonce dont les SKU pointent vers plusieurs produits PrestaShop est signalée comme conflit et n'est pas reliée.
## Mapping des catégories
L'onglet _Catégories_ associe chaque catégorie PrestaShop à :
- une **catégorie Google**, utilisée par Pinterest et par le flux TikTok Ads : tapez quelques mots et choisissez dans la taxonomie Google intégrée ;
- une **catégorie TikTok Shop** : tapez pour chercher, ou cliquez sur _Suggérer_ pour que TikTok propose la catégorie à partir de vos produits.
Une sous-catégorie sans mapping propre hérite de celui de son parent, affiché en gris. Les produits utilisent leur catégorie par défaut. Les modifications s'enregistrent toutes ensemble avec _Enregistrer les modifications_.
Le bouton _Attributs_ ouvre les attributs de la catégorie TikTok. Ceux marqués d'un astérisque sont obligatoires chez TikTok et s'appliquent à tous les produits de la catégorie. Le mapping s'exporte et s'importe en CSV (séparateur point-virgule).
## Commandes TikTok
L'onglet _Commandes TikTok_ évite la survente : sans import, une vente TikTok ne baisse le stock que chez TikTok. Trois modes sont proposés :
- **Créer des commandes PrestaShop** : chaque vente devient une commande au prix payé sur TikTok (remise vendeur déduite) et avec les frais de port TikTok. La TVA est calculée par PrestaShop et le stock baisse. Le paiement apparaît sous le nom « TikTok Shop », avec le numéro de commande TikTok en transaction.
- **Décrémenter le stock uniquement** : pour les commandes expédiées depuis le Seller Center ou par TikTok.
- **Désactivé**.
Les commandes sont importées par la tâche cron. À l'activation, celles des dernières 24 heures sont reprises. Choisissez le statut des nouvelles commandes et le transporteur. Les frais de port restent ceux payés sur TikTok, quel que soit le transporteur.
- **Annulations** : une annulation TikTok passe la commande en « Annulé », ou remet le stock en mode stock seul.
- **Erreurs** : une commande en erreur (SKU non relié, devise non activée) apparaît avec la raison et se relance seule toutes les 15 minutes. Le bouton _Relancer_ la réessaie au prochain import.
- **Acheteurs** : ils sont créés en clients invités avec une adresse en @tiktokshop.invalid. TikTok interdit de les contacter hors plateforme, donc le module bloque tout e-mail qui leur serait envoyé.
La fiche commande PrestaShop affiche un bloc TikTok Shop avec le numéro TikTok, le statut et l'état du suivi.
## Numéros de suivi
Quand un numéro de suivi est ajouté à une commande importée, que ce soit à la main ou par un module transporteur, il est envoyé à TikTok dans les 5 minutes et la commande TikTok passe en expédiée. Les commandes expédiées par TikTok sont ignorées.
TikTok demande un prestataire d'expédition. Dans l'onglet TikTok Shop, section _Transporteurs et prestataires d'expédition TikTok_, associez chaque transporteur PrestaShop à un prestataire TikTok. Sans association, le module cherche un prestataire du même nom. En cas d'échec, l'erreur liste les prestataires disponibles.
## Onglet Produits
Chaque ligne affiche la miniature, le prix, le stock, l'état sur chaque canal et un score qualité sur 100 avec le principal problème. Les causes possibles sont :
- image manquante, prix nul ou description trop courte ;
- EAN invalide ;
- catégorie non associée ;
- plus de 3 groupes d'attributs pour TikTok.
Les filtres permettent d'afficher les produits en erreur, exclus, sans catégorie Google ou TikTok, ou reliés depuis le Seller Center. Cochez des produits pour les exporter ou les exclure en masse, ou programmer une synchronisation complète. L'aperçu montre les variantes telles qu'elles partiront et permet de définir un titre propre à chaque canal. _Synchroniser_ envoie le produit immédiatement.
## Réglages avancés
- **Paramètres UTM** : ajoutés aux liens des flux et des épingles Pinterest pour l'attribution dans Google Analytics. Laissez vide pour désactiver.
- **Libellés personnalisés** : custom_label_0 = catégorie, custom_label_1 = tranche de prix, custom_label_2 = promo ou normal.
- **Règles d'exclusion** : catégories (sous-catégories comprises), marques, prix minimum TTC, et variantes en rupture retirées des flux et de Pinterest. Un produit exclu est retiré des flux, supprimé de Pinterest et désactivé sur TikTok Shop. Modifier une règle remet tout le catalogue en file.
- **Moment d'envoi** : juste après chaque modification (hébergement PHP-FPM ou LiteSpeed), ou uniquement par cron.
## Tâche cron
Copiez les deux lignes de l'onglet _Vue d'ensemble_ dans la crontab de votre hébergement :
- toutes les 5 minutes, `task=sync` : file d'envoi, relances, commandes TikTok, suivi, résultats Pinterest ;
- toutes les heures, `task=feeds` : régénération des flux.
La vue d'ensemble indique si le cron a été vu dans les 20 dernières minutes. Une erreur d'API est relancée à 2, 4, 8, 16 puis 32 minutes. Le bouton _Relancer les tâches en échec_ remet les tâches abandonnées en file.
Le jeton de sécurité protège les URL des flux et du cron. Si vous le régénérez, mettez à jour la crontab et les URL de flux déclarées chez Pinterest et TikTok.
## Journaux et dépannage
L'onglet _Journaux_ conserve 30 jours d'événements, filtrables par canal : Pinterest, TikTok, commandes TikTok. Les erreurs d'API y figurent avec la réponse complète.
- **Un produit ne part pas sur TikTok** : vérifiez son score dans l'onglet Produits. Une catégorie TikTok manquante ou un produit virtuel bloquent l'envoi.
- **Une commande TikTok reste en erreur** : le SKU vendeur doit correspondre à une référence PrestaShop ou l'annonce doit avoir été créée par le module. Corrigez puis cliquez sur _Relancer_.
- **Les modifications faites par un employé ne partent pas** : PrestaShop n'exécute pas les hooks d'un module pour un profil sans droit « Voir » sur ce module. Donnez ce droit, ou utilisez _Synchroniser_ dans l'onglet Produits.