Импорт данных из CSV: пошаговая настройка

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

Где в Битрикс запускается импорт из CSV

За загрузку товаров в формате CSV отвечает модуль «Торговый каталог» (catalog). Мастер импорта открывается в административном разделе: Магазин → Настройки → Экспорт / импорт → Импорт данных, где в списке форматов нужно выбрать CSV. Технически это страница /bitrix/admin/cat_import_setup.php.

Если каталога как такового нет и вы грузите произвольный инфоблок (новости, статьи, справочники), используйте общий импорт: Контент → Инфоблоки → Импорт → CSV. Логика мастера одинакова, отличается только набор специфичных для магазина полей — цены, склады, единицы измерения.

Шаг 1. Параметры CSV-файла

На первом экране вы указываете путь к файлу (обычно предварительно загруженному в /upload/ через FTP или файловый менеджер) и описываете его формат. Ключевые параметры:

• Разделитель полей — запятая, точка с запятой, табуляция, пробел или произвольный символ. Русский Excel по умолчанию сохраняет CSV с ;, поэтому чаще всего выбирают точку с запятой.
• Разделитель значений — символ внутри одной ячейки для множественных свойств (например, несколько значений «Цвет»).
• Ограничитель строк — обычно двойная кавычка ", если текстовые поля содержат разделитель.
• Кодировка файла — UTF-8 или Windows-1251.

Шаг 2. Выбор инфоблока-приёмника

Дальше мастер спрашивает, куда складывать данные. Здесь вы выбираете тип инфоблока и сам инфоблок — например, Каталог (catalog), если товары попадают в основной каталог магазина. Если в файле есть отдельная колонка для торговых предложений (размеры, цвета), учитывайте, что SKU живут в связанном инфоблоке предложений и настраиваются отдельным профилем.

Тут же задаётся ключевой параметр — по какому полю искать существующие элементы, чтобы обновлять их, а не плодить дубли:

• По ID — если в файле есть внутренний идентификатор Битрикс;
• По внешнему коду (XML_ID) — универсальный вариант для регулярной выгрузки из учётной системы;
• По артикулу — удобно, когда единый ключ товара — код поставщика.

Если совпадение не найдено, элемент создаётся заново; если найдено — обновляется. Неверный ключ приводит к массовому задвоению каталога.

Шаг 3. Сопоставление колонок

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

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

Шаг 4. Цены, склады и поведение импорта

Для торгового каталога мастер добавляет коммерческие параметры, которых нет в обычном инфоблоке:

• Тип цены и валюта — в какую цену (например, «Базовая», BASE) писать числовое значение из колонки;
• Ставка НДС — если она едина для загрузки;
• Единица измерения и коэффициент — штуки, упаковки;
• Склад и количество — при включённом складском учёте.

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

Шаг 5. Запуск и проверка результата

После настройки мастер выполняет импорт и выводит отчёт: сколько элементов добавлено, обновлено, пропущено, и какие строки вызвали ошибки. Большие файлы Битрикс обрабатывает пошагово (порциями), чтобы не упереться в max_execution_time PHP — на экране крутится прогресс.

Что проверить сразу после загрузки:

1. Открыть 3–5 случайных товаров и сверить название, цену, свойства и раздел;
2. Убедиться, что цена записалась в нужный тип цены и валюту;
3. Проверить символьные коды — при пустом CODE ЧПУ-ссылки не сформируются;
4. Посмотреть, не появились ли дубли (признак неверного ключа поиска).

Частые ошибки настройки

Большинство сбоев импорта — это не баги платформы, а неточности в параметрах мастера:

• «Кракозябры» в названиях — неверная кодировка на шаге 1 или незамеченный BOM в UTF-8-файле.
• Дубли товаров — не задан или задан неверно ключ поиска существующих элементов на шаге 2.
• Съехавшие колонки — разделитель полей в мастере не совпал с реальным разделителем в файле; в предпросмотре всё в одной колонке.
• Товары без цены — колонка сопоставлена не с типом цены, а с текстовым свойством, либо в числе стоит запятая как десятичный разделитель.
• Импорт «отваливается» на большом файле — стоит увеличить лимиты PHP или дробить файл, а настройки сохранить в профиль для повторного запуска.

Итог

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

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