Определение основного товара или предложения
Робот «Определение основного товара или предложения» помогает понять, является ли товар основной карточкой или предложением, чтобы дальше выбрать правильную логику обработки.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору товарных процессов, которому нужно понять, относится строка карточки к основному товару или к конкретному торговому предложению.
Для отчёта по моделям товара важен родитель, а для складского действия обычно нужна конкретная вариация. Робот возвращает оба уровня и признак предложения, чтобы последующие шаги использовали нужный ID без ручного поиска.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID элемента (entityId) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Добавьте робота в процесс нужного типа CRM. В ID элемента укажите карточку, чьи товарные строки нужно прочитать, а не ID одного товара.
- Убедитесь, что у пользователя интеграции есть доступ к карточке и связанному каталогу. Тип карточки определяется контекстом процесса.
- После выполнения получите параллельные списки ID товара, основного товара, признака предложения и типа base/offer. Соотносите значения по одной позиции списка.
- Для действия с вариацией используйте ID товара из строки; для группировки по модели используйте ID основного товара. Проверьте статус до использования списков.
Учебный пример и ожидаемый результат
Пусть учебная карточка содержит доступное предложение 701 с основным товаром 500. В соответствующей позиции ожидаются productId=701, baseProductId=500, признак предложения включён и тип offer. Для обычного товара 502 оба ID равны 502, признак предложения выключен и тип base.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «ID товара из позиции» (
productId), список значений. - «ID основного товара» (
baseProductId), список значений. - «Товар является предложением» (
isOffer), список значений. - «Тип товара (base/offer)» (
productType), список значений.
Выходы являются списками, даже если карточка содержит одну подходящую позицию. Строки без связанного товара и недоступные записи могут быть пропущены. Поэтому число результатов нельзя без дополнительной сверки считать количеством всех исходных товарных строк.
Проверяйте объявленный выход «Статус выполнения» перед использованием результатов. Отдельного объявленного поля ошибки нет. При отрицательном результате проверьте исходные параметры и доступ к данным; не создавайте подстановку на несуществующее пояснение.
Ограничения и разбор ошибок
Входом служит ID карточки соответствующего процессу типа CRM. Результаты представляют параллельные списки по прочитанным связанным товарам. Строки без ID товара и недоступные товары пропускаются. Для предложения возвращается ID родителя, для базового товара его собственный ID. Состав каталога и карточки не меняется.
Робот не меняет товар или его родителя и не объединяет вариации в одну запись. Он читает связь, существующую в каталоге. Не используйте ID элемента CRM вместо productId для последующих действий над товаром.