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

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

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

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

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

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

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

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

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

Сторінка налаштувань у меню 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 — для всіх і перезбирається сам щодоби.

Файл змінених товарів і перевірка перед імпортом

Повний файл на кілька тисяч товарів кабінет обробляє довго, а за день у магазині змінюється десяток позицій. Тому кожне збирання тепер пише два файли: повний і файл лише змінених товарів. Плагін запамʼятовує відбиток кожного рядка <offer> і наступного разу порівнює з ним — у файл змінених потрапляють тільки ті товари, у яких справді щось інше: ціна, стара ціна, наявність, назва, фото чи характеристика.

Після збирання у звіті видно рядок «Змінених з минулого збирання: 12, без змін: 3 480», посилання на обидва файли й окремий блок «Зникли з файлу» — артикули, які були в минулому файлі, а тепер ні: товар вимкнули, прибрали з категорії або в нього загубився обовʼязковий реквізит. Імпорт такі товари з кабінету не прибирає, тож їх варто зняти там руками.

Файл змінених беруть так само, як повний: кнопкою на сторінці «Епіцентр: товари». Обидва файли лежать поруч у непублічній теці wp-content/uploads/cceps-epicentr, посилання на кожен — в адмінці.

Звіт «що кабінет відхилить»

Раніше про помилку у файлі ставало відомо вже в кабінеті: «Невідомий тег shop у рядку 3» — і імпорт зупинено. Тепер файл перевіряється до завантаження: кнопки «Перевірити файл» і «Перевірити файл змінених» читають готовий XML так само, як його читає Епіцентр, і називають проблему разом з номером рядка:

• сторонній тег поза тим набором, який приймає кабінет, — саме той рядок, на якому імпорт обірветься;
• той самий артикул у файлі двічі — кабінет зіставляє товар за артикулом, і другий рядок перезапише перший;
• офер без артикула;
• обірваний XML або не-UTF-8 рядок — з номером рядка;
• порожній файл або файл без жодного товару.

Окремою таблицею йдуть товари, які кабінет прийме, але з втратами: недосяжне фото (локальна адреса, формат не jpg/png/webp, пробіл в адресі), код категорії, якого немає в довіднику, обрізані назва (150 символів) і опис (12 160), стара ціна, яку кабінет проігнорує, бо після націнки й округлення вона вже не більша за поточну, битий GTIN за контрольною сумою і необовʼязкові характеристики, які тихо не потраплять у картку. Такі товари імпортуються — просто тепер видно, що саме з них зникне.

Файл змінених — можливість Pro; відбитки рахуються завжди, тому одразу після купівлі Pro перший файл змінених уже коректний. Перевірка файлу працює і в безкоштовній версії.

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

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

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

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

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

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

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

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

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

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