Tobto.shopДовідка

Маркетплейси і фіди товарів

Розділ «Маркетплейси» дозволяє продавати на Rozetka, Prom.ua та в Епіцентрі К: товари йдуть туди фідом з вашою націнкою, замовлення приходять у «Замовлення», а статус і ТТН повертаються назад. Google Merchant, Meta (Facebook, Instagram) і TikTok отримують лише фід каталогу. Окремий фід є також для Hotline.ua.

Як підключити маркетплейс

  1. Встановіть і увімкніть потрібне розширення в «Розширення»: «YML-фід для Prom і Rozetka» (для Prom.ua і Rozetka), «Google Merchant Center», «Каталог Meta (Facebook та Instagram)», «Каталог TikTok», «Hotline.ua». Для кожного заповніть «Адреса вітрини» (https://…) та інші поля в його «Налаштуваннях» і ввімкніть «Фід увімкнено».
  2. Відкрийте «Налаштування → Маркетплейси» і оберіть канал (стани: «Увімкнено», «Вимкнено», «Помилка»).
  3. У блоці «Підключення» позначте «Продавати на цьому маркетплейсі» і введіть дані входу: для Rozetka — «Логін кабінету продавця Rozetka» і «Пароль кабінету продавця Rozetka»; для Prom.ua — «API-токен Prom.ua»; для Епіцентру — «API-токен Епіцентру». Дані зберігаються зашифрованими; поле «Видалити збережені дані входу» стирає їх. Токен Prom створюється в кабінеті Prom: Налаштування → Керування API-токенами, з доступом до замовлень, доставки й товарів.
  4. Збережіть.

Google Merchant, Meta і TikTok не потребують входу — лише фід.

Як налаштувати, які товари й за якою ціною

У блоці «Які товари й за якою ціною»:

  • «Націнка, %» (ціна на маркетплейсі = ціна магазину + націнка; може бути від'ємною) і «Додати до ціни, у валюті магазину»;
  • «Округлення»: «Без округлення», «До цілих», «До …9»;
  • «Лише товари в наявності», «Лише ці категорії», «Крім цих категорій», «Не передавати артикули».

У блоці «Відповідність категорій і характеристик» зіставте категорії магазину з ID чи кодами маркетплейсу. Для Епіцентру код категорії обов'язковий, а товари без категорії Епіцентру у фід не потрапляють. Для Rozetka — ID категорії (rz_id), для Prom — portal_category_id, для Google, Meta і TikTok — категорія Google (наприклад 1868). Підкатегорії успадковують відповідність. Характеристики пишуться як «Колір = Колір; Обʼєм = Обʼєм, мл».

Як передати фід маркетплейсу

  1. У блоці «Фід» натисніть «Створити нове посилання» і одразу скопіюйте його: повністю воно більше не показується, а нове посилання робить старе недійсним. Для Google, Meta, TikTok і Hotline токен створюється кнопкою «Створити або оновити токен» у розширенні.
  2. Вставте посилання в кабінеті: Rozetka — «Товари → Імпорт → YML»; Prom — «Товари → Імпорт → За посиланням» з автооновленням; Епіцентр — передайте менеджеру або вставте в кабінеті продавця; Google Merchant Center — «Товари → Джерела даних → Додати → Файл за посиланням»; Meta — Commerce Manager, «Каталог → Джерела даних → Фід даних → Заплановане завантаження»; TikTok — TikTok Ads Manager, «Активи → Каталоги → Товари → Додати товари → Фід даних → Заплановане оновлення»; Hotline — «кабінет продавця → Прайс-листи → Посилання на прайс».
  3. Кнопка «Оновити фід зараз» формує фід негайно; стан показано рядком «Фід: …» (товарних пропозицій і затриманих через помилки).
  4. Блок «Діагностика» у розширенні показує, що не потрапить у фід (немає ціни, фото, категорії тощо).

Instagram і TikTok

  • Instagram окремого фіду не має: Instagram Shopping і позначення товарів у дописах беруть товари з того самого каталогу Meta, що й Facebook. Підключіть фід «Каталог Meta (Facebook та Instagram)» у Commerce Manager і привʼяжіть каталог до свого акаунта Instagram. Щоб товари лишилися на Facebook, але не позначалися в Instagram, увімкніть у розширенні «Не позначати в Instagram»; щоб не потрапляли в динамічну рекламу — «Не використовувати в рекламі каталогу».
  • TikTok: встановіть «Каталог TikTok», заповніть «Адреса вітрини» і «Бренд за замовчуванням» (TikTok вимагає бренд для кожного товару — без нього товар у фід не потрапить), увімкніть «Фід увімкнено» і створіть токен. Посилання вставте в TikTok Ads Manager як заплановане джерело каталогу. Націнку, відбір і категорії — у «Маркетплейси → TikTok».
  • Товари «Тільки для оптових» і приховані для груп покупців у жоден публічний фід не потрапляють.

Замовлення з маркетплейсу

  • «Забирати нові замовлення кожні 5 хвилин» — для Rozetka (Seller API) і Prom/Епіцентру (API продавця); кнопка «Отримати замовлення зараз» перевіряє одразу. Замовлення з позначкою маркетплейсу з'являються в «Замовленнях».
  • «Передавати залишки й ціни одразу після змін (через API)» і «Оновлювати фід одразу після зміни залишків чи цін». Для Rozetka через Seller API одразу йде кількість у наявності; ціна, як і раніше, передається фідом, який теж оновлюється при кожній зміні.
  • Статус повертається на маркетплейс («Підтверджено», «Відправлено», «Скасовано») разом з ТТН; кнопка «Передати статус» повторює передачу. Коди статусів («Код статусу «Підтверджено»» тощо) змінюйте, лише якщо маркетплейс змінив свої.
  • «Фіскальний чек видає маркетплейс» — коли замовлення оплачене онлайн на маркетплейсі й чек уже видано; замовлення з оплатою при отриманні лишаються неоплаченими, і чек видаєте ви.

Епіцентр К

Епіцентр працює як Rozetka і Prom: каталог іде фідом, замовлення забираються через API продавця, а статус і ТТН повертаються назад. Окреме розширення для фіду не потрібне — фід Епіцентру формує сам розділ «Маркетплейси».

  1. Підключення. У «Налаштування → Маркетплейси» оберіть «Епіцентр К», позначте «Продавати на цьому маркетплейсі» і вставте «API-токен Епіцентру» (токен з кабінету продавця Епіцентру, розділ API). Токен зберігається зашифрованим.
  2. Категорії. У блоці «Відповідність категорій і характеристик» для кожної категорії магазину вкажіть код категорії Епіцентру («ID / код на маркетплейсі») і, за бажанням, «Назва на маркетплейсі». Підкатегорії успадковують відповідність. Код обов'язковий: товар без категорії Епіцентру у фід не потрапляє і рахується в рядку «Фід: …» як «затримано через помилки». У «Характеристиках» вкажіть «назва у вашому магазині = код параметра Епіцентру», наприклад «Колір = color».
  3. Фід. «Створити нове посилання» в блоці «Фід» → передайте посилання менеджеру Епіцентру або вставте в кабінеті продавця. Формат — YML: кожна пропозиція містить код категорії Епіцентру (<category code="…"> і <attribute_set code="…">), ціну з націнкою, стару ціну (якщо вона більша), артикул, штрихкод, залишок, до 15 фото, назву й опис окремо українською та російською (lang="ua", lang="ru"; якщо перекладу немає, береться основна назва) і характеристики з кодом параметра (paramcode). Блоку категорій магазину у фіді Епіцентру немає.
  4. Залишки й ціни. Через API Епіцентру вони не передаються — лише фідом. Позначка «Оновлювати фід одразу після зміни залишків чи цін» перебудовує фід після кожної зміни; Епіцентр підхопить його під час наступного читання.
  5. Замовлення. «Забирати нові замовлення кожні 5 хвилин» забирає замовлення Епіцентру в статусі «нове»; «Отримати замовлення зараз» перевіряє одразу. Товар у замовленні знаходиться за ідентифікатором пропозиції з фіду, а якщо його немає — за артикулом. У «Замовленнях» таке замовлення позначене «Епіцентр» (фільтр «Джерело»), з даними покупця, містом, адресою або номером відділення, службою доставки, способом оплати й коментарем.
  6. Статус і ТТН. «Підтверджено», «Відправлено» (разом з ТТН) і «Скасовано» передаються в Епіцентр кодами confirmed, sent, canceled; змінюйте їх у полях «Код статусу …», лише якщо Епіцентр змінить свої. «Передати статус» повторює передачу.
  7. Передоплата і чек. Замовлення приходить оплаченим, якщо Епіцентр позначив оплату як здійснену (оплата онлайн на маркетплейсі); оплата записується як оплата через Епіцентр. Якщо ввімкнено «Фіскальний чек видає маркетплейс», магазин не видає власний чек за цю оплату. Замовлення з оплатою при отриманні лишаються неоплаченими, і чек видаєте ви.

Обмін з API Епіцентру зроблено за його документацією, але ще не перевірено на справжньому акаунті продавця. Перші замовлення звірте з кабінетом Епіцентру; якщо з'явиться стан «Помилка», напишіть у підтримку Tobto.shop з кодом помилки.

Важливо

  • Фід для Rozetka і Prom використовує правила маркетплейсу, наприклад ліміт фото на товар (Prom — 10, Rozetka й Епіцентр — 15), вибір у полі «Маркетплейс».
  • Для Google і Meta можна також увімкнути «Ще й англійський фід»; Google потребує бренд («Бренд за замовчуванням»), а Meta — бренд або штрихкод.
  • Збій показується в стані «Помилка» з останнім кодом (наприклад, «маркетплейс не прийняв дані входу або токен»).
  • Звіт «Джерела продажів» (розділ «Аналітика») показує, звідки приходять покупці за utm-мітками, див. Аналітика й реклама.

Див. також