TikTok Shop — торговий майданчик усередині TikTok: товари продаються прямо з відео, стрімів і вітрини магазину. Продавець створює картки сам, тож Elbuz працює з ним у повному циклі: забирає товари в базовий каталог, приймає замовлення, оновлює ціни й залишки, а за потреби публікує нові товари.
Загальний порядок для всіх API-джерел каталогу — в огляді імпорту каталогу через API, спільні правила замовлень — в огляді імпорту замовлень. Тут — те, що стосується TikTok Shop.
Де це у програмі
У вікні завантаження створіть шаблон і оберіть тип «TikTok Shop». Файл не потрібен: підключення відбувається прив'язкою магазину.
1
Поле «ID складу»2
Поле «Валюта для публікації»- Поле «ID складу» — якщо залишити порожнім, використається склад за замовчуванням.
- Поле «Валюта для публікації» — валюта товарів, що публікуються в TikTok Shop, за замовчуванням USD.
Як підключити: код прив'язки
Реєструвати застосунок у TikTok і розбиратися з ключами й підписами не потрібно. У формі шаблону є картка встановлення застосунку: натискаєте «Підключити», підтверджуєте доступ до свого магазину TikTok і вводите короткий код прив'язки. Далі Elbuz працює від вашого імені, а доступ продовжується сам.
У картці «Підключення» два поля, обидва необов'язкові:
| Поле | Навіщо |
|---|---|
| ID складу | Склад, за яким ведеться залишок. Обирається кнопкою «Обрати зі списку»; порожнє поле — Elbuz візьме склад за замовчуванням із вашого кабінету |
| Валюта для публікації | Валюта, в якій створюються нові товари. За замовчуванням USD |
Кнопка «Перевірити підключення» у відповідь показує назву вашого магазину — найшвидший спосіб переконатися, що прив'язка спрацювала.
У TikTok Shop залишок ведеться по складах: одна й та сама позиція може мати різну кількість у різних локаціях. Elbuz оновлює залишок на одному складі — тому, що вказаний у полі «ID складу», а якщо поле порожнє, на складі за замовчуванням. Якщо у вас кілька складів і торгівля йде з конкретного, вкажіть його явно, інакше цифри в кабінеті й в Elbuz розійдуться.
Шукати ідентифікатор у кабінеті не потрібно: під полем є кнопка «Обрати зі списку» — Elbuz запитує склади у самого TikTok Shop і показує їх переліком. У назві видно тип складу й позначку складу за замовчуванням, тож два схожі склади не переплутати. Поле лишається текстовим, тож ID можна вписати й руками, якщо він у вас уже є.
Як підключити крок за кроком
Створіть шаблон типу «TikTok Shop» і збережіть його — прив'язка працює вже для збереженого шаблону. Натисніть «Підключити», підтвердіть доступ до магазину, скопіюйте короткий код і вставте його у форму. Переконайтеся кнопкою «Перевірити підключення», що у відповіді видно назву вашого магазину.
Одразу після прив'язки натисніть «Обрати зі списку» під полем складу: якщо складів у кабінеті кілька, потрібний краще зафіксувати відразу — інакше залишок оновлюватиметься не там, де ви очікуєте. Далі позначте, що завантажувати, запустіть шаблон вручну й перевірте перші результати очима: кілька карток і кілька замовлень. Коли цифри сходяться з кабінетом, ставте завдання на розклад.
Що приходить у каталог
Elbuz забирає активні товари магазину. Спершу читається список, потім по кожному товару запитується повна картка — саме тому завантаження великого каталогу помітно повільніше, ніж могло б здаватися: запитів виходить більше, ніж самих товарів.
| Дані TikTok Shop | Поле товару в Elbuz |
|---|---|
| назва товару | Назва |
| опис | Опис |
| артикул продавця (seller SKU) | Артикул |
| ціна позиції | Ціна |
| залишки по складах | Кількість (сумою за всіма складами) |
| стан товару | Статус: активний — увімкнений товар |
| категорія TikTok | Категорія |
| головні зображення | Фотографії (якщо ввімкнено галочку) |
З TikTok Shop не приходять характеристики товару — назва, опис, ціна, залишок, фото й категорія є, атрибутів немає. Якщо каталог в Elbuz для вас основний, заповніть характеристики у себе: далі вони роз'їдуться на інші канали, де вони потрібні.
Категорія приходить числовим кодом. Зрозуміле ім'я Elbuz бере з довідника категорій TikTok, який наповнюється окремо при першому підключенні майданчика. Поки довідника немає, товари лягають у категорію джерела — розкладіть їх по своєму дереву, далі оновлення потраплятимуть саме туди.
Замовлення
Перший запуск переносить історію, далі забираються замовлення, змінені з моменту минулого запуску; вже завантажені при цьому оновлюються, а не дублюються.
У документ потрапляють номер замовлення, дати створення й зміни, ім'я одержувача, телефон, пошта покупця, адреса доставки одним рядком з індексом і кодом регіону, валюта, повідомлення покупця, статус замовлення, ознака оплати, спосіб оплати й служба доставки.
У цій версії API TikTok віддає замовлення окремими одиницями товару, без поля «кількість» у рядку. Elbuz збирає однакові одиниці в одну позицію й рахує кількість за числом рядків: три однакові товари у замовленні перетворюються на одну позицію з кількістю три. Сума позиції рахується як ціна помножена на цю кількість, тож підсумок замовлення сходиться.
Оновлення цін і залишків
Зворотний напрямок — окремий шаблон вивантаження типу «TikTok Shop». Ціна й залишок надсилаються двома різними викликами на кожну позицію (так влаштований API майданчика), причому залишок — на конкретний склад. Ключі, за якими це робиться, Elbuz запам'ятовує ще на завантаженні каталогу, тому найнадійніший порядок такий: спершу один раз завантажити каталог із TikTok, потім налаштовувати вивантаження.
Публікація нових товарів
Якщо ввімкнено галочку створення товарів, Elbuz заводить у TikTok Shop нові картки. Фотографії майданчик за посиланням не приймає, тому Elbuz скачує зображення й заливає їх у TikTok, а вже потім створює товар — з назвою, описом, категорією, вагою упаковки, артикулом, ціною й залишком на складі.
Категорія TikTok має бути сопоставлена для категорії товару — без неї картка пропускається. Потрібна хоча б одна фотографія, яку вдалося завантажити, — товар без зображення майданчик не прийме. Має бути визначений склад — або вказаний у шаблоні, або доступний за замовчуванням. Усі пропуски видно в журналі операції з назвою товару, тож розібратися, чому саме цей товар не поїхав, можна відразу.
Розклад
TikTok Shop працює поллінгом: миттєвих сповіщень немає, Elbuz звертається до майданчика за розкладом, який задають кнопкою налаштування завдання у формі шаблону. Для соціальної комерції характерні сплески — під час стріма чи вдалого відео замовлення йдуть хвилею, — тож ставте достатньо частий розклад, щоб черга обробки не відставала.
Навіщо зводити TikTok Shop в Elbuz
TikTok Shop рідко буває єдиним каналом: зазвичай поруч є сайт, маркетплейс або офлайн. Головний ризик при цьому — залишки: вдале відео здатне за годину забрати весь склад, і якщо про це не дізнаються інші канали, почнуться скасування. Elbuz тримає єдиний залишок на всі канали й одну чергу замовлень, тож продаж у TikTok одразу зменшує наявність скрізь. А ще з'являється те, чого в кабінеті майданчика немає: історія покупців, документи й склад.
Часті труднощі
Перша й найчастіша — прив'язка не спрацювала: код прив'язки живе недовго, тож вставляйте його одразу після отримання. Перевірка підключення має відповісти назвою магазину; якщо відповідь порожня або з помилкою, повторіть підключення.
Друга — залишки розходяться з кабінетом. Майже завжди причина в складі: у кабінеті кілька локацій, а в шаблоні склад не вказаний, тож оновлення йде не туди, куди ви дивитесь. Натисніть «Обрати зі списку» й виберіть потрібний склад явно.
Третя — каталог вантажиться довго. Це нормально: по кожному товару Elbuz запитує повну картку окремо, тож запусків раз на добу для каталогу цілком достатньо, а часті запуски лишіть для замовлень.
Часті питання
Чи треба реєструвати застосунок TikTok Shop?
Ні. Підключення відбувається кодом прив'язки: натискаєте «Підключити», підтверджуєте доступ до свого магазину й вводите короткий код. Ключі й підписи запитів Elbuz бере на себе.
Навіщо вказувати ID складу і де його взяти?
Залишок у TikTok Shop ведеться по складах, і Elbuz оновлює кількість на одному з них: тому, що вказано в шаблоні, або на складі за замовчуванням. Шукати ідентифікатор у кабінеті не треба — натисніть «Обрати зі списку» під полем, і Elbuz покаже склади, які віддає сам майданчик, з типом складу й позначкою складу за замовчуванням.
Чому в товарах немає характеристик?
TikTok Shop не передає атрибути через цей канал: приходять назва, опис, ціна, залишок, фото й категорія. Характеристики заповнюються в Elbuz, звідки далі йдуть на канали, де вони потрібні.
Чому товар не опублікувався в TikTok Shop?
Три типові причини, і всі видно в журналі: не сопоставлена категорія TikTok для категорії товару, не вдалося завантажити жодної фотографії, або не визначено склад. Виправте те, що названо в журналі, і повторіть вивантаження.
Чому кількість у позиції замовлення не збігається з тим, що я бачу в кабінеті?
TikTok віддає замовлення окремими одиницями товару, без кількості в рядку. Elbuz збирає однакові одиниці в одну позицію й рахує кількість за числом рядків, а суму — як ціну помножену на цю кількість. Підсумок замовлення при цьому сходиться.