S-WEBS24

Битрикс24

CRM, процессы и приложения для вашей компании

CRM роботы 2.0 + AI (300+ роботов)

Свойство товара по ID

Робот «Свойство товара по ID товара или предложения» по ID товара или предложения в каталоге возвращает значение свойства и разделы. Для SKU при пустом значении: с основного товара. Без привязки к сделке или лиду.

Для кого и какую задачу решает

Администратору CRM, которому известен конкретный товар или вариация и нужно прочитать свойство вместе с разделами родительской модели.

Перебирать все товары сделки ради одного ID избыточно. Робот работает с переданным товаром и использует значение родителя, если у вариации оно пустое. Это подходит для единой характеристики модели с возможным переопределением в варианте.

Параметры и подготовка

Поле Как заполнить
ID товара или торгового предложения (productId) Обязательное поле
ID инфоблока каталога (idIblock) Необязательное поле
Код или числовой идентификатор свойства (codeField) Обязательное поле

Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.

Как использовать

  1. В productId передайте ID каталожного товара или вариации, полученный из строки товара или предыдущего поиска. Это не ID товарной строки CRM.
  2. Укажите каталог для настройки выбора и codeField: код либо числовой идентификатор нужного свойства.
  3. Проверьте успешный статус, затем valueField. Пустое значение вариации допускает подстановку того же свойства родителя.
  4. Используйте одиночные результаты раздела и верхнего раздела. 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.