TikTok Shop wystartował w Polsce i coraz więcej sklepów pyta, jak sprzedawać na nim bez ręcznego przepisywania oferty. Jeśli prowadzisz sklep na PrestaShop 8 lub 9, nie musisz budować osobnego katalogu ani obsługiwać zamówień w dwóch panelach. W tym artykule opisuję, jak działa integracja PrestaShop z TikTok Shop przez oficjalne API, jak wygląda wdrożenie krok po kroku, na czym najczęściej wykładają się sklepy i ile to kosztuje.
Tekst powstał na podstawie wdrożenia w działającym sklepie odzieżowym z tysiącami wariantów oraz rozmów z właścicielami sklepów, którzy próbowali wejść na TikTok Shop ręcznie. Jeśli szukasz samej listy wymagań, zobacz osobną checklistę 10 wymagań TikTok Shop dla sklepu PrestaShop.
Czym jest TikTok Shop i dlaczego warto tam być
TikTok Shop to sklep wbudowany w aplikację TikTok. Klient widzi produkt w filmie, transmisji LIVE lub na profilu twórcy i kupuje go bez wychodzenia z aplikacji. Dla sklepu oznacza to nowy kanał sprzedaży z własnym koszykiem, płatnościami i zamówieniami, które trzeba połączyć z magazynem i logistyką. Ręczne wystawianie ofert ma sens przy kilku produktach. Przy kilkuset, z wariantami rozmiarów i kolorów, bez integracji się nie da.
Największa różnica między TikTok Shop a klasycznym marketplace: klient nie szuka produktu, tylko go odkrywa. Sklep, który ma uporządkowany katalog i szybko reaguje na zamówienia, wygrywa z większym konkurentem, który wystawia ręcznie.
Jak działa integracja PrestaShop z TikTok Shop
Moduł PrestaShop TikTok Shop (RB TikTok Shop Pro) łączy sklep z kontem sprzedawcy przez TikTok Shop Open API (wersja 202309 i nowsze). Cała praca odbywa się w panelu PrestaShop, w sekcji TikTok Shop z 14 ekranami: od pulpitu i połączenia OAuth, przez produkty, mapowanie kategorii i atrybutów, ceny i magazyn, po zamówienia, webhooki, kolejkę, logi i diagnostykę.
Połączenie z kontem sprzedawcy
Konfiguracja nie wymaga programisty. Wpisujesz dane aplikacji z TikTok Shop Partner Center, klikasz „Połącz z TikTok Shop” i autoryzujesz sklep. Moduł sam pobiera identyfikator sklepu, region i shop cipher, a tokeny odświeża automatycznie przed każdym wywołaniem API. Integrator może wygenerować jednorazowy link autoryzacyjny ważny 48 godzin i wysłać go właścicielowi sklepu, który zatwierdza dostęp na własnym koncie. Jest też środowisko sandbox do testów.
Eksport produktów z wariantami i zdjęciami
Ekran Produkty pokazuje cały katalog ze statusem w TikTok Shop, identyfikatorem produktu TikTok, datą ostatniej synchronizacji i ostatnim błędem. Kombinacje PrestaShop stają się wariantami TikToka (do trzech grup atrybutów, z indeksem i EAN), zdjęcia są wysyłane raz i ponownie tylko po podmianie pliku, a waga i wymiary trafiają z danych produktu z obsługą jednostek sklepu. Produkt, który już istnieje w TikTok Shop, jest aktualizowany zamiast duplikowany. Do dziesięciu zaznaczonych produktów wysyłasz od razu z wynikiem dla każdego, większe paczki obsługuje kolejka w tle. Przed wysyłką możesz zobaczyć podgląd danych (dry run).
Kategorie, atrybuty, certyfikaty i GPSR
TikTok wymaga przypisania każdego produktu do kategorii z własnego drzewa i uzupełnienia atrybutów obowiązkowych. Moduł pobiera drzewo kategorii TikToka, mapuje kategorie PrestaShop z podpowiedziami AI, pobiera listę atrybutów i dozwolonych wartości, dopasowuje je z cech produktu i pozwala ustawić wartość domyślną dla kategorii. Certyfikaty i tabele rozmiarów dodajesz raz dla kategorii, a dane GPSR (producent i osoba odpowiedzialna w UE) są pobierane z Twojego Seller Center i dołączane do każdego eksportu. Walidacja przed wysyłką zatrzymuje eksport z linkiem do ekranu, na którym uzupełnisz braki.
Ceny i stany magazynowe
Każda zmiana stanu, ceny lub ceny specjalnej w PrestaShop trafia do kolejki i jest przesyłana do TikTok Shop. Dla kanału TikTok ustawiasz osobną politykę cenową: narzut procentowy lub kwotowy, zaokrąglanie, opcjonalne uwzględnianie cen specjalnych. Bufor magazynowy pozwala pokazywać w TikToku mniej sztuk, niż masz, aby nie sprzedać tej samej sztuki w dwóch kanałach. Pełną synchronizację uruchamiasz na żądanie lub z harmonogramu.
Zamówienia, statusy i wysyłka w obie strony
Zamówienia są pobierane webhookiem i cronem albo ręcznie od wybranej daty. Każde staje się pełnoprawnym zamówieniem PrestaShop, widocznym na liście zamówień, w raportach i w ERP. Moduł czeka, aż TikTok zwolni zamówienie do realizacji, więc anulowane w oknie rezygnacji nie trafiają do sklepu. Produkty są dopasowywane po SKU, zamówienie dostaje wybranego przewoźnika i koszt dostawy z TikToka, a klient trafia na wspólne konto techniczne, jako gość albo na konto z prawdziwym adresem e-mail (po wgraniu eksportu CSV z Seller Center). Gdy nadasz numer przesyłki, moduł przekazuje go do TikToka; anulowania i zwroty wracają do sklepu przez webhooki. Mapujesz przewoźników, sposób przekazania paczki i statusy w obie strony.
Asystent AI i niezawodność
Opcjonalny asystent AI (dostawca zgodny z OpenAI, Twój klucz API przechowywany w postaci zaszyfrowanej) dopasowuje kategorie, podpowiada mapowanie atrybutów, generuje tytuły i opisy pod TikTok Shop, audytuje gotowość katalogu i tłumaczy błędy API na polski z sugestią, co poprawić. Nigdy nie nadpisuje danych bez Twojej zgody, a miesięczny limit zapytań chroni przed kosztami. Pod spodem działa kolejka zadań z priorytetami, automatyczne ponawianie przy limitach API, bezpieczne webhooki z weryfikacją podpisu, cron przez CLI lub tajny URL, logi z maskowaniem danych i szyfrowanie tokenów AES-256-GCM.
Wdrożenie krok po kroku
- Konto i aplikacja. Konto sprzedawcy w TikTok Shop Seller Center oraz aplikacja w Partner Center z uprawnieniami do produktów, zamówień i logistyki. W dokumentacji modułu opisuję krok po kroku, jakie uprawnienia włączyć i jakie adresy wpisać.
- Instalacja i połączenie. Instalacja modułu w PrestaShop 8.x lub 9.x, wpisanie danych aplikacji, autoryzacja OAuth, test połączenia i uprawnień na ekranie diagnostyki.
- Porządek w katalogu. SKU na produktach i kombinacjach, wagi i wymiary, cechy produktów, z których moduł wyciąga atrybuty. To etap, na którym zwykle wychodzą braki w danych sklepu.
- Mapowanie. Kategorie, atrybuty, grupy atrybutów, certyfikaty, GPSR i przewoźnicy. Z asystentem AI zajmuje to godziny zamiast dni.
- Eksport testowy. Podgląd danych (dry run), eksport kilku produktów, sprawdzenie moderacji TikToka, poprawki i eksport całego katalogu przez kolejkę.
- Zamówienia. Konfiguracja przewoźnika, trybu klienta, statusów i webhooków, import testowy od wybranej daty w trybie cichym, a potem start na produkcji.
Najczęstsze problemy przy integracji z TikTok Shop
Z wdrożeń u klientów wynika, że najwięcej czasu zabierają trzy rzeczy: dopasowanie kategorii i atrybutów do wymagań TikToka, dane GPSR wymagane w UE oraz odrzucone oferty, których powód jest opisany tylko w angielskim komunikacie API. Dlatego w module są podpowiedzi kategorii z AI, pola GPSR przenoszone z Seller Center i logi z tłumaczeniem błędów. Zamiast sprawdzać każdy produkt ręcznie, widzisz listę odrzuconych ofert z konkretnym powodem i linkiem do miejsca, gdzie go usuniesz.
Czwarty problem to adresy e-mail kupujących. TikTok zwraca przez API adresy zastępcze. Jeśli chcesz mieć prawdziwe adresy w sklepie, potrzebujesz eksportu CSV z Seller Center i narzędzia, które przypisze je do zamówień. W module robisz to jednym kliknięciem z podglądem zmian.
Dla kogo jest ta integracja
- Dla sklepów modowych, kosmetycznych, lifestyle i z akcesoriami, których produkty dobrze sprzedają się przez wideo i współpracę z twórcami.
- Dla sklepów z dużą liczbą wariantów, dla których ręczne wystawianie jest nierealne.
- Dla firm pracujących z ERP lub systemem magazynowym podłączonym do PrestaShop: zamówienia TikTok płyną tą samą ścieżką co pozostałe.
- Dla agencji i integratorów obsługujących sklepy klientów, dzięki linkowi autoryzacyjnemu dla właściciela i multistore z osobnym połączeniem na sklep.
Kiedy integracja się nie opłaca
Jeśli masz kilkanaście produktów bez wariantów i nie planujesz rozbudowy katalogu, ręczne wystawienie w Seller Center zajmie jedno popołudnie i nie potrzebujesz modułu. Integracja zaczyna się opłacać, gdy stany i ceny zmieniają się częściej niż raz w tygodniu, gdy obsługujesz zamówienia w ERP albo gdy katalog ma więcej niż kilkadziesiąt pozycji. Wtedy każdy dzień ręcznej synchronizacji kosztuje więcej niż licencja.
Ile kosztuje integracja PrestaShop z TikTok Shop
Moduł RB TikTok Shop Pro kosztuje 999 zł i obejmuje licencję oraz wsparcie przy konfiguracji. Jeśli Twój sklep ma nietypowe atrybuty, własny system magazynowy lub ERP, integrację dopasowuję w ramach supportu PrestaShop. Sprzedajesz też w InPost Merchant? Oba kanały obsłużysz z jednego panelu, bo moduł PrestaShop InPost Buy Merchant działa na tej samej zasadzie.
Najczęstsze pytania
Czy muszę mieć konto TikTok Shop?
Tak. Moduł łączy PrestaShop z istniejącym kontem sprzedawcy TikTok Shop. Potrzebna jest też aplikacja w TikTok Shop Partner Center.
Czy ceny w TikTok mogą być inne niż w sklepie?
Tak. Ustawiasz narzut procentowy lub kwotowy, zaokrąglanie oraz decydujesz, czy uwzględniać ceny specjalne.
Czy moduł działa w multistore?
Tak. Każdy sklep może mieć własne połączenie z TikTok Shop, własne mapowania i ustawienia.
Czy AI jest wymagane?
Nie. Asystent AI jest opcjonalny i działa dopiero po podaniu własnego klucza API. Cała integracja działa bez niego.
Jakie są wymagania techniczne?
PrestaShop 8.0–8.2.x lub 9.x, PHP 7.4–8.3 z rozszerzeniami curl i openssl, cron do kolejki. Bez Composera na serwerze i bez modyfikacji plików core. Panel modułu jest po polsku i angielsku.
Masz pytania o integrację z TikTok Shop? Napisz do mnie, odpowiadam w ciągu jednego dnia roboczego.
