Свойство товара по ID
Когда выручает робот «Свойство товара по ID»
В бизнес-процессе уже известен идентификатор карточки из торгового каталога — его вернул предыдущий робот, он лежит в поле сделки или пришёл из внешней системы. Робот берёт этот ID, читает с карточки значение выбранного свойства и возвращает его вместе с разделами каталога. Указывать сделку, лид или смарт-процесс не нужно: робот работает напрямую с каталогом товаров.
Один шаг — одна карточка — один результат. Если нужно обойти все товарные позиции элемента CRM, используйте робота «Значение свойства товара и разделы каталога», который возвращает списки значений по каждой позиции.
Что робот возвращает
| Поле | Что внутри |
|---|---|
| Значение свойства | Строка со значением; пустая, если свойство не заполнено ни на карточке, ни на основном товаре |
| ID и название раздела | Ближайший раздел каталога, где лежит основной товар |
| ID и название верхнего раздела | Корневой раздел ветки — удобен для грубой маршрутизации |
| ID переданного товара | Тот идентификатор, с которым робот вызван |
| ID основного товара | Для SKU — идентификатор родительской карточки |
| Статус и текст ошибки | Результат выполнения и причина сбоя, если она была |
Настройка
Полей три, обязательных два:
- ID товара или предложения — числовой идентификатор карточки в каталоге. Обычно подставляется из переменных: результат прошлого робота, поле элемента, значение из товарной позиции;
- Свойство товара (codeField) — выбирается из выпадающего списка, код руками вводить не требуется. Под капотом уходит числовой ID или символьный код свойства без префикса PROPERTY_;
- ID инфоблока — необязательный параметр. Он нужен только форме настройки, чтобы подгрузить список свойств выбранного каталога. На выполнение робота он не влияет: читать значение робот будет по коду свойства в любом случае.
Товар и торговое предложение: откуда берётся значение
Робот сначала смотрит свойство на той карточке, чей ID получил. Если это торговое предложение и свойство на нём пустое, значение подтягивается с основного товара. Так устроены вариации: общие характеристики вроде бренда и страны производства хранятся на родителе, а на вариантах — только отличия вроде размера и цвета.
Разделы каталога всегда определяются по основному товару, даже если передан ID предложения. Заодно робот возвращает ID основного товара — его можно передать дальше по цепочке, например в робота «Свойство предложения по ID товара и разделы основного».
Сценарии из практики
Приёмка каталога после выгрузки из 1С. Обмен загрузил новые товары, но часть карточек без веса. Процесс пробегает по списку ID новинок, робот читает «Вес» с каждой карточки. Пустое значение — карточка попадает в задачу контент-менеджеру. Каталог не расползается молча.
Выбор тарифа доставки. Из товарной позиции сделки процесс достаёт ID товара, робот читает свойства «Вес» и «Объём». Дальше условие: до 5 кг — СДЭК, до 20 кг — Деловые Линии, больше — заявка логисту. Менеджер не считает варианты руками по каждой позиции.
Гарантийное уведомление клиенту. Сделка перешла в стадию «Отгружено». Робот по ID товара читает «Гарантийный срок», и клиенту уходит письмо с условиями гарантии на его оборудование, а не общий текст на всякий случай.
Типичные ошибки
«Укажите корректный ID товара (productId > 0)». В параметр пришёл ноль или пустая строка — чаще всего переменная не подставилась. Проверьте, что робот-источник ID действительно отработал и вернул число до этого шага.
«Товар каталога ID=… не найден». Карточку удалили, либо передан ID не из каталога: например, ID товарной позиции сделки или предложения из другого инфоблока. Убедитесь, что число — именно идентификатор элемента товарного каталога.
«codeField is required». Свойство не выбрано. Обычно это значит, что список свойств в форме пуст: смените ID инфоблока на каталог, где лежат ваши товары, и выберите свойство заново.
Пустое значение свойства. Это не сбой, а штатный результат: свойство не заполнено ни на карточке, ни на основном товаре. Ставьте после робота условие на пустоту и заводите ветку заполнения карточки, иначе пустая строка молча уедет в документы и письма.