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