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

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

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

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

#См. также

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Что важно:

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

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

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

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

Что важно:

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

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

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

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

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

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

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

Для импорта:

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

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

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

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

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

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

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

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

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

#Пример

Ширина: 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. Нет ли неожиданных дублей по связке Производитель + Артикул.