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