Импорт из Excel в Битрикс24: списки, товары, контакты и компании

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

В этой инструкции разберём, как подготовить данные, перенести реестр в универсальный список, загрузить товары, контакты и компании и проверить, что повторный импорт не создаёт лишние дубли. Основной пример — реестр оборудования: у каждого объекта есть постоянный номер, а название, состояние и другие сведения могут меняться.

Интерфейс и документация проверены 30 сентября 2026 года. Скриншоты показывают реальные экраны настройки; адрес портала, персональные данные и сведения о компаниях исключены из кадров. Учебные примеры вымышлены. Импорт в рабочие записи для подготовки статьи не выполнялся. Доступность разделов зависит от тарифа, версии и прав пользователя.

Импорт из Excel в Битрикс24: какой способ выбрать

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

Excel — программа для подготовки таблицы, а XLSX и CSV — разные форматы файла. Штатные мастера импорта контактов, компаний и товаров используют CSV. Приложения могут принимать XLSX напрямую. Переименование расширения .xlsx в .csv не преобразует содержимое: нужен пункт «Сохранить как» с выбором формата.

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

Как подготовить Excel или CSV перед загрузкой

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

• Оставьте одну строку заголовков. Уберите надписи над таблицей, объединённые ячейки, промежуточные итоги и пустые заголовки между заполненными столбцами.
• Определите ключ записи. Например, инвентарный номер оборудования или внешний код товара. Ключ должен быть заполненным, уникальным в вашей выборке и постоянным между загрузками.
• Сохраните коды как текст. Значение 000127 не должно превратиться в 127. Особенно внимательно проверьте длинные номера и значения, которые Excel преобразует в дату.
• Проверьте числа и даты. В колонке цены не должно быть комментария «уточнить», а в количестве — единицы измерения вместе с числом. Формат дат должен соответствовать выбранному импортёру.
• Проверьте вычисляемые значения. Для файла обмена удобнее подготовить копию с результатами формул, если формулы не являются частью поддерживаемого сценария.
• Для CSV проверьте кодировку и разделитель. После сохранения откройте файл в текстовом редакторе: столбцы могут разделяться запятой или точкой с запятой. Настройка мастера должна соответствовать файлу.

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

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

Как импортировать Excel в универсальные списки Битрикс24

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

Для загрузки можно использовать наше приложение «Импорт универсальных списков». В нём выбирается список, скачивается его Excel-шаблон и сопоставляются столбцы файла с полями. Текущий интерфейс принимает XLS, XLSX и CSV размером до 10 МБ.

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

Первый столбец — существенная настройка. Если режим обновления выбран, но первый столбец не сопоставлен, приложение предупреждает, что элементы будут только добавляться. Поэтому не ставьте перед ключом колонку «№ строки» и не пропускайте первую колонку при настройке.

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

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

Как повторно обновлять список без лишних дублей

Название объекта неудобно использовать как ключ: «Ноутбук для переговорной» завтра может стать «Ноутбук для переговорной №2», хотя речь идёт о той же вещи. Инвентарный номер EQ-001 должен остаться прежним. Изменение названия тогда не мешает найти существующую запись.

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

Для проверки повторной загрузки используйте такой порядок:

1. В отдельном тестовом списке создайте небольшую проверочную выборку через выбранный импортёр.
2. Сохраните ID созданных элементов и их ключи.
3. Измените у одной строки обычное поле, сохранив ключ, а вторую оставьте прежней.
4. Повторите импорт в режиме обновления с тем же сопоставлением.
5. Проверьте: ID прежних элементов сохранились, нужное поле изменилось, число записей не выросло. Затем отдельно проверьте добавление строки с новым ключом.

Отдельно выясните поведение пустых ячеек: пропуск поля, очистка значения и запись пустой строки — разные действия. Если задача состоит только в изменении состояния оборудования, не включайте в обновление остальные поля без необходимости.

После сбоя не загружайте весь файл повторно в режиме добавления. Часть строк могла успеть записаться. Сверьте журнал с фактическими элементами и подготовьте файл только для оставшихся или исправленных строк. Успешное чтение Excel ещё не означает, что все его строки сохранены в Битрикс24.

Импорт товаров из Excel и обновление цен

Для штатной загрузки откройте «CRM → Товары и склады → Каталог товаров → Настройки → Импорт товаров». Скачайте шаблон, подготовьте CSV и сопоставьте поля. По текущей документации этот сценарий предназначен для обычных товаров без вариаций. Инструкция по штатному импорту товаров.

Для обновления выгрузите нужные товары вместе с полем «Внешний код». Совпадение этого кода позволяет обновить существующую позицию; без него может появиться новый товар. При обратной загрузке сохраните коды без изменений. Изменение цены в каталоге не обновляет автоматически цену в уже добавленной товарной строке сделки. Правила обновления товаров через импорт.

Если удобнее работать непосредственно с XLS или XLSX, наше приложение «Импорт товаров из Excel» принимает такие файлы до 10 МБ. После загрузки можно сопоставить столбцы и выбрать добавление либо обновление с добавлением. В режиме обновления поиск идёт по XML_ID — внешнему коду товара.

Артикул и XML_ID не обязательно совпадают. Если в прайсе есть колонка «Артикул», а в каталоге это отдельное пользовательское поле, одного совпадения артикулов недостаточно для обновления по XML_ID. Сначала установите соответствие кодов. Не перезаписывайте внешние коды, которыми уже пользуется другая интеграция.

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

Подробности сопоставления разобраны в отдельном обзоре импорта товаров и XML_ID. Для рабочего каталога начинайте с небольшой категории или проверочной группы позиций.

Как импортировать контакты и компании из Excel

Для клиентской базы используйте штатный мастер CRM. В разделе «CRM → Клиенты → Контакты» откройте настройки и выберите «Импорт из CSV со своими настройками». Для организаций откройте компании и их импорт. Подготовьте таблицу по скачанному шаблону и сохраните её в CSV.

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

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

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

Типичные ошибки импорта и проверка результата

После импорта сопоставьте три набора: строки файла, отчёт обработки и записи в Битрикс24. Для каждой строки должно быть понятно, создан новый объект, обновлён существующий, пропущен дубль или получена ошибка. Одна итоговая надпись «завершено» такой проверки не заменяет.

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

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

Ответы на частые вопросы

Можно ли загрузить XLSX без преобразования в CSV?

Да, если выбранный импортёр поддерживает XLSX. Показанные приложения для списков и товаров принимают Excel напрямую. Штатные сценарии контактов, компаний и товаров, рассмотренные в статье, используют CSV.

Можно ли использовать один файл и для товаров, и для списка?

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

Гарантирует ли режим обновления отсутствие дублей?

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

Что делать, если импорт оборвался?

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

С чего начать первую загрузку?

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