Найти сделки с товаром
Робот «Найти сделки с товаром» находит в Битрикс24 сделки, в товарах которых есть нужный товар, с фильтром по контакту, компании и открытым сделкам, и возвращает их ID, количество и ID самой новой.
Робот ищет сделки по товару из каталога. Штатными средствами в бизнес-процессе нельзя узнать, в каких сделках продаётся конкретный товар: фильтр списка сделок по товарам роботам недоступен. Робот принимает ID товара и по желанию ID контакта, ID компании и признак «только открытые сделки» (не в финальной стадии), просматривает подходящие сделки от новых к старым и возвращает список ID тех, где товар есть в товарной части, их количество и ID самой новой. Число сделок в ответе ограничивается настройкой (по умолчанию 50), а просмотр — последними 500 сделками по фильтру, поэтому робот не перегружает портал. Если сделок нет, количество равно нулю и процесс может выбрать другую ветку.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| ID товара | int | да | |
| ID контакта (необязательно) | string | — | |
| ID компании (необязательно) | string | — | |
| Только открытые сделки | bool | — | N |
| Сколько сделок вернуть (по умолчанию 50; просматриваются последние 500 сделок по фильтру) | int | — | 50 |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| ID найденных сделок | int |
| Количество найденных сделок | int |
| ID первой (самой новой) сделки | int |
| Успешно | bool |
| Ошибка | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Укажите ID товара.
- Ошибка API при поиске сделок.
Сценарий: предупредить менеджеров об отзыве товара
- Процесс запускается вручную с ID товара
- Робот возвращает ID открытых сделок, где есть этот товар
- Цикл по списку ставит задачу ответственному каждой сделки