Эпицентр: цены и наличие для 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 минут, множитель цены с округлением и исключение категорий.