Импорт прайсов поставщиков для OpenCart 2.3, 3 и 4

Импорт прайсов поставщиков обновляет цены и остатки в OpenCart из файла, который прислал поставщик — Excel, CSV или XML/YML, с компьютера или по ссылке. Есть три сборки: для OpenCart 4.0.2 – 4.1.x, 3.0.2 – 3.0.5.0 и 2.3.0.x; функциональность одинаковая, отличается только пакет. Код открытый, ionCube не нужен, файлы ядра не меняются.

Любой файл поставщика

Модуль читает XLSX (обычный Excel, без пересохранения в CSV), CSV в UTF-8 или windows-1251 с любым разделителем, а также XML и YML — тот формат, в котором прайсы отдают Rozetka, Prom и большинство украинских дистрибьюторов. Разделитель, кодировка и формат определяются автоматически; лист Excel, количество служебных строк сверху и тег товара в XML при необходимости указываются вручную.

Прайс можно загрузить файлом или дать ссылку — тогда модуль сам забирает его с сайта поставщика при каждом запуске.

Колонки определяются сами

Модуль читает заголовок файла и сам находит, где артикул, где цена, где остаток: понимает «Артикул», «Код товара», «Цена закупочная», «Наличие», «vendorCode», «stock_quantity» и десятки других вариантов написания. Любое соответствие можно переопределить вручную — рядом показаны первые строки файла, чтобы было видно, что именно попадёт в магазин.

Товар находится по артикулу (SKU, MPN или модель), отдельно по модели или по штрих-коду (EAN, UPC, JAN, ISBN) — тем полем, которое реально заполнено в вашем каталоге.

Цена считается по вашим правилам

Цена поставщика не попадает в магазин напрямую. Сначала она переводится из валюты прайса по курсу магазина или по курсу, который вы укажете. Дальше применяется наценка уровнями: до 500 грн — 40%, от 500 до 2000 — 25%, выше — 15% плюс фиксированная сумма, сколько уровней нужно. Затем — округление: до гривны, до десятки или до привычного «…,99», «…,95», «…,50». Есть и нижняя граница цены, ниже которой модуль не опускается.

Остатки понимают не только числа: «в наличии», «под заказ», «нет» превращаются в количество по вашей таблице соответствий. Можно умножать остаток на коэффициент, ограничивать потолком и автоматически выключать товар, когда остаток стал нулём.

Защита от испорченного прайса

Поставщик один раз выгрузил цены в копейках или сдвинул колонку — и весь каталог поехал. Чтобы такого не случилось, укажите лимит изменения в процентах: строки, где цена меняется сильнее, чем разрешено, не записываются, а показываются отдельным списком «Подозрительное изменение». Вы смотрите на них и решаете сами.

Сначала план, потом запись

Модуль никогда не пишет в каталог сразу. Сначала он читает файл, сопоставляет его с товарами и показывает полный план: сколько строк прочитано, сколько найдено в каталоге, какие цены и остатки изменятся — таблица «было → станет» по каждому товару. Отдельно видно строки с неизвестными кодами, подозрительные изменения, ошибки и те, где ничего не изменилось.

Только после вашего подтверждения план применяется — пакетами, поэтому 40 тысяч строк не зависят от того, выдержит ли один запрос таймаут сервера.

Товары, которых нет в прайсе

Если поставщик больше не возит позицию, её можно автоматически обнулить по остатку, выключить или сделать и то, и другое. Правило работает только в пределах выбранного производителя или категории — именно поэтому частичный прайс одного поставщика не выключает весь каталог.

Журнал и откат

Каждый запуск сохраняется: когда, из какого файла, сколько строк прочитано и сколько товаров обновлено. Все изменения записываются по полям — старая и новая цена, старый и новый остаток, — поэтому любой запуск откатывается одним кликом к значениям, которые были до него. Это не «восстановите бэкап базы», а точный возврат именно тех товаров, которых коснулся импорт.

Автоматическое обновление по расписанию

Профиль поставщика со ссылкой на прайс можно поставить на расписание — ежечасно, каждые 6 часов, ежедневно или еженедельно. Модуль сам забирает файл, считает цены по вашим правилам и обновляет каталог; результат каждого запуска остаётся в истории с тем же откатом. Запуск выполняется по адресу cron с секретным токеном, чтобы никто посторонний не мог запустить импорт.

Зачем это магазину

Прайс поставщика — это почти всегда чужой Excel с произвольными колонками, который приходит раз в неделю и каждый раз немного другой. Ручное сведение такого файла с каталогом занимает часы и заканчивается ошибками в ценах.

Модуль забирает эту работу: сам распознаёт колонки, считает цену по вашим правилам и показывает план изменений до того, как что-то запишется.

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

1. Залейте архив через «Расширения → Установщик расширений» и установите модуль.

2. Загрузите один прайс и проверьте, правильно ли определились колонки.

3. Задайте правила цены и поведение для товаров вне прайса.

4. Посмотрите план изменений, и только тогда запускайте запись.