Робот «Тип товара по ID товарной позиции» по ID строки товаров в CRM определяет тип: простой, с предложениями или составной. Подходит для сделки, лида, счёта, КП и смарт-процесса.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору товарного процесса, который выбирает дальнейшую ветку по типу товара конкретной строки CRM.
Простой товар, модель с предложениями, вариация и комплект требуют разной обработки. Робот читает одну позицию по её ID и возвращает признаки типа вместе с ID товара и родителя. Это позволяет не гадать по названию строки.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID товарной позиции (productRowId) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Передайте productRowId из итератора или предыдущего чтения строк. Это ID товарной позиции, а не ID товара каталога.
- Убедитесь, что строка доступна пользователю интеграции. Для связанного товара нужны права чтения каталога.
- После статуса выберите ветку по productTypeCode либо отдельным признакам isSimple/isWithOffers/isComposite. Признак isOffer проверяйте отдельно.
- Для свободной строки учитывайте productId=0: она успешно обозначается как простая без каталожного товара. text объяснит этот случай.
Учебный пример и ожидаемый результат
Учебная позиция 310 ссылается на вариацию 701 с родителем 500. Ожидаются productRowId=310, productId=701, baseProductId=500 и isOffer=true. Конкретный productTypeCode определяется типом основной записи каталога. Для свободной строки без товара ожидается simple, isSimple=true и productId=0.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Пояснение или текст ошибки» (
text). - «Код типа товара (simple/with_offers/composite)» (
productTypeCode). - «Название типа товара» (
productTypeName). - «Тип товара в каталоге Bitrix24 (число)» (
catalogTypeId). - «Строка: торговое предложение (SKU)» (
isOffer). - «Товар простой» (
isSimple). - «Товар с предложениями» (
isWithOffers). - «Товар составной (комплект)» (
isComposite). - «ID товара в позиции» (
productId). - «ID основного товара» (
baseProductId). - «Название товара в позиции» (
productName). - «Название основного товара» (
baseProductName). - «ID элемента CRM-владельца» (
ownerId). - «Тип владельца (D/L/Q и т.д.)» (
ownerType). - «ID товарной позиции» (
productRowId).
ownerId и ownerType показывают владельца строки CRM. productName и baseProductName помогают сверить выбранные записи. Числовой catalogTypeId отражает тип из каталога, а текстовый код удобен для пользовательских условий.
Проверяйте статус и объявленный выход text. Для дальнейшего чтения каталога также нужен ненулевой productId. Успешная классификация свободной строки не создаёт для неё товар каталога.
Ограничения и разбор ошибок
Входом служит положительный ID одной товарной позиции. Результаты simple/with_offers/composite и отдельный признак предложения помогают различить типы. Свободная строка без товара считается simple, productId/baseProductId равны 0. Ошибки возвращаются через text.
Свойства, остатки и состав комплектов этот робот не возвращает. text используется как пояснение или ошибка; отдельного error нет. Положительный статус для свободной строки не означает, что существует каталожный товар для дальнейшего складского действия.