Oficjalna autoryzacja OAuth
Połączenie idzie przez ekran zgody TikTok Shop. Nigdy nie prosimy o hasło do Twojego konta, a powrót z ekranu zgody jest wiązany z sesją, z której wyszedł.
Dla sprzedawców
Integracja z TikTok Shop
Podłączasz swój sklep TikTok Shop do FIRMSET, wystawiasz oferty i odbierasz zamówienia w tym samym panelu, w którym prowadzisz magazyn, faktury i pozostałe kanały sprzedaży.
Sprzedawcy TikTok Shop
Autoryzacja OAuth
Słownik kategorii
Publikacja ofert
Zamówienia w panelu
Log wywołań API
Prosty start
Trzy kroki od konta do gotowego słownika kategorii
Nie potrzebujesz własnych kluczy API ani konta dewelopera. Stroną techniczną zajmuje się FIRMSET.
1
Dodajesz konto sprzedawcy
W panelu FIRMSET tworzysz konto integracji i nadajesz mu nazwę. Formularz nie prosi o żadne klucze API — aplikacja partnerska należy do FIRMSET.
2
Autoryzujesz sklep w TikTok Shop
Klikasz „Połącz” i trafiasz na oficjalny ekran zgody TikTok Shop. Po zatwierdzeniu wracasz do panelu, a my zapisujemy tokeny sprzedawcy i listę autoryzowanych sklepów.
3
Pobieramy słownik kategorii
Po podłączeniu sklepu FIRMSET pobiera pełne drzewo kategorii TikTok Shop razem z cechami i wymaganiami, a potem odświeża je co noc.
Na jakim etapie jest moduł
Moduł jest gotowy po stronie FIRMSET. Połączenie sklepu udostępniamy sprzedawcom po zakończeniu weryfikacji naszej aplikacji przez TikTok Shop.
Zakres integracji
Co dokładnie robi moduł TikTok Shop
Opisujemy wyłącznie to, co jest w produkcie dzisiaj. Funkcje z planu rozwoju wypisaliśmy niżej, osobno i wprost.
Autoryzacja, która się nie urywa
Tokeny odnawiamy automatycznie, z dobowym zapasem przed wygaśnięciem. Gdy kończy się ważność zgody, panel ostrzega z wyprzedzeniem, zamiast po cichu przestać działać.
Wiele kont, wiele sklepów
Jedno konto FIRMSET obsługuje kilka kont sprzedawcy i kilka sklepów naraz. Jeden sklep oznaczasz jako domyślny, resztą sterujesz z listy.
Podpis HMAC-SHA256 przy każdym żądaniu
Każde wywołanie API podpisujemy zgodnie z wymaganiami TikTok Shop. Poprawności podpisu pilnuje zestaw testów na zamrożonym wzorcu.
Codzienne odświeżanie kategorii
Pełne drzewo kategorii pobieramy co noc, a cechy i wymagania kategorii osobnym przebiegiem. Kategoria, która zniknie z API, zostaje oznaczona, a nie skasowana bez śladu.
Wyszukiwarka kategorii i podpowiedź
Kategorię znajdujesz po nazwie albo schodzisz drzewem z podglądem pełnej ścieżki. Możesz też poprosić TikToka o podpowiedź na podstawie nazwy i opisu produktu.
Wymagania kategorii na wierzchu
Dla wybranej kategorii widzisz, czy TikTok Shop oczekuje danych GPSR, tabeli rozmiarów, wymiarów paczki albo wyłączenia płatności przy odbiorze.
Publikacja i edycja ofert
Ofertę przygotowujesz w tym samym edytorze, w którym prowadzisz Allegro. Zdjęcia wysyłamy na CDN TikToka, a przed wysyłką robimy próbne sprawdzenie oferty, żeby nie zakładać u TikToka produktów z błędem. Ofertę możesz też zaktualizować i wycofać ze sprzedaży.
Wynik moderacji widoczny w panelu
TikTok Shop przyjmuje ofertę do audytu, a nie od razu na sprzedaż. Dlatego panel pisze „wysłano do weryfikacji”, dopóki audyt trwa, a po odrzuceniu pokazuje powody podane przez TikToka.
Zamówienia w panelu FIRMSET
Zamówienia z TikTok Shop pobieramy dwiema drogami — powiadomieniem o zmianie statusu i cyklicznym przebiegiem co 15 minut. Widzisz je na własnym ekranie razem z pozycjami, kwotami i terminami, a przez pierwszą godzinę po zapłacie zamówienie jest oznaczone jako wstrzymane, bo kupujący może je jeszcze anulować.
Log wywołań z numerem request_id
Zapisujemy metodę, ścieżkę, kod odpowiedzi i czas trwania — bez tokenów i bez podpisów. Kody błędów TikToka tłumaczymy na komunikaty „co się stało i jak to naprawić”.
Zaufanie
Twoje dane sprzedażowe zostają Twoje
Dane pobrane z TikTok Shop przetwarzamy po to i tylko po to, żeby wykonać w panelu to, o co prosisz.
Przetwarzamy na Twoje polecenie
Wobec danych pobranych z API TikTok Shop FIRMSET działa jako podmiot przetwarzający sprzedawcy. Nie łączymy ich z danymi innych firm i nie odsprzedajemy ich.
Tokeny zaszyfrowane, nigdy w logach
Tokeny dostępu i identyfikator sklepu trzymamy zaszyfrowane w bazie. Log wywołań API nie zapisuje ani tokenów, ani sekretu aplikacji, ani podpisu żądania.
Twarda separacja firm
Dane każdej firmy są odseparowane na poziomie zapytań do bazy, a ten sam sklep TikTok Shop nie może być jednocześnie podpięty u dwóch klientów FIRMSET.
Zgodę cofasz, kiedy chcesz
W panelu FIRMSET rozłączasz konto jednym kliknięciem: tokeny znikają, a wywołania do TikTok Shop się zatrzymują. Autoryzację możesz też cofnąć po stronie TikTok Shop. Usunięcie konta integracji usuwa również zapisane sklepy.
Zanim podłączysz sklep
Zasady przetwarzania danych i warunki korzystania z FIRMSET opisaliśmy w dwóch dokumentach. Oba są publiczne, w polskiej i angielskiej wersji.
Sprawy danych osobowych: biuro@dashstack.pl · FIRMSET jest produktem Dash Stack sp. z o.o.
Jeden panel
TikTok Shop to jeden z kanałów, nie osobny system
Konto integracji zakładasz tam, gdzie masz resztę firmy. Te moduły są w FIRMSET dzisiaj:
Allegro
EmpikPlace
Erli.pl
WooCommerce
Sklep e-commerce FIRMSET
Magazyn WMS
Faktury i KSeF
InPost
Każdy kanał włączasz osobno — płacisz tylko za te, których używasz.
Uczciwie
Czego moduł jeszcze nie robi
Wolimy napisać to wprost, niż obiecać funkcję, której dziś nie znajdziesz w panelu. Poniższych rzeczy moduł TikTok Shop nie wykonuje.
W planie
Synchronizacja stanów magazynowych i cen
W planie
Faktury do zamówień TikTok Shop
W planie
Etykiety i statusy wysyłki
W planie
Automatyczna rejestracja powiadomień po stronie TikTok Shop z poziomu panelu
W planie
Przekazywanie danych GPSR do TikTok Shop
W planie
Zwroty i rozliczenia
Sprzedajesz na TikTok Shop?
Napisz do nas. Powiemy, na jakim etapie jest integracja i co możemy dla Ciebie zrobić już teraz.
TikTok i TikTok Shop są znakami towarowymi swoich właścicieli. FIRMSET jest niezależnym dostawcą oprogramowania i nie jest podmiotem powiązanym z TikTok.