Формат полей при импорте

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

Важно

CS-Cart и Multi-Vendor поддерживают только файлы с кодировкой UTF-8. Если какие-то значения импортируются неправильно (или не импортируются вообще), попробуйте сохранить файл в кодировке UTF-8 и импортировать его снова.

Product code

Это поле является обязательным и должно быть уникальным для каждого товара. В полее можно вводить цифры, буквы и их сочетания (до 32 символов). Если вы хотите экспортировать данные товаров в CSV-файл, убедитесь, что у каждого товара заполнено поле КОД.

Важно

ПРИМЕР: B0002OG6NY

Предупреждение

Если значение в этом поле совпадает с кодом любого уже существующего товара, то при импорте будут обновлены данные этого товара.

Language

Код языка, состоящий из двух букв в нижнем регистре. Это обязательное поле.

Чтобы узнать код языка:

  1. Откройте страницу Администрирование → Языки в панели администратора.
  2. Перейдите на вкладку Доступные.
  3. Найдите нужный язык, а затем найдите его код в колонке Код языка.

Важно

ПРИМЕР: en

Product id

Числовой идентификатор товара в базе данных магазина. Если у товара нет Product code то для идентификации товара будет использоваться Product id.

Важно

ПРИМЕР: 130

Product type

Примечание

Это поле — часть модуля “Вариации товаров”.

Тип товара:

  • P — простой товар;
  • C — настраиваемый товар;
  • V — вариация настраиваемого товара.

Важно

ПРИМЕР: C

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

  • 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

Store

Витрина, которой принадлежит товар. Это обязательное поле.

Важно

ПРИМЕР: Sample Store

SEO name

SEO-имя товара.

Важно

ПРИМЕР: my-product

Pay by points

Важно

ПРИМЕР: Y

Override points

  • Y — заменить количество баллов, получаемых зa покупку этого товара;
  • N — не заменять количество баллов, получаемых за покупку этого товара.

Важно

ПРИМЕР: Y

Override exchange rate

  • Y — заменить цену в баллах для этого товара;
  • N — использовать для этого товара глобальный курс бонусных баллов.

Важно

ПРИМЕР: Y

Popularity

Популярность товара. Это целое число, которое изменяется в зависимости от активности, связанной с товаром (когда товар просматривают, добавляют в корзину, удаляют из корзины или покупают). Чем выше число, тем популярнее товар.

Важно

ПРИМЕР: 8