Market Feeds — Rozetka / Prom для OpenCart 2.3, 3.x и 4.x

Market Feeds — модуль фидов для OpenCart 2.3, 3.x и 4.x, который выгружает каталог магазина в два самых популярных украинских маркетплейса: Rozetka (XML) и Prom.ua (YML). Вместо ручного экспорта или самописных скриптов вы получаете два постоянных URL-фида, защищённых секретным токеном — маркетплейсы сами забирают актуальные товары, цены и остатки по своему расписанию. Генерация потоковая, поэтому фид не «кладёт» сервер даже на больших каталогах.

Модуль полностью бесплатный. Код открыт: github.com/catcodestudio/opencart-market-feeds. Никаких платных версий, лимитов или лицензионных ключей — все функции доступны сразу после установки.

Google Merchant Center и Meta с вариантами

С версии 1.2.0 (OpenCart 4.x и 3.x) и 1.1.0 (OpenCart 2.3) модуль отдаёт ещё два фида: для Google Merchant Center и для каталога Meta (реклама в Facebook и Instagram). Формат — RSS 2.0 с атрибутами g:, тот самый, который принимают оба кабинета. Цены с налогом, акции, наличие и фильтры категорий берутся те же, что в фидах Rozetka и Prom, поэтому цена в рекламе не расходится с ценой на странице товара, а ссылка на товар идёт с ЧПУ, как её печатает витрина.

Размеры и цвета — одной карточкой, а не дублями. В OpenCart размер и цвет — это опции без собственных артикулов, поэтому обычный фид отдаёт один товар, и реклама крутится на нём или на копиях. В настройках вы отмечаете, какие опции означают «Размер», а какие — «Цвет». Каждое значение, а для двух опций каждая комбинация размер × цвет, идёт отдельным товаром с общим g:item_group_id, заполненными g:size и g:color. Цена варианта считается так же, как в корзине: цена товара или акционная плюс надбавка опции, вместе с налогом. Значение, которого нет на складе, в фид не попадает (или идёт как «нет в наличии», если так настроено).

Реальный срок отправки. Товар «в наличии», но отправка через 2–6 дней — обычная история при работе с поставщиком. Задайте типовой срок в рабочих днях («0», «2» или «2-6») и, при необходимости, отдельный для товара через любой атрибут. Google получает g:min_handling_time и g:max_handling_time и показывает покупателю честную дату доставки. В фиде Prom.ua статус «Готово к отправке» (in_stock="true") ставится только товарам, которые действительно уходят за один день.

Оба фида выключены по умолчанию: после обновления магазин не публикует ничего нового, пока вы не включите их на вкладке «Google и Meta» и не вставите ссылку в Merchant Center или Commerce Manager.

Как это работает — шаг за шагом

1. Устанавливаете модуль и одним кликом генерируете секретный токен доступа — без него фид недоступен посторонним.
2. Настраиваете выгрузку: валюта, язык, множитель цены, фильтры по категориям и производителям (пусто = весь каталог).
3. Копируете готовые URL фидов со страницы настроек — отдельно для Rozetka (feed.rozetka) и Prom.ua (feed.prom).
4. Вставляете ссылки в кабинетах маркетплейсов — Rozetka и Prom.ua сами периодически читают фид и обновляют товары, цены и остатки.
5. Акции подхватываются автоматически: если на товар действует спеццена, она становится <price>, а обычная цена — <price_old> (маркетплейс показывает скидку).
6. Для больших каталогов включаете файловый кеш: фид перестраивается кроном в фоне и отдаётся маркетплейсу мгновенно.

Что под капотом

• Потоковая генерация через XMLWriter — товары выбираются постранично, изображения, атрибуты и акции подгружаются батчами. Стабильное потребление памяти независимо от размера каталога.
• Токен-защита URL — фид отдаётся только с секретным параметром token; сгенерировать новый можно одним кликом в админке.
• Акционные цены через родную механику каждой ветки — product_discount в OpenCart 4.1, отдельная product_special в 4.0, 3.x и 2.3; схема определяется автоматически.
• Правильные теги остатков для каждой платформы: Rozetka получает stock_quantity, Prom — quantity_in_stock, плюс настраиваемый порог «в наличии».
• Cron-кеш в файл — в OpenCart 4 маршрут extension/cc_feeds/cron.rebuild перестраивает фид по расписанию, в 3.x и 2.3 то же делает защищённая токеном ссылка для crontab хостинга; кнопка «Проверить» в админке показывает, сколько товаров попадёт в выгрузку.

Как установить

1. Возьмите сборку под свою версию магазина: cc_feeds.ocmod.zip (OpenCart 4.0.2–4.1.x), cc_feeds-oc3.ocmod.zip (3.0.2–3.0.5.0) или cc_feeds-oc2.ocmod.zip (2.3.0.0–2.3.0.2).
2. В OpenCart 3 и 4 архив ставится через Расширения → Инсталлятор. В 2.3 штатный инсталлятор работает только по FTP, поэтому надёжнее распаковать архив и залить содержимое папки upload/ в корень магазина.
3. Расширения → Модули (в OpenCart 3.x — тип расширений «Фиды») → найдите Market Feeds → Установить → Настроить.
4. Сгенерируйте токен, выберите валюту, язык и фильтры → Сохранить.
5. Скопируйте URL фидов из секции «Ссылки на фиды».
6. Добавьте ссылки в кабинетах Rozetka и Prom.ua как источник импорта товаров.
7. Опционально: включите «Кешировать в файл» и добавьте cron-задачу на перестройку кеша — готовая строка показана на странице настроек (в OpenCart 3.x и 2.3 это единственный способ обновлять кеш, потому что планировщика в ядре нет).