Импорт товаров из Excel в Битрикс24: сопоставление полей и обновление по XML_ID

Импорт товаров из Excel в Битрикс24: сопоставление полей и обновление по XML_ID

Обновлено 3 сентября 2026 года.

Материал дополняет анонс приложения «Импорт товаров из Excel» от 5 мая 2025 года. Оно загружает товары из XLS/XLSX в каталог CRM Битрикс24 и позволяет сопоставить столбцы таблицы с полями товара.

Возможности и условия

В карточке приложения в Маркете описаны загрузка файла до 10 МБ, сопоставление полей, режим добавления и режим обновления по XML_ID, а также отображение результата обработки. В опубликованной версии 3 от 25 июня 2026 года заявлены улучшения стабильности.

Приложение доступно в подписке Маркета. Условия вашего портала и разрешения на изменение каталога проверяются перед установкой. Фактическая скорость импорта зависит от файла, количества запросов и ответов API; обещать одинаковое время для любого каталога нельзя.

XML_ID — внешний код, а не любое поле «Артикул»

Обновление существующего товара опирается на совпадение внешнего кода XML_ID. Если артикул хранится в отдельном пользовательском поле, совпадения в этом поле недостаточно: нужный столбец должен быть сопоставлен именно с внешним кодом. Название столбца в Excel не меняет его назначение в CRM.

Используйте постоянный идентификатор из учётной системы. Проверьте пустые значения и дубли как в файле, так и в каталоге. Код 00125 храните как текст: после преобразования Excel в число 125 исходные ведущие нули уже не восстановятся простым изменением формата ячейки.

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

Порядок загрузки

  1. Сохраните исходный файл и доступную выгрузку текущего каталога. Обычный экспорт не следует считать полной резервной копией всех связей и настроек.
  2. Подготовьте небольшой пробный файл с новым товаром и товаром, который уже есть в каталоге. Проверьте названия, внешние коды, цены, единицы измерения и нужные пользовательские поля.
  3. Выберите файл и проверьте сопоставление каждого столбца. Автоматическая подсказка по названию не заменяет эту проверку.
  4. Осознанно выберите режим: только добавление либо обновление при совпадении XML_ID. Повторная загрузка в режиме добавления может создать лишние карточки.
  5. Просмотрите результат и ошибки. Откройте обе пробные карточки в каталоге и сравните поля с файлом.
  6. Повторите пробную загрузку в режиме обновления: убедитесь, что существующие позиции не получили дубли, а нужные значения изменились. Затем переходите к основному файлу.
Читай также:  Битрикс24 и Power BI: подключение данных и проверка отчёта

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

Как принять результат

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