TikTok Shop — торговий майданчик усередині TikTok: товари продаються прямо з відео, стрімів і вітрини магазину. Продавець створює картки сам, тож Elbuz працює з ним у повному циклі: забирає товари в базовий каталог, приймає замовлення, оновлює ціни й залишки, а за потреби публікує нові товари.
Загальний порядок для всіх API-джерел каталогу — в огляді імпорту каталогу через API, спільні правила замовлень — в огляді імпорту замовлень. Тут — те, що стосується TikTok Shop.
Де це у програмі
У вікні завантаження створіть шаблон і оберіть тип «TikTok Shop». Файл не потрібен: підключення відбувається прив'язкою магазину.
1
Поле «ID складу»2
Поле «Валюта для публікації»- Поле «ID складу» — якщо залишити порожнім, використається склад за замовчуванням.
- Поле «Валюта для публікації» — валюта товарів, що публікуються в TikTok Shop, за замовчуванням USD.
Як підключити: код прив'язки
Реєструвати застосунок у TikTok і розбиратися з ключами й підписами не потрібно. У формі шаблону є картка встановлення застосунку: натискаєте «Підключити», підтверджуєте доступ до свого магазину TikTok і вводите короткий код прив'язки. Далі Elbuz працює від вашого імені, а доступ продовжується сам.
У картці «Підключення» два поля, обидва необов'язкові:
| Поле | Навіщо |
|---|---|
| ID складу | Тут зручно дізнатися ідентифікатор складу: кнопка «Обрати зі списку» показує склади вашого кабінету |
| Валюта для публікації | Код валюти, наприклад USD. На вивантаження й публікацію це поле не впливає — валюту задає шаблон вивантаження, див. нижче |
Склад і валюту, з якими Elbuz оновлює залишки й публікує нові товари, задає шаблон вивантаження «TikTok Shop»: у його картці підключення є поле «Версія API (параметри майданчика)». Формат — ID складу і код валюти через вертикальну риску, наприклад 74012345|USD. Поле можна лишити порожнім: тоді візьметься склад за замовчуванням із вашого кабінету й валюта магазина за замовчуванням в Elbuz. Можна вказати тільки склад — валюта теж буде валютою магазина.
Кнопка «Перевірити підключення» у відповідь показує назву вашого магазину — найшвидший спосіб переконатися, що прив'язка спрацювала.
У TikTok Shop залишок ведеться по складах: одна й та сама позиція може мати різну кількість у різних локаціях. Elbuz оновлює залишок на одному складі — тому, що вказаний першим у полі «Версія API» шаблону вивантаження, а якщо там порожньо, на складі за замовчуванням. Якщо у вас кілька складів і торгівля йде з конкретного, вкажіть його явно, інакше цифри в кабінеті й в Elbuz розійдуться.
Шукати ідентифікатор у кабінеті не потрібно: під полем «ID складу» в шаблоні завантаження є кнопка «Обрати зі списку» — Elbuz запитує склади у самого TikTok Shop і показує їх переліком. У назві видно тип складу й позначку складу за замовчуванням, тож два схожі склади не переплутати. Знайдений ID перенесіть у поле «Версія API» шаблону вивантаження.
Як підключити крок за кроком
Створіть шаблон типу «TikTok Shop» і збережіть його — прив'язка працює вже для збереженого шаблону. Натисніть «Підключити», підтвердіть доступ до магазину, скопіюйте короткий код і вставте його у форму. Переконайтеся кнопкою «Перевірити підключення», що у відповіді видно назву вашого магазину.
Одразу після прив'язки натисніть «Обрати зі списку» під полем складу: якщо складів у кабінеті кілька, потрібний краще зафіксувати відразу в полі «Версія API» шаблону вивантаження — інакше залишок оновлюватиметься не там, де ви очікуєте. Далі позначте, що завантажувати, запустіть шаблон вручну й перевірте перші результати очима: кілька карток і кілька замовлень. Коли цифри сходяться з кабінетом, ставте завдання на розклад.
Що приходить у каталог
Elbuz забирає активні товари магазину. Спершу читається список, потім по кожному товару запитується повна картка — саме тому завантаження великого каталогу помітно повільніше, ніж могло б здаватися: запитів виходить більше, ніж самих товарів.
| Дані TikTok Shop | Поле товару в Elbuz |
|---|---|
| назва товару | Назва |
| опис | Опис |
| артикул продавця (seller SKU) | Артикул |
| ціна позиції | Ціна |
| залишки по складах | Кількість (сумою за всіма складами) |
| стан товару | Статус: активний — увімкнений товар |
| категорія TikTok | Категорія |
| головні зображення | Фотографії (якщо ввімкнено галочку) |
З TikTok Shop не приходять характеристики товару — назва, опис, ціна, залишок, фото й категорія є, атрибутів немає. Якщо каталог в Elbuz для вас основний, заповніть характеристики у себе: далі вони роз'їдуться на інші канали, де вони потрібні.
Категорія приходить числовим кодом. Зрозуміле ім'я Elbuz бере з довідника категорій TikTok. Сам при підключенні він не наповнюється — його завантажує кнопка «Завантажити довідник майданчика» у вікні зіставлення категорій. Поки довідника немає, товари лягають у категорію джерела — розкладіть їх по своєму дереву, далі оновлення потраплятимуть саме туди.
Що буде з товаром, який зник із TikTok Shop
Elbuz просить у майданчика список товарів зі станом «активний» — інших у відповіді немає взагалі. Тому позиція, яку ви зняли з продажу, вимкнули, видалили чи відправили на перевірку, у прогін просто не потрапляє.
З карткою в Elbuz при цьому не відбувається нічого. Оновлюється тільки те, що приїхало, а решта лишається такою, якою її записав попередній вдалий прогін: остання ціна, остання кількість, ознака «увімкнено». Картка не деактивується, залишок не обнуляється, окремого рядка в журналі про неї не буде. Єдина ознака — підсумкове число: «каталог завантажено, товарів: …» стане меншим, ніж було минулого разу.
Зворотний бік того самого правила стосується вашої власної позначки активності. Ознака «увімкнено/вимкнено» приходить із TikTok, а приходять звідти тільки активні товари — тож якщо ви вимкнули товар у себе, а на майданчику він живий, наступний прогін каталогу знову його ввімкне. Утримати своє значення можна лише перемикачем «Не оновлювати» в картці товару, секція «Захист під час імпорту»: така картка прогоном не переписується взагалі.
1
Не оновлювати2
Фіксована ціна- Не оновлювати — завантаження TikTok пропускає картку цілком.
- Фіксована ціна — завантаження TikTok не змінює ціну картки.
Прив'язка картки до майданчика нікуди не дівається навіть тоді, коли товару в TikTok уже немає. Шаблон вивантаження далі шле на цей товар оновлення ціни й залишку, і якщо майданчик відповість відмовою, у журналі вивантаження стане рядок «TikTok Shop: помилка вивантаження» з назвою товару й текстом відмови.
Замовлення
Перший запуск переносить історію, далі забираються замовлення, змінені з моменту минулого запуску; вже завантажені при цьому оновлюються, а не дублюються.
У документ потрапляють номер замовлення, дати створення й зміни, ім'я одержувача, телефон, пошта покупця, адреса доставки одним рядком з індексом і кодом регіону, валюта, повідомлення покупця, статус замовлення, ознака оплати, спосіб оплати й служба доставки.
У цій версії API TikTok віддає замовлення окремими одиницями товару, без поля «кількість» у рядку. Elbuz збирає однакові одиниці в одну позицію й рахує кількість за числом рядків: три однакові товари у замовленні перетворюються на одну позицію з кількістю три. Сума позиції рахується як ціна помножена на цю кількість, тож підсумок замовлення сходиться.
Оновлення цін і залишків
Зворотний напрямок — окремий шаблон вивантаження типу «TikTok Shop». Ціна й залишок надсилаються двома різними викликами на кожну позицію (так влаштований API майданчика), причому залишок — на конкретний склад. Ключі, за якими це робиться, Elbuz запам'ятовує ще на завантаженні каталогу, тому найнадійніший порядок такий: спершу один раз завантажити каталог із TikTok, потім налаштовувати вивантаження.
Якщо склад не вдалося визначити — у полі «Версія API» порожньо, а склад за замовчуванням кабінет не віддав, — залишки не надсилаються зовсім, оновлюються лише ціни. На початку вивантаження в журналі стає червоний рядок «TikTok Shop: не знайдено склад (warehouse) — залишки не оновлено, лише ціни. Вкажіть ID складу в шаблоні або налаштуйте склад у кабінеті TikTok».
Публікація нових товарів
Якщо в шаблоні вивантаження ввімкнено галочку «Публікувати нові товари», Elbuz заводить у TikTok Shop нові картки для товарів, які ще не прив'язані до майданчика. Фотографії майданчик за посиланням не приймає, тому Elbuz скачує зображення й заливає їх у TikTok, а вже потім створює товар — з назвою, описом, категорією, вагою упаковки, артикулом, ціною й залишком на складі. Ціна йде у валюті з поля «Версія API» шаблону вивантаження, а якщо її там немає — у валюті магазина за замовчуванням.
Категорія TikTok має бути зіставлена для категорії товару — без неї картка пропускається. Потрібна хоча б одна фотографія, яку вдалося завантажити, — товар без зображення майданчик не прийме. Має бути визначений склад — або вказаний у полі «Версія API» шаблону вивантаження, або доступний за замовчуванням. Пропуск через категорію чи фото видно в журналі операції окремим рядком з назвою товару, тож розібратися, чому саме цей товар не поїхав, можна відразу. Без складу публікація не починається взагалі, і про це теж є рядок у журналі.
Як побачити, що прогін відпрацював
Журнал прогону відкривається в Центрі операцій — правій панелі, яка не блокує роботу. У TikTok-підключення в ньому свої рядки, і в них стоять числа, а не просто «готово».
Каталог. Після кожної сторінки списку стає рядок «TikTok Shop: отримано товарів: …» з наростаючим підсумком, у кінці — «TikTok Shop: каталог завантажено, товарів: …». Це число означає, скільки активних товарів віддав майданчик і скільки пішло в базовий каталог. Далі — спільний для всіх завантажень рядок «Оновлення значень на основі формул» і остання строка «Завантаження даних завершено!» з приписом «Витрачено часу». Рядків «Перевірка цілісності даних» та «Індексування товарів» у TikTok-прогоні немає: цю роботу каталожний шлях робить сам, не називаючи її в журналі.
Замовлення. Рядок «TikTok Shop: завантажено замовлень: …» — теж після кожної сторінки й теж наростаючим підсумком.
Відмова майданчика пишеться туди ж червоним: «TikTok Shop: помилка API —» і далі текст відмови від самого TikTok. Та частина прогону, на якій це сталося — каталог чи замовлення, — на цьому й обривається. Картку операції такий рядок помилковою не робить: наприкінці однаково стає «Завантаження даних завершено!», тож червоні рядки в журналі доводиться шукати очима.
Вивантаження веде свій рахунок. Рядок «TikTok Shop: оновлено товарів: …» стає в журнал на кожні п'ятдесят успішно оновлених позицій, підсумок виглядає як «TikTok Shop: ціни та залишки оновлено, товарів: … (помилок: …)» — у другому числі ті позиції, на яких майданчик відмовив хоча б в одному з двох викликів. Публікація рахується окремо: «TikTok Shop: створено нових товарів: … (помилок: …)», а те, що пропущено без спроби, — рядком «TikTok Shop: не опубліковано нових товарів: …» з причиною в дужках. Перед ним на кожен пропущений товар стоїть свій червоний рядок з назвою: «TikTok Shop: «…» — категорію не зіставлено з TikTok, товар не створено» або «TikTok Shop: «…» — немає фото (TikTok потребує щонайменше одне), товар не створено». Кожен опублікований товар отримує свій рядок «TikTok Shop: опубліковано товар «…» (ID …)» — за цим ID картку легко знайти в кабінеті.
У сітці «Товари» факт оновлення підтверджують ті самі колонки, що й в інших API-підключень: «Дата оновлення» й «Джерело: назва» (див. огляд імпорту каталогу через API).
Якщо прогін обірвався
Каталог не чекає кінця прогону: щойно набирається пачка у 500 товарів, вона йде в базовий каталог. Тому обрив ділить результат надвоє — те, що встигло лягти пачками, уже оновлене, решта лишилася зі старими даними.
Повторний запуск безпечний. Каталог із TikTok тягнеться цілком щоразу — відбору «тільки змінене» тут немає, — а товар шукається за вже заведеною карткою, тож дублів не з'явиться. Наприкінці вдалого прогону Elbuz доводить набір до ладу: застосовує правила націнки й оновлює службові дані каталогу. Після обриву цей крок не виконується, але й не губиться: наступний вдалий прогін зробить його разом і для того, що лишилося від обірваного.
Якщо обірвався прогін замовлень, історію заново тягнути не доведеться. Позначка «звідки продовжувати» — найпізніша дата зміни серед завантажених замовлень — переписується після кожної збереженої сторінки. Наступний запуск бере замовлення, змінені з цієї дати включно, тож останні приїдуть удруге й оновляться, а не задвояться.
У Центрі операцій є кнопка «Зупинити», і вона пише в журнал «Операція перервана користувачем!». Прогін TikTok Shop перевіряє її після кожної сторінки списку: поточну сторінку — до 100 товарів чи замовлень — він доводить до кінця, а наступну вже не бере. Зібрані до цього товари лягають у базовий каталог, спрацьовують правила націнки, і в журнал стає звичайний підсумок «TikTok Shop: каталог завантажено, товарів: …» — просто з меншим числом. Решта товарів лишається зі старими даними до наступного прогону.
Повна картка запитується окремо на кожен товар. Якщо саме цей запит не вдався, прогін не зупиняється й рядка в журнал не пише — Elbuz бере короткий запис зі списку й будує картку з нього. Ціна й залишок збираються з блоку варіантів товару, і якщо в короткому записі його немає, ціна й кількість прийдуть нулями. Нульова ціна в картку не запишеться — лишиться попередня. А от кількість 0 запишеться поверх ваших даних. Тому після прогону, під час якого майданчик збоїв, варто переглянути відбір у сітці «Товари» за сьогоднішньою «Датою оновлення»: нульові залишки помітні в тій самій сітці.
Скільки це триває і де межі
Стелі на кількість товарів чи замовлень за один прогін немає: сторінки читаються, доки майданчик віддає наступну. Вікно можна закрити — журнал живе в Центрі операцій, і прогін від цього не переривається. Числа, які в програмі справді задані, такі:
| Що обмежено | Значення |
|---|---|
| Розмір сторінки | 100 товарів або 100 замовлень за один запит |
| Запитів на завантаження каталогу | один на сторінку списку плюс один на кожен товар |
| Пачка запису в каталог | 500 товарів |
| Очікування відповіді на один запит | 120 секунд; на встановлення з'єднання — 30 |
| Перевищено ліміт звернень майданчика | три спроби з паузами 2, 4 і 6 секунд. Якщо ліміт вичерпався на сторінці списку товарів чи замовлень, прогін зупиняється з помилкою; на повній картці товару — товар береться з короткого запису списку; при вивантаженні помилку отримує лише ця позиція (у журналі «TikTok Shop: помилка вивантаження»), решта йде далі |
| Запитів на позицію при вивантаженні | два: окремо залишок, окремо ціна |
| Фото при публікації | не більше 9 на товар, на скачування кожного — до 60 секунд |
| Обрізання полів при публікації | назва — 255 символів, опис — 10 000, артикул — 50 |
Скільки триває саме ваш каталог, вигадувати не треба: це видно в колонці «Витрачено часу» списку шаблонів і в останньому рядку журналу.
Коли на один товар претендує кілька джерел
Спільне правило для всіх API-підключень одне: у полі лишається значення того прогону, який завершився останнім, пріоритету джерел у шаблонах немає — це розібрано в огляді імпорту каталогу через API. Що до цього додає саме TikTok Shop:
- Залишок приходить сумою, а повертається на один склад. У картку Elbuz кількість складається за всіма складами TikTok, а зворотне оновлення йде рівно на один — той, що вказаний у полі «Версія API» шаблону вивантаження. Якщо складів більше одного, після кола «завантажив — вивантажив» цифри в кабінеті будуть не тими, на які ви розраховували.
- «Не оновлювати» тримає картку, «Фіксована ціна» — тільки ціну. Перемикач «Не оновлювати» захищає картку від запису цілком, разом із назвою, описом, ціною й залишком. Сусідній перемикач «Фіксована ціна» не дає прогону переписати ціни картки, а назва, опис і залишок з майданчика оновлюються як звичайно.
- Захист працює в один бік. «Не оновлювати» забороняє записувати в картку, але не забороняє Elbuz відправляти її ціну й залишок у TikTok: відбір у вивантаження йде за іншою ознакою — про неї нижче.
- Ключі товару можуть прийти з іншого підключення. Ціна й залишок надсилаються за парою ключів майданчика, яку Elbuz запам'ятав на завантаженні каталогу. Якщо в цього шаблона бракує хоча б одного з двох ключів, він шукає їх серед усіх TikTok-підключень акаунта й бере знайдені. Коли магазин один, це рятує: ключі, отримані завантаженням, працюють і для вивантаження. Коли TikTok-магазинів два, оновлення може піти на товар іншого магазину.
Вимкнути товар, шаблон чи прив'язку
Знята «Активність» товару не зупиняє оновлення в TikTok. У вивантаження позиція потрапляє за ознакою «Вивантажувати у файл (на сайт)» і за станом своєї категорії: категорія має бути активною і теж позначеною до вивантаження. Зняли позначку з товару або вимкнули категорію — позиція випала з вивантаження, і в TikTok лишиться те, що Elbuz записав туди востаннє.
Вимкнути сам товар на майданчику Elbuz не вміє: назовні йдуть тільки залишок і ціна, ознаки «продається / не продається» серед них немає. Єдиний спосіб прибрати позицію з продажу засобами Elbuz — обнулити залишок: нуль піде на склад як звичайне число.
Шаблон вимикається пілюлею в шапці його картки, і це знімає його з розкладу: планувальник бере тільки активні. Ручний запуск у вимкненого шаблона працює. Увімкнули назад — наступне спрацювання розкладу відпрацює так, ніби нічого не було: ні прив'язка магазину, ні склад, ні валюта, ні прив'язки карток до майданчика при вимкненні не губляться.
Якщо прогін зробив не те
Залишки пішли не на той склад. Elbuz оновлює рівно один склад — той, що вказаний у полі «Версія API» шаблону вивантаження (або склад за замовчуванням), — і не вміє ані обнуляти, ані чистити інші. Тому порядок такий: знайдіть правильний склад кнопкою «Обрати зі списку», впишіть його ID у поле «Версія API» шаблону вивантаження й запустіть вивантаження ще раз — правильний склад отримає ваші цифри. А те, що встигло лягти на помилковий, доведеться прибрати в кабінеті TikTok Shop руками: звідси такої команди немає.
Товари опублікувалися помилково. Зняти чи видалити картку в TikTok Elbuz теж не вміє — це робиться в кабінеті майданчика. У себе такі товари знайти просто: у момент публікації Elbuz ставить прив'язку до майданчика й позначку «Вивантажено» в товарі. Якщо картку в кабінеті видалили, прив'язка в Elbuz лишається, і наступне вивантаження ще намагатиметься її оновити — відмову буде видно в журналі.
Каталог затягнув зайве або перезаписав ваші правки. Це спільна для всіх API-підключень робота: товари цього шаблона відбираються в сітці «Товари» колонкою «Джерело: назва», усі зачеплені прогоном — колонкою «Дата оновлення», масового відкату значень у програмі немає. Порядок дій — в огляді імпорту каталогу через API.
Розклад
TikTok Shop працює поллінгом: миттєвих сповіщень немає, Elbuz звертається до майданчика за розкладом, який задають кнопкою налаштування завдання у формі шаблону. Для соціальної комерції характерні сплески — під час стріма чи вдалого відео замовлення йдуть хвилею, — тож ставте достатньо частий розклад, щоб черга обробки не відставала.
Сценарії
Завести товари TikTok-магазину в базовий каталог. У шаблоні «TikTok Shop», у картці «Вибір даних для завантаження», позначте «Товари» і, якщо потрібні зображення, «Фото». Прогін забере активні товари з назвою, описом, артикулом, ціною, залишком сумою по складах і категорією, а кожна картка отримає прив'язку до майданчика — ті самі ключі, за якими потім піде вивантаження. Чого не буде: характеристики не прийдуть, товари в іншому стані на майданчику не прийдуть взагалі, а їхні картки в Elbuz лишаться такими, як були. Повторний запуск дублів не створює.
1
Товари2
Фото3
Замовлення- Товари — завантажувати товари з TikTok Shop до каталогу.
- Фото — завантажувати разом із товарами їхні фотографії.
- Замовлення — отримувати замовлення з TikTok Shop.
Приймати замовлення з TikTok без прогону каталогу. Позначте в шаблоні тільки «Замовлення», а «Товари» зніміть. Перший прогін перенесе всю історію, наступні беруть замовлення, змінені з дати останнього завантаженого, і вже завантажені оновлюються. Однакові одиниці товару в замовленні складаються в одну позицію з кількістю. Чого не буде: без галочки «Товари» каталог прогін не запитує, тож ціни й залишки наявних карток цим шаблоном не змінюються. Але позиція замовлення, якої немає в каталозі, стане новою карткою в окремій категорії «Товари - tiktok - …».
Тримати в картці свою ціну або всю картку, хоча TikTok її перезаписує. У картці товару, секція «Захист під час імпорту», увімкніть «Фіксована ціна» — прогін не перепише ціни, а назва, опис і залишок оновлюватимуться. Увімкніть «Не оновлювати» — картка не перепишеться цілком. Чого не буде: жоден із перемикачів не зупиняє вивантаження, тож ціна й залишок цієї картки далі йтимуть у TikTok.
Оновлювати в TikTok ціни й залишки товарів, які там уже продаються. Спершу хоча б раз прогоніть шаблон завантаження з галочкою «Товари» — він запише ключі майданчика. Потім створіть шаблон вивантаження типу «TikTok Shop» і позначте в ньому «Товари». На кожен товар підуть два запити: окремо залишок на склад, окремо ціна; відмова майданчика стане в журнал рядком «TikTok Shop: помилка вивантаження» з назвою товару. Чого не буде: назва, опис і фото в TikTok не оновлюються, товар на майданчику не вимикається, а товар без ключів майданчика, якщо публікацію нових товарів не ввімкнено, пропускається без жодного рядка в журналі.
Навіщо зводити TikTok Shop в Elbuz
TikTok Shop рідко буває єдиним каналом: зазвичай поруч є сайт, маркетплейс або офлайн. Головний ризик при цьому — залишки: вдале відео здатне за годину забрати весь склад, і якщо про це не дізнаються інші канали, почнуться скасування. Elbuz тримає єдиний залишок на всі канали й одну чергу замовлень, тож продаж у TikTok одразу зменшує наявність скрізь. А ще з'являється те, чого в кабінеті майданчика немає: історія покупців, документи й склад.
Часті труднощі
Перша й найчастіша — прив'язка не спрацювала: код прив'язки живе недовго, тож вставляйте його одразу після отримання. Перевірка підключення має відповісти назвою магазину; якщо відповідь порожня або з помилкою, повторіть підключення.
Друга — залишки розходяться з кабінетом. Майже завжди причина в складі: у кабінеті кілька локацій, а в шаблоні вивантаження склад не вказаний, тож оновлення йде не туди, куди ви дивитесь. Знайдіть потрібний склад кнопкою «Обрати зі списку» й впишіть його ID у поле «Версія API» шаблону вивантаження.
Третя — каталог вантажиться довго. Це нормально: по кожному товару Elbuz запитує повну картку окремо, тож запусків раз на добу для каталогу цілком достатньо, а часті запуски лишіть для замовлень.
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «TikTok Shop: підключіть магазин кнопкою «Підключити» (код прив'язки)» | У шаблона немає доступу до магазину: прив'язку не завершили або її відкликали | Пройдіть прив'язку заново й перевірте кнопкою «Перевірити підключення» (код прив'язки) |
| «TikTok Shop: помилка API —» і текст від майданчика | Майданчик відповів відмовою; прогін зупинився на цьому місці, раніші пачки вже в каталозі | Прочитайте текст після тире й запустіть шаблон ще раз — повтор безпечний (якщо прогін обірвався) |
| «TikTok Shop: не знайдено склад (warehouse) — публікація неможлива» або «… — залишки не оновлено, лише ціни» | Ні в шаблоні вивантаження, ні в кабінеті не знайшлося складу, на який писати залишок: нові товари не створюються, у наявних оновлюються тільки ціни | Знайдіть склад кнопкою «Обрати зі списку» під полем «ID складу» й впишіть його ID у поле «Версія API» шаблону вивантаження (код прив'язки) |
| «TikTok Shop: «…» — категорію не зіставлено з TikTok, товар не створено» | Для категорії цього товару в Elbuz не зіставлено категорію TikTok | Зіставте категорію TikTok; якщо довідник категорій порожній, спершу натисніть «Завантажити довідник майданчика» у вікні зіставлення (публікація нових товарів) |
| «TikTok Shop: «…» — немає фото (TikTok потребує щонайменше одне), товар не створено» | Жодного зображення товару не вдалося скачати й залити на майданчик | Додайте товару фото, доступне за посиланням, і повторіть вивантаження (публікація нових товарів) |
| «TikTok Shop: не опубліковано нових товарів: …» | Для категорії товару не зіставлено категорію TikTok або немає фото; які саме товари пропущено, видно з рядків вище з їхніми назвами | Розберіть рядки з назвами товарів: зіставте категорію TikTok або додайте фото й повторіть вивантаження (публікація нових товарів) |
Часті питання
Чи треба реєструвати застосунок TikTok Shop?
Ні. Підключення відбувається кодом прив'язки: натискаєте «Підключити», підтверджуєте доступ до свого магазину й вводите короткий код. Ключі й підписи запитів Elbuz бере на себе.
Навіщо вказувати ID складу і де його взяти?
Залишок у TikTok Shop ведеться по складах, і Elbuz оновлює кількість на одному з них: тому, що вказано в полі «Версія API» шаблону вивантаження (у форматі ID складу|валюта), або на складі за замовчуванням. Шукати ідентифікатор у кабінеті не треба — натисніть «Обрати зі списку» під полем «ID складу» в шаблоні завантаження, і Elbuz покаже склади, які віддає сам майданчик, з типом складу й позначкою складу за замовчуванням.
Чому в товарах немає характеристик?
TikTok Shop не передає атрибути через цей канал: приходять назва, опис, ціна, залишок, фото й категорія. Характеристики заповнюються в Elbuz, звідки далі йдуть на канали, де вони потрібні.
Чому товар не опублікувався в TikTok Shop?
Три типові причини, і всі видно в журналі: не зіставлена категорія TikTok для категорії товару, не вдалося завантажити жодної фотографії, або не визначено склад. Виправте те, що названо в журналі, і повторіть вивантаження.
Чому кількість у позиції замовлення не збігається з тим, що я бачу в кабінеті?
TikTok віддає замовлення окремими одиницями товару, без кількості в рядку. Elbuz збирає однакові одиниці в одну позицію й рахує кількість за числом рядків, а суму — як ціну помножену на цю кількість. Підсумок замовлення при цьому сходиться.
Товар зник із TikTok Shop — що буде з карткою в Elbuz?
Нічого. Elbuz забирає тільки активні товари, тож знята з продажу позиція в прогін не потрапляє: картка лишається з останньою ціною, останньою кількістю й ознакою «увімкнено». Вона не деактивується, залишок не обнуляється, рядка в журналі про неї не буде — менші стануть лише підсумкові числа.
Чи можна зупинити завантаження TikTok кнопкою «Зупинити»?
Так, з кроком в одну сторінку. Прогін дочитує поточну сторінку списку — до 100 товарів чи замовлень — і наступну вже не бере; зібране до цього лягає в каталог. Повторний запуск після цього безпечний: товари шукаються за вже заведеними картками, дублів не буде.