Elbuz łączy sklep TikTok Shop kodem powiązania, pobiera produkty do katalogu bazowego, przyjmuje zamówienia i odsyła na platformę ceny oraz stany — sprzedaż na TikToku od razu zmniejsza dostępność we wszystkich kanałach.
Kiedy to się przyda:
- Produkty są już w TikTok Shop — aktywne pozycje trafią do katalogu z ceną, stanem, zdjęciami i kategorią.
- Udany live opróżnia magazyn w godzinę — zamówienia stają się dokumentami, a stan na TikToku aktualizuje się z Elbuz.
- Katalog prowadzisz w Elbuz — nowe produkty są publikowane w TikTok Shop razem ze zdjęciami.
Od czego zacząć: utwórz szablon typu „TikTok Shop” i połącz sklep kodem.
Co potrafi połączenie z TikTok Shop
- Powiązanie kodem — bez rejestracji aplikacji, kluczy i podpisów.
- Import aktywnych produktów — nazwa, opis, SKU, cena, stan jako suma ze wszystkich magazynów, kategoria i zdjęcia.
- Zamówienia — historia przy pierwszym uruchomieniu, dalej tylko zmienione.
- Ceny i stany z powrotem na TikTok — stan na wybrany magazyn.
- Publikacja nowych produktów — Elbuz sam przesyła zdjęcia i tworzy kartę.
Czego potrzeba od TikTok Shop
Rejestrować aplikacji w TikToku i zajmować się kluczami i podpisami nie trzeba. Formularz szablonu ma kartę instalacji aplikacji: klikasz „Połącz”, potwierdzasz dostęp do swojego sklepu i wpisujesz krótki kod powiązania. Dalej Elbuz działa w Twoim imieniu, a dostęp przedłuża się sam.
Karta „Połączenie” ma dwa pola, oba nieobowiązkowe:
| Pole | Po co |
|---|---|
| magazynu | Tu wygodnie sprawdzić identyfikator magazynu: przycisk „Wybierz z listy” pokazuje magazyny Twojego panelu |
| Waluta publikacji | Kod waluty, np. USD. Na eksport i publikację to pole nie wpływa — walutę ustala szablon eksportu |
Magazyn i walutę dla stanów i publikacji ustala szablon eksportu „TikTok Shop”, pole „Wersja API (parametry platformy)”. Format — ID magazynu i kod waluty rozdzielone pionową kreską, np. 74012345|USD.
- Pole puste — magazyn domyślny z panelu i domyślna waluta sklepu w Elbuz.
- Podano tylko magazyn — domyślna waluta sklepu.
W TikTok Shop stan jest prowadzony według magazynów. Elbuz aktualizuje jeden magazyn — podany w polu „Wersja API (parametry platformy)” szablonu eksportu, a bez niego — magazyn domyślny. Sprzedajesz z konkretnego magazynu — podaj go wprost, inaczej liczby w panelu i w Elbuz się rozjadą.
Jeśli magazynu nie podano, a Elbuz nie znalazł w TikTok Shop magazynu domyślnego, na platformę idą tylko ceny: w dzienniku „TikTok Shop: nie znaleziono magazynu (warehouse) — stany nie zostały zaktualizowane, tylko ceny…”. Nowe produkty bez magazynu nie są publikowane.
Przycisk „Wybierz z listy” pod polem „ID magazynu” w szablonie importu pobiera magazyny z TikTok Shop i pokazuje je z typem i oznaczeniem magazynu domyślnego. Znalezione ID przenieś do pola „Wersja API (parametry platformy)” szablonu eksportu.
Jak połączyć krok po kroku
- Utwórz szablon typu „TikTok Shop” i zapisz go — powiązanie działa dla zapisanego szablonu. „Aktywny” i „Zamówienia” są w nowym szablonie już włączone: 5 minut po powiązaniu Elbuz zacznie pobierać historię zamówień. Statusy platformy Elbuz sam dopasowuje do Twoich, po nazwie; co przyszło i jak dopasowano, widać w oknie „Statusy zamówienia” szablonu. Chcesz najpierw sprawdzić — odznacz „Zamówienia”.
- Kliknij „Połącz”, potwierdź dostęp do sklepu, skopiuj krótki kod i od razu wklej go do formularza: kod jest ważny krótko.
- Kliknij „Sprawdź połączenie” — w odpowiedzi powinna być nazwa Twojego sklepu.
- Kliknij „Wybierz z listy” pod polem magazynu i zapisz potrzebny magazyn w polu „Wersja API (parametry platformy)” szablonu eksportu.
- Zaznacz, co importować, uruchom szablon ręcznie i porównaj z panelem kilka kart i zamówień. Gdy liczby się zgadzają — ustaw katalog w harmonogramie.
Powiązanie jest jedno na konto TikTok Shop: połączono w szablonie importu — szablon eksportu działa z tym samym dostępem i odwrotnie. Przycisk „Połącz” i pole „Kod powiązania” są w obu szablonach.
Co trafia do karty
Elbuz pobiera aktywne produkty sklepu. Najpierw czyta listę, potem dla każdego produktu — pełną kartę, więc zapytań jest więcej niż produktów, a duży katalog importuje się wyraźnie długo.
| Dane TikTok Shop | Pole produktu w Elbuz |
|---|---|
| nazwa produktu | Nazwa |
| opis | Opis |
| kod sprzedawcy (seller ) | SKU |
| cena pozycji | Cena |
| stany według magazynów | Ilość (suma ze wszystkich magazynów) |
| stan produktu | Status: aktywny — produkt włączony |
| kategoria TikTok | Kategoria |
| zdjęcia główne | Zdjęcia (jeśli zaznaczono pole) |
Cechy i kategorie
Z TikTok Shop nie przychodzą cechy produktu. Jeśli katalog w Elbuz jest dla Ciebie główny, uzupełnij cechy u siebie — dalej trafią do kanałów, które ich wymagają.
Kategoria przychodzi kodem liczbowym, a zrozumiałą nazwę Elbuz bierze ze słownika kategorii TikTok. Słownik pobiera przycisk „Pobierz słownik platformy” w oknie dopasowania kategorii. Dopóki go nie ma, produkty trafiają do kategorii źródła — rozłóż je w swoim drzewie, a aktualizacje będą tam trafiać.
Produkt zniknął z TikTok Shop albo go wyłączono
Elbuz prosi platformę tylko o produkty w stanie „aktywny”. Wycofana ze sprzedaży, wyłączona, usunięta lub wysłana do weryfikacji pozycja nie trafia do przebiegu i z kartą w Elbuz nic się nie dzieje: ostatnia cena, ilość i znacznik „włączone” zostają. Jedyny sygnał — podsumowanie „katalog zaimportowany, produktów: …” będzie mniejsze.
Druga strona medalu: jeśli wyłączysz produkt u siebie, a na platformie żyje, następny przebieg znów go włączy. Utrzymać swoją wartość można przełącznikiem „Nie aktualizuj” w karcie produktu, sekcja „Ochrona podczas importu”: takiej karty przebieg nie nadpisuje wcale. „Stała cena” chroni tylko cenę.
1
Nie aktualizuj2
Stała cena- „Nie aktualizuj” — przebieg importu pomija całą kartę produktu.
- „Stała cena” — przebieg importu nie zmienia ceny w karcie.
Powiązanie karty z platformą zostaje także wtedy, gdy produktu na TikToku już nie ma. Eksport dalej wysyła do niego cenę i stan; odmowę platformy widać w dzienniku wierszem „TikTok Shop: błąd eksportu” z nazwą produktu.
Jak przychodzą zamówienia
Pierwsze uruchomienie przenosi historię, dalej pobierane są zamówienia zmienione od poprzedniego uruchomienia; już zaimportowane są aktualizowane, a nie dublowane. Pozycja, której nie ma w katalogu, staje się nową kartą w osobnej kategorii „Produkty - tiktok - …”.
Do dokumentu trafiają:
- numer zamówienia, daty utworzenia i zmiany, status;
- imię i nazwisko odbiorcy, telefon, e-mail klienta, wiadomość od klienta;
- adres dostawy w jednym wierszu z kodem pocztowym i kodem regionu, firma kurierska;
- waluta, znacznik płatności, sposób płatności.
TikTok oddaje zamówienie osobnymi sztukami towaru, bez pola „ilość”. Elbuz łączy jednakowe sztuki w jedną pozycję: trzy takie same produkty stają się jedną pozycją z ilością trzy. Kwota pozycji to cena pomnożona przez ilość, więc suma zamówienia się zgadza.
Jak ceny i stany wracają do TikTok Shop
Kierunek zwrotny to osobny szablon eksportu typu „TikTok Shop”. Cena i stan idą dwoma różnymi wywołaniami na każdą pozycję, stan — na konkretny magazyn. Klucze do tego Elbuz zapamiętuje przy imporcie katalogu, więc najpierw raz zaimportuj katalog z TikToka, a potem konfiguruj eksport.
Jeśli magazynu nie ustalono (pole „Wersja API (parametry platformy)” puste, a panel nie oddał magazynu domyślnego), stany nie są wysyłane, aktualizują się tylko ceny; w dzienniku — czerwony wiersz o tym (rozwiązywanie problemów).
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Pozycja trafia do eksportu według flagi „Eksportuj do pliku (do sklepu)” i stanu kategorii: musi być aktywna i oznaczona do eksportu. Wyłączona „Aktywność” produktu nie zatrzymuje aktualizacji na TikToku. Wyłączyć produktu na platformie Elbuz nie potrafi — na zewnątrz idą tylko cena i stan; wycofać pozycję ze sprzedaży można, zerując stan.
Kilka magazynów, kilka sklepów
- Stan przychodzi jako suma, a wraca na jeden magazyn. Jeśli magazynów jest więcej niż jeden, po cyklu „import — eksport” liczby w panelu nie będą tymi, na które liczysz.
- Ochrona działa w jedną stronę. „Nie aktualizuj” i „Stała cena” zabraniają zapisu w karcie, ale cena i stan tej karty dalej idą na TikTok.
- Klucze produktu mogą przyjść z innego połączenia. Jeśli w szablonie brakuje klucza, Elbuz szuka go wśród wszystkich połączeń TikTok konta. Przy dwóch sklepach TikTok aktualizacja może trafić do produktu innego sklepu.
Gdy produkt prowadzi także inne źródło, w polu zostaje wartość przebiegu, który zakończył się ostatni: priorytetu źródeł nie ma (dwa szablony dla tego samego produktu).
Publikacja nowych produktów
Z zaznaczonym polem „Publikuj nowe produkty” w szablonie eksportu Elbuz zakłada w TikTok Shop karty produktów, które nie są jeszcze powiązane z platformą. Platforma nie przyjmuje zdjęć po linku, więc Elbuz pobiera obrazy i przesyła je, a potem tworzy produkt z nazwą, opisem, kategorią, wagą opakowania, SKU, ceną i stanem.
Cena idzie w walucie z pola „Wersja API (parametry platformy)”, a bez niej — w domyślnej walucie sklepu.
- Kategoria TikTok jest dopasowana do kategorii produktu — bez niej karta jest pomijana.
- Udało się przesłać choć jedno zdjęcie — bez obrazu platforma nie przyjmie produktu. Idzie do 9 zdjęć.
- Niezerowy stan — produkt z zerowym stanem jest pomijany.
- Magazyn jest ustalony — bez niego publikacja w ogóle się nie zaczyna.
Każde pominięcie widać w dzienniku osobnym wierszem z nazwą produktu, a dla zerowego stanu — wspólnym licznikiem. Jeśli waga nie jest podana, do karty trafi 0,5 kg.
Opublikowany produkt dostaje powiązanie z platformą i flagę „Wyeksportowano”. Wycofać ani usunąć karty na TikToku Elbuz nie potrafi — robi się to w panelu platformy.
Aktualizacja według harmonogramu
TikTok Shop nie wysyła natychmiastowych powiadomień, więc zamówienia Elbuz pobiera sam co 5 minut, jeśli w szablonie zaznaczono „Zamówienia” i sklep jest powiązany — fala zamówień podczas live’a nie czeka. Robi to wspólne zadanie „Zamówienia z marketplace’ów” w oknie „Harmonogram zadań”, tam też zmienia się interwał. Katalog w tym przejściu się nie importuje, a zamówienia pobrane także harmonogramem szablonu się nie dublują.
Katalog aktualizuje harmonogram samego szablonu — przycisk „Ustawienia harmonogramu” w formularzu szablonu. Raz na dobę, np. w nocy, wystarczy: dopóki trwa import katalogu, przejście zamówień jest pomijane do następnego. Ogólne zasady harmonogramu i wyłączania szablonu: przegląd importu.
Jak sprawdzić, że przebieg się wykonał
Dziennik przebiegu otwiera się w Centrum operacji, okno szablonu można zamknąć. Połączenie TikTok zapisuje w dzienniku liczby:
| Wiersz dziennika | Co oznacza |
|---|---|
| „TikTok Shop: pobrano produktów: …” | po każdej stronie listy, narastająco |
| „TikTok Shop: katalog zaimportowany, produktów: …” | ile aktywnych produktów oddała platforma i trafiło do katalogu |
| „TikTok Shop: zaimportowano zamówień: …” | po każdej stronie zamówień, narastająco |
| „TikTok Shop: błąd API —” (czerwony) | odmowa platformy; ta część przebiegu się urywa, ale operacja i tak zakończy się komunikatem „Import danych zakończony!” |
| „TikTok Shop: zaktualizowano produktów: …” | eksport, co 50 zaktualizowanych pozycji |
| „TikTok Shop: ceny i stany zaktualizowane, produktów: … (błędów: …)” | podsumowanie eksportu; błędy — pozycje, przy których platforma odmówiła choć w jednym z dwóch wywołań |
| „TikTok Shop: utworzono nowych produktów: … (błędów: …)” | podsumowanie publikacji |
| „TikTok Shop: opublikowano produkt „…” (ID …)” | po tym ID łatwo znaleźć kartę w panelu |
Czerwone wiersze nie oznaczają karty operacji jako błędnej — szukaj ich wzrokiem. Wierszy „Sprawdzanie integralności danych” i „Indeksowanie produktów” w przebiegu TikTok nie ma: tę pracę ścieżka katalogowa wykonuje bez osobnych wierszy.
Jeśli zapytanie o pełną kartę się nie powiodło, przebieg się nie zatrzymuje i nie zapisuje wiersza — karta jest budowana z krótkiego wpisu listy. Bez bloku wariantów cena i ilość przychodzą jako zera: zerowa cena się nie zapisze, a ilość 0 — zapisze. Po przebiegu z awariami platformy przejrzyj w tabeli „Produkty” wynik filtrowania po dzisiejszej „Dacie aktualizacji”.
Ile to trwa
Limitu liczby produktów ani zamówień nie ma: strony są czytane, dopóki platforma oddaje następną. Ile trwa Twój katalog, widać w kolumnie „Czas trwania” listy szablonów i w ostatnim wierszu dziennika.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
| Co jest ograniczone | Wartość |
|---|---|
| Rozmiar strony | 100 produktów lub 100 zamówień na jedno zapytanie |
| Zapytania przy imporcie katalogu | jedno na stronę listy plus jedno na każdy produkt |
| Partia zapisu do katalogu | 500 produktów |
| Oczekiwanie na odpowiedź na jedno zapytanie | 120 sekund; na nawiązanie połączenia — 30 |
| Przekroczony limit zapytań platformy | trzy próby z pauzami 2, 4 i 6 sekund; dalej na stronie listy przebieg zatrzymuje się z błędem, przy pełnej karcie — brany jest krótki wpis, przy eksporcie błąd dostaje tylko ta pozycja |
| Zapytania na pozycję przy eksporcie | dwa: osobno stan, osobno cena |
| Zdjęcia przy publikacji | nie więcej niż 9 na produkt, na pobranie każdego — do 60 sekund |
| Przycinanie pól przy publikacji | nazwa — 255 znaków, opis — 10 000, SKU — 50 |
Scenariusze
1
Pole „Produkty”2
Pole „Zdjęcia”3
Pole „Zamówienia”- „Produkty” — import katalogu produktów.
- „Zdjęcia” — import zdjęć produktów.
- „Zamówienia” — odbiór zamówień z platformy.
Wprowadzić produkty sklepu TikTok do katalogu bazowego
Co włączyć. W karcie „Wybór danych do importu” — „Produkty”, a dla obrazów także „Zdjęcia”.
Efekt. Aktywne produkty przyjdą z nazwą, opisem, SKU, ceną, stanem jako sumą ze wszystkich magazynów i kategorią, a każda karta dostanie klucze do eksportu. Cechy nie przyjdą; ponowne uruchomienie nie tworzy duplikatów.
Przyjmować zamówienia z TikToka bez przebiegu katalogu
Co włączyć. Tylko „Zamówienia”, „Produkty” odznacz. Harmonogram szablonu nie jest potrzebny: zamówienia przychodzą same co 5 minut.
Efekt. Pierwszy przebieg przeniesie historię, kolejne biorą zmienione zamówienia. Ceny i stany istniejących kart ten szablon nie zmienia, a pozycja, której nie ma w katalogu, stanie się nową kartą w kategorii „Produkty - tiktok - …”.
Utrzymać w karcie swoją cenę albo całą kartę
Co włączyć. W karcie produktu, sekcja „Ochrona podczas importu”, — „Stała cena” lub „Nie aktualizuj”.
Efekt. Ze „Stałą ceną” przebieg nie nadpisze ceny, a nazwa, opis i stan będą się aktualizować; z „Nie aktualizuj” karta nie zostanie nadpisana wcale. Cena i stan karty dalej będą szły na TikTok.
Aktualizować na TikToku ceny i stany produktów, które już się tam sprzedają
Co włączyć. Najpierw choć raz uruchom import z polem „Produkty”, potem utwórz szablon eksportu typu „TikTok Shop” z polem „Produkty”.
Efekt. Na każdy produkt pójdą dwa zapytania: stan na magazyn i cena. Nazwa, opis i zdjęcia na TikToku się nie aktualizują, a produkt bez kluczy platformy bez publikacji jest pomijany bez komunikatu.
Co zrobić, gdy TikTok Shop nie oddaje lub nie przyjmuje danych
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „TikTok Shop: połącz sklep przyciskiem „Połącz” (kod powiązania)” | Szablon nie ma dostępu do sklepu: powiązania nie dokończono albo je cofnięto | Przejdź powiązanie od nowa i sprawdź przyciskiem „Sprawdź połączenie” (jak połączyć) |
| „Sprawdź połączenie” nie pokazuje nazwy sklepu | Kod powiązania jest ważny krótko i mógł wygasnąć | Powtórz łączenie i od razu wklej nowy kod (jak połączyć) |
| „TikTok Shop: błąd API —” i tekst od platformy | Platforma odpowiedziała odmową; przebieg zatrzymał się w tym miejscu, wcześniejsze partie po 500 produktów są już w katalogu | Przeczytaj tekst po myślniku i uruchom szablon jeszcze raz — powtórka jest bezpieczna (jeśli przebieg został przerwany) |
| Przebieg zamówień urwał się w połowie | Znacznik „skąd kontynuować” aktualizuje się po każdej zapisanej stronie | Uruchom ponownie: ostatnie zamówienia przyjdą drugi raz i się zaktualizują, a nie zdublują |
| „Operacja przerwana przez użytkownika!”, a w podsumowaniu mniej produktów | „Zatrzymaj” działa po bieżącej stronie (do 100 produktów lub zamówień); zebrane trafia do katalogu z narzutem | Resztę zaktualizuje następny przebieg (zatrzymanie przebiegu) |
| „TikTok Shop: nie znaleziono magazynu (warehouse) — publikacja jest niemożliwa” albo „… — stany nie zostały zaktualizowane, tylko ceny” | Ani w szablonie eksportu, ani w panelu nie znalazł się magazyn: nowe produkty nie są tworzone, w istniejących aktualizują się tylko ceny | Znajdź magazyn przyciskiem „Wybierz z listy” pod polem „ID magazynu” i wpisz jego ID w polu „Wersja API (parametry platformy)” szablonu eksportu (czego potrzeba) |
| Stany w panelu nie zgadzają się z Elbuz albo trafiły na zły magazyn | Aktualizowany jest dokładnie jeden magazyn — z pola „Wersja API (parametry platformy)” albo domyślny; innych Elbuz nie czyści | Wpisz właściwy magazyn i uruchom eksport jeszcze raz; na błędnym magazynie usuń stany w panelu ręcznie (kilka magazynów) |
| „TikTok Shop: „…” — kategoria nie jest powiązana z TikTok, produkt nie został utworzony” | Do kategorii produktu nie dopasowano kategorii TikTok | Dopasuj kategorię; jeśli słownik jest pusty, najpierw „Pobierz słownik platformy” w oknie dopasowania (publikacja) |
| „TikTok Shop: „…” — brak zdjęcia (TikTok wymaga co najmniej jednego), produkt nie został utworzony” | Nie udało się pobrać ani przesłać na platformę żadnego obrazu produktu | Dodaj zdjęcie dostępne pod linkiem i powtórz eksport (publikacja) |
| „TikTok Shop: nie opublikowano nowych produktów: …” | Nie dopasowano kategorii albo brak zdjęcia; które produkty pominięto — w wierszach powyżej, z nazwami | Popraw to, co wskazują te wiersze, i powtórz eksport (publikacja) |
| Katalog wciągnął zbędne pozycje albo nadpisał Twoje poprawki | Sytuacja wspólna dla wszystkich źródeł, zbiorczego cofnięcia wartości nie ma | Produkty szablonu wybierz kolumną „Źródło: nazwa”, a dotknięte — „Data aktualizacji” (jeśli zaimportowano nie to) |
Najczęstsze pytania
Dlaczego produkty nie mają cech?
TikTok Shop nie przekazuje atrybutów tym kanałem. Cechy uzupełnia się w Elbuz i stamtąd idą do innych kanałów (cechy).
Dlaczego w pozycji zamówienia ilość wynosi trzy, a w panelu są trzy wiersze?
TikTok oddaje zamówienie osobnymi sztukami, bez ilości. Elbuz łączy jednakowe sztuki w jedną pozycję, a suma się zgadza (zamówienia).
Produkt zniknął z TikTok Shop — co będzie z kartą w Elbuz?
Nic: karta zostaje z ostatnią ceną, ilością i znacznikiem „włączone” (znikające produkty).
Wyłączono produkt w Elbuz — dlaczego dalej sprzedaje się na TikToku?
Wyłączona „Aktywność” nie zatrzymuje eksportu, a wyłączyć produktu na platformie Elbuz nie potrafi. Wyzeruj stan albo wycofaj produkt w panelu (eksport).
Dlaczego katalog importuje się tak długo?
Dla każdego produktu Elbuz osobno pobiera pełną kartę. Katalogowi wystarczy uruchomienie raz na dobę, w nocy; zamówienia Elbuz pobiera osobno co 5 minut (ile to trwa).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → nowy szablon typu „TikTok Shop”
- Inne wejścia
- Słowniki → Operacje → Eksport danych — szablon dla cen i stanów
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Przygotuj
- dostęp sprzedawcy do panelu TikTok Shop
1
Pole „ID magazynu”2
Pole „Waluta publikacji”- „ID magazynu” — zostaw puste, aby użyć domyślnego magazynu TikTok Shop.
- „Waluta publikacji” — waluta, w której publikowane są produkty (domyślnie USD).
Powiązane tematy
- Jeśli potrzebujesz ogólnego mechanizmu importu — harmonogram, przerwanie, kategorie techniczne: przegląd importu danych.
- Jeśli przyjmujesz zamówienia także z innych platform: import zamówień przez API.
- Jeśli trzeba podłączyć inne źródło katalogu przez API: import katalogu przez API.
