Робот «Свойство товара по ID товара или предложения» по ID товара или предложения в каталоге возвращает значение свойства и разделы. Для SKU при пустом значении: с основного товара. Без привязки к сделке или лиду.
Для кого и какую задачу решает
Администратору CRM, которому известен конкретный товар или вариация и нужно прочитать свойство вместе с разделами родительской модели.
Перебирать все товары сделки ради одного ID избыточно. Робот работает с переданным товаром и использует значение родителя, если у вариации оно пустое. Это подходит для единой характеристики модели с возможным переопределением в варианте.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID товара или торгового предложения (productId) |
Обязательное поле |
ID инфоблока каталога (idIblock) |
Необязательное поле |
Код или числовой идентификатор свойства (codeField) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- В productId передайте ID каталожного товара или вариации, полученный из строки товара или предыдущего поиска. Это не ID товарной строки CRM.
- Укажите каталог для настройки выбора и codeField: код либо числовой идентификатор нужного свойства.
- Проверьте успешный статус, затем valueField. Пустое значение вариации допускает подстановку того же свойства родителя.
- Используйте одиночные результаты раздела и верхнего раздела. productId и baseProductId помогают понять, какой товар был передан и где находится основная модель.
Учебный пример и ожидаемый результат
Для учебной вариации 701 с родителем 500 передайте productId=701. Если выбранное свойство у 701 пустое, а у 500 «Модель А», ожидается valueField=«Модель А», productId=701, baseProductId=500. Разделы относятся к 500. Для обычного товара без родителя оба ID совпадают.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Значение свойства» (
valueField). - «ID раздела основного товара» (
sectionId). - «Название раздела основного товара» (
sectionName). - «ID верхнего раздела в иерархии» (
topSectionId). - «Название верхнего раздела в иерархии» (
topSectionName). - «ID переданного товара» (
productId). - «ID основного товара» (
baseProductId).
В отличие от робота по карточке, результаты здесь одиночные. Пустое свойство и отсутствующий раздел возможны при успешном чтении. Перед обязательной подстановкой в документ проверяйте именно содержимое нужного результата, а не только статус.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Текст ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Положительный productId задаёт один товар или вариацию. Код свойства нормализуется, поддерживаются числовые ID. При пустом свойстве вариации читается родитель. Раздел и верхний раздел относятся к основному товару. Возвращаются одиночные значения и оба ID.
Робот не ищет товар по артикулу, не проверяет наличие на складе и не меняет каталог. Нельзя передавать ID элемента CRM в productId. Если требуется строго собственное свойство вариации без родительской подстановки, используйте действие свойства предложения по ID.