Формат файла для импорта и экспорта

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

Проще всего брать за основу готовые файлы прямо из окна импорта:

• Скачать минимальный пример
• Скачать полный пример
• Скачать пример категорий и характеристик

См. также

• Импорт в каталог наличия
• Экспорт из каталога наличия
• Типовые проблемы импорта и экспорта

Где находится

Каталог → Товары

Импорт и экспорт запускаются из шапки списка товаров.

Какие колонки обязательны для импорта

Чтобы система вообще смогла создать или обновить товар, в файле должны быть три поля:

Колонка	Что в ней должно быть
Наименование	Название товара
Производитель	Бренд товара
Артикул	Артикул товара

Без этих колонок система не поймёт, что именно нужно загрузить.

Как определяется товар

При импорте товар ищется по связке:

Производитель + Артикул

Если такая связка уже есть, система обновляет существующую карточку. Если нет — создаёт новую.

Категория по умолчанию в настройках импорта: поиск сначала среди товаров этой категории, затем по всему каталогу.

Если в одном файле несколько строк относятся к одной и той же связке, итоговое уведомление покажет это как повторное попадание строк в уже затронутую карточку.

Все основные колонки файла

Колонка	Что передавать	Для чего нужно
Наименование	Текст	Название товара
Производитель	Текст	Бренд товара
Артикул	Текст	Основной реквизит товара
Описание	Текст или HTML	Описание карточки
Категории	Название категории, путь или список	Размещение товара в каталоге
Теги	Список через запятую	Дополнительные метки
Изображения	Одна или несколько ссылок	Фото товара
Порядок сортировки	Целое число	Позиция в списках
Флаг активности	Да/нет, true/false, 1/0	Включён товар или выключен
Seo url	Текст	Адрес страницы товара
Meta title	Текст	SEO-заголовок
Meta description	Текст	SEO-описание
Meta keywords	Текст	SEO-ключевые слова
Основные характеристики	Пары Название: значение	Основные свойства товара
Дополнительные характеристики	Пары Название: значение	Дополнительные свойства товара
Цена продажи	Число в рублях	Цена для покупателя
Цена зачеркнутая	Число в рублях	Старая цена
Цена закупа	Число в рублях	Закупочная цена
Количество	Целое число	Остаток
Срок доставки (дни)	Целое число	Срок доставки
Аналоги	Пары Бренд: артикул	Связь с аналогами

Как заполнять колонку «Категории»

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

Как можно записывать категории

Что Вы хотите указать	Как писать в ячейке
Один раздел	Фильтры
Вложенный раздел	Автозапчасти > Фильтры > Масляные
Несколько категорий	Фильтры, Расходники

Что система умеет понимать

Система умеет:

• убирать лишние пробелы;
• сравнивать названия без учёта регистра;
• понимать некоторые приставки вроде Товарная группа:;
• искать категорию даже по одному названию, если такое название в каталоге уникально.

Но если одинаковые названия есть в разных ветках, всегда лучше передавать полный путь через >.

Что важно помнить про категорию по умолчанию

Если в настройках импорта выбрана Категория по умолчанию, товар в любом случае попадёт в неё.

Если при этом колонка Категории в файле тоже заполнена, система добавит товар ещё и в категории из файла.

Пример. В настройках выбрана категория по умолчанию «Акции», а в CSV у товара указано «Автозапчасти > Масла». После импорта товар окажется и в «Акции», и в «Автозапчасти > Масла».

Если категории ещё нет в системе

Если включена опция «Создавать недостающие категории из файла», система создаст недостающий раздел автоматически.

Если опция выключена, строка уйдёт в ошибку.

Как заполнять колонку «Изображения»

В эту колонку передают ссылки на фото товара.

Пример одной ячейки

https://example.com/image1.jpg, https://example.com/image2.jpg

Что важно:

• ссылки должны быть корректными;
• используйте только https (безопасное соединение); ссылки на http:// не подойдут;
• если ссылка неправильная, строка может уйти в ошибку;
• дальнейшее поведение зависит от выбранного режима изображений при импорте.

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

Как работает колонка «Seo url»

Это адрес страницы товара.

Что важно:

• для нового товара можно передать свой Seo url;
• если поле пустое, система сама сформирует адрес из названия и артикула;
• если такой адрес уже занят, система добавит суффикс -1, -2 и так далее;
• у существующего товара Seo url из файла автоматически не перезаписывается.

Как работает колонка «Флаг активности»

В ней можно передать, активен товар или нет.

Обычно подходят значения:

• 1 / 0
• true / false
• yes / no
• да / нет

Если колонка не передана для нового товара, он обычно создаётся активным.

Как передавать цены и наличие

Для импорта:

• Цена продажи передаётся в рублях;
• Цена зачеркнутая передаётся в рублях;
• Цена закупа передаётся в рублях;
• Количество передаётся обычным числом;
• Срок доставки (дни) передаётся обычным числом.

Не путайте рубли и копейки

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

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

• Точка выдачи
• Склад точки выдачи

Иначе наличие не сохранится.

Как передавать характеристики

Характеристики передаются в виде пар:

Название: значение

Пары разделяются точкой с запятой.

Пример

Ширина: 120; Высота: 80; Диаметр: 15

Что важно:

• название характеристики должно совпадать с тем, что уже доступно для категорий этого товара;
• основные и дополнительные характеристики передаются в разные колонки;
• если характеристика относится к категории, которой у товара нет, система не сможет использовать её так, как Вы ожидаете.

Как передавать аналоги

Аналоги передаются парами:

Бренд: артикул

Пары разделяются точкой с запятой.

Пример

VIC: C110; AIKO: ASD-123

Примеры готовых файлов

Минимальный файл

Наименование,Производитель,Артикул
Фильтр масляный FORD Focus II 1.8,FORD,BE8Z6731AC
Фильтр воздушный FORD Fiesta,FORD,1803059

Файл с категориями и наличием

Наименование,Производитель,Артикул,Категории,Цена продажи,Цена закупа,Количество,Срок доставки (дни)
Фильтр A,ACME,A-1,Автозапчасти > Фильтры,1000,700,5,1
Масло B,CASTROL,B-2,Автозапчасти > Масла,2500,1800,10,2

Файл с фото

Наименование,Производитель,Артикул,Изображения
Товар с фото,ACME,PH-1,"https://cdn.example.com/a.jpg, https://cdn.example.com/b.jpg"

Файл с категориями и характеристиками

Наименование,Производитель,Артикул,Категории,Основные характеристики,Дополнительные характеристики
Фильтр салонный FORD Focus,FORD,CABIN-001,Автозапчасти > Фильтры,"Страна: Россия; EAN-13: 1234567890123","Материал: Угольный; Сезон: Всесезонный"

Чем экспорт отличается от импорта

Экспорт и импорт похожи только внешне. Это не один и тот же формат "скачал и сразу загрузил обратно без проверки".

Главные отличия:

• в экспорте колонка Название, при импорте сопоставьте её с Наименование;
• при экспорте цены выгружаются в копейках, импорт ждёт рубли;
• в колонке Изображения экспорт может отдать либо внешние URL, либо локальные ссылки;
• без Категорий экспортируемых товаров выгрузка будет пустой;
• перед обратной загрузкой файл всегда лучше проверить.

Что проверить перед запуском импорта

1. Есть ли Наименование, Производитель и Артикул.
2. Понимаете ли Вы, откуда возьмутся категории.
3. Если в файле есть цены и остатки, выберете ли потом Точку выдачи и Склад точки выдачи.
4. Корректны ли ссылки в колонке Изображения.
5. Не перепутаны ли рубли и копейки.
6. Нет ли неожиданных дублей по связке Производитель + Артикул.