Импорт товаров из CSV: подготовка файла

Качество импорта в 1С-Битрикс на 90% определяется тем, как подготовлен CSV-файл. Штатный инструмент «Загрузка данных из файла CSV» нетребователен к формату, но именно из-за этого прощает мусор в данных: кривая кодировка, лишние разделители и неверная структура колонок превращаются в дубли товаров и битые свойства. Разберём, как собрать файл так, чтобы импорт прошёл с первого раза.

Что за инструмент и когда он уместен

В 1С-Битрикс за загрузку данных из плоских файлов отвечает модуль Информационные блоки (iblock). Инструмент находится в списке элементов инфоблока: Контент → Инфоблоки → тип → инфоблок → Импорт → CSV, технически это страница /bitrix/admin/csv_import.php. Он умеет создавать и обновлять элементы и разделы, заполнять базовые поля и свойства.

CSV-импорт хорош, когда каталог приходит из внешней системы, у которой нет обмена по CommerceML: выгрузка от поставщика, экспорт из Excel-прайса, перенос со старой CMS. Если же источник — 1С, правильнее настраивать обмен по CommerceML, а CSV использовать как разовый или вспомогательный канал.

Структура файла: какие колонки нужны

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

Минимально осмысленный набор колонок для товара:

• Название — поле NAME, обязательное;
• Символьный код — CODE, латиницей, служит человекочитаемым URL и удобным ключом обновления;
• Внешний код / артикул — XML_ID или отдельное свойство; именно по нему при повторном импорте элементы обновляются, а не дублируются;
• Раздел — путь к категории каталога;
• Активность — ACTIVE (Y/N), сортировка, детальный и анонсовый текст;
• Свойства — бренд, цвет, размер, артикул и прочие характеристики.

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

Кодировка, разделители и ограничители

Три параметра формата, из-за которых чаще всего рассыпается импорт, — кодировка, разделитель полей и ограничитель строк. Их нужно знать заранее и указать в мастере импорта ровно так, как они в файле.

Разделы и вложенность каталога

CSV-импорт умеет раскладывать товары по разделам и создавать недостающие категории на лету. Есть два рабочих подхода. Первый — колонка с путём раздела, где уровни вложенности разделены выбранным символом, например Обувь > Мужская > Ботинки. Битрикс разберёт цепочку и привяжет товар к последнему уровню, попутно создав промежуточные разделы.

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

1. Определитесь с глубиной дерева и зафиксируйте разделитель уровней;
2. Убедитесь, что названия разделов написаны единообразно — «Аксессуары» и «аксессуары» создадут два разных раздела;
3. Проверьте, что у товара указан полный путь, а не только конечная категория.

Свойства, множественные значения и изображения

Каждое свойство инфоблока — это отдельная колонка. Для множественных свойств (несколько цветов, набор тегов) значения в ячейке разделяют тем самым «разделителем значений», который не должен совпадать с разделителем полей. Свойства типа «список» лучше заранее завести в инфоблоке: если импорт создаёт значения справочника автоматически, легко получить дубли вариантов из-за лишних пробелов и регистра.

С изображениями работает правило: картинка — это путь, а не сама картинка. В ячейке указывается путь к файлу, который уже лежит на сервере (например, /upload/import/img/art-1024.jpg) либо доступен по URL. Поэтому изображения выкладывают на сервер до импорта, а в CSV кладут ссылки на них.

Очистка и валидация перед загрузкой

Файл от поставщика почти всегда содержит мусор, который штатный импорт молча проглотит и превратит в проблемы каталога. Прогоните данные по короткому чек-листу до запуска:

• Уникальность ключа. Проверьте, что артикул/внешний код не повторяется — дубли по ключу дадут перезапись или лишние карточки;
• Пробелы и регистр. Уберите двойные и хвостовые пробелы, приведите к единому виду бренды и разделы;
• Числа. Единый десятичный разделитель, без разрядов-пробелов в цифрах;
• Пустые обязательные поля. Строки без NAME не загрузятся;
• Символы разметки. В описаниях уберите разделитель и ограничитель или экранируйте их кавычками.

Перед боевым импортом сделайте пробную загрузку на 10–20 строк и проверьте результат в списке элементов: раскладку по разделам, кодировку названий, подтянувшиеся картинки и свойства. Дешевле переделать образец, чем чистить весь каталог после массового импорта.

Подводные камни больших файлов

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

• Дробите большой CSV на файлы по несколько тысяч строк — так проще ловить и локализовать ошибки;
• Держите картинки в подпапках /upload/, а не грузите их порознь через тот же файл;
• Для регулярных загрузок сохраняйте конфигурацию сопоставления полей и запускайте её на однотипных файлах.

Итог

Подготовка CSV сводится к трём вещам: правильная структура колонок под поля инфоблока, согласованные кодировка и разделители, а также вычищенные данные с уникальным ключом обновления. Если файл собран аккуратно, штатный импорт 1С-Битрикс отрабатывает предсказуемо, а повторные загрузки обновляют каталог, а не плодят дубли.

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