Общая информация о модуле

CSV Price Pro import/export — один из самых мощных и надёжных инструментов для работы с данными в OpenCart. Последние версии 5.x ориентированы на OpenCart 3.x + PHP 7.4–8.1. Лицензия: один домен (включая поддомены и тестовые), есть пробные 7-дневные и тестовые 30-дневные ключи.

Основные возможности (v5.0+):

  • Импорт/экспорт товаров с ценами, остатками, атрибутами, опциями, скидками, акциями, изображениями
  • Полная поддержка мульти-магазинов и мульти-языков
  • Автоматическое создание недостающих категорий, производителей, атрибутов
  • Импорт изображений по URL (автозагрузка)
  • Два режима работы с атрибутами: объединённый (ATTRIBUTES) и отдельные поля
  • Планировщик задач (CRON)
  • Профили настроек (сохранение/загрузка)
  • Журнал операций
  • Экспорт заказов и клиентов

Ваша версия 5.0.12.18 — это одна из стабильных поздних сборок ветки 5.x (исправлены многие баги с PHP 8.x и большими файлами).

2. Интерфейс модуля

После установки модуль появляется в меню Extensions → Modules → CSV Price Pro import/export.

Основные вкладки (слева направо):

  • Основное — общие настройки модуля
  • Товары — импорт/экспорт товаров (самая используемая)
  • Категории — работа только с категориями
  • Производители — импорт/экспорт производителей
  • Клиенты — экспорт/импорт покупателей
  • Заказы — экспорт заказов (иногда и импорт)
  • Планировщик — настройка автоматических задач по CRON
  • Журнал — лог всех операций (очень полезно при отладке)
  • О модуле — версия, лицензия, контакты поддержки

На вкладке Товары → Импорт вы видите именно тот экран.

Подробное описание настроек импорта товаров

3. Подробное описание настроек импорта товаров

Вот разбор каждого поля на странице импорта (Товары → Импорт):

Поле / Элемент Значение по умолчанию / ваш скриншот Описание и рекомендации
Загрузить профиль Import - Default Product Import Выбор сохранённого профиля. Кнопки: обновить список, сохранить, удалить. Создавайте свои профили под разные задачи!
Создать новый профиль — Введите имя → нажмите зелёный «+». Очень удобно для разных поставщиков.
Кодировка файла UTF-8 Всегда оставляйте UTF-8 — это стандарт OpenCart. Проблемы возникают только при Windows-1251.
Разделитель полей CSV ; Самый надёжный вариант — точка с запятой (;). Запятая (,) часто ломается из-за текста в описаниях.
Локализация Russian Язык, на который импортируются названия/описания. Для мультиязыка — делайте отдельные файлы на каждый язык.
Режим импорта Только обновить (на скрине) Варианты: Только добавить / Только обновить / Обновить и добавить. Самый безопасный для цен — «Только обновить».
Ключевое поле Product Model По какому полю искать существующий товар для обновления. Самые надёжные: Product Model, SKU, Product ID.
Производитель Ключевое поле Производитель По какому полю искать/создавать производителя. Обычно оставляют «Производитель» (имя).
Импортировать id товара из файла Нет Если в файле есть колонка ID и вы хотите сохранить оригинальные ID — ставьте «Да» (редко нужно).
Разделитель для поля CATEGORY    
Заполнять родительские категории Нет Если «Да» — товар попадёт во все родительские категории пути. Обычно не нужно.
Главное меню для категорий Да Ставит галочку «В топ-меню» для главных категорий.
Показывать в категориях — Список категорий, в которых товар будет отображаться дополнительно.
Чекбоксы «Игнорировать при обновлении» Включены почти все Очень важные! Если галочка стоит — поле не обновляется при режиме «Обновить». Полезно для защиты цен, описаний и т.д.

Рекомендуемая базовая настройка для обновления цен/остатков:

  • Режим: Только обновить
  • Ключевое поле: Product Model или SKU
  • Галочки «Игнорировать» на всём, кроме: QUANTITY, PRICE, SPECIAL, DISCOUNT

4. Самые важные поля CSV (для товаров)

Вот таблица самых часто используемых полей (обязательно в верхней строке CSVиии

Поле в CSV Описание Формат примера Обязательно?
ID ID товара (только если импортируете) 145 Нет
NAME Название товара iPhone 14 Pro Max Да
MODEL Модель (самое надёжное ключевое поле) iphone-14-pro-max Да
SKU Артикул AP-IP14PM-128 Рекоменд.
MANUFACTURER Производитель (создаётся автоматически) Apple Да
PRICE Цена 5499.00 Да
QUANTITY Остаток 45 Да
CATEGORY Путь категории (по строкам или через ) Электроника|Смартфоны|Apple
DESCRIPTION Полное описание (HTML можно)

Отличный телефон...

 Рекоменд.
IMAGE Главное изображение catalog/iphone/14promax.jpg Рекоменд.
IMAGES Доп. изображения (через запятую) catalog/a.jpg,catalog/b.jpg Нет
ATTRIBUTES Атрибуты (по строкам) Цвет|Красный Память|256GB Нет
SPECIAL Акционная цена 1,999.00,2026-01-01,2026-02-28 Нет
SEO_KEYWORD ЧПУ (SEO URL) iphone-14-pro-max Рекоменд.

5. Как правильно подготовить CSV-файл

  1. Экспортируйте шаблон → Товары → Экспорт → выберите нужные поля → Экспорт → получите идеальный шаблон.
  2. Открывайте и редактируйте только в LibreOffice Calc или Apache OpenOffice (не в Excel!).
  3. При сохранении:
    • Кодировка: UTF-8
    • Разделитель полей: ; (точка с запятой)
    • Разделитель текста: " (двойные кавычки)
    • Галочка: Quote all text cells
  4. Проверяйте в текстовом редакторе (Notepad++): первая строка — названия полей с подчёркиваниями (NAME, PRICE и т.д.).

6. Типичные сценарии использования

Сценарий 1: Обновление только цен и остатков

  • Ключевое поле → Product Model
  • Режим → Только обновить
  • Галочки «Игнорировать» на всех полях кроме PRICE и QUANTITY
  • В CSV только 3 столбца: MODEL;PRICE;QUANTITY

Сценарий 2: Массовое добавление новых товаров от поставщика

  • Режим → Обновить и добавить
  • Ключевое поле → SKU или Model
  • Включить автосоздание категорий и производителей
  • Поле CATEGORY с полным путём

Сценарий 3: Импорт изображений по URL

7. Планировщик (CRON) — автоматическое обновление

  1. Создайте профиль импорта (например, «Цены_ежедневно»)
  2. Перейдите в Планировщик
  3. Добавьте задачу → выберите профиль → укажите период (ежедневно в 03:00)
  4. Скопируйте CRON-команду (выглядит примерно так): /usr/bin/php /home/user/public_html/admin/index.php?route=extension/module/csvprice_pro/cron&profile_id=5&key=ВАШ_СЕКРЕТНЫЙ_КЛЮЧ
  5. Добавьте в CRON на хостинге (cPanel → Cron Jobs)

8. Типичные ошибки и их решения

  • Ошибка «File encoding is not UTF-8» → пересохраните в UTF-8 без BOM
  • Товары не обновляются → проверьте ключевое поле и галочки «Игнорировать»
  • Изображения не грузятся → проверьте права на папку image/catalog (755–777), включите allow_url_fopen в php.ini
  • 504 Gateway Timeout → увеличьте max_execution_time до 600–1200 сек
  • Пустой лог → смотрите Журнал внутри модуля