Тип товара по ID товарной позиции

Что делает робот «Тип товара по ID товарной позиции»

В блоке «Товары» сделки или счёта строки выглядят одинаково, но за ними стоит разная номенклатура: простой товар, товар с торговыми предложениями или составной комплект. От этого зависит логика процесса: комплект нужно собрать на складе, у товара с вариациями уточнить размер или цвет, простой товар отгружается сразу. Робот по ID одной строки определяет тип и возвращает готовые признаки для ветвления.

Робот работает с товарной позицией любой сущности: сделки, лида, счёта, коммерческого предложения или смарт-процесса. Перебирать весь каталог не нужно — достаточно идентификатора строки.

Что возвращает робот

Главное — код типа: simple (простой), with_offers (с торговыми предложениями) или composite (составной комплект). Рядом с кодом робот отдаёт название типа по-русски и числовой тип из торгового каталога Битрикс24.

Для условий в бизнес-процессе есть готовые признаки «да/нет»:

• товар простой;
• товар с предложениями;
• товар составной;
• строка является конкретным торговым предложением (SKU).

Отдельно возвращаются ID и название товара в позиции, ID и название основного товара — для вариации это её родительская карточка, — а также ID и тип владельца позиции (сделка, лид и т.д.). Эти значения передают следующим роботам: получить свойства товара, остатки, разделы каталога.

Сценарии использования

Сборка комплекта. Сделка переходит в работу, процесс проверяет каждую позицию. Тип composite — на склад уходит задача на сборку комплекта с датой отгрузки. Простые товары этой проверки не касаются.

Уточнение вариации у клиента. Позиция — товар с предложениями, но конкретный вариант не выбран. Признак «является предложением» пустой, процесс ставит менеджеру задачу: уточнить у клиента размер и цвет до выставления счёта.

Разные пути согласования. Простые товары до 50 тысяч проходят без согласования, комплекты и вариации — через руководителя: у них сложнее логистика и выше риск ошибки. Робот даёт процессу признак для развилки.

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

Настройка робота

Параметр один — ID товарной позиции. Это идентификатор строки в блоке «Товары», а не ID товара из каталога. Обычно сюда подставляют значение из контекста: роботы работы с товарами возвращают ID позиций, и его передают дальше по цепочке.

Больше настраивать нечего: робот сам находит строку, определяет товар за ней и его тип в каталоге.

Результат и ошибки

При успехе робот возвращает статус «истина» и все описанные поля. Если позиция с таким ID не найдена — например, строку удалили из сделки между запусками — статус будет ложным, а в пояснении придёт причина. В процессе это стоит отлавливать, чтобы следующие роботы не работали с пустыми ID.

Типичные ошибки при настройке

Передан ID товара вместо ID позиции. Это разные идентификаторы: товар живёт в каталоге, позиция — строка в конкретной сделке. ID товара робот не примет. Если на руках только ID товара из каталога, используйте робота Свойство товара по ID.

Ожидание типа основного товара у вариации. Если в позиции стоит конкретное торговое предложение, робот вернёт тип with_offers и признак «является предложением». Тип родительской карточки при этом смотрят по ID основного товара из результата.

Позиция из скопированной сделки. При копировании сделки строки товаров получают новые ID. Если процесс хранит ID позиции в поле, после копирования сделки он указывает в никуда — переполучайте ID внутри того же запуска процесса.