# 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…
- Seite:
- Sprache: de
- Aktualisiert am: 2026-09-24
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dftiktokpinterest/index.md), [en](https://www.datafirefly.com/en/documentation/dftiktokpinterest/index.md), [es](https://www.datafirefly.com/es/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:
## Ü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.
Im Multistore wählen Sie im Kontext-Selektor einen Shop: Die Kanaleinstellungen werden pro Shop gespeichert.
## 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](https://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](https://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.
Das Sicherheitstoken schützt die Feed- und Cron-URLs. Wenn Sie es neu erzeugen, aktualisieren Sie die Crontab und die bei Pinterest und TikTok hinterlegten Feed-URLs.
## 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.