⤴️Импорт товаров. Формат полей в таблице
В импортируемом CSV-файле с информацией о товарах могут быть колонки, перечисленные ниже.
Product code
Это поле является обязательным и должно быть уникальным для каждого товара. В поле можно вводить цифры, буквы и их сочетания (до 32 символов). Если вы хотите экспортировать данные товаров в CSV-файл, убедитесь, что у каждого товара заполнено поле КОД.
ПРИМЕР: B0002OG6NY
Если значение в этом поле совпадает с кодом любого уже существующего товара, то при импорте будут обновлены данные этого товара.
Language
Код языка, состоящий из двух букв в нижнем регистре. Это обязательное поле.
Чтобы узнать код языка:
Откройте страницу Администрирование → Языки в панели администратора.
Перейдите на вкладку Доступные.
Найдите нужный язык, а затем найдите его код в колонке Код языка.
ПРИМЕР: en
Product ID
Числовой идентификатор товара в базе данных магазина. Если у товара нет Product code то для идентификации товара будет использоваться Product id.
ПРИМЕР: 130
Category
Полный путь до основной категории товара. Родительские и дочерние категории в пути должны отделяться друг от друга с помощью Разделителя категорий, который вы задаёте, когда вы импортируете товары в CSV-файле.
ПРИМЕР: (с разделителем ///): Компьютеры///Ноутбуки
Если указанные родительские и дочерние категории не существуют, они будут созданы.
Если название вашей категории содержит двоеточие (:), например Промо-акции///Скидка: 10%, то в импортируемом файле нужно экранировать категорию следующим образом: |Промо-акции///Скидка: 10%|. Иначе категория импортируется неправильно.
Price
Цена товара в вашем магазине; должна быть в формате 0.00.
ПРИМЕР: 1600.00
List price
Рекомендуемая цена товара. Используется для отображения скидки на витрине: Скидка = List price - Price. Эта цена должна быть в формате 0.00.
ПРИМЕР: 1750.00
Status
Статус товара:
A — включен — товар появляется на витрине;
H — скрыт — товар не появляется на витрине, но покупатели могут увидеть его по прямой ссылке;
D — выключен — товар можно увидеть только в панели администратора.
ПРИМЕР: A
Quantity
Количество экземпляров этого товара в наличии.
ПРИМЕР: 50
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
B — отслеживать количество товаров в наличии;
D — не отслеживать количество товаров в наличии.
ПРИМЕР: D
Out of stock actions
Этот столбец определяет, что покупатели смогут сделать на странице товара, если товара нет в наличии:
B — предзаказать товар;
S — подписаться на уведомление о количестве товара в наличии;
N — ничего (действие не выбрано).
ПРИМЕР: B
Free shipping
Y — товар доставляется бесплатно и не будет учитываться при расчёте стоимости доставки, если способ доставки можно использовать для бесплатной доставки;
N — товар не доставляется бесплатно и всегда будет учитываться при расчёте стоимости доставки.
ПРИМЕР: Y
Zero price action
Это поле описывает действия, доступные для покупателя при нулевой цене.
R — запретить добавление товара в корзину;
P — разрешить добaвление товара в корзину;
A — попросить покупателя ввести цену.
ПРИМЕР: A
Images (Изображения)
Путь (или пути) к изображениям товаров. Если изображений несколько, отделяйте пути к ним с помощью разделятеля изображений из дополнительных настроек во вкладке Файл на странице пресета импорта.
ПРИМЕР: 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), то всем этим столбцам или узлам можно задать соотвествие со свойством 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[Красный]
Если характеристики или варианта нет в базе данных, она будет создана автоматически. Также вы можете создать характеристики вручную или импортировать их до того, как импортируете товары с этими характеристиками.
Variation group code
Общий идентификатор, который связывает несколько вариаций товара в одну группу вариаций. Например, если вы продаёте футболку с характеристиками Цвет и Размер, то белая футболка XXL и синяя футболка M будут вариациями товара. Если у них одинаковый код группы вариаций, то покупатели смогут переключаться между этими вариациями на странице товара.
Код группы может содержать только цифры, латиницу и знаки “-” и “_”.
У нас есть отдельная статья об импорте вариаций товаров.
ПРИМЕР: T-shirt_Need4Sports
Variation set as default
Этот столбец сработает, только если в импортируемом файле также есть Variation group code.
Несколько вариаций товара могут занимать одну позицию в каталоге. Тогда покупатели в списке товаров увидят только одну из вариаций. На остальные вариации они смогут переключиться уже только со страницы товара.
С помощью этого столбца можно задать, какую из вариаций покупатели увидят первой, т.е. уже на списке товаров. Этот столбец не обязателен. Если его не будет, то:
при первом создании группы вариаций первый товар в ней станет вариацией по умолчанию;
при изменении товаров в группе вариаций порядок уже роли играть не будет, и вариация по умолчанию не изменится.
EXAMPLE: Y
Options
У всех опций, которые вы импортируете, должен быть такой формат:
(Магазин) Название: Тип[Вариант 1///свойство=значение///свойство=значение, ..., Вариант X///свойство=значение///свойство=значение]///настройка=значение///настройка=значение
Несколько опций отделяются друг от друга точной с запятой (;).
(Магазин) — название витрины;
Если не указать название витрины, вы не сможете редактировать эти опции.
Название — название опции;
Тип — один из следующих типов опции:
IG — текст;
TG — текстовая область;
SG — список вариантов;
RG — радиогруппа;
CG — флажок.
ПРИМЕР (текстовые опции): (Simtech) Возраст: IG; (Simtech) Дата рождения: IG; (Simtech) Примечание: TG
Варианты опций
Варианты можно задать для опций с типом список вариантов (SG) или радиогруппа (RG) сразу после типа опции:
(Магазин) Название: Тип[Вариант 1///свойство=значение///свойство=значение, ..., Вариант X///свойство=значение///свойство=значение]
Вариант 1, ..., Вариант X — названия вариантов.
ПРИМЕР: (Simtech) Цвет: SG[Красный, Зелёный, Синий]; (Simtech) Размер: RG[S, M, L, XL, XXL]
/// — разделитель вариантов характеристики, который вы задаёте при импорте CSV-файла с товарами.
свойство=значение///свойство=значение — значения свойств этого варианта опций; вот возможные свойства:
modifier — модификатор цены: положительное или отрицательное значение, которое добавляется или вычитается из цены товара, когда выбран этот вариант опции;
modifier_type — тип модификатора цены:
P — процент;
A — абсолютное значение в валюте магазина по умолчанию;
weight_modifier — модификатор веса: положительное или отрицательное значение, которое добавляется или вычитается из веса товара, когда выбран этот вариант опции;
weight_modifier_type — тип модификатора веса:
P — процент;
A — абсолютное значение в единице измерения веса, используемой в магазине;
image — изображение варианта опции. Это свойство работает так же, как поле Detailed image.
ПРИМЕР: (Simtech) Размер: SG[Обычный,Большой///modifier=10.000///modifier_type=P///weight_modifier=20.000///weight_modifier_type=A]; Цвет: SG[Серый///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) Цвет: SG[Красный///modifier=5///modifier_type=A,Зеленый///modifier=10///modifier_type=P]///inventory=Y///missing_variants_handling=M///required=Y///status=A
multiupload (только для опций с типом FG — файл) — определяет, могут ли покупатели загрузить для одной опции несколько файлов:
Y — да;
N — нет;
max_file_size (только для опций с типом FG — файл) — максимальный размер файла, который можно загрузить в килобайтах.
allowed_extensions (только для опций с типом FG — файл) — расширения файлов, которые можно загрузить;
ПРИМЕР: (Simtech) Своё изображение: FG///required=Y///multiupload=N///allowed_extensions=jpg,bmp,gif///max_file_size=1000
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
Store
Витрина, которой принадлежит товар. Это обязательное поле.
ПРИМЕР: Sample Store
SEO name
SEO-имя товара.
ПРИМЕР: my-product
Pay by points
Y — покупатели могут оплатить товар с помощью бонусных баллов;
N — покупатели не могут оплатить товар с помощью бонусных баллов.
ПРИМЕР: Y
Override points
Y — заменить количество баллов, получаемых зa покупку этого товара;
N — не заменять количество баллов, получаемых за покупку этого товара.
ПРИМЕР: Y
Override exchange rate
Y — заменить цену в баллах для этого товара;
N — использовать для этого товара глобальный курс бонусных баллов.
ПРИМЕР: Y
Popularity
Популярность товара. Это целое число, которое изменяется в зависимости от активности, связанной с товаром (когда товар просматривают, добавляют в корзину, удаляют из корзины или покупают). Чем выше число, тем популярнее товар.
ПРИМЕР: 8
Last updated