Епіцентр: ціни й наявність для WooCommerce

Епіцентр: ціни й наявність — плагін для WooCommerce, який надсилає ціну, стару (закреслену) ціну й наявність товарів магазину в кабінет Епіцентр Маркетплейс через офіційне API. Змінили ціну, скінчився залишок, запустили розпродаж — кабінет отримує те саме, без вивантаження файлів і без ручного редагування карток.

Описи товарів, які вже є в кабінеті, плагін не міняє. Він оновлює те, що змінюється щодня: скільки коштує і чи є в наявності. Картки в кабінеті лишаються вашими, плагін лише тримає ціни й залишки в синхроні з WooCommerce.

Нові товари плагін теж допомагає завести. Публічне API Епіцентру створювати товари не вміє, тож плагін збирає XML-файл для імпорту в кабінет: категорії й характеристики бере з довідника Епіцентру, значення — з ваших товарів, і показує, якої обовʼязкової характеристики бракує. Після модерації ціни й наявність цих товарів далі тримає синхронізація через API.

Навіщо це магазину

Продавець на Епіцентрі веде два каталоги: власний магазин і кабінет маркетплейсу. Ціну змінюють у WooCommerce, а в кабінеті вона лишається старою, поки хтось не дійде до неї руками. Товар закінчився у вас — на Епіцентрі його продовжують купувати, і замовлення доводиться скасовувати.

Кожне скасування б’є по рейтингу продавця, а ціна нижча, ніж на сайті, — по маржі. На кількох сотнях позицій ручна звірка не встигає за змінами, особливо коли той самий склад продає і сайт, і маркетплейс.

Плагін прибирає цю звірку: бачить, що в товарі змінилось, і надсилає в кабінет лише це.

Живе демо

У Епіцентру немає пісочниці: API відкривається тільки токеном живого кабінету продавця, тому показати відправку на чужому демо неможливо. Замість демо в плагіні є кнопка «Перевірити зв’язок»: ви вставляєте свій токен і одразу бачите, чи прийняв його кабінет, ще до першої відправки.

Що отримує адмін

Сторінка налаштувань у меню WooCommerce: підключення, що надсилати, автоматика, синхронізація, список товарів, які не оновились, і журнал пакетів. У картці кожного товару й кожної варіації, поруч з артикулом, видно рядок «Епіцентр» — що з цим товаром відбулось востаннє.

Що саме надсилається

Ціна. Береться ціна товару з податком або без — як ви оберете, щоб збігалася з тим, що бачить покупець. Ціни Епіцентр приймає лише в гривнях, тому ціну плагін надсилає, коли валюта магазину UAH; інакше йде тільки наявність.

Стара ціна. Якщо на товар діє акційна ціна WooCommerce, вона їде як ціна, а звичайна — як закреслена стара.

Наявність. «Є в наявності» — в наявності. Закінчився — «немає в наявності». Для товарів із дозволеним передзамовленням можна обрати, як показувати їх в Епіцентрі. Поріг залишку допомагає, коли той самий склад продає і сайт: залишок не більший за поріг уже вважається «немає».

Як знаходити товар. За артикулом: SKU на сайті має збігатися з «Артикулом» у кабінеті. Або за ID товару Епіцентру: плагін додає поле «ID товару в Епіцентрі» в картку товару й варіації, а якщо ID уже записав імпорт — можна вказати свій ключ мета-поля.

Варіації. Варіативний товар в Епіцентрі — це окремі позиції, тому надсилається кожна варіація зі своїм артикулом, ціною й залишком.

Як це працює — крок за кроком

1. Ви вставляєте токен кабінету й натискаєте «Перевірити зв’язок». Токен береться в кабінеті: «Налаштування компанії» → вкладка «API».

2. Натискаєте «Надіслати зміни зараз». Плагін проходить каталог частинами до 20 секунд, щоб не впертися в таймаут хостингу; на великому каталозі кнопку натискають ще раз, і прохід продовжується з того місця.

3. Змінене збирається в пакети до 1000 товарів і йде в Епіцентр. Товари, у яких нічого не змінилось від попередньої відправки, пропускаються.

4. Епіцентр застосовує зміни не миттєво. «Оновити статуси з Епіцентру» добирає результат: що оновлено, що вже було таким самим, що відхилено.

5. Товари з проблемою потрапляють у список «Товари, які не оновились» з поясненням зрозумілими словами.

У Pro кроки 2–4 відбуваються самі: зміна товару чи залишку ставить його в чергу, а раз на 10 хвилин плагін відправляє чергу й добирає результати.

Товари, які не оновились

Кабінет не завжди приймає зміну, і причина важлива. Товару з таким артикулом у кабінеті немає — треба звірити коди. Товар бере участь в акції Епіцентру — ціну змінити не можна, поки акція триває. У товару немає артикула — його нема чим знайти.

Плагін показує це словами, а не кодом відповіді API. Той самий набір значень повторно не надсилається, поки ви не зміните товар, — кабінет не отримує одну й ту саму помилку кожні 10 хвилин.

Журнал пакетів

Кожна відправка лягає в журнал: коли, кнопкою чи автоматично, скільки товарів і що з ними сталося. Пакет, який Епіцентр ще обробляє, чекає добору статусів, після чого закривається підсумком. Журнал можна очистити однією кнопкою.

Нові товари з характеристиками

Епіцентр приймає новий товар лише з обовʼязковими характеристиками зі свого довідника: бренд, країна, обʼєм — у кожної категорії свій набір і свої коди значень. Вручну це таблиця на сотні рядків. Плагін робить із цього три кроки:

1. Довідник. Кнопка тягне категорії Епіцентру через API, а набори характеристик і значення списків довантажуються лише для потрібних категорій.
2. Звʼязки. Для категорії магазину вибираєте категорію Епіцентру пошуком за назвою, а для кожної характеристики — звідки брати значення: атрибут, бренд, GTIN, мета-поле, вага й габарити (переводяться в грами й міліметри) або одне значення на всі товари. Значення списків підставляються за назвою, розбіжності на кшталт «Рінгель» → «Ringel» зіставляються вручну.
3. Файл. Плагін збирає XML у форматі імпорту Епіцентру й показує товари, які не потрапили у файл, з причиною: немає фото, порожня обовʼязкова характеристика, значення немає в довіднику. Файл завантажується в кабінеті: «Імпорт» → «Файл» → «Оновити все».

Без Pro файл збирається для однієї категорії магазину, з Pro — для всіх і перезбирається сам щодоби.

Безкоштовна версія і Pro

Безкоштовна версія робить синхронізацію кнопкою: ціна, стара ціна, наявність, варіації, пропуск незмінених товарів, добір статусів, статус у картці товару, список проблемних товарів і журнал. Обмежень за кількістю товарів немає.

Pro прибирає ручну частину і додає правила:

— автоматичне оновлення: раз на 10 хвилин плагін забирає товари, в яких змінилась ціна чи залишок;
— множник ціни з округленням до гривні — наприклад, ціна на Епіцентрі на 15% вища, щоб покрити комісію; стара ціна множиться так само;
— файл нових товарів для будь-якої кількості категорій і щоденне перезбирання;
— виключення категорій — товари, ціну й наявність яких ви ведете в кабінеті самі, плагін не чіпає.

Pro можна спробувати 7 днів безкоштовно, без картки.

Скільки коштує

Ліцензія Pro — 990 грн, на один домен. Ліцензія річна (можна взяти на 1–5 років): у неї входять оновлення й підтримка на цей строк.

Технічні вимоги

WordPress 6.2 і новіший, WooCommerce, PHP 7.4 і новіший. Плагін сумісний з HPOS — окремими таблицями замовлень WooCommerce. Потрібен вихідний HTTPS до API Епіцентру і валюта магазину UAH для надсилання цін.

Що під капотом

Плагін працює через офіційні ендпоінти Merchant API Епіцентру для оновлення цін і наявності — без парсингу кабінету й без імітації входу. Токен зберігається в базі в зашифрованому вигляді.

Що саме відправлено й що відповів кабінет, зберігається в мета-даних товару, тому плагін знає, що змінилось, і не шле зайвого. Черга змін живе в одній опції й обмежена за розміром, журнал тримає останні 30 пакетів. Автоматика працює на WP-Cron.

На вітрині плагін нічого не додає — покупець його не бачить і не може сповільнити.

Як встановити

1. Завантажте архів у «Плагіни → Додати новий → Завантажити плагін» і активуйте.

2. WooCommerce → «Епіцентр: ціни й наявність» — вставте токен кабінету й натисніть «Перевірити зв’язок».

3. Оберіть, як знаходити товар: за артикулом або за ID товару Епіцентру.

4. Натисніть «Надіслати зміни зараз», а за кілька хвилин — «Оновити статуси з Епіцентру».

Якщо вкладки «API» в кабінеті не видно, доступ до оновлення цін і наявності відкриває ваш категорійний менеджер Епіцентру.

Історія версій

1.1.0 — XML-файл нових товарів з характеристиками для імпорту в кабінет: довідник категорій і характеристик Епіцентру через API, звʼязка категорій, джерела значень, зіставлення значень списків і звіт про товари, які не потрапили у файл. Без Pro — одна категорія, з Pro — усі й щоденне перезбирання.

1.0.0 — перший випуск. Ціна, стара ціна й наявність в Епіцентр Маркетплейс через API, варіації, пошук товару за артикулом або ID Епіцентру, податок у ціні, поріг залишку, передзамовлення, пропуск незмінених товарів, пакети до 1000 записів, добір статусів, статус у картці товару, список товарів, які не оновились, журнал пакетів, сумісність з HPOS. У Pro — автоматичне оновлення кожні 10 хвилин, множник ціни з округленням і виключення категорій.