↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Завантаження даних
    4. Маркетплейси США

    Як підключити TikTok Shop до Elbuz: товари, замовлення й залишки по складу

    23 хв читанняОновлено

    Elbuz підключає магазин TikTok Shop кодом прив'язки, забирає товари в базовий каталог, приймає замовлення й повертає на майданчик ціни та залишки — продаж у TikTok одразу зменшує наявність на всіх каналах.

    Коли це знадобиться:

    • Товари вже заведені в TikTok Shop — активні позиції приїдуть у каталог із ціною, залишком, фото й категорією.
    • Вдалий стрім забирає склад за годину — замовлення стають документами, а залишок у TikTok оновлюється з Elbuz.
    • Каталог ведете в Elbuz — нові товари публікуються в TikTok Shop разом із фото.

    З чого почати: створіть шаблон типу «TikTok Shop» і прив'яжіть магазин кодом.

    Що вміє підключення TikTok Shop

    Що потрібно від 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» шаблону вивантаження.

    Як підключити крок за кроком

    1. Створіть шаблон типу «TikTok Shop» і збережіть його — прив'язка працює для збереженого шаблону. «Активний» і «Замовлення» в новому шаблоні вже ввімкнені: за 5 хвилин після прив'язки Elbuz почне забирати історію замовлень. Статуси майданчика Elbuz зводить до ваших сам, за назвою; що прийшло і як зведено, видно у вікні «Статуси замовлення» шаблону. Хочете спершу перевірити — зніміть «Замовлення».
    2. Натисніть «Підключити», підтвердіть доступ до магазину, скопіюйте короткий код і вставте його у форму одразу: код живе недовго.
    3. Натисніть «Перевірити підключення» — у відповіді має бути назва вашого магазину.
    4. Натисніть «Обрати зі списку» під полем складу й зафіксуйте потрібний склад у полі «Версія API» шаблону вивантаження.
    5. Позначте, що завантажувати, запустіть шаблон вручну й звірте з кабінетом кілька карток і замовлень. Коли цифри сходяться — ставте каталог на розклад.

    Прив'язка одна на акаунт TikTok Shop: підключили в шаблоні завантаження — шаблон вивантаження працює з тим самим доступом, і навпаки. Кнопка «Підключити» й поле «Код прив'язки» є в обох шаблонах.

    Що переноситься в картку

    Elbuz забирає активні товари магазину. Спершу читається список, потім по кожному товару — повна картка, тому запитів більше, ніж товарів, і великий каталог вантажиться помітно довго.

    Дані TikTok ShopПоле товару в Elbuz
    назва товаруНазва
    описОпис
    артикул продавця (seller )Артикул
    ціна позиціїЦіна
    залишки по складахКількість (сумою за всіма складами)
    стан товаруСтатус: активний — увімкнений товар
    категорія TikTokКатегорія
    головні зображенняФотографії (якщо ввімкнено галочку)

    Характеристики й категорії

    З TikTok Shop не приходять характеристики товару. Якщо каталог в Elbuz для вас основний, заповніть характеристики у себе — далі вони підуть на канали, де потрібні.

    Категорія приходить числовим кодом, зрозуміле ім'я Elbuz бере з довідника категорій TikTok. Довідник завантажує кнопка «Завантажити довідник майданчика» у вікні зіставлення категорій. Поки його немає, товари лягають у категорію джерела — розкладіть їх по своєму дереву, і оновлення потраплятимуть туди.

    Товар зник із TikTok Shop або ви його вимкнули

    Elbuz просить у майданчика тільки товари зі станом «активний». Знята з продажу, вимкнена, видалена чи відправлена на перевірку позиція в прогін не потрапляє, і з карткою в Elbuz не відбувається нічого: остання ціна, кількість і ознака «увімкнено» лишаються. Єдина ознака — підсумок «каталог завантажено, товарів: …» стане меншим.

    Зворотний бік: якщо ви вимкнули товар у себе, а на майданчику він живий, наступний прогін знову його ввімкне. Утримати своє значення можна перемикачем «Не оновлювати» в картці товару, секція «Захист під час імпорту»: таку картку прогін не переписує взагалі. «Фіксована ціна» захищає лише ціну.

    Секція «Захист під час імпорту» в картці товару
    1Не оновлювати
    2Фіксована ціна
    1. Не оновлювати — завантаження TikTok пропускає картку цілком.
    2. Фіксована ціна — завантаження TikTok не змінює ціну картки.

    Прив'язка картки до майданчика лишається й тоді, коли товару в TikTok уже немає. Вивантаження далі шле на нього ціну й залишок; відмову майданчика видно в журналі рядком «TikTok Shop: помилка вивантаження» з назвою товару.

    Як приходять замовлення

    Перший запуск переносить історію, далі забираються замовлення, змінені з моменту минулого запуску; вже завантажені оновлюються, а не дублюються. Позиція, якої немає в каталозі, стає новою карткою в окремій категорії «Товари - tiktok - …».

    У документ потрапляють:

    • номер замовлення, дати створення й зміни, статус;
    • ім'я одержувача, телефон, пошта покупця, повідомлення покупця;
    • адреса доставки одним рядком з індексом і кодом регіону, служба доставки;
    • валюта, ознака оплати, спосіб оплати.

    TikTok віддає замовлення окремими одиницями товару, без поля «кількість». Elbuz збирає однакові одиниці в одну позицію: три однакові товари стають однією позицією з кількістю три. Сума позиції — ціна, помножена на кількість, тож підсумок замовлення сходиться.

    Як ціни й залишки повертаються в TikTok Shop

    Зворотний напрямок — окремий шаблон вивантаження типу «TikTok Shop». Ціна й залишок ідуть двома різними викликами на кожну позицію, залишок — на конкретний склад. Ключі для цього Elbuz запам'ятовує на завантаженні каталогу, тому спершу один раз завантажте каталог із TikTok, потім налаштовуйте вивантаження.

    Якщо склад не визначився (поле «Версія API» порожнє, а кабінет склад за замовчуванням не віддав), залишки не надсилаються, оновлюються лише ціни; у журналі — червоний рядок про це (розбір).

    Ліва гілка — звідки беруться ключі товару: спершу з цього шаблону, а якщо тут бракує хоча б одного з двох ключів — з будь-якого іншого TikTok-підключення. Товар без ключів, якщо «Публікувати нові товари» не ввімкнено, випадає мовчки, у підсумкові лічильники він не потрапляє; з увімкненою галочкою він іде в публікацію.
    такнітакнітакнітакніШаблон вивантаження «TikTokShop» з галочкою «Товари»Склад визначено?Товар із відбору вивантаженняЧервоний рядок «не знайденосклад — залишки не оновлено,лише ціни»Обидва ключі майданчика є вцьому шаблоні?Залишок на склад — окремийзапит, якщо склад визначеноКлючі є в іншомуTikTok-підключенні?Без «Публікувати нові товари» —пропуск без рядка в журналі, знею — у публікацію після циклуЦіна — окремий запитЗапити прийняті?До лічильника оновлених«TikTok Shop: помилкавивантаження» і до лічильникапомилок«TikTok Shop: ціни та залишкионовлено, товарів: … (помилок:…)»
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    У вивантаження позиція потрапляє за ознакою «Вивантажувати у файл (на сайт)» і за станом категорії: вона має бути активною й позначеною до вивантаження. Знята «Активність» товару оновлення в 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Майданчик відповів?«TikTok Shop: помилка API —» ікінець каталогуПовна картка по кожному товаруКартка прийшла?Картка з короткого запису спискуТовар у пачку — кожні 500лягають у каталог«TikTok Shop: отримано товарів:…»Натиснуто «Зупинити» абосторінки скінчилися?Решта пачки в каталог і правиланацінки«TikTok Shop: каталогзавантажено, товарів: …»
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді
    Що обмеженоЗначення
    Розмір сторінки100 товарів або 100 замовлень за один запит
    Запитів на завантаження каталогуодин на сторінку списку плюс один на кожен товар
    Пачка запису в каталог500 товарів
    Очікування відповіді на один запит120 секунд; на встановлення з'єднання — 30
    Перевищено ліміт звернень майданчикатри спроби з паузами 2, 4 і 6 секунд; далі на сторінці списку прогін зупиняється з помилкою, на повній картці — береться короткий запис, при вивантаженні помилку отримує лише ця позиція
    Запитів на позицію при вивантаженнідва: окремо залишок, окремо ціна
    Фото при публікаціїне більше 9 на товар, на скачування кожного — до 60 секунд
    Обрізання полів при публікаціїназва — 255 символів, опис — 10 000, артикул — 50

    Сценарії

    Картка «Вибір даних для завантаження» у формі шаблону TikTok Shop
    1Товари
    2Фото
    3Замовлення
    1. Товари — завантажувати товари з TikTok Shop до каталогу.
    2. Фото — завантажувати разом із товарами їхні фотографії.
    3. Замовлення — отримувати замовлення з 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
    Картка «Підключення» форми API TikTok Shop
    1Поле «ID складу»
    2Поле «Валюта для публікації»
    1. Поле «ID складу» — якщо залишити порожнім, використається склад за замовчуванням.
    2. Поле «Валюта для публікації» — на публікацію не впливає: валюту задає шаблон вивантаження.

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно