Экспорт и импорт в Битрикс: типичные ошибки и решения

Импорт каталога в 1С-Битрикс может завершиться без ошибки — и всё равно оставить на сайте дубли товаров, пустые свойства или цены в неверном формате. Проблема обычно не в кнопке загрузки, а в несовпадении структуры файла с настройками инфоблока и в том, что результат проверяют только по сообщению «Готово». Ниже — практические проверки для 1С-Битрикс: Управление сайтом; названия пунктов интерфейса и доступные возможности могут различаться между версиями и настройками проекта.

До импорта: выясните, что именно меняет файл

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

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

Параметры импорта, в частности разделитель CSV, кодировку и правила сопоставления полей, выбирайте по фактическому файлу и экрану импорта вашей версии. Универсальных настроек для всех проектов нет.

Формат задаёт способ проверки

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

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

Надёжный импорт — это не тот, который однажды загрузил файл без ошибки. Это тот, который при повторной загрузке обновляет те же записи, а не создаёт новый каталог рядом со старым.

Ошибки, которые чаще всего портят результат

1. Поля сопоставлены по названию, а не по смыслу

Колонки «Артикул», «Код» и «ID» могут выглядеть взаимозаменяемыми, но для систем это разные значения. Если импортёр использует один идентификатор для поиска существующего товара, а файл передаёт другой, повторная загрузка способна создать дубли. До массового запуска проверьте на паре записей, какой идентификатор отвечает за обновление, а какой просто хранится в поле.

2. Значения свойств не совпадают с настройками инфоблока

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

3. CSV прочитан с неверной кодировкой или разделителем

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

4. Числа и цены интерпретированы иначе

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

5. Изображения и файлы недоступны по указанным путям

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

6. Повторный запуск создаёт дубли

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

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

1. Зафиксируйте исходное состояние. Запишите количество товаров и предложений, а также несколько контрольных значений: артикул, цену, остаток и свойства. Проверка пройдена, если есть точка сравнения до импорта.
2. Подготовьте маленький тестовый файл. Возьмите новые записи, существующие записи и строку с необязательным полем. Проверка пройдена, если каждая строка покрывает отдельный сценарий, а не только идеальные данные.
3. Настройте сопоставление полей. Свяжите колонки файла с нужными полями и свойствами инфоблока. Проверка пройдена, если тестовый товар получил правильные значения в карточке и не появился в чужом разделе.
4. Выполните импорт на копии. Сверьте не только сообщение об успешной обработке, но и фактические записи, цены, остатки, изображения и связи с предложениями. Проверка пройдена, если число новых и обновлённых объектов соответствует тестовым строкам.
5. Повторите тот же импорт. Это проверка на дубли и неидемпотентность*. Проверка пройдена, если повторная загрузка обновляет ожидаемые записи и не увеличивает каталог без причины.
6. Переносите настройки на рабочий сайт поэтапно. Сохраните резервную копию и начните с малого объёма, если сценарий это позволяет. Проверка пройдена, если после загрузки контрольные значения совпали с исходными данными.

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

Если результат не совпал с ожиданиями

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

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

Что делать дальше

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

*Идемпотентность — свойство операции, при котором повторное выполнение с теми же данными не создаёт лишних изменений, например дублей товаров.