RB TikTok Shop Pro - moduł PrestaShop TikTok Shop (integracja API)

RB TikTok Shop Pro - sprzedawaj na TikTok Shop prosto z PrestaShop

TikTok Shop to sklep wbudowany bezpośrednio w aplikację, w której klienci odkrywają produkty z filmów, transmisji LIVE i profili twórców - i kupują je bez wychodzenia z TikToka. RB TikTok Shop Pro pozwala wejść na ten kanał bez ręcznego wystawiania ofert i bez przepisywania zamówień. Twój katalog, ceny, stany magazynowe i zamówienia są zarządzane z jednego miejsca: panelu PrestaShop.

Moduł korzysta z oficjalnego TikTok Shop Open API (wersja 202309 i nowsze) i obsługuje pełny cykl sprzedaży: od eksportu produktu, przez aktualizację ceny i stanu, po import zamówienia, przekazanie numeru przesyłki i zmianę statusu. Wszystko w obie strony, automatycznie i z pełną kontrolą nad tym, co trafia do TikToka.

Najważniejsze korzyści

• Nowy kanał sprzedaży w kilka dni - zamiast ręcznego wprowadzania setek produktów w Seller Center.
• Jeden magazyn, zero oversellingu - stany i ceny aktualizują się w TikTok Shop po każdej zmianie w PrestaShop.
• Zamówienia TikTok jak każde inne - trafiają do PrestaShop z klientem, adresem, przewoźnikiem i statusem, więc obsługujesz je tym samym procesem (i tym samym ERP).
• Mniej odrzuceń przez TikTok - walidacja przed wysyłką, atrybuty kategorii, certyfikaty, tabele rozmiarów i dane GPSR są obsłużone w module.
• AI, które oszczędza godziny pracy - podpowiedzi kategorii, brakujących danych i zrozumiałe wyjaśnienia błędów API po polsku.

Połączenie z TikTok Shop

Gdy masz już aplikację w TikTok Shop Partner Center, połączenie nie wymaga programowania. Wpisujesz dane aplikacji (App Key, App Secret, Service ID), klikasz „Połącz z TikTok Shop” i autoryzujesz sklep. Moduł sam pobiera identyfikator sklepu, region i shop_cipher, a tokeny dostępowe odświeża automatycznie przed każdym wywołaniem API.

• Logowanie OAuth z ochroną przed atakami CSRF (weryfikacja parametru state).
• Link autoryzacyjny dla właściciela sklepu - integrator generuje jednorazowy link (ważny 48 h) i wysyła go sprzedawcy, który zatwierdza dostęp na swoim koncie.
• Bez sandboxa - praca na produkcyjnym API: TikTok Shop nie udostępnia środowiska testowego dla tej integracji. Dlatego moduł ma podgląd danych (dry run), walidację przed wysyłką i tryb cichy, a pojedyncze produkty możesz wysłać próbnie przed eksportem całego katalogu.
• Podgląd przyznanych uprawnień (scope) - od razu widać, czy pakiet API dodany w Partner Center dotarł do konta sprzedawcy.
• Tryb cichy - wyłącza wysyłkę maili do klientów podczas importu zamówień i zmian statusów. Przydatny, gdy sklep testowy jest podłączony do produkcyjnego konta TikTok.

Eksport produktów - z wariantami, zdjęciami i kontrolą

Ekran Produkty pokazuje cały katalog sklepu ze statusem w TikTok Shop, identyfikatorem produktu TikTok, datą ostatniej synchronizacji i ostatnim błędem. Filtrujesz po ID, nazwie, indeksie i statusie, sortujesz kolumny i zaznaczasz produkty do wysyłki.

• Kombinacje PrestaShop jako warianty TikTok (SKU) - np. Rozmiar i Kolor, do trzech grup atrybutów, z indeksem i kodem EAN.
• Automatyczne przesyłanie zdjęć do TikToka z inteligentną pamięcią podręczną: niezmienione zdjęcie nie jest wysyłane drugi raz, a podmiana pliku wymusza ponowny upload. Zdjęcia spoza wymagań TikToka (300-4000 px) są zastępowane pasującą miniaturą.
• Waga i wymiary paczki z danych produktu, z obsługą jednostek sklepu (kg/g/lb, cm/mm/m/in) i wartościami domyślnymi, gdy produkt ich nie ma.
• Aktualizacja zamiast duplikatów - produkt, który już istnieje w TikTok Shop (także odrzucony), jest edytowany z zachowaniem identyfikatorów SKU.
• Natychmiastowy wynik - do 10 zaznaczonych produktów jest wysyłanych od razu, z wynikiem dla każdego z nich. Większe paczki obsługuje kolejka w tle.
• Podgląd danych (dry run) - zobaczysz dokładnie, co zostanie wysłane do TikToka, zanim cokolwiek wyślesz.
• Reguły eksportu: tylko aktywne produkty, tylko produkty na stanie, minimalny stan, a w karcie produktu przełączniki „wyklucz z TikToka” i „wymuś eksport”.

Kategorie i atrybuty dopasowane do wymagań TikTok

TikTok Shop wymaga, aby każdy produkt był przypisany do kategorii z jego drzewa i miał uzupełnione atrybuty obowiązkowe tej kategorii. Moduł prowadzi Cię przez ten proces krok po kroku.

• Mapowanie kategorii PrestaShop → TikTok z pobranym drzewem kategorii TikTok i podpowiedziami AI.
• Atrybuty kategorii TikTok - moduł pobiera listę atrybutów i ich dozwolonych wartości. Wartość domyślną ustawiasz raz dla całej kategorii.
• Wartości per produkt z cech PrestaShop. Tekst produktu jest dopasowywany do listy wartości TikTok, także dla składu materiałowego po polsku i angielsku (np. „95% wiskoza, 5% elastan”). Jeśli TikTok dopuszcza własną wartość, moduł ją wyśle.
• Mapowanie grup atrybutów (rozmiar, kolor) na atrybuty sprzedażowe TikTok.
• Certyfikaty i tabele rozmiarów - wymagane dokumenty (JPG, PNG, WEBP, PDF) dodajesz raz dla kategorii, a moduł dołącza je do każdego produktu.
• Walidacja przed wysyłką - brakujące atrybuty, waga czy certyfikat zatrzymują eksport z linkiem prosto do ekranu, na którym je uzupełnisz.

Zgodność z UE: GPSR

Rozporządzenie GPSR wymaga podania producenta i osoby odpowiedzialnej za produkt w UE. Moduł pobiera listę producentów i osób odpowiedzialnych zarejestrowanych w Twoim TikTok Seller Center i dołącza wybrane dane do każdego eksportowanego produktu. Błąd TikToka dotyczący GPSR prowadzi prosto do właściwej sekcji konfiguracji.

Ceny i stany magazynowe zawsze aktualne

Każda zmiana stanu, ceny lub ceny specjalnej w PrestaShop trafia do kolejki i jest przesyłana do TikTok Shop. Nie musisz pamiętać o ręcznej aktualizacji, a klient nie kupi produktu, którego już nie masz.

• Narzut procentowy i kwotowy oraz zaokrąglanie cen - osobna polityka cenowa dla kanału TikTok.
• Opcjonalne uwzględnianie cen specjalnych PrestaShop.
• Bufor magazynowy - możesz pokazywać w TikTok mniej sztuk, niż masz, aby zabezpieczyć się przed sprzedażą tego samego produktu w dwóch kanałach.
• Pełna synchronizacja cen i stanów na żądanie lub z harmonogramu (cron).

Zamówienia z TikTok Shop prosto w PrestaShop

Zamówienia są pobierane automatycznie (webhook i cron) lub ręcznie od wybranej daty. Każde staje się pełnoprawnym zamówieniem PrestaShop, widocznym na liście zamówień, w raportach i w zintegrowanym ERP.

• Import we właściwym momencie - moduł czeka, aż TikTok zwolni zamówienie do realizacji (status AWAITING_SHIPMENT). Zamówienia anulowane w oknie rezygnacji nie trafiają do sklepu.
• Dopasowanie produktów po SKU - po indeksie kombinacji, indeksie produktu lub nazwie wariantu.
• Przewoźnik i koszt dostawy - wybierasz przewoźnika, do którego trafiają zamówienia TikTok (np. InPost Kurier), z kosztem wysyłki z TikToka.
• Trzy tryby klienta: wspólne konto techniczne, zamówienie gościa albo konto klienta z jego adresem e-mail.
• Prawdziwe adresy e-mail kupujących - TikTok API zwraca tylko adres zastępczy. Wgrywasz eksport CSV z Seller Center, sprawdzasz podgląd zmian i jednym kliknięciem przypisujesz zamówienia do prawdziwych adresów. Adresy z zamówień jeszcze niezaimportowanych zostaną użyte przy imporcie.
• Numer zamówienia TikTok w notatce zamówienia („TikTok: …”) - dostępny dla ERP przez webservice.
• Kolumna TikTok na liście zamówień z filtrem i linkiem do zamówienia w TikTok Seller Center.
• Karta TikTok na stronie zamówienia z danymi zamówienia i przyciskiem „Aktualizuj dane z TikTok”.
• 5 dedykowanych statusów: nowe, oczekuje na wysyłkę, wysłane, anulowane, zwrot.
• Zgodność z modułami innych firm, które reagują na tworzenie koszyka i zamówienia (np. moduły pakietów produktów).

Statusy i wysyłka w obie strony

Gdy wysyłasz paczkę i nadajesz numer przesyłki w PrestaShop, moduł przekazuje go do TikTok Shop i oznacza paczkę jako wysłaną. Zmiany statusu po stronie TikToka (anulowanie, zwrot) wracają do PrestaShop przez webhooki.

• Mapowanie przewoźników PrestaShop na przewoźników TikTok, z listą pobieraną z Twoich magazynów i opcji dostawy w TikTok Shop.
• Sposób przekazania paczki: odbiór przez kuriera (PICKUP) lub nadanie w punkcie (DROP_OFF).
• Korekta numeru przesyłki dla paczki już przekazanej.
• Mapowanie statusów zamówień PrestaShop ↔ TikTok.

Asystent AI - szybsze wdrożenie i mniej błędów

Opcjonalny asystent AI (dostawca zgodny z OpenAI) wykonuje pracę, która zwykle zajmuje najwięcej czasu przy wejściu na marketplace.

• Dopasowanie kategorii TikTok do kategorii sklepu.
• Podpowiedzi mapowania atrybutów i wykrywanie brakujących danych.
• Tytuły, opisy, punkty i tagi zoptymalizowane pod TikTok Shop.
• Wyjaśnianie błędów API po polsku z sugestią, co poprawić.
• Audyt gotowości do eksportu całego katalogu.
• Autopilot w trzech trybach: tylko sugestie, sugestie do zatwierdzenia albo automatyczne zastosowanie.

AI nigdy nie nadpisuje danych produktu bez Twojej zgody. Klucz API jest przechowywany w postaci zaszyfrowanej, a miesięczny limit zapytań chroni przed nieplanowanymi kosztami.

Niezawodność: kolejka, webhooki i cron

Ciężkie operacje nie spowalniają panelu ani sklepu. Każde zadanie (eksport, aktualizacja ceny i stanu, import zamówienia, wysyłka, webhook) trafia do kolejki z priorytetami.

• Automatyczne ponawianie z rosnącym odstępem przy błędach sieci, limitach API (HTTP 429) i błędach serwera TikTok. Błędy danych nie są ponawiane bez końca, tylko od razu pokazane do poprawy.
• Brak podwójnego przetwarzania - blokady zadań i odzyskiwanie zadań zawieszonych.
• Bezpieczne webhooki - tajny token, weryfikacja podpisu i ochrona przed powtórzeniem tego samego zdarzenia.
• Cron przez CLI lub tajne adresy URL, z blokadą równoległych uruchomień.
• Podgląd kolejki z ręcznym ponowieniem lub anulowaniem i wglądem w dane zadania.

Diagnostyka, logi i bezpieczeństwo

• Ekran diagnostyki z testem połączenia, uprawnień i tokenu oraz kontrolą wymagań serwera.
• Logi API z filtrami i eksportem do CSV. Tokeny, sekrety i dane osobowe są w logach maskowane.
• Szyfrowanie AES-256-GCM tokenów i kluczy, z kluczem unikalnym dla każdej instalacji.
• App Secret tylko do zapisu - po zapisaniu nie jest nigdzie wyświetlany.
• Ochrona CSRF wszystkich formularzy i akcji, uprawnienia zgodne z rolami pracowników w panelu.
• Przy odinstalowaniu decydujesz, czy zachować dane integracji, czy usunąć wszystko.

Panel TikTok Shop w PrestaShop

Po instalacji w menu panelu pojawia się sekcja TikTok Shop z 14 ekranami: Pulpit, Konfiguracja, Połączenie OAuth, Produkty, Mapowanie kategorii, Mapowanie atrybutów, Ceny i magazyn, Zamówienia, Statusy i wysyłka, Webhooki, Kolejka synchronizacji, Logi API, AI Assistant oraz Cron / Diagnostyka. Dodatkowo moduł dodaje zakładkę TikTok w karcie produktu, kartę TikTok w szczegółach zamówienia i kolumnę TikTok na liście zamówień.

Wymagania techniczne

Dla kogo jest RB TikTok Shop Pro?

• Dla sklepów modowych, kosmetycznych, lifestyle i z akcesoriami, których produkty dobrze sprzedają się przez wideo i współpracę z twórcami.
• Dla firm, które chcą dodać TikTok Shop jako kolejny kanał bez osobnego systemu do zarządzania ofertami.
• Dla sklepów z dużą liczbą wariantów (rozmiary, kolory), 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.

Najczęściej zadawane pytania

Czy muszę mieć konto TikTok Shop?

Tak. Moduł łączy PrestaShop z istniejącym kontem sprzedawcy TikTok Shop. Potrzebna jest też własna aplikacja w TikTok Shop Partner Center (TikTok udostępnia ją kontom z przypisanym Account Managerem) - w dokumentacji opisujemy krok po kroku, jakie uprawnienia włączyć i jakie adresy wpisać.

Czy mogę najpierw przetestować integrację?

TikTok Shop nie oferuje sandboxa, więc moduł pracuje na produkcyjnym API. Bezpieczny start: podgląd danych (dry run), walidacja przed wysyłką, tryb cichy dla zamówień i wysyłka pojedynczych produktów, zanim wyślesz cały katalog.

Czy mogę wysłać do TikToka tylko część produktów?

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.

Co z produktami, które już wystawiłem w Seller Center?

Moduł rozpoznaje produkty po SKU i aktualizuje istniejące oferty zamiast tworzyć duplikaty.

Czy ceny w TikTok mogą być inne niż w sklepie?

Tak. Możesz ustawić narzut procentowy lub kwotowy, zaokrąglanie oraz zdecydować, czy uwzględniać ceny specjalne.

Czy klienci TikTok dostaną maile ze sklepu?

To zależy od wybranego trybu klienta i ustawienia trybu cichego. Możesz importować zamówienia bez wysyłania żadnych wiadomości.

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.

Dlaczego RB TikTok Shop Pro?

Bo to pełna integracja dwukierunkowa, a nie prosty eksport pliku z produktami. Moduł obsługuje to, na czym zwykle kończą się proste rozwiązania: warianty, atrybuty kategorii, certyfikaty, GPSR, zdjęcia, okno anulowania zamówień, przewoźników, numery przesyłek i prawdziwe adresy e-mail kupujących. Powstał na podstawie wdrożenia w działającym sklepie internetowym i jest rozwijany w odpowiedzi na realne potrzeby sprzedawców.

Zainstaluj RB TikTok Shop Pro i zacznij sprzedawać tam, gdzie Twoi klienci spędzają czas.