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 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.

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, 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, 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.

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.