TikTok Shop to kanał, w którym klient kupuje w trakcie oglądania filmu, transmisji LIVE albo profilu twórcy, bez wychodzenia z aplikacji. Dla sklepu internetowego oznacza to nowy rynek, ale też zupełnie nowe wymagania: osobne drzewo kategorii, obowiązkowe atrybuty, dane GPSR, certyfikaty, limity zdjęć i okno anulowania zamówień. Większość sklepów, które próbowały wejść na TikTok Shop „na szybko”, utknęła na odrzuconych ofertach i ręcznym przepisywaniu zamówień.
Poniżej znajdziesz checklistę, którą przechodzę z klientami przed uruchomieniem sprzedaży na TikTok Shop ze sklepu PrestaShop. Kolejność nie jest przypadkowa: zaczynamy od rzeczy, bez których integracja w ogóle nie wystartuje, a kończymy na tych, które decydują o tym, czy po miesiącu nadal będziesz mieć nad tym kontrolę. Przy każdym punkcie piszę, co da się zautomatyzować, a co trzeba przygotować ręcznie.
1. Konto sprzedawcy i aplikacja w TikTok Shop Partner Center
Sprzedaż zaczyna się od konta w TikTok Shop Seller Center. To tam rejestrujesz firmę, magazyny, opcje dostawy i producentów. Jeśli chcesz podłączyć sklep przez API, a nie wystawiać produkty ręcznie, potrzebujesz dodatkowo aplikacji w TikTok Shop Partner Center z uprawnieniami do produktów, zamówień i logistyki.
Dlaczego to ważne
Najczęstsza przyczyna błędów przy pierwszym eksporcie to nie kod, tylko uprawnienia. Pakiet API dodany w Partner Center musi zostać zaakceptowany po stronie konta sprzedawcy, a brakujący zakres (np. logistyka) objawia się dopiero przy próbie nadania przesyłki. Integracja łączy się z kontem przez OAuth: wpisujesz dane aplikacji, klikasz „Połącz z TikTok Shop” i autoryzujesz sklep. Dobry moduł pokaże od razu listę przyznanych zakresów (scopes), datę wygaśnięcia tokenu i identyfikator sklepu.
- Załóż konto w Seller Center i uzupełnij dane firmy, magazyn oraz opcje dostawy.
- Utwórz aplikację w Partner Center i dodaj pakiet uprawnień do produktów, zamówień i logistyki.
- Jeśli wdrożenie robi integrator, wygeneruj dla właściciela sklepu jednorazowy link autoryzacyjny, zamiast przekazywać mu hasła.
- Przetestuj integrację w środowisku sandbox, zanim produkty trafią do klientów.
2. SKU na każdym produkcie i każdej kombinacji
TikTok rozpoznaje produkty i warianty po SKU. W PrestaShop odpowiada mu pole indeks (reference) na produkcie i na kombinacji. Jeśli jest puste, integracja nie dopasuje ofert wystawionych wcześniej ręcznie w Seller Center i powstaną duplikaty, a każda aktualizacja ceny lub stanu trafi w próżnię.
Dlaczego to ważne
SKU jest jedynym stabilnym kluczem między sklepem a marketplace. Nazwa produktu może się zmienić, identyfikator TikToka poznasz dopiero po pierwszym eksporcie, a EAN nie zawsze istnieje. Moduł, który rozpoznaje produkty po SKU, aktualizuje istniejące oferty zamiast tworzyć nowe, także te odrzucone wcześniej przez moderację.
Jeśli w katalogu masz kombinacje bez indeksu, uzupełnij je przed pierwszym eksportem. Dopisywanie SKU po fakcie oznacza ręczne łączenie ofert w Seller Center.
3. Kategorie TikToka i atrybuty obowiązkowe
Każdy produkt musi być przypisany do kategorii z drzewa TikToka, a nie z Twojego sklepu. Każda kategoria ma własną listę atrybutów obowiązkowych z dozwolonymi wartościami: skład materiałowy, rozmiar, kolor, płeć, sezon, a w elektronice parametry techniczne. Bez kompletu produkt zostaje odrzucony.
Dlaczego to ważne
To najbardziej pracochłonny punkt całej listy. Ręczne mapowanie kilkuset produktów na kategorie i atrybuty TikToka zajmuje dni, a przy zmianie drzewa kategorii trzeba je powtórzyć. W module PrestaShop TikTok Shop mapowanie kategorii wspiera asystent AI, wartości atrybutów są dopasowywane z cech produktu (także skład materiałowy po polsku i angielsku, np. „95% wiskoza, 5% elastan”), a wartość domyślną ustawiasz raz dla całej kategorii. Grupy atrybutów PrestaShop (rozmiar, kolor) mapujesz na atrybuty sprzedażowe TikToka.
- Pobierz aktualne drzewo kategorii TikToka i zmapuj najpierw kategorie z największą liczbą produktów.
- Dla każdej kategorii ustaw wartości domyślne atrybutów obowiązkowych.
- Uzupełnij cechy produktów w PrestaShop, z których moduł wyciąga wartości per produkt.
- Uruchom walidację przed wysyłką: brakujące atrybuty mają zatrzymać eksport z linkiem do ekranu, na którym je uzupełnisz.
4. GPSR: producent i osoba odpowiedzialna w UE
Rozporządzenie GPSR wymaga podania producenta i osoby odpowiedzialnej za produkt w Unii Europejskiej. TikTok Shop egzekwuje to przy wystawianiu oferty i odrzuca produkty bez tych danych. Nie ma znaczenia, że w Twoim sklepie te informacje już są: TikTok musi je dostać w swoim formacie.
Dlaczego to ważne
Producentów i osoby odpowiedzialne rejestruje się w Seller Center. Integracja powinna pobrać tę listę i pozwolić przypisać właściwy wpis do produktów lub całych kategorii, a następnie dołączać go do każdego eksportu. Błąd TikToka dotyczący GPSR powinien prowadzić prosto do właściwej sekcji konfiguracji, a nie do kodu błędu w logu. Jeśli prowadzisz już rejestr GPSR w sklepie, zobacz, jak zrobić to raz, w artykule o regulacjach prawnych dla PrestaShop.
5. Zdjęcia, waga i wymiary paczki
TikTok przyjmuje zdjęcia w zakresie 300–4000 px i wymaga wagi oraz wymiarów paczki do wyliczenia dostawy i doboru przewoźnika. Produkt bez wagi nie zostanie wystawiony, a zdjęcie poza limitem zostanie odrzucone w całości, nie tylko przeskalowane.
Dlaczego to ważne
W sklepie z tysiącem produktów ręczne sprawdzanie wymiarów nie ma sensu. Lepiej ustawić wartości domyślne dla produktów bez danych i jednostki zgodne ze sklepem (kg/g, cm/mm), a zdjęcia spoza wymagań zastępować pasującą miniaturą. Przy eksporcie przez API zdjęcia powinny być wysyłane do TikToka raz, a ponownie tylko po podmianie pliku. Przy dużym katalogu to różnica między godziną a dobą synchronizacji.
6. Certyfikaty i tabele rozmiarów
Część kategorii wymaga dokumentów: kosmetyki, zabawki, elektronika, odzież dziecięca, suplementy. TikTok oczekuje certyfikatów, deklaracji zgodności albo tabeli rozmiarów w formacie JPG, PNG, WEBP lub PDF, dołączonych do oferty.
Dlaczego to ważne
Dokumenty są zwykle wspólne dla całej kategorii. Przygotuj je przed startem i przypisz raz do kategorii, żeby integracja dołączała je automatycznie do każdego produktu. Lista kategorii wymagających dokumentów zmienia się, dlatego warto, by moduł pobierał ją z API i pokazywał brak dokumentu w walidacji przed wysyłką.
7. Polityka cenowa i bufor magazynowy dla TikToka
Ceny w TikTok Shop nie muszą być takie same jak w sklepie. Prowizja marketplace, kampanie twórców i promocje TikToka wymagają osobnej polityki cenowej. Zdecyduj, czy stosujesz narzut procentowy lub kwotowy, zaokrąglanie do pełnych złotych i czy uwzględniasz ceny specjalne z PrestaShop.
Dlaczego to ważne
Drugi element to bufor magazynowy. Stany synchronizują się z opóźnieniem liczonym w sekundach lub minutach, więc ostatnia sztuka może zostać sprzedana jednocześnie w sklepie i na TikToku. Pokazywanie w TikToku kilku sztuk mniej, niż masz w magazynie, chroni przed oversellingiem i anulowaniami, które obniżają ocenę sprzedawcy.
Każda zmiana ceny, ceny specjalnej lub stanu w PrestaShop powinna trafiać do kolejki i być przesyłana do TikToka automatycznie. Jeśli ktoś musi o tym pamiętać, w końcu zapomni.
8. Zamówienia: okno anulowania, przewoźnik i adresy e-mail
Zamówienie z TikToka powinno trafić do PrestaShop dopiero wtedy, gdy TikTok zwolni je do realizacji (status AWAITING_SHIPMENT). Zamówienia anulowane przez klienta w oknie rezygnacji nie powinny w ogóle pojawić się w sklepie, bo inaczej magazyn pakuje paczkę, której nikt nie odbierze.
Dlaczego to ważne
Zamówienie z TikToka musi stać się pełnoprawnym zamówieniem PrestaShop: z klientem, adresem, przewoźnikiem, kosztem dostawy i statusem, tak aby obsłużył je ten sam proces i ten sam ERP co pozostałe. Wybierz przewoźnika, do którego trafiają zamówienia TikTok, i tryb klienta: wspólne konto techniczne, zamówienie gościa albo konto z adresem e-mail kupującego. Pamiętaj, że API TikToka zwraca adresy zastępcze: prawdziwe adresy e-mail dostaniesz z eksportu CSV w Seller Center i możesz przypisać je do zamówień w sklepie jednym kliknięciem.
- Importuj zamówienia webhookiem i cronem, a ręcznie tylko od wybranej daty przy pierwszym uruchomieniu.
- Dopasowuj produkty po SKU kombinacji, SKU produktu lub nazwie wariantu, w tej kolejności.
- Zapisuj numer zamówienia TikTok w notatce zamówienia, żeby ERP widział go przez webservice.
- Włącz tryb cichy na czas testów, żeby klienci TikToka nie dostawali maili ze sklepu testowego.
9. Statusy i numery przesyłek w obie strony
Gdy nadasz numer przesyłki w PrestaShop, musi on wrócić do TikToka, a paczka ma zostać oznaczona jako wysłana. Anulowanie lub zwrot po stronie TikToka musi wrócić do sklepu. Bez tego obsługa zamówień z TikToka kończy się przepisywaniem numerów ręcznie w dwóch panelach.
Dlaczego to ważne
Zaplanuj mapowanie przewoźników PrestaShop na przewoźników TikToka (lista pobierana z Twoich magazynów i opcji dostawy w TikTok Shop), sposób przekazania paczki (odbiór przez kuriera lub nadanie w punkcie) oraz mapowanie statusów zamówień w obie strony. Dedykowane statusy w PrestaShop (nowe z TikToka, oczekuje na wysyłkę, wysłane, anulowane, zwrot) ułatwiają filtrowanie i raporty.
10. Cron, kolejka i logi
Eksport produktów, aktualizacje cen i stanów oraz import zamówień powinny działać w tle, w kolejce z priorytetami i ponawianiem przy limitach API (HTTP 429) oraz błędach sieci. Ciężkie operacje nie mogą spowalniać panelu ani sklepu.
Dlaczego to ważne
Ustaw cron (CLI lub tajny adres URL) i sprawdź, czy masz dostęp do logów API z filtrami, eksportem do CSV i maskowaniem tokenów oraz danych osobowych. To logi pozwalają zrozumieć, dlaczego TikTok odrzucił ofertę. Ekran diagnostyki z testem połączenia, uprawnień, tokenu i wymagań serwera (PHP, curl, openssl) oszczędza godziny przy wdrożeniu i po każdej aktualizacji sklepu.
Co łączy wszystkie te punkty
Każdy z nich dotyczy danych, które sklep ma albo powinien mieć, tylko w innym formacie niż oczekuje TikTok. Problem nie polega na tym, że TikTok Shop jest trudny, lecz na tym, że wymaga kompletu i konsekwencji: pełnych SKU, cech produktów, wag, dokumentów i aktualnych stanów. Sklep, który ma te dane uporządkowane, wchodzi na TikTok Shop w kilka dni. Sklep, który ich nie ma, utknie na pierwszych odrzuconych ofertach niezależnie od modułu.
Prosta lista kontrolna przed startem
- Konto Seller Center i aplikacja w Partner Center z pełnym pakietem uprawnień.
- SKU na wszystkich produktach i kombinacjach, najlepiej z EAN.
- Zmapowane kategorie i wartości domyślne atrybutów obowiązkowych.
- Producenci i osoby odpowiedzialne (GPSR) zarejestrowane w Seller Center.
- Zdjęcia 300–4000 px, waga i wymiary lub wartości domyślne.
- Certyfikaty i tabele rozmiarów przypisane do kategorii.
- Narzut, zaokrąglanie i bufor magazynowy ustalone dla kanału TikTok.
- Przewoźnik, tryb klienta i import zamówień od statusu AWAITING_SHIPMENT.
- Mapowanie statusów i przewoźników w obie strony.
- Cron, kolejka, logi i ekran diagnostyki.
Co z tej listy robi za Ciebie integracja
Punkty 3, 5, 6, 8, 9 i 10 w całości obsługuje RB TikTok Shop Pro, moduł integracji PrestaShop z TikTok Shop, zgodny z PrestaShop 8.x i 9.x. Walidacja przed wysyłką zatrzymuje eksport z linkiem do ekranu, na którym uzupełnisz brakujące dane, a asystent AI tłumaczy komunikaty błędów API na polski i podpowiada, co poprawić. Jeśli sprzedajesz także w InPost Merchant, oba kanały obsłużysz z jednego panelu, o czym piszę w poradniku o integracji PrestaShop z InPost Merchant. Jak przebiega samo wdrożenie, opisuję w artykule o integracji PrestaShop z TikTok Shop.
Kiedy warto oddać wdrożenie komuś z zewnątrz
Jeśli masz do kilkudziesięciu produktów bez wariantów, przejdziesz tę listę samodzielnie w jeden dzień. Przy setkach produktów z kombinacjami, ERP lub systemem magazynowym podłączonym do PrestaShop i kilku sklepach w multistore, wdrożenie z kimś, kto zna wymagania TikToka i API PrestaShop, zwykle zwraca się po pierwszych odrzuconych ofertach, których nie będzie.
Najczęstsze pytania
Czy mogę wystawić na TikTok Shop tylko część katalogu?
Tak. Wybierasz produkty ręcznie, ustawiasz reguły eksportu (tylko aktywne, tylko na stanie, minimalny stan) i możesz wykluczyć pojedyncze produkty w ich karcie albo wymusić eksport konkretnego produktu.
Co z produktami, które już wystawiłem ręcznie w Seller Center?
Jeśli mają SKU zgodne z indeksami w PrestaShop, integracja rozpozna je i zacznie aktualizować zamiast tworzyć duplikaty. Dotyczy to także ofert odrzuconych wcześniej przez moderację.
Czy klienci z TikToka dostaną maile z mojego sklepu?
To zależy od trybu klienta i ustawienia trybu cichego. Możesz importować zamówienia bez wysyłania żadnych wiadomości i włączyć powiadomienia dopiero po zakończeniu testów.
Czy do integracji potrzebny jest Composer albo dodatkowy serwer?
Nie. Wystarczy PrestaShop 8.0–9.x, PHP 7.4–8.3 z rozszerzeniami curl i openssl oraz cron do przetwarzania kolejki. Moduł nie modyfikuje plików core i działa w multistore z osobnym połączeniem dla każdego sklepu.
Masz sklep na PrestaShop i chcesz wystartować na TikTok Shop? Napisz, sprawdzę Twój katalog pod kątem tej checklisty i wycenię wdrożenie.
