С помощью CSV-файла можно быстро импортировать в интернет-магазин сразу много товаров и категорий. Создавайте CSV-файлы в табличных программах, например: OpenOffice/LibreOffice Calc, Microsoft Excel, iWork.
Образцы CSV-файлов с примерами из этого руководства — в кодировке Windows-1251 (Excel) или UTF-8 (OpenOffice/LibreOffice).
Как самому получить образец правильного CSV-файла
- Добавьте вручную несколько категорий с товарами в бекенде интернет-магазина.
- Экспортируйте эти категории и товары в CSV-файл.
Посмотрите, как устроен экспортированный файл, и создавайте собственные файлы точно так же.
Порядок импорта CSV-файла
- Составьте CSV-файл.
- Загрузите файл в разделе «Импорт/Экспорт → Импорт товаров из CSV».
- Выберите соответствия для столбцов файла. Проверьте, правильно ли сработал автоматический выбор соответствий.
- Выберите столбцы идентификации товаров/категорий и артикулов.
- Если нужно, укажите расширенные настройки импорта.
- Выполните анализ файла и настроек импорта.
- Импортируйте файл.
Сначала потренируйтесь импортировать 1–2 товара. Когда будете уверены в правильности результата, переходите к большему количеству товаров. Так вы избежите больших ошибок, которые трудно исправлять.
1. Составление CSV-файла
В первой строке файла должны быть заголовки столбцов. В этой строке все ячейки должны идти друг за другом — без пропусков в виде пустых ячеек.
Начиная со второй строки начинайте добавлять товары и категории.
Любая строка может быть товаром, артикулом или категорией
Категория
Если в строке заполнены ячейки только в тех столбцах, которые относятся только к категориям , значит, из этой строки будет импортирована категория.
Товар или артикул
Если в строке заполнена хотя бы одна ячейка из столбцов, которые относятся только к товарам , то из строки будет импортирован товар или артикул товара.
Если в идущих подряд нескольких строках заполнены ячейки в столбцах артикулов и совпадают значения в столбце, выбранном для идентификации товаров, то из первой строки в этой группе импортируется товар и его первый артикул, а из остальных строк этой группы импортируются дополнительные артикулы товара.
При импорте строк учитываются не все столбцы с заполненными ячейками, а только те столбцы, для которых выбраны соответствия на странице импорта. Соответствия для столбцов CSV-файла выбираются сразу после загрузки файла.
Описания столбцов
Заголовки столбцов могут быть необязательно такими, как в этой таблице. Столбцы можно называть как угодно. Главное, чтобы их названия отличались друг от друга.
Только если вы импортируете несколько изображений для каждого товара, то все столбцы с изображениями должны иметь одинаковые названия.
столбцы, которые можно заполнять для категорий
столбцы, которые нельзя заполнять для категорий
| Столбец CSV-файла | Описание | Пример | Только категории |
|---|---|---|---|
| Свойства товаров и категорий | |||
| Наименование | Название товара или категории. | Apple iPhone 5S | |
| Ссылка на витрину | Фрагмент адреса URL. | iphone-5s | |
| Заголовок | HTML-тег TITLE. | Apple iPhone 5S | |
| META keywords | META-тег keywords. | Apple, iPhone, мобильный телефон | |
| META description | META-тег description. | смартфон на платформе iOS сенсорный экран мультитач (емкостный) диагональ экрана 4"... | |
| Описание | Текст полного описания. Может содержать HTML-теги. | <h3>Опережая мысли.</h3><div>iPhone 5s задуман с определённой целью... | |
| Статус | Отображение товара или категории на витрине. 1 — виден. 0 — на витрине не отображается. Скрытые товары и категории на витрине не видны, но доступны по прямой ссылке. | 1 | |
| Валюта | ISO3-код валюты для импорт цен артикулов. Если валюта не указана, то цены импортируются в основной валюте магазина. | RUB | |
| Тип товаров | Название типа товаров, который должен быть присвоен данному товару. Если в файле указан тип товаров, которого нет в настройках магазина, то при импорте файла будет создан новый тип с таким названием (только если у пользователя, выполняющего импорт, есть достаточные для этого права доступа). | Мобильные телефоны | |
| Краткое описание | Сокращенное описание товара для показа в списках товаров, например, в категориях и результатах поиска. Может содержать HTML-теги, но они могут не учитываться некоторыми темами дизайна. | В iPhone 5s технологий стало ещё больше. Датчик идентификации по отпечатку пальца... | |
| Наклейка | Один из стандартных идентификаторов наклеек для изображений товаров: new, bestseller, lowprice, или HTML-код собственной наклейки. | new | |
| Теги | Теги товара через запятую. | iPhone,мобильный телефон,Apple | |
| Облагается налогом | Название класса налогов для товара. Класс налогов с указанным в CSV-файле названием должен быть заранее настроен в разделе «Настройки → Налоги». | НДС | |
| Изображения | URL или имя файла изображения товара. Чтобы импортировать несколько изображений для каждого товара, добавьте в CSV-файл несколько столбцов с одинаковым названием и укажите в них URL либо имена файлов изображений. |
iphone-5s-silver.jpg | |
| Описания изображений товаров | Описание изображения, указанного в предыдущем столбце. | Вид спереди. | |
| Изображения | Пример еще одного столбца с изображениями товаров. | iphone-5s-gold.jpg | |
| Описания изображений товаров | Описание следующего изображения. | Вид сзади. | |
| Размер пример характеристики | Дополнительная характеристика товара. Формат значения зависит от типа характеристики:
|
12 см {12 см,24 см,"38,5 см"} <{M,L,XL,XXL}> | |
| Свойства артикулов товаров | |||
| Артикул | Код артикула товара. Если у товара всего один артикул, то этот столбец можно не включать в файл. | iphone-5s-white | |
| Наименование артикула | Наименование артикула товара, отображающееся на витрине. Если у товара всего один артикул, то этот столбец можно не включать в файл. | Белый, 32Gb | |
| Цена | Цена артикула. Валюта цены импортируется из столбца товара «Валюта». | 41990 | |
| Доступен для заказа | 0 — артикул недоступен для заказа. 1 — артикул можно заказать. | 1 | |
| Зачеркнутая цена | «Зачеркнутая цена» артикула. Валюта цены импортируется из столбца товара «Валюта». | 42550 | |
| Закупочная цена | «Закупочная цена» артикула. Валюта цены импортируется из столбца товара «Валюта». | 39990 | |
| В наличии | Количество артикула на общем складе магазина. Название конкретного склада не указывается, если склады в магазине не настроены. | 24 | |
| В наличии @склад1 | Количество единиц артикула на складе с указанным названием. Если в магазине настроено несколько складов, добавьте в CSV-файл несколько столбцов для импорта остатков для каждого склада. Названия складов в файле должны точно соответствовать названиям складов магазина. Перед названием склада поставьте символ @ без пробела. | 18 | |
| В наличии @склад2 | Пример столбца с остатками еще одного склада. | 25 | |
| Основной артикул | Обозначение артикула, который должен стать основным артикулом товара. У каждого товара только один артикул может быть артикулом по умолчанию. | 1 | |
| Изображения | URL или имя файла изображения товара, которое должно быть выбрано в свойствах артикула. | iphone-5s-silver.jpg | |
Категории и подкатегории
С помощью CSV-файла можно создавать только статические категории товаров. Существующие динамические категории можно только обновлять — добавлять их нельзя.
Без специальных обозначений категории импортируются в самом верхнем уровне каталога. Чтобы разместить одну категорию внутри другой, перед названием такой подкатегории добавьте восклицательный знак.
Строка с подкатегорией должна быть в CSV-файле ниже строки с родительской категорией: либо сразу под ней, либо после товаров родительской категории.
| Наименование | Цена |
|---|---|
| Мобильные телефоны | |
| Тут может быть товар родительской категории | 100 |
| !Apple | |
| А тут товар подкатегории | 150 |
Чтобы разместить категорию на еще более низком уровне относительно предыдущей, добавьте перед названием еще один восклицательный знак.
Если нужно поместить очередную категорию на уровень выше относительно предыдущей, добавьте перед ее названием меньшее количество восклицательных знаков:
| Наименование | Цена |
|---|---|
| Мобильные телефоны | |
| !Nokia | |
| !!Series 60 | |
| !Apple |
Размещение товаров в категориях
Чтобы импортировать товары в нужную категорию, добавьте строки с этими товарами ниже строки с этой категорией — до строк с другими категориями.
Изменить принадлежность товара к категории можно только вручную в бекенде интернет-магазина. С помощью импорта CSV-файла принадлежность к категориям изменить нельзя.
Пример размещения товаров в категориях
| Наименование | Цена |
|---|---|
| Мобильные телефоны | |
| Apple iPhone 5S | 36990 |
| !Распродажа | |
| HTC One | 15900 |
В этом примере товар с наименованием «Apple iPhone 5S» будет импортирован в категорию «Мобильные телефоны», а товар «HTC One» — в категорию «Распродажа».
Добавление товара в несколько категорий
Путем импорта товар можно разместить сразу в нескольких категориях. Для этого нужно продублировать строку товара под строками нескольких категорий.
Пример
| Наименование | Цена |
|---|---|
| Категория 1 | |
| Товар | 1000 |
| Категория 2 | |
| Товар | 1000 |
Импорт товаров и их артикулов
Чтобы импортировать товар с несколькими артикулами, перечислите в файле строки таких артикулов одну за другой — после основной строки с товаром. В столбце идентификации товаров в таких строках должно быть указано одинаковое значение — чтобы вся группа артикулов оказалась отнесена к одному и тому же товару. Если идентификация товаров выполняется по названиям, то у всех артикулов одного товара должно быть одинаковое название товара.
Из группы строк, носящихся к одному товару, информация импортируется так:
- Из первой строки группы информация из столбцов товаров импортируется в свойства товара.
- Информация из столбцов товаров для всех остальных строк, кроме первой, не импортируется.
- Из всех строк группы информация из столбцов артикулов импортируется в свойства артикулов.
Артикулы можно импортировать в одном из двух режимов: 1) простой список артикулов и 2) выбор значений характеристик.
Режим 1: Простой список артикулов
Для импорта артикулов в виде простого списка перечислите все артикулы товара друг за другом. В столбце идентификации товаров укажите одинаковое значение. В столбце идентификации артикулов укажите разные значения.
Вот пример CSV-файла со списком артикулов одного товара. Для идентификации товаров используется столбец с наименованием, а для идентификации артикулов — столбец с артикулами.
| Наименование | Артикул | Цена |
|---|---|---|
| Ботинки для сноуборда Jet | jet-6-white | 5050 |
| Ботинки для сноуборда Jet | jet-7.5-black | 5080 |
| Ботинки для сноуборда Jet | jet-8-white | 5080 |
Режим 2: Выбор значений характеристик
Для импорта артикулов товаров в режиме выбора значений характеристик укажите значения характеристик через запятую внутри специальных двойных скобок <{}>. В этом режиме можно использовать только характеристики с форматом «Выбор нескольких значений из списка». Из каждого сочетания значений во время импорта файла будет создан отдельный артикул. Для идентификации артикулов, сформированных из значений характеристик, выберите столбец с наименованиями артикулов.
Пример
Нужно сформировать артикулы из трех значений характеристики «Цвет». В этом примере из них будут созданы три артикула — каждый для одного из значений характеристики «Цвет».
| Наименование | Цена | Доступен для заказа | В наличии | Цвет |
|---|---|---|---|---|
| Apple iPhone 5S | 36990 | 1 | 200 | <{серый,серебряный,золотой}> |
Остальные свойства, относящиеся к артикулам, будут применены ко всем сформированным артикулам. В этом примере для всех трех артикулов будет включено свойство «Доступен для заказа» и будет установлена цена 36990.
Для создания артикулов можно использовать значения нескольких характеристик. Точно так же вы выбираете значения нескольких характеристик, когда вручную создаете артикулы из значений характеристик в бекенде магазина.
Пример
В этом примере будут сформированы 9 артикулов — для всех сочетаний из 3 значений характеристики «Цвет» и 3 значений характеристики «Объем встроенной памяти» (3х3=9).
| Наименование | Цена | Цвет | Объем встроенной памяти |
|---|---|---|---|
| Apple iPhone 5S | 36990 | <{серый,серебряный,золотой}> | <{16 ГБ,32 ГБ,64 ГБ}> |
Импорт индивидуальных значений для артикулов, сформированных из значений характеристик
Чтобы указать индивидуальные значения цены, доступности для заказа и наличия на складе для отдельных артикулов, для таких артикулов нужно добавить отдельные строки. В этих строках в столбце с наименованиями артикулов нужно перечислить через запятую с пробелом значения характеристик, которые соответствуют каждому такому артикулу, и эти же значения указать в столбцах с характеристиками — без двойных скобок <{}>.
Количество на складе для автоматически генерируемых артикулов им импорте также извлекается из этой строки, однако оно может быть импортировано несколькими способами (нужный способ можно выбрать в расширенных настройках во время импорта CSV-файла):
- Разделить указанное значение на складе поровну между всеми такими артикулами (режим, выбранный по умолчанию).
- Импортировать указанное значение на складе для каждого из артикулов.
- Не импортировать значение наличия на складе при импорте артикулов, сгенерированных на основе значений характеристик.
Пример
| Наименование | Наименование артикула | Цена | В наличии | Цвет | Объем встроенной памяти |
|---|---|---|---|---|---|
| Apple iPhone 5S | 36990 | <{серый,серебряный,золотой}> | <{16Gb,32Gb,64Gb}> | ||
| Apple iPhone 5S | серый, 32Gb | 41990 | 12 | серый | 32Gb |
| Apple iPhone 5S | золотой, 64Gb | 46990 | 34 | золотой | 64Gb |
При импорте артикулов в режиме «Выбор значений характеристик» для идентификации артикулов необходимо выбирать столбец, содержащий наименования артикулов.
2. Загрузка файла
Перейдите в раздел «Импорт/экспорт → Импорт товаров из CSV».
Выберите символ, который используется в файле для разделения данных. Обычно это точка с запятой.
Выберите кодировку файла. Обычно UTF-8, если файл создавался в OpenOffice или LibreOffice, или Windows-1251, если файл создавался в Microsoft Excel.
Если вы используете в названиях или описаниях товаров специальные символы, например, ©, ±, ö и некоторые другие, то CSV-файл для импорта таких товаров рекомендуется сохранять с использованием международной кодировки UTF-8, чтобы эти символы не потерялись.
Выберите CSV-файл из папки на своем компьютере.
Если размер файла составляет несколько мегабайтов, то лучше запаковать его в ZIP- или GZ-архив. Скрипт импорта сам распакует архив на сервере, а вы сэкономите время на загрузку большого файла.
После загрузки файла на странице появится список его столбцов.
3. Выбор соответствий для столбцов файла
Для некоторых столбцов сразу будет выбрано соответствие — в какие свойства товаров/категорий или артикулов нужно импортировать каждый столбец. Проверьте, насколько правильно сработало автоматическое определение, и исправьте ошибки.
4. Выбор столбцов идентификации
Выберите свойства категорий/товаров/артикулов, которые должны использоваться для идентификации элементов каталога.
Идентификация очень важна — для того чтобы «показать» скрипту импорта, чем отличаются друг от друга категории товары и артикулы, перечисленные в CSV-файле. Выберите для идентификации те свойства, в чьих столбцах должны содержаться неповторяющиеся значения для каждого типа элементов каталога.
Варианты идентификации товаров и категорий
Выберите подходящий вариант:
- Наименование: товары и категории в файле будут различаться по столбцу, для которого вы выберите свойство «Наименование».
- Ссылка: товары и категории в файле будут различаться по столбцу, для которого вы выберите свойство «Ссылка на витрину».
- ID товара: категории импортироваться и обновляться не будут, а товары в файле будут различаться по столбцу, для которого вы выберите свойство «ID товара». ID товара — это числовой идентификатор товара в таблице базы данных shop_product. Его видно на странице редактирования товара в бекенде магазина. Этот вариант идентификации можно использовать только при обновлении существующих товаров, но не для импорта новых товаров.
- Идентификатор товара «1С»: категории и товары в файле будут различаться по столбцу, для которого вы выберите свойство «Товар: Идентификатор 1С».
- Столбец идентификации артикулов: категории импортироваться и обновляться не будут, а товары в файле будут различаться по столбцу, который вы выберите для идентификации артикулов.
- (пропускать товары и категории и импортировать только артикулы): категории и товары импортироваться и обновляться не будут, а будут импортироваться и обновляться только артикулы товаров, и они будут различаться по столбцу, который вы выберите для идентификации артикулов.
Варианты идентификации артикулов
Выберите подходящий вариант:
- Код артикула: артикулы товаров в файле будут различаться по столбцу, для которого вы выберите свойство «Код артикула».
- Наименование артикула: артикулы товаров в файле будут различаться по столбцу, для которого вы выберите свойство «Наименование артикула».
- ID артикула: артикулы товаров в файле будут различаться по столбцу, для которого вы выберите свойство «ID артикула». ID артикула — это числовой идентификатор артикула в таблице базы данных shop_product_skus. Этот вариант идентификации можно использовать только при обновлении существующих артикулов, но не для импорта новых артикулов.
- Идентификатор артикула «1С»: категории и товары в файле будут различаться по столбцу, для которого вы выберите свойство «Артикул: Идентификатор 1С».
5. Расширенные настройки
Расширенные настройки нужно изменять не всегда. Когда нужно:
- Вы хотите обновлять товары по названию и в категориях вашего каталога есть товары с совпадающими названиями. По умолчанию скрипт импорта ищет товары с совпадающими названиями или ссылками URL по всему каталогу, чтобы обновить их из CSV-файла. А если выключить флажок «Игнорировать принадлежность категориям при поиске совпадений товаров», то скрипт импорта будет искать товары с такими данными только в той категории, в которой они указаны в CSV-файле.
- Вам важно, какой тип будет присвоен новым товарам из файла, для которых в файле тип не указан. По умолчанию для товаров без типа в CSV-файле выбран один из типов из настроек магазина. Если по умолчанию выбран не тот тип, выберите нужный.
- В CSV-файле в описаниях товаров нет HTML-тегов. Чтобы на страницах магазина учитывались переносы строк в описаниях товаров, для них скрипт импорта добавит HTML-теги <br>.
- Вы импортируете изображения товаров из загруженных файлов, а не по URL. Выберите подходящую корневую директорию сервера и допишите путь к той поддиректории, в которую вы загрузили файлы изображений товаров. Загружать изображения товаров нужно в директорию на сервере, а не на вашем компьютере.
- Вы импортируете изображения товаров по URL, которые оканчиваются одинаково. Например, в URL изображений различается только путь к файлу, а имя файла во всех URL совпадает. В этом случае для настройки «Уникальность URL изображений товаров» выберите вариант «по пути к файлу». Если совпадает и путь к файлу, а различается доменное имя, то выберите вариант «по пути к файлу и доменному имени».
- Вы импортируете складские остатки для артикулов товаров, сформированных из значений характеристик в двойных скобках <{ … }>. Выберите подходящий вариант импорта складских остатков для таких артикулов.
6. Анализ выбранных параметров
Нажмите на кнопку внизу страницы, чтобы выполнить предварительный анализ файла и выбранных настроек. Скрипт импорта оценит, сколько категорий, товаров и артикулов будут импортированы. Если вы рассчитывали, что их количество должно быть другим, проверьте, правильно ли вы выбрали настройки импорта. После исправления настроек снова выполните анализ файла.
7. Импорт файла
Импортировать файл можно только после окончания его анализа. Чтобы начать импорт файла, нажмите на кнопку подтверждения внизу страницы.
Не закрывайте страницу экспорта в браузере, пока файл импортируется. Дождитесь сообщения об окончании импорта.
