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

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

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

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

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

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

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

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

Живе демо

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

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

Одна сторінка в «Розширення → Модулі»: підключення, що саме надсилати, синхронізація, список товарів, які не оновились, і журнал пакетів. Над кнопкою видно лічильники: скільки товарів оновлено, скільки ще в обробці Епіцентру, скільки не знайдено в кабінеті й скільки змін чекає на відправку.

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

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

Стара ціна. Якщо на товар діє акція, акційна ціна їде як ціна, а звичайна — як закреслена стара. Акції з OpenCart 2.3 і 3.x, і нова схема знижок OpenCart 4.1 враховуються однаково.

Наявність. Товар із залишком більшим за поріг — «в наявності». Закінчився — «немає в наявності» або «під замовлення», як ви оберете. Вимкнений на сайті товар на маркетплейсі теж не продається.

Код товару. Епіцентр знаходить ваш товар за артикулом. Модуль бере артикул (SKU), а якщо він порожній — модель. Можна примусово брати тільки модель.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ліцензія Pro — 1 290 грн, на один домен. Для OpenCart ліцензія назавжди: оплачуєте один раз, і Pro-можливості лишаються з вами без щорічних платежів.

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

Підтримуються OpenCart 4.x, 3.x і 2.3 та ocStore на цих версіях — окремі архіви під кожну гілку. PHP — той, на якому працює ваша версія OpenCart. Потрібне розширення cURL і вихідний HTTPS до API Епіцентру.

Ціни Епіцентр приймає лише в гривнях, тому в магазині має бути валюта UAH. Якщо основна валюта інша, модуль переведе ціну за курсом із «Локалізація → Валюти».

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

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

Стан кожного товару — що саме відправлено й що відповів кабінет — лежить в окремій таблиці, тому модуль знає, що змінилось, і не шле зайвого. Ліміт Епіцентру в 120 запитів за 2 хвилини модуль тримає сам: якщо його досягнуто, решта піде наступним проходом.

Для автоматики в OpenCart 4 модуль реєструє завдання в планувальнику, а для частішого запуску і в OpenCart 2.3 та 3.x показує посилання з токеном для cron хостингу. На вітрині модуль нічого не додає — покупець його не бачить.

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

1. Завантажте архів під свою версію: в OpenCart 4.x і 3.x — через «Розширення → Установник розширень». В OpenCart 2.3 установник працює лише через FTP, тому вміст папки upload заливається в корінь магазину.

2. «Розширення → Модулі» → «Епіцентр: ціни й наявність» → «Встановити».

3. Відкрийте налаштування, вставте токен кабінету й натисніть «Перевірити».

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

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

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

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

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