Настройка выгрузки характеристик номенклатуры из 1С:УТ в 1С-Битрикс

Настройка выгрузки характеристик номенклатуры из 1С:УТ в 1С-Битрикс

Характеристики номенклатуры в УТ — это механизм учёта разновидностей одного товара. Футболка в трёх цветах и пяти размерах — это одна позиция номенклатуры с 15 характеристиками (3×5). В Битрикс это торговые предложения (SKU). Корректная передача этой структуры — одна из самых технически требовательных задач при интеграции.

Характеристики в УТ: внутреннее устройство

В 1С:УТ 11 характеристики хранятся в справочнике ХарактеристикиНоменклатуры. Каждая характеристика — это набор значений свойств: цвет = «Синий», размер = «M», материал = «Хлопок». Характеристика имеет собственный GUID, который используется при идентификации в Битрикс.

Регистр ЦеныНоменклатуры и регистр ТоварыНаСкладах ведут учёт в разрезе характеристик. Это означает: у разных характеристик одной номенклатуры могут быть разные цены и разные остатки.

Как характеристики попадают в XML

При выгрузке характеристики передаются двумя способами:

Способ 1: Через классификатор — в секции Классификатор → ХарактеристикиТоваров описываются возможные свойства (Цвет, Размер) и их значения. Это «схема». Затем в Каталог → Товар → ХарактеристикиТовара каждая характеристика ссылается на значения из классификатора.

Способ 2: Inline — значения характеристик передаются прямо внутри <Предложение>, без отдельного классификатора. Этот способ проще для парсинга, но теряет связи между значениями.

Битрикс поддерживает оба способа. Стандартный обмен УТ использует способ 1.

Маппинг: характеристики УТ → SKU Битрикс

После импорта структура в Битрикс выглядит так:

• Инфоблок товаров (например, ID=5) — головные элементы (футболки)
• Инфоблок предложений (связан с IB товаров) — SKU (конкретные характеристики)

Каждое торговое предложение (SKU) в Битрикс соответствует одной характеристике в УТ. XML_ID предложения = {GUID товара}#{GUID характеристики}.

XML_ID товара:     a1b2c3d4-...
XML_ID характ.:    e5f6g7h8-...
XML_ID предложения: a1b2c3d4-...#e5f6g7h8-...

Эта пара GUID — ключ идентификации. При обновлении цены или остатка характеристики в УТ — Битрикс находит нужное предложение именно по этому ключу.

Типичные проблемы при импорте характеристик

Дубли торговых предложений. Если GUID характеристики в УТ изменился (пересоздание базы, слияние баз) — Битрикс создаст новое предложение вместо обновления существующего. Старое предложение останется как «мёртвое». Нужно периодически чистить b_iblock_element от элементов инфоблока предложений без привязки к актуальным GUID.

Потеря значений свойств. Если значение свойства в УТ — не текст, а ссылка на элемент справочника (например, цвет из справочника «Цвета» с GUID), Битрикс получает GUID, а не название. В шаблоне отобразится «{8f3a...}» вместо «Синий». Нужен обработчик, который при импорте подставляет строковое значение.

Зависимые характеристики. В УТ нет встроенного механизма зависимых характеристик (если размер = XL, то доступные цвета = только Синий и Чёрный). В Битрикс это реализуется через JavaScript на фронтенде или через таблицу совместимости значений. При импорте нужно либо создавать все возможные комбинации как SKU (включая нереальные), либо передавать матрицу доступных комбинаций отдельным механизмом.

Большое количество характеристик: оптимизация

Номенклатура с многими характеристиками — например, 500 товаров по 100 характеристик каждый = 50 000 SKU — создаёт нагрузку при импорте.

Рекомендации:

• Включить SITE_CHARSET = utf-8 в настройках Битрикс (кириллица в GUID не создаёт проблем)
• При первом импорте отключить полнотекстовую индексацию (CSearch::Index не вызывается при SKIP_REINDEX = Y в опциях агента)
• После первого импорта — запустить переиндексацию вручную
• Пакетное обновление цен/остатков SKU через CCatalogProduct::Update в транзакции, а не по одному

Кейс: одежда с матрицей размер×цвет

Бренд одежды: 800 моделей, каждая в 5–8 цветах и 6 размерах = до 2400 SKU на группу. Всего около 180 тыс. SKU в Битрикс.

Первый полный импорт с характеристиками: 3 часа 40 минут. После оптимизации (отключение индексирования во время импорта, пакетное создание SKU, zip-архивирование XML): 55 минут.

Инкрементальный обмен (только изменившиеся SKU): 3–8 минут каждые 30 минут.

Отдельная задача: в шаблоне каталога при выборе цвета — автоматически скрывать недоступные размеры (нет остатка). Реализовано через JS-матрицу, которую Битрикс генерирует из таблицы SKU с остатками.