TikTok Shop App registrieren
Diese Anleitung fuehrt durch die Registrierung im TikTok Shop Partner Center und zeigt, welche Angaben anschliessend im Shop fuer die Verbindung benoetigt werden.
Ziel der Registrierung
Am Ende der Registrierung gibt es eine TikTok Shop App, die der Shop fuer Autorisierung, Produktdaten, Bestellungen und weitere TikTok-Funktionen nutzen kann. Aus dem Partner Center werden dafuer vor allem App ID beziehungsweise Service ID, App Key und App Secret in den Shop uebertragen.
Vor dem Start
- Ein aktivierter TikTok Shop Seller Account muss vorhanden sein.
- Der Zugang zum TikTok Shop Partner Center muss mit dem Seller Account zusammenpassen.
- Fuer Seller Developer muss die Verifizierungs-E-Mail mit der E-Mail aus der TikTok-Shop-Registrierung uebereinstimmen.
- Im Shop sollte die TikTok-Verbindungsseite geoeffnet sein, damit die angezeigte Redirect URL in das Partner Center uebernommen werden kann.
Developer-Typ waehlen
Fuer einen normalen Haendler, der nur den eigenen TikTok Shop mit dieser Shopsoftware verbinden will, ist der Seller-Developer- beziehungsweise Custom-App-Weg passend. Diese App greift nur auf die eigenen Seller-Daten zu.
Der App-Developer- oder ISV-Weg ist fuer Anbieter gedacht, die eine oeffentliche App fuer mehrere TikTok-Shop-Seller bereitstellen. Dieser Weg ist fuer die reine Eigenanbindung meistens unnoetig aufwendig.
Wenn im Partner Center zwischen Seller Developer und App Developer/ISV unterschieden wird, fuer die eigene Shopanbindung den Seller-Bezug waehlen. ISV nur verwenden, wenn die App spaeter mehreren fremden Sellern zur Autorisierung angeboten werden soll.
App im Partner Center anlegen
- Im TikTok Shop Partner Center anmelden oder dem Partner Center beitreten.
- Developer Onboarding starten und Land beziehungsweise Markt passend zum TikTok Shop auswaehlen.
- Den passenden Developer-Typ auswaehlen: fuer die Eigenanbindung Seller Developer oder TikTok Shop Seller.
- Eine TikTok Shop App beziehungsweise einen OAuth Client erstellen.
- Als Redirect URL die URL verwenden, die im Shop unter Verbindung und Bestellabgleich angezeigt wird.
- App erstellen und die angezeigten Zugangsdaten sichern: App ID beziehungsweise Service ID, App Key und App Secret.
Die TikTok-Dokumentation nutzt in Testbeispielen teilweise localhost als Redirect URL. Fuer die echte Shopverbindung gehoert dort nicht localhost hinein, sondern die Redirect URL aus dem Shop-Backend.
Server-IP in der TikTok App freischalten
In den App-Einstellungen im TikTok Shop Partner Center muss die Server-IP-Adresse des Shops freigeschaltet werden, wenn TikTok fuer die App eine IP-Whitelist verlangt. Gemeint ist die ausgehende IP-Adresse des Webservers, von dem die API-Anfragen an TikTok gesendet werden, nicht die lokale Arbeitsplatz-IP.
- Bei eigenem Server oder VPS die oeffentliche ausgehende IPv4-Adresse des Shopservers verwenden.
- Bei Hosting mit mehreren ausgehenden IP-Adressen alle relevanten Server-IP-Adressen beim Hosting-Anbieter erfragen und eintragen.
- Nach einem Serverumzug, Proxy-Wechsel oder Hosting-Wechsel die IP-Freigabe im Partner Center pruefen und bei Bedarf aktualisieren.
Wenn die Server-IP nicht freigegeben ist, koennen Token-Abruf, Produktabgleich oder Bestellabruf trotz korrekter App-Daten fehlschlagen. In diesem Fall zuerst die TikTok-Logs und danach die IP-Whitelist der App pruefen.
Scopes und Berechtigungen festlegen
Der Shop setzt die Scopes nicht in der Autorisierungs-URL. Die benoetigten Berechtigungen muessen daher an der App im TikTok Shop Partner Center aktiviert werden. Die Bezeichnungen koennen je nach Partner-Center-Version abweichen; wichtig sind die Funktionsbereiche.
- Autorisierung und Seller-Zugriff: Token erzeugen, Token erneuern und autorisierte Shops abrufen.
- Bestellungen: Bestellungen suchen, Bestelldetails lesen und externe Bestellreferenzen setzen.
- Produkte: Produkte suchen, anlegen, bearbeiten, pruefen, aktivieren, deaktivieren und loeschen.
- Produktgrundlagen: Kategorien, Attribute, Kategorieregeln, Marken sowie Bild- und Datei-Uploads.
- Lager und Versand: Warenlager, Versandvorlagen, Lieferoptionen, Versanddienstleister und Versandmarkierung.
- Bestand und Preise: Bestand und Preise von TikTok-SKUs aktualisieren.
- Retouren und Erstattungen: Storno-, After-Sales-, Ruecksende- und Erstattungsfunktionen, sofern diese Workflows genutzt werden.
- Compliance: Hersteller und verantwortliche Personen, wenn Produktsortiment oder TikTok-Kategorie diese Angaben verlangt.
Wenn der Umfang unklar ist, zuerst die Bereiche aktivieren, die fuer den geplanten Start wirklich gebraucht werden. Fehlende Berechtigungen fallen spaeter meist beim Verbindungstest, beim Produktabgleich oder in den TikTok-Logs auf.
Daten im Shop hinterlegen
- Im Shop zu TikTok Shop und Verbindung und Bestellabgleich wechseln.
- App ID beziehungsweise Service ID in das Feld app_id eintragen.
- App Key in app_key und App Secret in app_secret eintragen.
- Einstellungen speichern.
- Ueber die Verbindungsschaltflaeche die TikTok-Autorisierung starten und den eigenen Seller Account freigeben.
- Nach der Rueckkehr pruefen, ob Access Token, Refresh Token, Shop ID und Shop Cipher gefuellt wurden.
Nach der Verbindung pruefen
- Der Verbindungstest meldet eine erfolgreiche Verbindung.
- Token und Shopdaten sind im Statusbereich sichtbar.
- Ein erster Produktabruf oder eine Listing-Pruefung liefert keine Berechtigungsfehler.
- Ein erster Bestellabruf laeuft ohne Scope- oder Autorisierungsfehler.
- Bei Problemen geben die TikTok-Logs Hinweise auf fehlende Berechtigungen, falsche Zugangsdaten oder abgelaufene Autorisierung.
Typische Stolperfallen
- Der TikTok Seller Account ist noch nicht aktiviert.
- Die Verifizierungs-E-Mail passt nicht zum TikTok Shop Seller Account.
- Im Partner Center wurde der ISV-Weg statt der Seller-Eigenanbindung gestartet.
- Als Redirect URL wurde ein Beispielwert wie localhost statt der Shop-Redirect-URL verwendet.
- App ID beziehungsweise Service ID, App Key und App Secret wurden vertauscht.
- Produkt-, Bestell- oder Logistikberechtigungen fehlen an der App.
Verwandte Bereiche
- Verbindung und Bestellabgleich fuer Zugangsdaten, Token, Shopdaten und Bestellimport.
- Produkte/Listings fuer Produktvorbereitung, Listing-Pruefung und Uebertragung.
- Logs fuer Rueckmeldungen der TikTok API und Fehleranalyse.