# Integracja TikTok Shop i katalogu Pinterest: instalacja i konfiguracja

> Przegląd Moduł łączy sklep PrestaShop 8 lub 9 z dwoma kanałami: TikTok Shop: tworzenie i aktualizacja ofert przez API Partner, wysyłka stanów i cen, import zamówień, wysyłka numerów przesyłek. Pinterest:…

- Strona: <https://www.datafirefly.com/pl/documentation/dftiktokpinterest/>
- Język: pl
- Zaktualizowano: 2026-09-24
- Inne języki: [fr](https://www.datafirefly.com/documentation/dftiktokpinterest/index.md), [en](https://www.datafirefly.com/en/documentation/dftiktokpinterest/index.md), [es](https://www.datafirefly.com/es/documentation/dftiktokpinterest/index.md), [de](https://www.datafirefly.com/de/documentation/dftiktokpinterest/index.md), [it](https://www.datafirefly.com/it/documentation/dftiktokpinterest/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftiktokpinterest/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftiktokpinterest/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Przegląd

Moduł łączy sklep PrestaShop 8 lub 9 z dwoma kanałami:

- **TikTok Shop**: tworzenie i aktualizacja ofert przez API Partner, wysyłka stanów i cen, import zamówień, wysyłka numerów przesyłek.
- **Pinterest**: feed katalogu TSV i opcjonalnie aktualizacje w czasie rzeczywistym przez API Catalogs.

W zestawie jest też feed CSV dla katalogów TikTok Ads. Moduł znajduje się w **Katalog > TikTok & Pinterest**. Zakładka _Przegląd_ pokazuje listę startową z krokami do wykonania.

## Instalacja

1. W **Moduły > Menedżer modułów** kliknij _Prześlij moduł_ i wybierz plik ZIP.
2. Otwórz **Katalog > TikTok & Pinterest**.
3. W zakładce _Ustawienia_ sprawdź język, walutę i kraj używane do cen (ceny są wysyłane z podatkiem tego kraju) oraz rozmiar zdjęć. TikTok Shop wymaga co najmniej 600 x 600 pikseli.

W trybie multistore wybierz jeden sklep w selektorze kontekstu: ustawienia kanałów są zapisywane dla każdego sklepu.

## Pinterest

### Tylko feed, bez aplikacji

1. Zakładka _Pinterest_: włącz Pinterest i skopiuj adres feedu.
2. W Pinterest Business Hub otwórz **Katalogi > Źródła danych**, dodaj źródło i wklej adres. Pinterest importuje feed co 24 godziny.

### Aktualizacje w czasie rzeczywistym przez API

1. Na [developers.pinterest.com](https://developers.pinterest.com/) utwórz aplikację i dodaj adres przekierowania z zakładki Pinterest modułu.
2. Wpisz App ID i App secret, zostaw _Aktualizacje w czasie rzeczywistym_ na Tak i kliknij _Zapisz i połącz Pinterest_.
3. Po połączeniu kliknij _Utwórz źródło danych w Pinterest_: moduł rejestruje feed z walutą i krajem z ustawień.

Zmiany stanów, cen i usunięcia trafiają wtedy do Pinterest w kilka minut. Dwie minuty po każdej wysyłce moduł odczytuje wynik z Pinterest. Odrzucona pozycja jest oznaczana błędem w zakładce _Produkty_ z komunikatem Pinterest.

## TikTok Shop

### Utworzenie aplikacji TikTok Shop

1. Na [partner.tiktokshop.com](https://partner.tiktokshop.com/) utwórz własną aplikację sprzedawcy lub aplikację usługi zewnętrznej.
2. Włącz zakresy **Product**, **Order**, **Fulfillment** i **Logistics**.
3. Jako adres przekierowania podaj adres z zakładki _TikTok Shop_ modułu.
4. Skopiuj App key, App secret i, jeśli aplikacja go ma, Service ID.

### Połączenie sklepu

1. Zakładka _TikTok Shop_: włącz TikTok, wybierz region (Europa i reszta świata albo Stany Zjednoczone), wpisz dane i kliknij _Zapisz i połącz TikTok Shop_.
2. Autoryzuj aplikację na stronie TikTok. Moduł pobiera sklep i domyślny magazyn.
3. Wybierz magazyn, jeśli masz kilka, a następnie producenta i osobę odpowiedzialną dla UE. Jeśli listy są puste, utwórz ich najpierw w Seller Center i kliknij _Odśwież listy_.
4. Kliknij _Wczytaj kategorie_, aby pobrać drzewo kategorii TikTok.

### Ustawienia ofert

- **Wysyłana cena**: po rabatach PrestaShop albo regularna, jeśli promocje prowadzisz w TikTok.
- **Domyślna paczka**: waga i wymiary dla produktów bez tych danych.
- **Twórz nowe oferty**: po wyłączeniu moduł aktualizuje tylko stan i cenę istniejących ofert.

## Oferty już istniejące w TikTok Shop

Jeśli już sprzedajesz w TikTok Shop, uruchom _Powiąż istniejące oferty_ w zakładce TikTok Shop **przed pierwszą synchronizacją**. Moduł łączy oferty z produktami po SKU sprzedawcy:

- indeks kombinacji;
- indeks produktu, dla produktu bez kombinacji;
- format PS12 lub PS12-34 używany przez moduł.

Powiązana oferta zachowuje tytuł, zdjęcia i opis z TikTok: moduł zarządza tylko stanem i ceną. Aby zastosować treść z PrestaShop, otwórz podgląd produktu w zakładce Produkty i kliknij _Zastąp treść danymi z PrestaShop_. Oferta, której SKU wskazują na kilka produktów, jest zgłaszana jako konflikt i nie jest wiązana.

## Mapowanie kategorii

Zakładka _Kategorie_ przypisuje każdej kategorii PrestaShop:

- **kategorię Google**, używaną przez Pinterest i feed TikTok Ads: wpisz kilka słów i wybierz z wbudowanej taksonomii Google;
- **kategorię TikTok Shop**: wpisz, aby wyszukać, lub kliknij _Zaproponuj_, aby TikTok zaproponował kategorię na podstawie produktów.

Podkategoria bez własnego mapowania dziedziczy mapowanie rodzica, pokazane na szaro. Produkty korzystają z kategorii domyślnej. Zmiany zapisuje się razem przyciskiem _Zapisz zmiany_.

Przycisk _Atrybuty_ otwiera atrybuty kategorii TikTok. Oznaczone gwiazdką są wymagane i dotyczą wszystkich produktów kategorii. Mapowanie można eksportować i importować w CSV (separator: średnik).

## Zamówienia TikTok

Zakładka _Zamówienia TikTok_ zapobiega nadsprzedaży: bez importu sprzedaż w TikTok obniża stan tylko w TikTok. Dostępne są trzy tryby:

- **Twórz zamówienia PrestaShop**: każda sprzedaż staje się zamówieniem w cenie zapłaconej w TikTok (po rabacie sprzedawcy) i z kosztem wysyłki TikTok. VAT liczy PrestaShop, stan maleje. Płatność widnieje jako „TikTok Shop” z numerem zamówienia TikTok jako transakcją.
- **Tylko zmniejszaj stan**: dla zamówień wysyłanych z Seller Center lub przez TikTok.
- **Wyłączone**.

Zamówienia są importowane przez cron. Po włączeniu pobierane są zamówienia z ostatnich 24 godzin. Wybierz status nowych zamówień i przewoźnika. Koszt wysyłki pozostaje taki, jak zapłacony w TikTok, niezależnie od przewoźnika.

- **Anulowania**: anulowanie w TikTok zmienia status zamówienia na „Anulowane” lub przywraca stan w trybie tylko stanów.
- **Błędy**: zamówienie z błędem (niepowiązany SKU, nieaktywna waluta) jest widoczne z przyczyną i ponawiane co 15 minut. Przycisk _Ponów_ spróbuje ponownie przy następnym imporcie.
- **Kupujący**: są tworzeni jako klienci-goście z adresem @tiktokshop.invalid. TikTok zabrania kontaktu poza platformą, więc moduł blokuje każdy e-mail skierowany do nich.

Karta zamówienia PrestaShop pokazuje blok TikTok Shop z numerem TikTok, statusem i stanem śledzenia.

## Numery przesyłek

Gdy do zaimportowanego zamówienia zostanie dodany numer przesyłki, ręcznie lub przez moduł przewoźnika, trafia do TikTok w ciągu 5 minut, a zamówienie TikTok zostaje oznaczone jako wysłane. Zamówienia realizowane przez TikTok są pomijane.

TikTok wymaga dostawcy wysyłki. W zakładce TikTok Shop, w sekcji _Przewoźnicy i dostawcy wysyłki TikTok_, przypisz każdego przewoźnika do dostawcy TikTok. Bez przypisania moduł szuka dostawcy o tej samej nazwie. Jeśli go nie znajdzie, błąd wymienia dostępnych dostawców.

## Zakładka Produkty

Każdy wiersz pokazuje miniaturę, cenę, stan, status w każdym kanale i wynik jakości na 100 z głównym problemem. Możliwe przyczyny to:

- brak zdjęcia, cena zero lub krótki opis;
- błędny EAN;
- nieprzypisana kategoria;
- więcej niż 3 grupy atrybutów dla TikTok.

Filtry pokazują produkty z błędami, wykluczone, bez kategorii Google lub TikTok albo powiązane z Seller Center. Zaznacz produkty, aby zbiorczo je eksportować lub wykluczyć, albo zaplanować pełną synchronizację. Podgląd pokazuje warianty tak, jak zostaną wysłane, i pozwala ustawić tytuł dla każdego kanału. _Synchronizuj teraz_ wysyła produkt od razu.

## Ustawienia zaawansowane

- **Parametry UTM**: dodawane do linków feedów i pinów Pinterest, na potrzeby Google Analytics. Zostaw puste, aby wyłączyć.
- **Etykiety niestandardowe**: custom_label_0 = kategoria, custom_label_1 = przedział cenowy, custom_label_2 = promocja lub cena regularna.
- **Reguły wykluczeń**: kategorie (z podkategoriami), marki, minimalna cena brutto, oraz warianty niedostępne usuwane z feedów i z Pinterest. Wykluczony produkt znika z feedów, jest usuwany z Pinterest i dezaktywowany w TikTok Shop. Zmiana reguły ponownie kolejkuje cały katalog.
- **Moment wysyłki**: zaraz po każdej zmianie (hosting PHP-FPM lub LiteSpeed) albo tylko przez cron.

## Zadanie cron

Skopiuj dwie linie z zakładki _Przegląd_ do crontab na hostingu:

- co 5 minut `task=sync`: kolejka, ponowienia, zamówienia TikTok, śledzenie, wyniki Pinterest;
- co godzinę `task=feeds`: ponowne generowanie feedów.

Przegląd pokazuje, czy cron działał w ciągu ostatnich 20 minut. Błąd API jest ponawiany po 2, 4, 8, 16 i 32 minutach.

Token bezpieczeństwa chroni adresy feedów i crona. Po wygenerowaniu nowego zaktualizuj crontab i adresy feedów zapisane w Pinterest i TikTok.

## Logi i rozwiązywanie problemów

Zakładka _Logi_ przechowuje zdarzenia z 30 dni, filtrowane po kanale: Pinterest, TikTok, zamówienia TikTok. Błędy API są zapisywane z pełną odpowiedzią.

- **Produkt nie trafia do TikTok**: sprawdź jego wynik w zakładce Produkty. Brak kategorii TikTok lub produkt wirtualny blokują wysyłkę.
- **Zamówienie TikTok pozostaje z błędem**: SKU sprzedawcy musi odpowiadać indeksowi w PrestaShop albo oferta musi być utworzona przez moduł. Popraw i kliknij _Ponów_.
- **Zmiany pracownika nie są wysyłane**: PrestaShop nie uruchamia hooków modułu dla profilu bez uprawnienia „Wyświetl” do tego modułu. Nadaj je albo użyj _Synchronizuj teraz_ w zakładce Produkty.