TikTok Shop & Pinterest Katalog-Anbindung: Installation und Einrichtung

Überblick

Das Modul verbindet Ihren PrestaShop-8- oder -9-Shop mit zwei Kanälen:

• TikTok Shop: Angebote über die Partner-API anlegen und aktualisieren, Bestand und Preise übertragen, Bestellungen importieren, Sendungsnummern zurückmelden.
• Pinterest: TSV-Katalog-Feed und optional Echtzeit-Updates über die Catalogs-API.

Ein CSV-Feed für TikTok-Ads-Kataloge ist ebenfalls enthalten. Das Modul finden Sie unter Katalog > TikTok & Pinterest. Der Tab Übersicht zeigt eine Einrichtungs-Checkliste mit den offenen Schritten.

Installation

1. Unter Module > Modulverwaltung auf Modul hochladen klicken und die ZIP-Datei wählen.
2. Katalog > TikTok & Pinterest öffnen.
3. Im Tab Einstellungen Sprache, Währung und Land für die Preise prüfen (Preise werden inklusive Steuern dieses Landes übertragen), dann die Bildgröße. TikTok Shop verlangt mindestens 600 x 600 Pixel.

Pinterest

Nur Feed, ohne App

1. Tab Pinterest: Pinterest aktivieren und die Feed-URL kopieren.
2. Im Pinterest Business Hub Kataloge > Datenquellen öffnen, eine Quelle hinzufügen und die URL einfügen. Pinterest importiert den Feed alle 24 Stunden.

Echtzeit-Updates per API

1. Auf developers.pinterest.com eine App anlegen und die Weiterleitungs-URI aus dem Pinterest-Tab des Moduls eintragen.
2. App ID und App Secret eingeben, Echtzeit-Updates auf Ja lassen und auf Speichern und Pinterest verbinden klicken.
3. Nach der Verbindung auf Datenquelle bei Pinterest anlegen klicken: Das Modul hinterlegt den Feed mit Währung und Land aus den Einstellungen.

Bestands-, Preisänderungen und Entfernungen gehen dann innerhalb weniger Minuten raus. Zwei Minuten nach jeder Übertragung liest das Modul das Ergebnis von Pinterest. Ein abgelehnter Artikel erscheint im Tab Produkte als Fehler mit der Meldung von Pinterest.

TikTok Shop

TikTok-Shop-App anlegen

1. Auf partner.tiktokshop.com eine eigene Verkäufer-App oder eine Drittanbieter-App anlegen.
2. Die Scopes Product, Order, Fulfillment und Logistics aktivieren.
3. Als Weiterleitungs-URL die im Tab TikTok Shop des Moduls angezeigte eintragen.
4. App Key, App Secret und, falls vorhanden, die Service ID kopieren.

Shop verbinden

1. Tab TikTok Shop: TikTok aktivieren, Region wählen (Europa und Rest der Welt oder USA), Zugangsdaten eingeben und auf Speichern und TikTok Shop verbinden klicken.
2. Die App auf der TikTok-Seite autorisieren. Das Modul übernimmt Shop und Standardlager.
3. Bei mehreren Lagern das Lager wählen, dann Hersteller und verantwortliche Person für die EU. Sind die Listen leer, diese zuerst im Seller Center anlegen und auf Listen aktualisieren klicken.
4. Auf Kategorien laden klicken, um den TikTok-Kategoriebaum abzurufen.

Angebotseinstellungen

• Übertragener Preis: Preis nach PrestaShop-Rabatten oder Normalpreis, wenn Sie Aktionen in TikTok steuern.
• Standardpaket: Gewicht und Maße für Produkte ohne eigene Werte.
• Neue Angebote anlegen: Ist die Option aus, aktualisiert das Modul nur Bestand und Preis bestehender Angebote.

Bereits vorhandene TikTok-Angebote

Verkaufen Sie schon auf TikTok Shop, starten Sie Bestehende Angebote verknüpfen im Tab TikTok Shop vor der ersten Synchronisation. Das Modul verknüpft Ihre Angebote per Verkäufer-SKU mit Ihren Produkten:

• Kombinationsreferenz;
• Produktreferenz bei Produkten ohne Kombinationen;
• das vom Modul verwendete Format PS12 oder PS12-34.

Ein verknüpftes Angebot behält Titel, Bilder und Beschreibung von TikTok: Das Modul verwaltet nur Bestand und Preis. Um den PrestaShop-Inhalt zu übernehmen, öffnen Sie die Produktvorschau im Tab Produkte und klicken auf Inhalt durch PrestaShop-Daten ersetzen. Verweisen die SKUs eines Angebots auf mehrere Produkte, wird es als Konflikt gemeldet und nicht verknüpft.

Kategoriezuordnung

Der Tab Kategorien ordnet jeder PrestaShop-Kategorie zu:

• eine Google-Kategorie für Pinterest und den TikTok-Ads-Feed: einige Wörter tippen und aus der integrierten Google-Taxonomie wählen;
• eine TikTok-Shop-Kategorie: tippen zum Suchen, oder Vorschlagen klicken, damit TikTok anhand Ihrer Produkte eine Kategorie vorschlägt.

Eine Unterkategorie ohne eigene Zuordnung übernimmt die der übergeordneten Kategorie, grau angezeigt. Produkte verwenden ihre Standardkategorie. Änderungen werden gesammelt mit Änderungen speichern gespeichert.

Die Schaltfläche Attribute öffnet die Attribute der TikTok-Kategorie. Mit Sternchen markierte sind bei TikTok Pflicht und gelten für alle Produkte der Kategorie. Die Zuordnung lässt sich als CSV (Semikolon) exportieren und importieren.

TikTok-Bestellungen

Der Tab TikTok-Bestellungen verhindert Überverkäufe: Ohne Import senkt ein TikTok-Verkauf nur den Bestand bei TikTok. Es gibt drei Modi:

• PrestaShop-Bestellungen anlegen: Jeder Verkauf wird zu einer Bestellung zum auf TikTok gezahlten Preis (abzüglich Händlerrabatt) mit den TikTok-Versandkosten. Die Mehrwertsteuer berechnet PrestaShop, der Bestand sinkt. Die Zahlung erscheint als „TikTok Shop“ mit der TikTok-Bestellnummer als Transaktion.
• Nur Bestand reduzieren: für Bestellungen, die über das Seller Center oder von TikTok versendet werden.
• Aus.

Bestellungen werden per Cron importiert. Beim Einschalten werden die Bestellungen der letzten 24 Stunden übernommen. Wählen Sie den Status neuer Bestellungen und den Versanddienst. Die Versandkosten bleiben die auf TikTok gezahlten, unabhängig vom Versanddienst.

• Stornierungen: Eine TikTok-Stornierung setzt die Bestellung auf „Storniert“ oder bucht im Nur-Bestand-Modus den Bestand zurück.
• Fehler: Eine fehlerhafte Bestellung (nicht verknüpfte SKU, Währung nicht aktiv) erscheint mit Grund und wird alle 15 Minuten erneut versucht. Erneut versuchen startet sie beim nächsten Import neu.
• Käufer: Sie werden als Gastkunden mit einer @tiktokshop.invalid-Adresse angelegt. TikTok verbietet die Kontaktaufnahme außerhalb der Plattform, deshalb blockiert das Modul jede an sie gerichtete E-Mail.

Die PrestaShop-Bestellseite zeigt einen TikTok-Shop-Block mit TikTok-Nummer, Status und Stand der Sendungsverfolgung.

Sendungsnummern

Wird einer importierten Bestellung eine Sendungsnummer hinzugefügt, manuell oder durch ein Versandmodul, geht sie innerhalb von 5 Minuten an TikTok und die TikTok-Bestellung wird als versendet markiert. Von TikTok abgewickelte Bestellungen werden übersprungen.

TikTok verlangt einen Versanddienstleister. Ordnen Sie im Tab TikTok Shop, Bereich Versanddienste und TikTok-Versanddienstleister, jedem Versanddienst einen TikTok-Dienstleister zu. Ohne Zuordnung sucht das Modul einen Dienstleister mit demselben Namen. Passt keiner, listet die Fehlermeldung die verfügbaren Dienstleister auf.

Tab Produkte

Jede Zeile zeigt Vorschaubild, Preis, Bestand, Status je Kanal und einen Qualitätswert von 100 mit dem Hauptproblem. Mögliche Ursachen sind:

• fehlendes Bild, Preis null oder kurze Beschreibung;
• ungültige EAN;
• nicht zugeordnete Kategorie;
• mehr als 3 Attributgruppen für TikTok.

Filter zeigen fehlerhafte, ausgeschlossene, nicht zugeordnete oder aus dem Seller Center verknüpfte Produkte. Markieren Sie Produkte, um sie gesammelt zu exportieren, auszuschließen oder eine vollständige Synchronisation einzureihen. Die Vorschau zeigt die Varianten wie gesendet und erlaubt einen eigenen Titel je Kanal. Jetzt synchronisieren überträgt das Produkt sofort.

Erweiterte Einstellungen

• UTM-Parameter: werden an die Links der Feeds und Pinterest-Pins angehängt, für die Zuordnung in Google Analytics. Leer lassen zum Deaktivieren.
• Benutzerdefinierte Labels: custom_label_0 = Kategorie, custom_label_1 = Preisspanne, custom_label_2 = Aktion oder regulär.
• Ausschlussregeln: Kategorien (samt Unterkategorien), Marken, Mindestpreis inklusive Steuern, und nicht vorrätige Varianten aus Feeds und Pinterest entfernt. Ein ausgeschlossenes Produkt verschwindet aus den Feeds, wird bei Pinterest gelöscht und auf TikTok Shop deaktiviert. Eine geänderte Regel reiht den ganzen Katalog neu ein.
• Übertragungszeitpunkt: direkt nach jeder Änderung (PHP-FPM- oder LiteSpeed-Hosting) oder nur per Cron.

Cron-Aufgabe

Kopieren Sie die zwei Zeilen aus dem Tab Übersicht in die Crontab Ihres Hostings:

• alle 5 Minuten task=sync: Warteschlange, Wiederholungen, TikTok-Bestellungen, Sendungsverfolgung, Pinterest-Ergebnisse;
• stündlich task=feeds: Neuerstellung der Feeds.

Die Übersicht zeigt, ob der Cron in den letzten 20 Minuten lief. Ein API-Fehler wird nach 2, 4, 8, 16 und 32 Minuten wiederholt.

Protokolle und Fehlerbehebung

Der Tab Protokolle speichert Ereignisse 30 Tage lang, filterbar nach Kanal: Pinterest, TikTok, TikTok-Bestellungen. API-Fehler werden mit vollständiger Antwort gespeichert.

• Ein Produkt wird nicht an TikTok gesendet: Prüfen Sie seinen Wert im Tab Produkte. Eine fehlende TikTok-Kategorie oder ein virtuelles Produkt blockieren die Übertragung.
• Eine TikTok-Bestellung bleibt fehlerhaft: Die Verkäufer-SKU muss einer PrestaShop-Referenz entsprechen, oder das Angebot muss vom Modul angelegt worden sein. Korrigieren und Erneut versuchen klicken.
• Änderungen eines Mitarbeiters werden nicht übertragen: PrestaShop führt die Hooks eines Moduls für Profile ohne Berechtigung „Anzeigen“ auf dieses Modul nicht aus. Berechtigung vergeben oder Jetzt synchronisieren im Tab Produkte nutzen.