Робот «Каталог товара из сделки/лида/смарт-процесса» помогает определить, к какому каталогу относится товар из карточки, и получить связанный основной товар, если используется вариация.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору CRM, который получает каталог и основной товар из одной выбранной товарной позиции карточки.
Вариация и родитель могут относиться к разным каталогам. Для дальнейшего выбора свойств часто нужен каталог основной модели, а для заказа конкретный ID вариации. Робот возвращает эти сведения раздельно.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID сущности (сделка/лид/смарт-процесс) (entityId) |
Необязательное поле |
Индекс товарной позиции (productIndex) |
Необязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Укажите entityId карточки соответствующего процессу типа. При пустом значении используется текущий элемент процесса.
- Задайте productIndex с нуля: 0 означает первую строку по возрастанию ID товарной позиции. Отрицательный индекс недопустим.
- После статуса проверьте catalogId, productId и baseProductId. Для вариации каталог относится к основному товару.
- Если карточка пуста или индекс вне диапазона, используйте text для обработки причины. Не продолжайте с нулевым ID каталога как с настоящим каталогом.
Учебный пример и ожидаемый результат
В учебной карточке первая строка содержит вариацию 701 с родителем 500 в каталоге 15. При productIndex=0 ожидаются productId=701, baseProductId=500, catalogId=15 и включённый isVariation. При обычном товаре оба ID совпадут, признак вариации выключен. Индекс 1 выберет вторую строку, если она существует.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Текст ошибки» (
text). - «Товар является вариацией» (
isVariation). - «ID каталога» (
catalogId). - «ID выбранного товара» (
productId). - «Название выбранного товара» (
productName). - «ID основного товара» (
baseProductId). - «Название основного товара» (
baseProductName).
Названия переданного и основного товара возвращаются отдельно. text содержит пояснение ошибки, поэтому условие должно использовать этот результат, а не несуществующее поле error. Успешное получение товара не создаёт связь с другим каталогом.
Проверьте «Статус выполнения». Для причины отрицательного результата используйте объявленный выход text («Текст ошибки»). Поле error в результатах этого робота не предусмотрено.
Ограничения и разбор ошибок
productIndex отсчитывается от нуля, по умолчанию 0; строки отсортированы по ID по возрастанию. Для вариации catalogId берётся у родителя. Пустая карточка и отсутствующий индекс дают отрицательный статус и text. Данные не меняются.
Порядок задаётся ID строк, а не визуальной сортировкой менеджера. Изменение состава карточки может сместить индекс. Для устойчивой обработки одной конкретной строки используйте её ID и робот определения типа товара по позиции.