Импорт товаров

В интернет-магазине товары можно добавить вручную, через AI или загрузить списком из файла. Этот раздел — про импорт из CSV и ZIP.

Импорт каталога не связан с экспортом/импортом всего сайта: ZIP проекта не содержит товары магазина. Каталог переносится отдельно из панели Товары.

Общий обзор магазина: Интернет-магазин.

Где импортировать

Откройте проект Интернет-магазин в редакторе.
Слева выберите раздел Товары.
Нажмите Управление товарами.
Дальше:
- Загрузить CSV — только таблица (названия, цены, характеристики). Картинки из файла не подгружаются.
- Перенос товаров (ZIP) — таблица + фото в одном архиве. Так удобнее залить каталог с картинками.

Сначала можно выгрузить текущий каталог (Выгрузить CSV или ZIP), посмотреть формат и править его в Excel / Google Sheets / Numbers.

Что выбрать: CSV или ZIP

Способ	Когда использовать
CSV	Обновить цены, названия, статусы, характеристики; фото уже есть в Медиа или их добавите позже
ZIP	Первый залив каталога с фото или перенос магазина вместе с картинками

Лимиты:

до 2000 строк товаров в одном CSV;
ZIP с товарами — до ~80 МБ;
у одного товара до 10 фото.

Формат CSV

Кодировка и разделитель

Файл в UTF-8 (лучше с BOM — так Excel реже ломает кириллицу).
Разделитель: запятая , или точка с запятой ; (как в русской Excel). Система определит сама по первой строке.
Первая строка — заголовки колонок на английском (см. ниже). Русские заголовки вроде «Название» / «Цена» не подойдут.

Обязательные колонки для новых товаров

Колонка	Пример	Правило
`title`	`Смартфон Nova X15`	Название, непустое
`price`	`34990`	Число больше 0, точка как десятичный разделитель (`99.5`), не запятая

Остальные колонки необязательны.

Основные колонки

Колонка	Назначение	Пример
`sku`	Артикул. Если товар с таким `sku` уже есть — строка обновит его	`PHN-001`
`slug`	Адрес в URL. Без `sku` поиск существующего идёт по `slug`	`smartphone-nova-x15`
`title`	Название	`Наушники Pulse Buds Pro`
`description`	Описание (текст / простой HTML)	`Беспроводные наушники…`
`price`	Цена	`7990`
`compare_at_price`	Старая цена (зачёркнутая). Пусто — сбросить	`9990`
`currency`	Валюта, 3 буквы. Пусто — валюта магазина	`RUB`
`status`	`active`, `draft` или `archived`. Пусто у нового → `active`	`active`
`stock`	Остаток (целое). Пусто — без учёта остатка	`12`
`sort_order`	Порядок в списке	`10`
`category_slug`	Категория по slug. Нет такой — создаётся. Пусто — без категории	`smartphones`
`image_path`	Имена файлов фото через запятую (см. ZIP)	`nova-x15.jpg,nova-x15-2.jpg`

На витрину попадают только товары со статусом active.

Как обновляются существующие товары

Импорт ищет товар в таком порядке:

по sku, если колонка заполнена;
иначе по slug;
если не нашёл — создаёт новый.

Без sku и slug каждый импорт будет плодить дубликаты. Для повторных загрузок задайте стабильный sku или slug.

В строке обновления меняются только колонки, которые есть в файле. Пустой status при обновлении статус не трогает; пустой category_slug снимает категорию; пустой image_path очищает фото.

Характеристики (свойства)

Любая колонка не из списка выше становится характеристикой товара (meta): бренд, цвет, память и т.п. Имя колонки = название свойства на витрине и в фильтрах.

Пример заголовков:

title,price,category_slug,Бренд,Цвет,Память

Значения — обычный текст в ячейках. При обновлении свойства из файла дописываются/перезаписываются к уже существующим.

Импорт ZIP с фото

Структура архива

В корне ZIP (или в одной вложенной папке) должен быть файл с точным именем:

products.csv
images/
  nova-x15.jpg
  nova-x15-2.jpg
  pulse-buds-pro.jpg

Важно:

файл называется products.csv;
картинки лежат в папке images/ (не в корне архива рядом с CSV);
имена файлов в images/ уникальны;
в image_path пишите только имя файла (nova-x15.jpg), как в папке images/.

Имена файлов лучше латиницей без пробелов: nova-x15.jpg, nova-x15-2.jpg. Кириллица в имени часто ломает сборку ZIP и сопоставление.

Несколько фото у одного товара

В image_path перечислите файлы через запятую, без пробелов или с пробелами после запятой — оба варианта допустимы:

nova-x15.jpg,nova-x15-2.jpg

Порядок слева направо = порядок в карточке (первое — главное). Максимум 10 фото на товар.

Как загрузить

Товары → Перенос товаров (ZIP).
Выберите собранный .zip.
Дождитесь результата: сколько создано / обновлено и список ошибок по строкам (если есть).

Тот же диалог умеет скачать текущий каталог частями ZIP — удобный эталон структуры.

Примеры

Минимальный CSV (без фото)

title,price,category_slug,status
Смартфон Nova X15,34990,smartphones,active
Ноутбук Atlas Book 14,79990,laptops,active
Наушники Pulse Buds Pro,7990,headphones,active
Зарядка Volt 65W,2490,accessories,active

Сохраните как products.csv и загрузите через Загрузить CSV. Фото добавьте позже в карточке товара или повторным ZIP-импортом с теми же sku/slug.

CSV с артикулами, описанием и свойствами

sku,title,description,price,compare_at_price,category_slug,status,Бренд,Память
PHN-001,Смартфон Nova X15,"Экран 6.7″, камера 108 Мп, батарея на весь день.",34990,39990,smartphones,active,Nova,256 ГБ
LAP-010,Ноутбук Atlas Book 14,"Лёгкий ноутбук для работы и учёбы.",79990,,laptops,active,Atlas,512 ГБ
EAR-003,Наушники Pulse Buds Pro,"Шумоподавление и до 30 часов с кейсом.",7990,,headphones,draft,Pulse,

Повторная загрузка того же файла с другими ценами обновит товары по sku, не создавая дубликаты. EAR-003 со статусом draft на витрине не появится.

ZIP: products.csv + images/

products.csv:

sku,title,price,category_slug,image_path,status,Бренд
PHN-001,Смартфон Nova X15,34990,smartphones,"nova-x15.jpg,nova-x15-2.jpg",active,Nova
LAP-010,Ноутбук Atlas Book 14,79990,laptops,"atlas-book-14.jpg,atlas-book-14-2.jpg",active,Atlas
EAR-005,Наушники Pulse Buds Pro,7990,headphones,pulse-buds-pro.jpg,active,Pulse

Содержимое архива:

products.csv
images/nova-x15.jpg
images/nova-x15-2.jpg
images/atlas-book-14.jpg
images/atlas-book-14-2.jpg
images/pulse-buds-pro.jpg

Соберите ZIP так, чтобы products.csv и папка images оказались на первом уровне архива (не Архив/products.csv внутри лишней обёртки — допускается одна общая папка, но имена внутри должны совпадать).

Пример для Excel

Создайте лист с заголовками: sku, title, price, category_slug, image_path, status, Бренд.
Заполните строки.
Сохранить как → CSV UTF-8 (или «CSV (разделители — запятые)»).
Для ZIP: положите CSV рядом с папкой images, выделите оба → сжать в ZIP → загрузите в Перенос товаров (ZIP).

Если Excel сохранил файл как .xlsx, импорт не примет его: нужен именно .csv внутри ZIP или отдельно.

Типичные ошибки

Сообщение / симптом	Что сделать
`ZIP must contain products.csv`	Переименуйте таблицу в `products.csv`. Проверьте, что файл не называется `Товары.csv`
`title is required` / `price is required`	Для новых строк нужны `title` и `price`
`Invalid price «8,800»` или `«99,5»`	Уберите разрядные пробелы/запятые; десятичная часть — через точку: `8800` или `99.5`
`status must be draft, active or archived`	Только эти три значения латиницей
`Image «…» not found in project media or ZIP`	Файл не в `images/`, опечатка в `image_path` или имя не совпадает
`Duplicate image basename «photo.jpg»`	Два файла с одним именем в разных подпапках `images/` — переименуйте
Дубликаты товаров после повторного импорта	Задайте уникальные `sku` или `slug` и импортируйте снова
Категории «Smartphones», «Laptops» вместо русских	Это нормально при создании из slug — переименуйте в Редактировать категории (например, «Смартфоны»)
Кириллические заголовки колонок	Замените на `title`, `price`, `description`, `category_slug`, …
Картинки в корне ZIP, не в `images/`	Импорт их проигнорирует — переложите в `images/`

После импорта

Откройте Управление товарами — проверьте названия, цены, фото.
В Редактировать категории поправьте русские названия категорий.
Убедитесь, что нужные товары в статусе active.
В настройках магазина включён переключатель Магазин включён.
Откройте предпросмотр каталога и сделайте тестовый заказ — см. чеклист перед публикацией.