ProductSite Документация Импорт товаров из CSV

Импорт товаров из CSV

Массовая загрузка и обновление товаров из таблицы Excel или Google Sheets. Удобно, когда позиций много или нужно регулярно менять цены и остатки. Инструмент доступен в кабинете: /editor/import/.

Когда доступен

Импорт выделен в отдельный платный модуль «Импорт товаров». Он работает только при активной подписке и подключённом модуле. Подключить и оплатить его можно в /editor/billing/, статус модулей виден в /editor/settings/modules/.

Модуль «Каталог» должен быть подключён, иначе товары на сайте не выводятся. Импорт при этом всё равно сохранит данные в черновик.

Создание и обновление

Каждая строка CSV сопоставляется с товарами по полю артикул (SKU):

Типичный сценарий: при первой загрузке отправляете полный файл со всеми колонками, а дальше обновляете прайс коротким файлом только с артикул, цена и наличие.

Формат файла

ПараметрЗначение
Разделитель колонокТочка с запятой ;
КодировкаUTF-8
ЗаголовкиФиксированные, на русском (см. таблицу ниже)
ШаблонКнопка «Скачать шаблон CSV» на странице импорта

Колонки CSV

КолонкаЧто значитПример
артикулУникальный код позиции для поиска при импорте. Обязателен для участия строки.TST-001
названиеНазвание товара на сайте. Нужно при создании новой позиции.Насос центробежный 50
категорияПуть категории: «Родитель > Подкатегория». Не более двух уровней, разделитель > (не слэш).Оборудование > Насосы
краткое_описаниеАнонс в списке каталога.Для промышленных линий
полное_описаниеТекст на вкладке «Описание» карточки.Многострочный текст
ценаЧисло. Можно с пробелами и запятой: 12 500,50. При режиме «по запросу» оставьте пустым.99650
режим_ценыОдно из: точная, от, по запросу.от
единицаЕдиница измерения для цены: шт, м, комплект и т.д.шт
наличиеОдно из: в наличии, под заказ, нет.под заказ
характеристикиПары «параметр=значение»; несколько пар разделяйте |.Мощность=4 кВт|Материал=сталь
фотоПрямые ссылки на изображения; несколько ссылок разделяйте |. Если колонка заполнена, текущие фото товара заменяются.https://…/a.jpg|https://…/b.jpg

Пустая ячейка — «не менять». Если при обновлении вы оставили колонку пустой, соответствующее поле товара останется как было. Исключение: колонка фото. Пустая колонка не трогает фото, а заполненная полностью заменяет набор снимков.

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

  1. Подготовьте CSV
    Сохраните таблицу из Excel или Google Sheets в UTF-8 с разделителем ;. Удобнее начать со шаблона на странице импорта.
  2. Загрузите и проверьте предпросмотр
    Система покажет, сколько товаров будет создано, обновлено или пропущено, и выведет построчные предупреждения, не применяя изменений.
  3. Нажмите «Применить в черновик»
    Импорт выполняется в фоне. Изменения попадают в черновик сайта, не на публичную версию.
  4. Опубликуйте сайт
    После импорта нажмите «Опубликовать» в шапке кабинета, иначе посетители увидят старые данные.

Категории при импорте

Если категории из CSV ещё нет, она создаётся автоматически (можно отключить опцией «не создавать новые категории» на странице импорта). Вложенность не глубже двух уровней: раздел и подраздел.

Чем импорт не является

CSV-импорт работает только с товарами. Он не сохраняет и не восстанавливает тексты страниц, настройки, новости и прочий контент. Для резервной копии черновика используйте выгрузку JSON.