OpenCart 3.0.3.x ocStore 3.0.3.x YML/XML CRON

Универсальный импорт товаров из YML/XML

Автоматическая загрузка и регулярное обновление товаров, категорий, изображений, характеристик, цен и остатков из каталогов поставщиков. Модуль работает по ссылке или с загруженным XML-файлом и поддерживает несколько независимых профилей импорта.

Возможности модуля

Какие данные можно обновлять

Настройка цены

Итоговая цена рассчитывается по формуле:

Работа с отсутствующими товарами

Для товаров, которые импортировались ранее, но отсутствуют в новой версии XML, можно выбрать одно из действий:

• ничего не менять;
• отключить товар;
• установить количество товара равным нулю.

Защита от зависаний и ошибок 502

Импорт выполняется поэтапно:

• XML по ссылке загружается частями;
• категории и товары обрабатываются небольшими пакетами;
• время одного шага ограничено настройками;
• каждый следующий шаг выполняется отдельным запросом;
• параллельная обработка одного задания блокируется;
• для изображений используются отдельные ограничения времени и размера.

Такой подход снижает нагрузку на сервер и риск превышения допустимого времени выполнения PHP при работе с большими каталогами.

Журнал выполнения

В административной панели отображаются:

• статус и текущий этап задания;
• количество обработанных категорий и товаров;
• число добавленных и обновлённых товаров;
• количество пропущенных позиций и ошибок;
• подробный журнал импорта.

Выполняющееся задание можно остановить или продолжить из административной панели.

Инструкция по настройке и работе

1. Общие настройки

Для первого запуска рекомендуется использовать следующие значения:

2. Создание профиля

Нажмите «Добавить профиль» и укажите понятное название, например «Основной поставщик» или «Каталог автозапчастей».

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

3. Выбор источника

• URL — вставьте прямую ссылку на XML-файл поставщика в поле «URL XML».
• Загруженный XML-файл — выберите файл с расширением .xml на компьютере.

4. Режим категорий

ID целевой категории можно посмотреть в адресной строке при редактировании категории. Например, в адресе с параметром category_id=303 ID категории равен 303.

5. Идентификация товара

6. Язык и магазины

Выберите язык, на котором будут создаваться и обновляться товары.

Для основного магазина в поле «ID магазинов» укажите 0. Для мультимагазина можно перечислить несколько ID через запятую: 0,1,2.

7. Количество и статус отсутствия

Левое поле в строке «Количество по умолчанию» определяет остаток, если поставщик не передал количество в XML.

Правое поле — ID статуса отсутствия товара. Статусы находятся в разделе Система → Локализация → Состояния на складе.

8. Основные переключатели

• Профиль включён — разрешает работу профиля.
• Запускать по cron — включает автоматический импорт.
• Создавать категории — создаёт отсутствующие категории.
• Создавать товары — создаёт товары, которых ещё нет на сайте.
• Скачивать изображения — загружает фотографии поставщика.
• param → характеристики — создаёт характеристики из параметров XML.
• Генерировать SEO URL — создаёт SEO-адреса товаров и категорий.

9. Преобразование параметров в опции

Чтобы отдельные параметры <param> создавались как опции типа Select, перечислите их точные названия через запятую в поле «Параметры → опции».

Пример:

10. Выбор данных для обновления

В блоке «Что обновлять у существующих товаров» отметьте только те данные, которые модулю разрешено изменять.

11. Сохранение и первый запуск

1. Нажмите синюю кнопку «Сохранить» в правом верхнем углу.
2. Нажмите «Запустить этот профиль».
3. Дождитесь завершения ручного импорта.
4. Откройте несколько товаров и проверьте результат.

После первого запуска рекомендуется проверить:

• названия и описания;
• цены и остатки;
• категории;
• главные и дополнительные изображения;
• характеристики и опции;
• SEO URL;
• производителей.

12. Автоматический запуск по cron

Установите галочку «Запускать по cron» и задайте интервал в минутах:

После сохранения скопируйте «URL для cron» и добавьте его в планировщик заданий на хостинге. Сам cron рекомендуется вызывать каждую минуту:

* * * * * curl -fsS --max-time 40 'https://ваш-сайт.ru/index.php?route=extension/module/universal_yml_import/cron&token=ВАШ_ТОКЕН' >/dev/null

Модуль самостоятельно проверяет расписание профилей. Если задание уже запущено, следующий cron-вызов продолжит его обработку.

13. Удаление профиля

Нажмите красную кнопку «Удалить профиль», подтвердите действие, а затем обязательно нажмите синюю кнопку «Сохранить».

Удаление профиля не удаляет ранее импортированные товары из магазина.

Рекомендации перед первым импортом

• Создайте резервную копию базы данных и изображений.
• Начните с пакета 10–20 товаров.
• Для отсутствующих товаров выберите «Ничего не менять».
• Используйте SKU/vendorCode, если артикулы уникальны.
• Сначала выполните импорт вручную.
• Проверьте созданные и обновлённые товары.
• Только после проверки включайте автоматический запуск по cron.