Налаштування вивантаження характеристик номенклатури з 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 із залишками.