Zakres integracji z TikTok

Integracja z TikTok Shop umożliwia publikowanie i aktualizowanie ofert, synchronizację cen i stanów magazynowych oraz pobieranie zamówień do xSale. Pozwala również przekazywać numer przesyłki dla zamówień wysyłanych przez sprzedawcę. Poniżej opisano zakres wymienianych danych i ograniczenia poszczególnych operacji.

Konfigurację połączenia opisuje Kreator integracji z TikTok.

W tym artykule znajdziesz

Zakres integracji
Obsługa ofert
Dane ofert przesyłane z xSale do TikTok
Pobieranie ofert z TikTok do xSale
Obsługa zamówień i płatności
Dane zamówień pobierane z TikTok do xSale
Warunki pobierania zamówień
Przekazywanie numerów przesyłek
Ograniczenia integracji
Zrzuty xSale
Zrzuty TikTok

Zakres integracji

Obszar	Kierunek	Zakres
Oferty	xSale → TikTok	Tworzenie, aktualizacja i dezaktywacja ofert.
Ceny i stany magazynowe	xSale → TikTok	Aktualizacja cen i dostępnych ilości wariantów.
Istniejące oferty	TikTok → xSale	Pobieranie danych ofert, wariantów i cen oraz stanów ze skonfigurowanego domyślnego magazynu TikTok.
Zamówienia	TikTok → xSale	Pobieranie zamówień oczekujących na wysyłkę, spełniających warunki importu.
Płatności	TikTok → xSale	Pobieranie informacji o opłaceniu zaimportowanych zamówień przedpłaconych.
Numer przesyłki	xSale → TikTok	Przekazanie numeru i przewoźnika dla obsługiwanych zamówień wysyłanych przez sprzedawcę.

Obsługa ofert

xSale umożliwia tworzenie i aktualizowanie ofert oraz synchronizowanie cen i stanów w TikTok. Poniższa tabela zestawia dane przesyłane z xSale do TikTok. Nazwy danych po stronie TikTok opisują ich znaczenie, nie muszą być dosłownymi etykietami w panelu sprzedawcy.

Szczegółowy zakres danych przesyłanych z xSale do TikTok

Pole xSale	Nr na zrzucie xSale	Dane w TikTok	Nr na zrzucie TikTok	Uwagi
Opisy i zdjęcia → Nazwa	1	Podstawowe informacje → Nazwa produktu	1	Nazwa oferty; maksymalnie 255 znaków. Dłuższa nazwa jest skracana podczas wysyłania do TikTok.
Opisy i zdjęcia → Opis	2	Szczegóły produktu → Opis	2	Opis oferty; maksymalnie 10 000 znaków. Dłuższy opis jest skracany podczas wysyłania do TikTok.
Opisy i zdjęcia → Zdjęcia	3	Podstawowe informacje → Obrazy	3	Do 9 głównych zdjęć produktu.
Parametry → Kategorie	4	Podstawowe informacje → Kategoria	4	Końcowa kategoria TikTok dostępna dla sklepu.
Parametry	5	Atrybuty / Zgodność produktu	5 (atrybuty), 5 (zgodność produktu)	Parametry i obsługiwane pliki wymagane przez kategorię TikTok, w tym certyfikaty. Zakres zależy od wybranej kategorii.
Kod	6	Informacje dotyczące sprzedaży → SKU sprzedawcy	6	Dla prostej oferty przekazywany jest kod oferty w xSale. Nie jest to pole Kod towaru widoczne poniżej na zrzucie.
Kod EAN	7	Informacje dotyczące sprzedaży → Kod identyfikacji produktu	7	Identyfikator jest przekazywany jako EAN, UPC lub GTIN, zależnie od jego długości.
Kanały sprzedaży → TikTok → Cena	8	Informacje dotyczące sprzedaży → Cena detaliczna	8	Dodatnia cena brutto w PLN, zaokrąglana do dwóch miejsc po przecinku. Eksport cen w innych walutach nie jest obsługiwany.
Kanały sprzedaży → TikTok → Stan	9	Informacje dotyczące sprzedaży → Stan magazynowy	9	Ilość przekazywana do skonfigurowanego magazynu TikTok. Ujemna ilość jest przekazywana jako 0, a dodatnia ilość ułamkowa jest zaokrąglana w dół do liczby całkowitej.
Parametry sprzedaży → Waga – jednostka / Waga przesyłki	10	Wysyłka → Waga przesyłki	10	Waga jest przekazywana wraz z wybraną jednostką.
Parametry sprzedaży → Wymiar: Długość / Szerokość / Wysokość	11	Wysyłka → Wymiary paczki	11	Długość, szerokość i wysokość w centymetrach.
Towary i warianty	12	Informacje dotyczące sprzedaży → Lista wariantów	12	Obsługiwane są oferty jedno- i wielowariantowe. Oferta może mieć do 300 wariantów (SKU), opisanych maksymalnie trzema cechami, np. kolorem i rozmiarem. Limit 3 widoczny w panelu TikTok dotyczy cech wariantowania, a nie liczby ich kombinacji. Numer 6 na zrzucie dotyczy kodu prostej oferty.
Marka	5	Podstawowe informacje → Marka	5	Marka zgodna ze słownikiem TikTok. Na zrzucie pole Marka jest częścią obszaru oznaczonego numerem 5; nie jest tym samym polem co Producent w sekcji Zgodność produktu.
Parametry sprzedaży → Osoba odpowiedzialna	13	Zgodność produktu → Dodaj podmiot odpowiedzialny	13	Wskazanie osoby odpowiedzialnej zgodnie z wymaganiami kategorii TikTok.
Parametry sprzedaży → Producent	14	Zgodność produktu → Producent	14	Wskazanie producenta zgodnie z wymaganiami kategorii TikTok. To osobne dane od marki produktu.
Parametry sprzedaży → Tabela rozmiarów	15	Tabela rozmiarów		Wskazanie tabeli rozmiarów dla produktu, zgodnie z wymaganiami kategorii TikTok.

Przesłanie danych nie oznacza jeszcze, że oferta jest widoczna dla kupujących. TikTok weryfikuje dane i wymagania dotyczące publikacji. Nieprawidłowa kategoria, brak wymaganych parametrów lub dokumentów mogą uniemożliwić wystawienie oferty.

Pobieranie ofert z TikTok do xSale

Podczas pobierania ofert xSale odczytuje z TikTok ich podstawowe dane, warianty, parametry, ceny i dane paczki. Są to w dużej mierze te same dane, które opisano w tabeli powyżej. Pobieranie ma jednak własne zasady i ograniczenia:

Ceny pobieranych ofert muszą być wyrażone w PLN. Warunek ten dotyczy cen ofert, nie waluty importowanych zamówień.
Stan magazynowy jest pobierany z jednego skonfigurowanego domyślnego magazynu TikTok, a nie jako suma stanów ze wszystkich magazynów.
Identyfikatory produktu i wariantów pochodzą z TikTok. Sposób przypisania kodów zależy od tego, czy pobierana oferta ma jeden, czy wiele wariantów.

Nie każda konfiguracja oferty utworzonej bezpośrednio w TikTok może zostać pobrana do xSale. Import może zostać zatrzymany m.in. dla wariantów z danymi przedsprzedaży lub osobnymi obrazami przypisanymi do cech wariantu. W takim przypadku sprawdź komunikat błędu; jeśli nie wskazuje jednoznacznego rozwiązania, skontaktuj się ze wsparciem xSale.

Obsługa zamówień i płatności

xSale pobiera zamówienia oczekujące na wysyłkę oraz dostępne informacje o płatnościach. Szczegółowy zakres danych i warunki ich pobierania opisano poniżej.

Szczegółowy zakres danych zamówień pobieranych z TikTok do xSale

Dane w TikTok	Nr na zrzucie TikTok	Pole xSale	Nr na zrzucie xSale	Uwagi
Numer zamówienia	1	Nr obcy	1	Identyfikator zamówienia TikTok jest zapisywany jako numer obcy zamówienia w xSale.
Czas utworzenia	2	Data zakupu	2	Data utworzenia zamówienia w TikTok.
Cena pozycji	3	Pozycje zamówienia → Cena	3	Jednostkowa cena sprzedaży brutto udostępniona przez TikTok.
Ilość pozycji	4	Pozycje zamówienia → Ilość	4	Liczba zamówionych sztuk.
SKU sprzedawcy	5	Pozycje zamówienia → Kod oferty	5	Zrzuty pokazują SKU sprzedawcy i kod widocznej oferty. Pozycja jest rozpoznawana na podstawie identyfikatora wariantu nadanego przez TikTok (sku_id), a nie na podstawie SKU sprzedawcy ani kodu EAN.
Suma	6	Podsumowanie zamówienia → Brutto	6	Na zrzutach pokazano kwotę całkowitą po obu stronach. W xSale podsumowanie wynika z pozycji i kosztu dostawy; kwota płatności jest pobierana osobno z danych płatności TikTok.
Adres wysyłki → Nazwa odbiorcy	7	Zamawiający → Nazwa	7	Nazwa lub imię i nazwisko odbiorcy.
Adres wysyłki → Telefon	8	Zamawiający → Telefon	8	Numer telefonu odbiorcy.
Adres wysyłki → E-mail	9	Zamawiający → E-mail	9	Adres e-mail jest pobierany, jeśli TikTok udostępnia go w danych zamówienia.
Adres wysyłki → Ulica	10	Zamawiający → Ulica	10	Ulica i numer z adresu dostawy.
Adres wysyłki → Miejscowość	11	Zamawiający → Miasto	11	Miejscowość z adresu dostawy.
Adres wysyłki → Kod pocztowy	12	Zamawiający → Kod pocztowy	12	Kod pocztowy z adresu dostawy.
Adres wysyłki → Kraj	13	Zamawiający → Kraj	13	Kraj z adresu dostawy.
Nazwa produktu	14	Pozycje zamówienia → Nazwa	14	Nazwa produktu z pozycji zamówienia.
Opis wariantu	15	Pozycje zamówienia → Dodatkowe informacje	15	Opis wariantu, w tym przykładzie Domyślny. Nie jest to opis oferty.
Waluta przy kwocie zamówienia	16	Waluta zamówienia	16	Waluta przekazana w danych płatności zamówienia; na zrzucie widoczna jako symbol zł przy sumie.
Opcje dostawy	17	Sposób dostawy	17	Nazwa sposobu dostawy przekazana przez TikTok. Sposób dostawy w xSale zależy od skonfigurowanego powiązania; jego nazwa może różnić się od nazwy widocznej w TikTok.
Opłata za wysyłkę po uwzględnieniu rabatów	18	Koszt dostawy	18	Koszt dostawy brutto przekazany przez TikTok.
Metoda płatności	19	Forma płatności	19	Nazwa lub kod metody płatności. Jeśli ich brakuje, integracja rozróżnia przedpłatę i pobranie. Formy płatności należy powiązać z odpowiednimi formami w xSale.
Historia zamówień → Zamówienie opłacone	20	Płatność	20	Historia pokazuje informację o opłaceniu i datę zapłaty; kwota jest widoczna osobno w polu Suma (6). Dla zamówienia przedpłaconego xSale pobiera dodatnią kwotę płatności, walutę i datę zapłaty, jeśli są dostępne w TikTok. Zamówienie za pobraniem nie jest na tej podstawie oznaczane jako opłacone.

Główny adres kontrahenta w xSale jest uzupełniany danymi adresu dostawy z zamówienia TikTok. Integracja nie pobiera osobnego kompletu danych do faktury.

Przy imporcie zamówienia rodzaj dokumentu sprzedaży jest ustawiany na paragon. Sam import zamówienia nie oznacza wystawienia dokumentu sprzedaży.

Warunki pobierania zamówień

xSale pobiera zamówienia o statusie oczekujące na wysyłkę (AWAITING_SHIPMENT). Zamówienia, dla których kupujący zgłosił żądanie anulowania, są pomijane.

Do importu potrzebne są kompletne dane odbiorcy: nazwa, telefon, ulica, miasto, kod pocztowy i kraj. Jeśli TikTok nie udostępnia jeszcze wszystkich wymaganych danych, pobranie zamówienia jest odkładane. W części zamówień integracja stosuje dodatkowo godzinny okres oczekiwania, liczony od zapłaty lub utworzenia zamówienia za pobraniem, a przy braku tych informacji od pierwszego wykrycia zamówienia przez xSale.

Wyszukiwanie zamówień uwzględnia datę ich aktualizacji w TikTok, z maksymalnym okresem wstecznym 7 dni. Nie jest to mechanizm pobierania całej historii zamówień sklepu.

Przekazywanie numerów przesyłek

xSale może przekazać do TikTok numer przesyłki wraz z przewoźnikiem dla zamówienia realizowanego przez sprzedawcę. Wymaga to poprawnego numeru zamówienia TikTok, numeru przesyłki i powiązania przewoźnika z przewoźnikiem dostępnym dla wybranej dostawy.

Pierwsze przekazanie dotyczy zamówienia oczekującego na wysyłkę i zgłasza jego wysłanie do TikTok. Obsługiwany jest wariant, w którym wszystkie pozycje zamówienia są wysyłane w jednej paczce. Nie obejmuje to dzielenia zamówienia na kilka paczek ani realizacji wysyłki przez TikTok.

Integracja umożliwia również poprawienie wcześniej przekazanych danych przesyłki dla obsługiwanych statusów wysłanego zamówienia. Sprawdza przy tym limit 72 godzin od oznaczenia zamówienia jako gotowego do wysyłki, a gdy tej daty nie ma, od daty wysłania.

Ograniczenia integracji

Import i eksport cen ofert obsługują PLN. Nie oznacza to ograniczenia waluty pobieranej z zamówienia do PLN.
Integracja nie przesyła faktur ani innych plików dokumentów sprzedaży do TikTok.
Nie obsługuje niezależnego ustawiania dowolnego statusu zamówienia w TikTok. Przekazanie informacji o wysyłce jest osobną operacją opisaną powyżej.
W opisanej ścieżce importu zamówień nie jest pobierany identyfikator punktu odbioru ani osobne dane do faktury.
Nie jest obsługiwane pobieranie korekt zamówień.

Zrzuty xSale

Fragmenty widoku oferty w xSale. Oznaczenia 1–11 odpowiadają numerom w tabeli danych przesyłanych z xSale do TikTok.

Otwórz pełny zrzut oferty xSale w oryginalnym rozmiarze

xSale: kod oferty i EAN (6–7)

xSale: cena i stan w kanale TikTok (8–9)

xSale: kategoria i parametry (4–5)

xSale: zdjęcia oferty (3)

xSale: nazwa i opis oferty (1–2)

xSale: waga i wymiary paczki (10–11)

Warianty i parametry sprzedaży

Oznaczenia 12–15 odpowiadają numerom w tabeli danych przesyłanych z xSale do TikTok.

Zamówienie z TikTok w xSale

Oznaczenia 1–20 wskazują pola opisane w tabeli danych zamówień.

Zrzuty TikTok

Produkt w TikTok Shop

Oznaczenia 1–11 oraz 13–14 odpowiadają numerom w tabeli danych przesyłanych z xSale do TikTok. Numer 5 obejmuje markę, atrybuty i wskazane dane zgodności produktu.

Integracje

W tym artykule znajdziesz

Zakres integracji

Obsługa ofert