Импорт и экспорт файлом

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

Две операции живут в разных местах, потому что нужны в разные моменты:

Что	Где	Доступ
Загрузить каталог из файла	раздел Импорт товаров, карточка «Импорт из файла»	всем
Выгрузить каталог в файл	кнопка «Экспорт каталога» на странице Товары	опция тарифа «Экспорт каталога»

Экспорт

По кнопке «Экспорт каталога» браузер сразу скачивает export.xlsx. В файле два листа — «Категории» и «Товары»; названия листов приходят на языке интерфейса, а при загрузке принимаются на любом из них.

Лист «Категории»

Колонка	Что в ней
`id`	номер категории, уникальный, больше нуля
`name`	название
`parentId`	номер родительской категории; пусто — категория верхнего уровня
`enabled`	показывать ли категорию: `1` — да, `0` — нет
`description`	описание
`index`	порядок среди соседних категорий

Лист «Товары»

Колонка	Что в ней
`id`	номер товара, уникальный, больше нуля
`name`	название, обязательно
`vendor_code`	артикул
`description`	описание
`price`, `old_price`	цена и цена до скидки
`weight`, `width`, `length`, `height`	вес в килограммах, габариты в сантиметрах
`categories`	номера категорий из первого листа; несколько — через `;` без пробелов
`measure`	единица измерения: `шт`, `кг`, `г`, `л` — без точек
`amount`, `minAmount`	остаток и порог уведомления
`status`	показывать ли товар: `1` — да, `0` — нет
`use_remains`	вести ли учёт остатков: `1` — да, `0` — нет
`vat_code`	ставка НДС

Импорт

Карточка «Импорт из файла» в разделе Импорт товаров — рядом с подключением маркетплейсов. Кнопка «Выбрать файл» открывает выбор файла, а флажки над ней говорят, что делать с совпадениями:

Не импортировать дубликаты категорий по имени
Не импортировать дубликаты товаров по имени
Не импортировать дубликаты товаров по артикулу

Совпадение ищется среди уже существующих в магазине записей. Если флажок снят, запись из файла заведётся ещё раз — рядом с прежней.

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

Отчёт

После импорта скачивается export_result.xlsx. Если всё прошло, в нём список обработанных товаров со ссылками на их карточки. Если что-то не прошло — причина по каждой строке.

В отчёте бывают и примечания к успешным строкам: товар выключен, потому что упёрся в лимит активных товаров тарифа; не найдена категория, указанная в колонке categories; единица измерения не распознана и заменена на «шт».

Когда файл не нужен

Если товары уже заведены на маркетплейсе, переносить их таблицей необязательно — есть прямой импорт из Ozon, Wildberries и Яндекс Маркета.