Формат полей при импорте¶
В импортируемом CSV-файле с информацией о товарах могут быть колонки, перечисленные ниже. Если вам нужен пример CSV-файла, вы можете посмотреть наш пример или экспортировать товары самостоятельно — так вы получите наглядный пример из вашего магазина.
Важно
CS-Cart и Multi-Vendor поддерживают только файлы с кодировкой UTF-8. Если какие-то значения импортируются неправильно (или не импортируются вообще), попробуйте сохранить файл в кодировке UTF-8 и импортировать его снова.
- Product code
- Language
- Product id
- Product type
- Category
- Price
- List price
- Status
- Quantity
- Weight
- Min quantity
- Max quantity
- Quantity step
- List qty count
- Shipping freight
- Date added
- Downloadable
- Files
- Ship downloadable
- Inventory tracking
- Out of stock actions
- Free shipping
- Feature comparison
- Zero price action
- Advanced Import: Images
- Detailed image
- Thumbnail
- Product name
- Description
- Short description
- Meta keywords
- Meta description
- Search words
- Page title
- Promo text
- Taxes
- Features
- Options
- Variation options
- Secondary categories
- Items in box
- Box size
- Usergroup IDs
- Available since
- Exceptions type
- Options type
- Store
- SEO name
- Pay by points
- Override points
- Override exchange rate
- Popularity
Product code¶
Это поле является обязательным и должно быть уникальным для каждого товара. В полее можно вводить цифры, буквы и их сочетания (до 32 символов). Если вы хотите экспортировать данные товаров в CSV-файл, убедитесь, что у каждого товара заполнено поле КОД.
Важно
ПРИМЕР: B0002OG6NY
Предупреждение
Если значение в этом поле совпадает с кодом любого уже существующего товара, то при импорте будут обновлены данные этого товара.
Language¶
Код языка, состоящий из двух букв в нижнем регистре. Это обязательное поле.
Чтобы узнать код языка:
- Откройте страницу Администрирование → Языки в панели администратора.
- Перейдите на вкладку Доступные.
- Найдите нужный язык, а затем найдите его код в колонке Код языка.
Важно
ПРИМЕР: en
Product id¶
Числовой идентификатор товара в базе данных магазина. Если у товара нет Product code то для идентификации товара будет использоваться Product id.
Важно
ПРИМЕР: 130
Product type¶
Примечание
Это поле — часть модуля “Вариации товаров”.
P
— простой товар;C
— настраиваемый товар;V
— вариация настраиваемого товара.
Важно
ПРИМЕР: C
Category¶
Полный путь до основной категории товара. Родительские и дочерние категории в пути должны отделяться друг от друга с помощью Разделителя категорий, который вы задаёте, когда вы импортируете товары в CSV-файле.
Важно
ПРИМЕР (с разделителем ///): Компьютеры///Ноутбуки
Примечание
Если указанные родительские и дочерние категории не существуют, они будут созданы.
Если название вашей категории содержит двоеточие (:
), например Промо-акции///Скидка: 10%, то в импортируемом файле нужно экранировать категорию следующим образом: |Промо-акции///Скидка: 10%|
. Иначе категория импортируется неправильно.
List price¶
Рекомендуемая цена товара. Используется для отображения скидки на витрине: Скидка = List price - Price
. Эта цена должна быть в формате 0.00.
Важно
ПРИМЕР: 1750.00
Status¶
Статус товара:
- A — включен — товар появляется на витрине;
- H — скрыт — товар не появляется на витрине, но покупатели могут увидеть его по прямой ссылке;
- D — выключен — товар можно увидеть только в панели администратора.
Важно
ПРИМЕР: A
Weight¶
Вес товара. Единицу веса можно настроить на странице Настройки → Общие. По умолчанию это кг.
Важно
ПРИМЕР: 20.25
Примечание
Вес должен быть целым числом или десятичной дробью с не более чем двумя цифрами в дробной части. Целую часть от дробной отделяет точка (.
).
Min quantity¶
Минимальное количество экземпляров товара, которое может быть куплено в одном заказе.
Важно
ПРИМЕР: 1
Max quantity¶
Максимальное количество экземпляров товара, которое может быть куплено в одном заказе.
Важно
ПРИМЕР: 10
Quantity step¶
Шаг, на который можно изменить количество экземпляров выбранного товара в корзине. Например:
- у Min quantity значение 2;
- у Max quantity значение 10;
- у Quantity step значение 2.
В этом случае покупатели смогут приобрести 2, 4, 6, 8 или 10 экземпляров товара в заказе.
Важно
ПРИМЕР: 1
List qty count¶
Максимальное количество вариантов в выпадающем списке выбора количества экземпляров товара в корзине. Например:
- у Min quantity значение 2;
- у Max quantity значение 10;
- у Quantity step значение 2;
- у List qty count значение 3.
Тогда покупатели смогут выбирать между 2, 4 или 6 экземплярами этого товара.
Важно
ПРИМЕР: 10
Примечание
Если использовать List qty count, то поле Количество на странице товара на витрине станет выпадающим списком.
Shipping freight¶
Дополнительная надбавка к стоимости доставки за этот товар; указывается в главной валюте магазина и прибавляется к автоматически рассчитанной или заданной стоимости доставки. Это поле можно использовать как стоимость упаковки.
Важно
ПРИМЕР: 2.00
Примечание
Допустим, CS-Cart рассчитал стоимость доставки 500 рублей; тогда, если надбавка составляет 50 рублей, а мы покупаем 3 экземпляра товара, то стоимость доставки будет 650 рублей.
Date added¶
Дата, когда товар был добавлен. Задаётся в формате:
dd mmm yyyy 00:00:00
Важно
ПРИМЕР: 25 Dec 2011 14:05:00
Примечание
Если это поле не заполнено, то будут использованы дата и время, когда товар был импортирован.
Downloadable¶
- Y — товар является скачиваемым;
- N — товар не является скачиваемым.
Важно
ПРИМЕР: Y
Примечание
Чтобы в магазине можно было создавать скачиваемые товары, откройте страницу Настройки → Общие и поставьте галочку Включить продажу цифровых товаров.
Files¶
Полный путь к файлам цифрового товара.
Важно
ПРИМЕР: /home/client/public_html/cscart-4.4.1/var/files/exim/backup/downloads/filename.pdf
Можно указать просто название файла без пути, если при импорте CSV-файла с товарами вы зададите настройку Директория с файлами. Если вы указываете несколько файлов, разделяйте их запятыми.
Важно
ПРИМЕР: file1.pdf, file2.jpg
Ship downloadable¶
- Y — рассчитывать стоимость доставки для цифрового товара так же, как и для физического;
- N— не рассчитывать стоимость доставки для цифрового товара.
Важно
ПРИМЕР: Y
Inventory tracking¶
- D — не отслеживать количество товаров в наличии;
- B — отслеживать количество товаров в наличии без учёта опций;
- O — отслеживать количество товаров в наличии с учётом опций.
Важно
ПРИМЕР: D
Out of stock actions¶
Этот столбец определяет, что покупатели смогут сделать на странице товара, если товара нет в наличии:
- B — предзаказать товар;
- S — подписаться на уведомление о количестве товара в наличии;
- N — ничего (действие не выбрано).
Важно
ПРИМЕР: B
Free shipping¶
- Y — товар доставляется бесплатно и не будет учитываться при расчёте стоимости доставки, если способ доставки можно использовать для бесплатной доставки;
- N — товар не доставляется бесплатно и всегда будет учитываться при расчёте стоимости доставки.
Важно
ПРИМЕР: Y
Feature comparison¶
- Y — товар можно добавить в список сравнения;
- N — товар нельзя добавить в список сравнения.
Важно
ПРИМЕР: Y
Примечание
Это поле существовало до версии 4.3.5. Начиная с CS-Cart 4.3.6 добавить в список сравнения можно любой товар.
Zero price action¶
Это поле описывает действия, доступные для покупателя при нулевой цене.
- R — запретить добавление товара в корзину;
- P — разрешить добaвление товара в корзину;
- A — попросить покупателя ввести цену.
Важно
ПРИМЕР: A
Advanced Import: Images¶
Примечание
Это поле доступно только с модулем Расширенный импорт товаров [Beta].
Путь (или пути) к изображениям товаров. Если изображений несколько, отделяйте пути к ним с помощью разделятеля изображений из дополнительных настроек во вкладке Файл на странице пресета импорта.
Важно
ПРИМЕР: exim/backup/images/main_image.jpg///exim/backup/images/additional_image.jpg
Можно указать просто название файла с изображением без пути, если при импорте CSV-файла с товарами вы зададите настройку Директория с изображениями.
После пути можно задать альтернативный текст для изображения.
Важно
EXAMPLE: exim/backup/images/main_image.jpg#{[ar]:Текст на арабском;[en]:Текст на английском;}///exim/backup/images/Nadditional_image.jpg#{[ar]:Текст на арабском;[en]:Текст на английском;}
Если каждое изображение находится в отдельном столбце (в файле CSV) или узле (в файле XML), то всем этим столбцам или узлам можно задать соотвествие со свойством Advanced Import: Images. Тогда данные объединятся правильно, и для товара импортируется несколько изображений.
Detailed image¶
Полный путь к детальному изображению товара.
Важно
ПРИМЕР: /home/client/public_html/cscart/var/files/exim/backup/images/detailed_image.jpg
Можно указать просто название файла с изображением без пути, если при импорте CSV-файла с товарами вы зададите настройку Директория с изображениями.
После пути можно задать альтернативный текст для изображения. Например, зададим текст для английского и немецкого языков:
Важно
ПРИМЕР: /home/client/public_html/cscart/var/files/exim/backup/images/detailed_image.jpg#{[de]:Пример текста на немецком;[en]:Пример текста на английском;}
Thumbnail¶
Полный путь к иконке товара. Иконки генерируются из детальных изображений автоматически, поэтому это поле нужно заполнять, только если вы хотите использовать иконку, которая отличается от детального изображения.
Важно
ПРИМЕР: /home/client/public_html/cscart/var/files/exim/backup/images/thumbnail_image.jpg
Примечание
Путь и альтернативный текст для иконки указываются так же, как для детального изображения.
Product name¶
Название товара; может содержать до 255 символов.
Важно
ПРИМЕР: Брюки для разогрева Adidas
Description¶
Подробное описание товара, может содержать до 16 777 215 символов.
Важно
ПРИМЕР: Брюки Adidas на боковой разъемной застежке-молнии. Идеальны для разогрева перед соревнованиями или тренировки. Доступны в трёх цветах: чёрный, тёмно-синий, белый.
В импортируемом файле может быть HTML-разметка, которая влияет на внешний вид текста. Чаще всего она встречается в описании, например:
<p>Брюки <i>Adidas</i> на боковой разъемной застежке-молнии.</p>
При импорте CSV-файла проблем нет. Но если вы импортируете XML-файл, то возникает проблема: теги в XML и в HTML выглядят одинаково (<...>
), и импорт не может понять, что есть что. Поэтому нужно отделить HTML-теги, которые должны импортироваться в описание как есть, от XML-тегов, которые задают структуру файла. Текст с HTML-разметкой должно выглядеть так:
<![CDATA[<p>Брюки <i>Adidas</i> на боковой разъемной застежке-молнии.</p>]]>
Short description¶
Краткое описание товара; может содержать до 16 777 215 символов.
Важно
ПРИМЕР: Брюки Adidas на боковой разъемной застежке-молнии.
Meta keywords¶
Ключевые слова из мета-тега; используются для поисковой оптимизации (SEO); в поле может быть до 255 символов.
Важно
ПРИМЕР: adidas, адидас, 100g, брюки для разогрева
Meta description¶
Описание страницы товара из мета-тега; используется для поисковой оптимизации (SEO); в поле может быть до 255 символов.
Важно
ПРИМЕР: Брюки для разогрева Adidas
Search words¶
Список поисковых слов товара, может содержать до 65 535 символов. Если в стандартную поисковую строку CS-Cart вбить одно из этих слов, то встроенный поиск CS-Cart найдёт этот товар.
Важно
ПРИМЕР: adidas, адидас, брюки для разогрева
Примечание
Поиск в CS-Cart не учитывает заглавные и строчные буквы.
Page title¶
Название страницы в браузере; в поле может быть до 255 символов.
Важно
ПРИМЕР: Брюки для разогрева Adidas
Promo text¶
Короткий промо-текст, который отобразится на странице товара; в поле может быть до 16 777 215 символов.
Важно
ПРИМЕР: БЕСПЛАТНАЯ доставка на заказ свыше 3000 рублей! Отправка заказа в течение суток.
Taxes¶
Названия налогов, которые включены для товара. Если нужно указать несколько налогов, это делается через запятую.
Важно
ПРИМЕР: НДС, test
Предупреждение
Перед тем, как указывать налоги для товара, создайте эти налоги.
Features¶
У всех характеристик, которые вы импортируете, должен быть такой формат:
{ID} (Группа) Название: Тип[Значение]
- ID — идентификатор характеристики;
- Группа — название группы, к которой относится характеристика;
- Название — название характеристики;
- Тип — один из следующих типов характеристики:
- C — один флажок;
- M — несколько флажков;
- S — список вариантов (текст);
- N — список вариантов (число);
- E — список вариантов (бренд/производитель);
- T — текст;
- O — число;
- D — дата;
- Значение — значение характеристики.
Если характеристик несколько, они отделяются друг от друга точкой с запятой.
Важно
ПРИМЕР: T[1233423423]; Дата релиза: D[05/05/07]; Цвет: S[Красный]
Примечание
Если характеристики или варианта нет в базе данных, она будет создана автоматически. Также вы можете создать характеристики вручную или импортировать их до того, как импортируете товары с этими характеристиками.
Options¶
У всех опций, которые вы импортируете, должен быть такой формат:
(Магазин) Название: Тип[Вариант 1///свойство=значение///свойство=значение, ..., Вариант X///свойство=значение///свойство=значение]///настройка=значение///настройка=значение
Примечание
Несколько опций отделяются друг от друга точной с запятой (;
).
(Магазин) — название витрины;
Предупреждение
Если не указать название витрины, вы не сможете редактировать эти опции.
Название — название опции;
Тип — один из следующих типов опции:
- I — текст;
- T — текстовая область;
- S — список вариантов;
- R — радиогруппа;
- C — флажок.
Важно
ПРИМЕР (текстовые опции): (Simtech) Возраст: I; (Simtech) Дата рождения: I; (Simtech) Примечание: T
Варианты опций¶
Варианты можно задать для опций с типом список вариантов (S) или радиогруппа (R) сразу после типа опции:
(Магазин) Название: Тип[Вариант 1///свойство=значение///свойство=значение, ..., Вариант X///свойство=значение///свойство=значение]
Вариант 1, ..., Вариант X — названия вариантов.
Важно
ПРИМЕР: (Simtech) Цвет: S[Красный, Зелёный, Синий]; (Simtech) Размер: R[S, M, L, XL, XXL]
/// — разделитель вариантов характеристики, который вы задаёте при импорте CSV-файла с товарами.
свойство=значение///свойство=значение — значения свойств этого варианта опций; вот возможные свойства:
- modifier — модификатор цены: положительное или отрицательное значение, которое добавляется или вычитается из цены товара, когда выбран этот вариант опции;
- modifier_type — тип модификатора цены:
- P — процент;
- A — абсолютное значение в валюте магазина по умолчанию;
- weight_modifier — модификатор веса: положительное или отрицательное значение, которое добавляется или вычитается из веса товара, когда выбран этот вариант опции;
- weight_modifier_type — тип модификатора веса:
- P — процент;
- A — абсолютное значение в единице измерения веса, используемой в магазине;
- image — изображение варианта опции. Это свойство работает так же, как поле Detailed image.
Важно
ПРИМЕР: (Simtech) Размер: S[Обычный,Большой///modifier=10.000///modifier_type=P///weight_modifier=20.000///weight_modifier_type=A]; Цвет: S[Серый///image=exim/backup/images/variant_image/grey_example.jpg,Черный///modifier=50.000///modifier_type=A///image=exim/backup/images/variant_image/black_example.jpg]
Настройки опций¶
Настройки можно указать после вариантов. Вот какие настройки можно указать:
inventory — определяет, может ли эта опция быть частью комбинации опций и должна ли она отслеживаться на складе отдельно:
- Y — да;
- N — нет;
missing_variants_handling — определяет, что делать, когда все варианты опции выключены или ни один вариант не создан:
- M — отобразить сообщение;
- H — полностью скрыть эту опцию;
required — если опция является обязательной, то покупатели обязательно должны будут выбрать один из ее вариантов:
- Y — опция обязательная;
- N — опция необязательная;
status — статус опции:
- A — опция включена;
- D — опция выключена;
Важно
ПРИМЕР: (Simtech) Цвет: S[Красный///modifier=5///modifier_type=A,Зеленый///modifier=10///modifier_type=P]///inventory=Y///missing_variants_handling=M///required=Y///status=A
multiupload (только для опций с типом F — файл) — определяет, могут ли покупатели загрузить для одной опции несколько файлов:
- Y — да;
- N — нет;
allowed_extensions (только для опций с типом F — файл) — расширения файлов, которые можно загрузить;
max_file_size (только для опций с типом F — файл) — максимальный размер файла, который можно загрузить в килобайтах.
Важно
ПРИМЕР: (Simtech) Своё изображение: F///required=Y///multiupload=N///allowed_extensions=jpg,bmp,gif///max_file_size=1000
Variation options¶
Варианты разных опций, которые вместе составляют вариацию товара. Например, если вы продаёте футболку с опциями Цвет и Размер, то белая футболка XXL будет вариацией товара. У нас есть отдельная статья об импорте вариаций товаров.
Важно
EXAMPLE: Размер:Обычный|Цвет:Белый
Secondary categories¶
Полный путь к дополнительным категориям, которые назначены этому товару. Родительские и дочерние категории в пути должны отделяться друг от друга с помощью Разделителя категорий, который вы задаёте, когда вы импортируете товары в CSV-файле. Если у товара несколько дополнительных категорий, то пути к каждой категории должны отделяться друг от друга точкой с запятой (;
).
Важно
ПРИМЕР (если разделитель ///): Компьютеры///Новинки; Компьютеры///Стационарные компьютеры
Если название вашей категории содержит двоеточие (:
), например Промо-акции///Скидка: 10%, то в импортируемом файле нужно экранировать категорию следующим образом: |Промо-акции///Скидка: 10%|
. Иначе категория импортируется неправильно.
Когда дополнительных категорий несколько, то запись может выглядеть так: Избранное;|Промо-акции///Скидка: 10%|
.
Items in box¶
Минимальное и максимальное количество экземпляров товара, которое перевозится в одной коробке. Это поле используется для автоматического расчёта стоимости доставки. Формат такой:
min:[number];max:[number]
Важно
ПРИМЕР: min:1;max:5
Box size¶
Размер коробки. Это поле используется для автоматического расчёта стоимости доставки. Формат такой:
length:[number];width:[number];height:[number]
Важно
ПРИМЕР: length:10;width:15;height:15
Usergroup IDs¶
Числовые идентификаторы групп пользователей, которые могут видеть этот товар. Вот идентификаторы, которые используются в CS-Cart по умолчанию:
- 0 — все пользователи;
- 1 — гости;
- 2 — зарегистрированные пользователи.
Важно
ПРИМЕР: 0,1,2,3
Available since¶
Дата, начиная с которой, товар можно покупать. Дата нужна, когда в качестве действия при отсутствии товара в наличии выбран Предзаказ. Используется следующий формат:
dd mmm yyyy 00:00:00
Важно
ПРИМЕР: 25 Dec 2015 14:05:00
Exceptions type¶
Тип исключений:
- F — запрещение; все исключения являются запрещенными комбинациями, и покупатели не могут добавить их в корзину. Остальные комбинации разрешены;
- A — разрешение; все исключения являются запрещёнными комбинациями, и покупатели могут добавить в корзину только исключения.
Важно
ПРИМЕР: F
Options type¶
Порядок, в котором покупатель выбирает варианты опций на странице товара:
- P — одновременно: покупатели выбирают варианты опций в любом порядке; у каждой опции по умолчанию выбран какой-то вариант;
- S — последовательно: покупатель сначала выбирает вариант первой опции, потом втторой опции, и так далее; по умолчанию ни один из вариантов не выбран.
Важно
ПРИМЕР: S
Pay by points¶
- Y — покупатели могут оплатить товар с помощью бонусных баллов;
- N — покупатели не могут оплатить товар с помощью бонусных баллов.
Важно
ПРИМЕР: Y
Override points¶
- Y — заменить количество баллов, получаемых зa покупку этого товара;
- N — не заменять количество баллов, получаемых за покупку этого товара.
Важно
ПРИМЕР: Y
Override exchange rate¶
- Y — заменить цену в баллах для этого товара;
- N — использовать для этого товара глобальный курс бонусных баллов.
Важно
ПРИМЕР: Y
Popularity¶
Популярность товара. Это целое число, которое изменяется в зависимости от активности, связанной с товаром (когда товар просматривают, добавляют в корзину, удаляют из корзины или покупают). Чем выше число, тем популярнее товар.
Важно
ПРИМЕР: 8