Формат CSV-файла

Для успешного импорта данных, Ваш CSV-файл должен соответствовать определенному формату:

  • Каждый столбец CSV-файла должен иметь заголовок с правильным названием (например _NAME_, ниже приведён список заголовков);
  • Каждая строка файла это одна запись, связанная с товаром (категорией или производителем);
  • Значения отдельных колонок (полей) разделяются разделительным символом точкой с запятой (;);
  • Текстовые значения обрамляются символом двойные кавычки (").
  • Если в значении встречаются кавычки — они представляются в файле в виде двух кавычек подряд;

Пример данных из CSV-файла:

"_CATEGORY_";"_NAME_";"_MODEL";"_PRICE_";"_SKU_";"_QUANTITY_"
"Непонятные товары|Мётлы чудные";"Метла: Нимбус-2000";"Н-2000";2999.00;"19781712";100
Как открыть CSV-файл в MS Office Excel?
Читать в разделе С чего начать
Как сохранить CSV-файл в MS Office Excel?
Читать в разделе С чего начать

Описание полей (заголовков) CSV-файла

_ATTRIBUTES_

Используется: Товары
Формат поля: Многострочная запись
Это поле позволяет добавить или обновить атрибуты.
Формат поля это список атрибутов разделённых переносом строки, одна строка = один атрибут со значениями через вертикальную черту

(Группа атрибутов|Название атрибута|Значение атрибута)
Пример:

    Процессор|No. of Cores|8
    Память|test 1|32ГБ
    Дисплей|Разрешение экрана|1980x1280

Вертикальная черта в названиях атрибутов не допускается.

_CATEGORY_

Используется: Товары
Формат поля: Перечисление категорий в одну строку или несколько строк.
Каждая отдельная строка это одна категория, включая подкатегории, для товара с разделителем вертикальная черта (|).
Последняя категория (или первая, если всего одна строка) будет присвоена товару как _MAIN_CATEGORY_.
Пример:

Категория|Подкатегория|Подкатегория|Категория_товара_1
Категория|Подкатегория|Подкатегория|Категория_товара_2
Категория|Подкатегория|Подкатегория|Категория_товара_3
_COLUMN_

Используется: Категории
Формат поля: Целое число
Количество колонок в выпадающем меню категорий (только для главных родительских категорий).

_DESCRIPTION_

Используется: Товары, Категории, Производители
Формат поля: Многострочный текст с поддержкой HTML
Описание товара.

_DISCOUNT_

Используется: Товары
Формат поля: Многострочная запись
Это поле позволяет добавить или обновить скидки. Формат поля это список скидок разделённых переносом строки, одна или несколько, где одна строка = одна скидка со значениями через запятую:

(ID группы покупателей,Количество,Приоритет,Цена,Дата начала,Дата окончания) — где даты можно пропустить
Пример:

    1,2,3,999.00
    1,10,2,799.00,2012-10-01
    1,100,1,699.00,2012-10-01,2012-10-31

Значения цены должны указываться в виде целых или дробных чисел, где разделитель дробной части должна быть точка

_EAN_

Используется: Товары
Формат поля: Текст в одну строку
Европейский стандарт штрихкода.
Имеет ограничение по количеству символов (поле в таблице MySQL).

_HEIGHT_

Используется: Товары
Формат поля: Дробное число, где разделитель дробной части точка (Американский стандарт)
Габариты товара высота


_HTML_H1_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Это поле соответствует HTML-тег H1 (тот самый H1).

_HTML_TITLE_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Это поле соответствует HTML-тег Title.

_ID_

Используется: Товары, Категории, Производители
Формат поля: Целое число
Данное поле можно импортировать только в режиме «Только добавить» для новых товаров и новых производителей.

_IMAGE_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Изображение товара (категории или производителя), в виде имени файла и отностилеьного пути до директории с изображением.

Для OpenCart 1.5.x используется data/:

data/mycatalog/panaconik/my01010.jpg

Для OpenCart 2.x используется catalog/:

catalog/mycatalog/panaconik/my01010.jpg

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

Если включена опция «Докачка изображений», то в качестве значения должна быть указана ссылка на изображение

http://www.example.com/my_directory/image_name_01010.jpg
_IMAGES_

Используется: Товары
Формат поля: Текст в одну строку
Изображения товара, список названий, разделённых запятой, в виде имени файла и относительного пути до директории с изображением.

Для OpenCart 1.5.x используется data/:

data/mycatalog/panaconik/my01010.jpg,data/mycatalog/panaconik/my01011.jpg,data/mycatalog/panaconik/my01020.jpg

Для OpenCart 2.x используется catalog/:

catalog/mycatalog/panaconik/my01010.jpg,catalog/mycatalog/panaconik/my01011.jpg,catalog/mycatalog/panaconik/my01020.jpg

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

Если включена опция «Докачка изображений», то в качестве значения должна быть указаны ссылки на изображение

http://www.example.com/my_directory/image_name_01.jpg,http://www.example.com/my_directory/image_name_02.jpg
_ISBN_

Используется: Товары
Формат поля: Текст в одну строку
Международный стандартный книжный номер.
Имеет ограничение по количеству символов (поле в таблице MySQL).

_JAN_

Используется: Товары
Формат поля: Текст в одну строку
Японский номер товара.
Имеет ограничение по количеству символов (поле в таблице MySQL).

_LENGTH_

Используется: Товары
Формат поля: Дробное число, где разделитель дробной части точка (Американский стандарт)
Габариты товара длина

_LOCATION_

Используется: Товары
Формат поля: Текст в одну строку
Расположение где-либо, как-либо или в чём (доставерно не известно).
Имеет ограничение по количеству символов (поле в таблице MySQL).

_MAIN_CATEGORY_

Используется: Товары
Формат поля: Перечисление категорий в одну строку с разделителем вертикальная черта (|)
Пример:

Категория|Подкатегория|Подкатегория|Категория_товара

Данное поле есть только в версии ocStore.

_MANUFACTURER_

Используется: Товары
Формат поля: Текст в одну строку
Наименование производителя (Бренда).
Если такого производителя в магазине не существует, будет производитель будет создан автоматически.

_META_DESCRIPTION_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Мета-тег Description описание страницы (из области: что-то там про SEO-оптимизацию).

_META_KEYWORDS_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Мета-тег Keywords ключевые слова (из области: что-то там про SEO-оптимизацию).

_MODEL_

Используется: Товары
Формат поля: Текст в одну строку
Модель товара, если такая имеется.
Имеет ограничение по количеству символов (поле в таблице MySQL).

_MPN_

Используется: Товары
Формат поля: Текст в одну строку
Номер производителя.
Имеет ограничение по количеству символов (поле в таблице MySQL).

_NAME_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Импортируется или экспортируется в зависимости от выбранного языка (опция Локализация)

_OPTIONS_

Используется: Товары
Формат поля: Многострочная запись
Это поле позволяет добавить или обновить опции товара.
Описание: Импорт-экспорт Опций

_POINTS_

Используется: Товары
Формат поля: Целое число
Количество баллов для покупки товара.

_PRICE_

Используется: Товары
Формат поля: Дробное число, где разделитель дробной части точка (Американский стандарт)
Цена товара.
Пример:

2341.90
_PRODUCT_TAG_

Используется: Товары
Формат поля: Текст в одну строку
Теги товара, список слов или словосочетаний разделённых запятой.

_QUANTITY_

Используется: Товары
Формат поля: Целое число
Количество товара (ведение склада по магазину).

_RELATED_

Используется: Товары
Формат поля: Строка в виде перечисления ID товаров через запятую
Сопутствующие товары (вкладка Связи в редактировани товара)
Пример

34,12,45,33

Также может быть использован другой заголовок и данные о товаре:
_RELATED_ID_ — строка в виде перечисления ID товаров через запятую (синоним для _RELATED_);
_RELATED_NAME_ — строка в виде перечисления наименований товаров через запятую;
_RELATED_MODEL_ — строка в виде перечисления моделей товаров через запятую;
_RELATED_SKU_ — строка в виде перечисления SKU(артикулов) товаров через запятую;
_RELATED_MPN_ — строка в виде перечисления MPN товаров через запятую;
_RELATED_EAN_ — строка в виде перечисления EAN товаров через запятую;
_RELATED_JAN_ — строка в виде перечисления JAN товаров через запятую;
_RELATED_ISBN_ — строка в виде перечисления ISBN товаров через запятую;

_SEO_KEYWORD_

Используется: Товары, Категории, Производители
Формат поля: Текст без пробелов и разделителей
Это поле соответствует SEO URL и должно быть уникальным на всю систему.

_SHIPPING_

Используется: Товары
Формат поля: Целое число (0 или 1)
Статус доставки (Необходима доставка), 0 = Нет, 1 = Да

_SKU_

Используется: Товары, Категории, Производители
Формат поля: Текст в одну строку
Артикул товара (произвольный или по базе Вашего склада например).
Имеет ограничение по количеству символов (поле в таблице MySQL).

_SORT_ORDER_

Используется: Товары, Категории, Производители
Формат поля: Целое число
Порядок сортировки (што будем видеть в первых рядах)

_SPECIAL_

Используется: Товары
Формат поля: Многострочная запись
Это поле позволяет добавить или обновить акции товара.
Формат поля это список скидок разделённых переносом строки, одна строка = одна акция со значениями через запятую:

(ID группы покупателей,Приоритет,Цена,Дата начала,Дата окончания) — где даты можно пропустить
Пример:

    1,3,999.00
    1,2,799.00,2012-10-01
    1,1,699.00,2012-10-01,2012-10-31
_STATUS_

Используется: Товары, Категории, Производители
Формат поля: Целое число (0 или 1)
Статус, где 0 = выключен, 1 = включен.

_STOCK_STATUS_ID_

Используется: Товары
Формат поля: Целое число
ID статуса (Остутствие на складе).

_STOCK_STATUS_

Используется: Товары
Формат поля: Текст в одну строку
Статус, показываемый, когда товара нет на складе (Остутствие на складе), содаётся автоматически если такого статуса нет в базе магазина.

_TOP_

Используется: Категории
Формат поля: Целое число
Показывать в главном меню (только для главных родительских категорий).

_UPC_

Используется: Товары
Формат поля: Текст в одну строку
Номер производителя.
Имеет ограничение по количеству символов (поле в таблице MySQL).
Американский стандарт штрих-кода

_WEIGHT_

Используется: Товары
Формат поля: Дробное число, где разделитель дробной части точка (Американский стандарт)
Вес товара (кг, мг, и тд.)

_WIDTH_

Используется: Товары
Формат поля: Дробное число, где разделитель дробной части точка (Американский стандарт)
Габариты товара ширина