Перейти к содержанию

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

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

Импорт товаров из Excel

XLS/XLSX → каталог CRM. Добавление по файлу и обновление цен из HTTPS-прайса с ручным подтверждением.

Категория: Импорт данных. Битрикс24 с каталогом товаров CRM; приложение устанавливается в портал из Маркета.

  • Добавление и обновление товаров из XLS/XLSX с сопоставлением колонок.
  • Обновление существующих товаров по постоянному внешнему коду XML_ID.
  • Ручное получение HTTPS-прайса, предпросмотр цен и подтверждение изменений администратором.

Операционная система: Windows.

Версия в Маркете: 3.

Проверенная среда: Google Chrome под Windows. Интерфейс открывается в браузере внутри Битрикс24; отдельная программа для Windows не требуется. Среда подтверждена проверками приложения в проекте разработки.

Разработчик: Media Targeting.

Доступно в подписке Битрикс24 Маркетплейс; условия подключения проверяйте в карточке приложения.

Сведения сверены с карточкой Маркета . Актуальные условия могут измениться.

Установка и актуальные условия в Маркете Битрикс24 →

← Все приложения и отчёты для Битрикс24

Загрузите прайс из XLS или XLSX в каталог CRM Битрикс24: сопоставьте столбцы, добавьте новые товары или обновите существующие по XML_ID. Начните с небольшого файла и проверки ключей — это помогает избежать дублей при повторной загрузке.

Открыть в Маркете Битрикс24

Оно загружает товары из XLS/XLSX в каталог CRM Битрикс24 и позволяет сопоставить столбцы таблицы с полями товара.

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

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

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

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

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

Читай также:  Почему изменились продажи: цена, количество и ассортимент в Битрикс24

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

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

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

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

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

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

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

Учебный файл и проверка обновления

Скачать учебный прайс XLSX. В нём два вымышленных товара с внешними кодами DEMO-001 и DEMO-002, названиями и ценами. Сопоставьте столбец XML_ID с внешним кодом, название — с названием, цену — с ценой. Валюту и остальные обязательные параметры проверьте в своём каталоге; не загружайте пример в рабочие данные без подготовки.

Читай также:  Смарт-процессы в Битрикс24: как выбрать структуру и подготовить автоматизацию

После первой загрузки запишите ID карточки DEMO-001. Измените её цену в файле с 1000 на 1100 и выполните обновление по XML_ID. В каталоге должна измениться прежняя карточка с тем же ID. Появление новой позиции означает, что ключ или режим требуют проверки.

Excel-приложение или штатный CSV-импорт

Штатный импорт каталога Битрикс24 позволяет обновлять товары из CSV по внешнему коду. Он подходит, когда таблицу удобно подготовить в этом формате. Приложение принимает XLS/XLSX напрямую и даёт сопоставление полей и журнал обработки. Выберите способ по формату исходного прайса и требуемому процессу; ни один из способов не отменяет проверку ключей и результата.

Материал BI Data / Media Targeting. Содержательно обновлён 27 октября 2026 года. Возможности и условия сверены с публичной карточкой решения.

Возможности и особенности работы

Два способа работы с прайсом

Для первоначального наполнения каталога загрузите XLS или XLSX, сопоставьте колонки и проверьте внешний код товара. При повторном импорте сохраняйте этот код: одинаковое название само по себе не заменяет XML_ID.

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

Ограничения обновления цен

Модуль HTTPS-прайса обрабатывает один источник на портал: XLS/XLSX до 10 МБ, один лист, до 2 000 строк товаров и 50 колонок. Он предназначен для изменения цены существующих позиций с сохранением валюты и единиц. Новые товары добавляйте обычным импортом.

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

Сведения о возможностях уточнены 27 октября 2026 года. Условия установки проверяйте в карточке решения.