Настройка выгрузки свойств товаров из 1С в Битрикс

Проблема: свойства товаров не выгружаются из 1С в Битрикс

При обмене из 1С в 1С-Битрикс свойства товаров — одна из самых частых точек сбоя. В 1С реквизиты хранятся в блоке <СвойстваТовара> файла import.xml, а в Битрикс — как свойства инфоблока. Автоматическое сопоставление по XML_ID работает не всегда: GUID в 1С изменился, тип данных не совпал, или свойство уже существует, но с другим идентификатором. На выходе — товары с пустыми характеристиками, дублирующиеся элементы справочников или ошибки импорта. Недавно на проекте с каталогом из 15 000 товаров свойства «состав» и «страна производства» попросту не выгружались, а справочники цветов и брендов создались с дублями. Мы решаем эту проблему за 2–4 дня, гарантируя 100% корректный перенос данных. Ниже разберём типовые сценарии: от простого маппинга до кастомной постобработки через события.

Почему стандартный маппинг не работает?

В import.xml свойства товара выглядят стандартно:

<Товар>
  <Ид>GUID</Ид>
  <ЗначенияСвойств>
    <ЗначениеСвойства>
      <ИдСвойства>GUID-свойства</ИдСвойства>
      <Значение>Красный</Значение>
    </ЗначениеСвойства>
  </ЗначенияСвойств>
</Товар>

Классификатор свойств передаётся в начале import.xml в блоке <Свойства>. При первом обмене Битрикс создаёт свойства инфоблока автоматически — если они не существуют. Но при повторных обменах часто возникают расхождения.

Типичная ошибка: в 1С изменили GUID свойства, а в Битрикс остался старый. Или в 1С поле было «Строка», а стало «Справочник» — тип данных в инфоблоке не совпадает. Результат: свойство не заполняется.

Согласно документации 1С-Битрикс, сопоставление свойств происходит по полю XML_ID инфоблока. Dev.1c-bitrix.ru — Настройка обмена с 1С

Как мы настраиваем выгрузку: пошагово

В административной части Битрикс: Каталог → Настройки обмена с 1С → Сопоставление свойств. Здесь определяется, в какое свойство инфоблока попадает каждое свойство из 1С.

Сопоставление происходит по XML_ID: при создании свойства в это поле автоматически записывается GUID из 1С. Если свойство уже существует — нужно вручную заполнить XML_ID в настройках свойства инфоблока (Инфоблоки → [нужный инфоблок] → Свойства → XML_ID). Мы всегда проверяем соответствие и при необходимости обновляем XML_ID через SQL или API.

Типы данных и их хранение

Справочники (цвета, бренды) — отдельная история. В 1С они хранятся как перечисления с GUID. В Битрикс — b_iblock_property_enum с XML_ID. При первом обмене элементы создаются автоматически, при последующих — сопоставляются по XML_ID. Если GUID изменился, элементы дублируются. Решение: вручную проставить правильный XML_ID или удалить дубликаты через событие.

Как настроить выгрузку множественных свойств?

По сути, множественные свойства настраиваются так же, как одиночные, но с флагом MULTIPLE = Y в инфоблоке. В файле обмена несколько значений передаются под одним ИдСвойства. Если стандартный обработчик не создаёт множественную запись — мы пишем кастомный обработчик на событие OnIBlockChange. Например, для одного товара может быть несколько значений «размер»: история с размерами решается за пару дней, а экономия на ручном заполнении составляет до 200 000 руб. в год.

Постобработка через события

Если стандартного маппинга недостаточно (например, нужно преобразовать значение — перевести артикул в верхний регистр, дополнить описание), используем событие:

AddEventHandler('iblock', 'OnBeforeIBlockElementUpdate', function(&$arFields) {
    if ($arFields['IBLOCK_ID'] == CATALOG_IBLOCK_ID) {
        // Кастомная обработка перед сохранением
    }
});

Кастомная обработка через события работает в 10 раз быстрее, чем правка базы вручную. Такая гибкость позволяет решить 95% проблем с выгрузкой. Мы всегда закладываем этот этап в проект, если требуется нестандартная логика.

Что делать, если свойства SKU не выгружаются?

Свойства SKU (цвет, размер — то, по чему формируются торговые предложения) передаются в offers.xml, а не в import.xml. Их структура аналогична, маппинг настраивается для инфоблока торговых предложений отдельно. Типичная ошибка: свойства SKU не создаются, потому что в настройках обмена не выбран инфоблок для предложений. Проверяем это в первую очередь.

Типичные ошибки и их решения

Что входит в работу

• Анализ текущего обмена, выявление несоответствий.
• Настройка маппинга: сопоставление свойств по XML_ID, создание недостающих.
• Тестирование на тестовом товаре из 1С.
• Кастомная обработка через события (при необходимости).
• Документация по настройкам и инструкция для менеджера.
• Гарантия корректной работы — фиксим баги бесплатно в течение месяца.

Стоимость и сроки

Стоимость настройки рассчитывается индивидуально в зависимости от сложности каталога и необходимости кастомных обработок. Срок — от 2 до 5 рабочих дней. Закажите предварительную оценку — мы проанализируем ваш обмен бесплатно. Свяжитесь с нами — получите консультацию по вашему проекту. Опыт наших инженеров позволяет устранить любые нестыковки в обмене, а экономия времени на ручном заполнении характеристик окупает работы уже за 2–3 месяца.