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