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