Настройка выгрузки дополнительных реквизитов из 1С в Битрикс

Выгрузка дополнительных реквизитов номенклатуры из 1С в 1С-Битрикс — это не просто копирование полей. Представьте: в 1С товар содержит 50 характеристик, а на сайте отображается лишь десяток. Или вместо значений приходят GUID, фильтр не работает, карточка товара пуста. Клиенты жалуются, конверсия падает. Если вы столкнулись с такой ситуацией, значит, настройка выгрузки дополнительных реквизитов из 1С выполнена некорректно — и пора это исправить. Например, справочник «Дополнительные сведения» в 1С:УТ 11 часто остаётся невыгруженным, а ссылочные реквизиты оборачиваются GUID. В результате на сайте теряются важные фильтры, страницы товаров выглядят неполно, а менеджеры тратят часы на ручное заполнение. Мы настраивали десятки интеграций и выработали методику, которая решает эти проблемы за 3–7 дней с экономией бюджета до 150 000 рублей в месяц.

Типы дополнительных реквизитов в 1С

В 1С:УТ 11 реквизиты живут в двух местах:

• Реквизиты объекта (ДополнительныеРеквизиты) — прямо в элементе справочника. Выгружаются при каждом обмене.
• Сведения объекта (ДополнительныеСведения) — в отдельном регистре сведений. Требуют отдельного включения в настройках узла обмена.

Типы значений: Строка, Число, Дата, Булево, Ссылка на справочник и Строка с вариантами. Ссылочный тип — главная головная боль.

Как реквизиты передаются в CommerceML

В XML-файле реквизиты попадают внутрь <Товар>:

<ЗначенияРеквизитов>
  <ЗначениеРеквизита>
    <Наименование>Мощность</Наименование>
    <Значение>2500</Значение>
  </ЗначениеРеквизита>
  <ЗначениеРеквизита>
    <Наименование>ЕдиницаМощности</Наименование>
    <Значение>Вт</Значение>
  </ЗначениеРеквизита>
  <ЗначениеРеквизита>
    <Наименование>ГарантийныйСрок</Наименование>
    <Значение>24</Значение>
  </ЗначениеРеквизита>
</ЗначенияРеквизитов>

Битрикс при импорте создаёт свойства инфоблока с такими же наименованиями и заполняет значениями.

Сравнение типов реквизитов и представления в Битриксе

Проблема: автоматические коды свойств

При первом импорте Битрикс присваивает свойствам коды вида CML2_ATTR_001, CML2_ATTR_002. Работать с ними в шаблонах — мучение. Решение: перед боевым импортом провести тестовый на копии, затем вручную переименовать коды в читаемые (POWER_WATT, WARRANTY_MONTHS). Последующие импорты не поменяют их, так как Битрикс ищет совпадение по наименованию.

Или — написать обработчик на OnIBlockPropertyAdd:

AddEventHandler('iblock', 'OnIBlockPropertyAdd',
    'setReadablePropertyCode');

function setReadablePropertyCode(&$arFields) {
    if (empty($arFields['CODE'])) {
        $arFields['CODE'] = CUtil::translit(
            $arFields['NAME'],
            'ru',
            ['change_case' => 'U', 'replace_space' => '_']
        );
    }
}

Как решить проблему с GUID? Два подхода

Ссылочные реквизиты в XML приходят как GUID:

<ЗначениеРеквизита>
  <Наименование>Производитель</Наименование>
  <Значение>f3a2b1c0-1234-5678-abcd-ef0123456789</Значение>
</ЗначениеРеквизита>

На сайте в карточке — кракозябра. Варианты:

1. На стороне 1С: перед выгрузкой подменить GUID на наименование элемента справочника. Это правильнее — не нагружает Битрикс лишней логикой.
2. На стороне Битрикс: вести таблицу маппинга «GUID → значение», формируемую из первичного обмена, и подставлять значение при записи свойства.

Подмена на стороне 1С не нагружает Битрикс, но требует доступа к конфигурации. Маппинг на стороне Битрикс быстрее в настройке (2–3 раза), но более рискован при обновлении справочников.

Что делать с множественными значениями?

Если в 1С реквизит допускает несколько значений, в XML они передаются повторяющимися тегами с одинаковым наименованием. Свойство в Битриксе должно быть «Множественным». Обработчик собирает все значения в массив:

$multiValues = [];
foreach ($arXML['ADDITIONAL_REQUISITES'] as $req) {
    if ($req['NAME'] === 'Применяемость') {
        $multiValues[] = $req['VALUE'];
    }
}
$arProps['APPLICABILITY'] = $multiValues;

Пошаговая инструкция настройки

1. Экспорт тестового XML из 1С — убедитесь, что все типы реквизитов отражены.
2. Анализ реквизитов — выявите ссылочные, множественные, строковые с вариантами.
3. Выбор подхода — определите, где обрабатывать GUID: в 1С или Битрикс.
4. Написание обработчика — доработка модуля обмена или создание обработчика событий.
5. Тестирование на копии — проверьте корректность типов, фильтров, карточек.
6. Деплой и обучение — перенос на прод, настройка инкрементального обмена.

Кейс: промышленный каталог с 60+ атрибутами

Из нашей практики: завод насосного оборудования. Каждое изделие описывается 60–80 параметрами (рабочее давление, температурный диапазон, материал корпуса, класс защиты). В 1С — дополнительные реквизиты. При первом импорте Битрикс создал 78 свойств с нечитаемыми кодами. Мы потратили день на переименование кодов и настройку типов: числовые — как «Число», с единицами измерения; строковые — как «Список» для фильтра.

После настройки компонент умного фильтра Битрикс автоматически предлагает фильтрацию по давлению, температуре и материалу — без дополнительной разработки. Инкрементальное обновление атрибутов (при изменении значений в 1С) — 4 минуты на весь каталог из 2300 позиций. Экономия времени на ручном сопровождении — до 20 часов в месяц, что при средней ставке оператора даёт существенную экономию бюджета.

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

• Анализ — выгрузка тестового XML, выявление всех типов реквизитов, ссылок.
• Проектирование — выбор схемы обработки (на стороне 1С или Битрикс), настройка множественных свойств.
• Реализация — доработка модуля обмена / написание обработчиков, переименование кодов.
• Тестирование — проверка на копии каталога, сравнение с 1С, проверка фильтра и карточки.
• Деплой — перенос настроек на прод, обучение операторов.

Сроки: от 3 до 7 рабочих дней в зависимости от числа реквизитов и сложности ссылочных полей. Стоимость рассчитывается индивидуально — запросите оценку у наших инженеров.

Наш опыт и гарантии

• 8+ лет опыта с интеграцией 1С и Битрикс.
• Более 120 выполненных проектов по обмену данными.
• Предоставляем документацию по настройкам и гарантию на работы.

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

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