Загрузка товаров в Битрикс из таблицы: как подготовить данные и проверить каталог

Что нужно решить перед загрузкой файла

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

CSV — текстовый формат таблицы: строки содержат записи, а значения разделены выбранным символом. В нём нет привычного оформления книги Excel, нескольких листов и формул как рабочего механизма расчёта. Для импорта нужен подготовленный набор значений, смысл которых совпадает с полями каталога.

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

Эта инструкция помогает руководителю или маркетологу подготовить и принять загрузку. Она не заменяет настройку исполнителем и не предполагает, что любой файл поставщика подходит без преобразования. Если каталог уже обновляется из 1С или другого источника, сначала согласуйте, какие поля разрешено менять вручную и не будут ли они перезаписаны следующим обменом.

Как сайт узнает уже существующий товар

Главный вопрос повторной загрузки — признак, по которому строка файла сопоставляется с товаром на сайте. Название неудобно использовать как устойчивый ключ: поставщик может исправить орфографию, дополнить модель или поменять порядок слов. Тогда прежняя позиция рискует выглядеть новой, хотя физически товар остался тем же.

Попросите исполнителя выбрать и показать стабильный идентификатор. В описании штатного импорта среди полей сопоставления названы уникальный идентификатор XML_ID и название. Для рабочего процесса с повторными загрузками полезно опираться на неизменяемый ключ, если схема каталога это поддерживает. Наличие артикула в таблице ещё не означает, что импорт настроен искать товар именно по нему.

Проверьте ключ на уникальность и сохранность. Условные коды 00125 и 125 могут обозначать разные позиции по правилам поставщика. Если табличный редактор убрал ведущие нули, восстановление по памяти недопустимо: нужно вернуться к исходным данным. Аналогично проверяют пробелы, разные алфавиты и случайные изменения регистра, если они значимы для выбранной схемы.

Для товаров с вариантами отдельно определите ключ родительской карточки и ключ каждого предложения. Размер или цвет может быть отдельной продаваемой единицей. Не объединяйте такие строки только по общему названию модели. Исполнитель должен показать, как вариант связан с товаром и где хранится его цена и наличие.

Подготовьте таблицу соответствия полей

Составьте короткий словарь данных: название столбца, его смысл, пример допустимого значения, поле сайта и правило при пустой ячейке. Это полезнее, чем просьба «загрузить как в файле». Один столбец «цена» не объясняет, какая это цена, в какой валюте и для какой единицы продажи.

Не смешивайте пустое значение, ноль и отсутствие столбца. Для количества ноль может означать отсутствие остатка, а пустая ячейка — неизвестное значение. Для цены это различие особенно существенно. По каждому спорному полю выберите правило: сохранить прежнее, очистить, отклонить строку или передать на ручную проверку.

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

Проверьте формат и опасные настройки

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

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

Особое внимание уделите товарам, которых нет в файле. Штатный профиль предусматривает разные действия с ними, включая сохранение, деактивацию и удаление. Выбор зависит от назначения загрузки. Небольшой файл с обновлением цен не должен случайно стать основанием для удаления остального каталога.

Согласуйте значение каждой настройки с исполнителем и сохраните снимок выбранного профиля. Для частичного обновления обычно требуется сохранять незатронутые записи; для полной замены ассортимента нужен отдельный проверенный порядок. Не выбирайте разрушительные действия только потому, что они доступны в форме.

Если импорт умеет удалять ранее сохранённую цену при пустых значениях, проверьте эту опцию отдельно. Пропуск поставщика не должен превращаться в незапланированное изменение условий продажи. Итоговое поведение необходимо подтвердить на пробных строках в установленной версии, особенно при наличии доработок каталога.

Начните с небольшой, но разнообразной партии

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

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

Зафиксируйте ожидаемые изменения до нажатия кнопки загрузки. Например, один товар добавится, у другого изменится цена, название третьего обновится без создания дубля, а четвёртая строка потребует исправления. Это условный набор сценариев, а не норматив по числу строк. После выполнения сравните результат с ожиданиями.

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

Повторите файл и измените одну запись

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

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

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

Разберите прерывание операции. Если часть данных уже применена, повтор всей загрузки должен быть предсказуемым. Исполнитель определяет технический способ продолжения, а заказчик принимает итог: нет дублей, понятен список обработанных и пропущенных записей, ошибки не скрыты. Сохраняйте исходный файл и журнал конкретного запуска.

Как перенести проверенную загрузку на рабочий сайт

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

Уберите параллельные изменения на время операции либо опишите порядок их учёта. Если контент-менеджер редактирует карточку, а импорт обновляет её из старого файла, одна работа может затереть другую. То же относится к автоматическому обмену с учётной системой. Владелец данных должен понимать, какой источник действует в этот период.

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

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

Что передать сотруднику для следующих обновлений

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

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

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

Для обсуждения работы со ШТАБ ИТ подготовьте обезличенный образец файла, перечень полей и ожидаемые результаты первого и повторного импорта. Это конкретная основа задачи по каталогу на Битрикс. После согласования ключей и правил пустых значений можно оценить подготовку данных, настройку и приёмку без догадок о содержании таблицы.