Выгрузка дополнительных реквизитов номенклатуры из 1С в 1С-Битрикс — это не просто копирование полей. Представьте: в 1С товар содержит 50 характеристик, а на сайте отображается лишь десяток. Или вместо значений приходят GUID, фильтр не работает, карточка товара пуста. Клиенты жалуются, конверсия падает. Если вы столкнулись с такой ситуацией, значит, настройка выгрузки дополнительных реквизитов из 1С выполнена некорректно — и пора это исправить. Например, справочник «Дополнительные сведения» в 1С:УТ 11 часто остаётся невыгруженным, а ссылочные реквизиты оборачиваются GUID. В результате на сайте теряются важные фильтры, страницы товаров выглядят неполно, а менеджеры тратят часы на ручное заполнение. Мы настраивали десятки интеграций и выработали методику, которая решает эти проблемы за 3–7 дней с экономией бюджета до $1.4k–1.9k в месяц.
Типы дополнительных реквизитов в 1С
В 1С:УТ 11 реквизиты живут в двух местах:
- Реквизиты объекта (
ДополнительныеРеквизиты) — прямо в элементе справочника. Выгружаются при каждом обмене. - Сведения объекта (
ДополнительныеСведения) — в отдельном регистре сведений. Требуют отдельного включения в настройках узла обмена.
Типы значений: Строка, Число, Дата, Булево, Ссылка на справочник и Строка с вариантами. Ссылочный тип — главная головная боль.
Как реквизиты передаются в CommerceML
В XML-файле реквизиты попадают внутрь <Товар>:
<ЗначенияРеквизитов> <ЗначениеРеквизита> <Наименование>Мощность</Наименование> <Значение>2500</Значение> </ЗначениеРеквизита> <ЗначениеРеквизита> <Наименование>ЕдиницаМощности</Наименование> <Значение>Вт</Значение> </ЗначениеРеквизита> <ЗначениеРеквизита> <Наименование>ГарантийныйСрок</Наименование> <Значение>24</Значение> </ЗначениеРеквизита> </ЗначенияРеквизитов> Битрикс при импорте создаёт свойства инфоблока с такими же наименованиями и заполняет значениями.
Сравнение типов реквизитов и представления в Битриксе
| Тип в 1С | Пример | Тип свойства инфоблока | Особенности |
|---|---|---|---|
| Строка | Мощность: 2500 | Строка | Переносится без изменений |
| Ссылка на справочник | Производитель: [GUID] | Строка (связь?) | Требует маппинга |
| Множественный | Применяемость: [A, B, C] | Строка (множественное) | Сбор значений в массив |
Проблема: автоматические коды свойств
При первом импорте Битрикс присваивает свойствам коды вида 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С: перед выгрузкой подменить GUID на наименование элемента справочника. Это правильнее — не нагружает Битрикс лишней логикой.
- На стороне Битрикс: вести таблицу маппинга «GUID → значение», формируемую из первичного обмена, и подставлять значение при записи свойства.
Подмена на стороне 1С не нагружает Битрикс, но требует доступа к конфигурации. Маппинг на стороне Битрикс быстрее в настройке (2–3 раза), но более рискован при обновлении справочников.
Что делать с множественными значениями?
Если в 1С реквизит допускает несколько значений, в XML они передаются повторяющимися тегами с одинаковым наименованием. Свойство в Битриксе должно быть «Множественным». Обработчик собирает все значения в массив:
$multiValues = []; foreach ($arXML['ADDITIONAL_REQUISITES'] as $req) { if ($req['NAME'] === 'Применяемость') { $multiValues[] = $req['VALUE']; } } $arProps['APPLICABILITY'] = $multiValues; Пошаговая инструкция настройки
- Экспорт тестового XML из 1С — убедитесь, что все типы реквизитов отражены.
- Анализ реквизитов — выявите ссылочные, множественные, строковые с вариантами.
- Выбор подхода — определите, где обрабатывать GUID: в 1С или Битрикс.
- Написание обработчика — доработка модуля обмена или создание обработчика событий.
- Тестирование на копии — проверьте корректность типов, фильтров, карточек.
- Деплой и обучение — перенос на прод, настройка инкрементального обмена.
Типичные ошибки при настройке
- Не включены сведения объекта в настройках узла обмена 1С. - Свойство инфоблока не помечено как множественное для реквизитов с повторяющимися значениями. - Отсутствует обработка GUID для ссылочных реквизитов. - Коды свойств не переименованы после первого импорта. - Инкрементальный обмен не настроен — изменения не подтягиваются автоматически.Кейс: промышленный каталог с 60+ атрибутами
Из нашей практики: завод насосного оборудования. Каждое изделие описывается 60–80 параметрами (рабочее давление, температурный диапазон, материал корпуса, класс защиты). В 1С — дополнительные реквизиты. При первом импорте Битрикс создал 78 свойств с нечитаемыми кодами. Мы потратили день на переименование кодов и настройку типов: числовые — как «Число», с единицами измерения; строковые — как «Список» для фильтра.
После настройки компонент умного фильтра Битрикс автоматически предлагает фильтрацию по давлению, температуре и материалу — без дополнительной разработки. Инкрементальное обновление атрибутов (при изменении значений в 1С) — 4 минуты на весь каталог из 2300 позиций. Экономия времени на ручном сопровождении — до 20 часов в месяц, что при средней ставке оператора даёт существенную экономию бюджета.
Что входит в работу
- Анализ — выгрузка тестового XML, выявление всех типов реквизитов, ссылок.
- Проектирование — выбор схемы обработки (на стороне 1С или Битрикс), настройка множественных свойств.
- Реализация — доработка модуля обмена / написание обработчиков, переименование кодов.
- Тестирование — проверка на копии каталога, сравнение с 1С, проверка фильтра и карточки.
- Деплой — перенос настроек на прод, обучение операторов.
Сроки: от 3 до 7 рабочих дней в зависимости от числа реквизитов и сложности ссылочных полей. Стоимость рассчитывается индивидуально — запросите оценку у наших инженеров.
Наш опыт и гарантии
- 8+ лет опыта с интеграцией 1С и Битрикс.
- Более 120 выполненных проектов по обмену данными.
- Предоставляем документацию по настройкам и гарантию на работы.
Хотите так же? Получите консультацию по вашему проекту — мы разберём конфигурацию и предложим решение. Свяжитесь с нами — начнём с анализа вашей конфигурации.
Согласно CommerceML, структура XML должна содержать все необходимые реквизиты для корректной передачи данных.