Роботека
Роботека · Роботы · Получить товары сделки

Получить товары сделки

Робот «Получить товары сделки» передаёт в бизнес-процесс Битрикс24 товарные позиции сделки: ID и названия товаров, количество, цены, готовый список текстом и итоговую сумму с валютой.

Робот читает товарную часть сделки и отдаёт её следующим шагам процесса. Штатные роботы товары сделки не видят: нельзя вставить список товаров в комментарий или задачу, проверить, есть ли в сделке нужный товар, или посчитать сумму по позициям. Робот возвращает ID товаров, их названия, количество и цену за единицу по каждой позиции отдельными списками, готовый текст вида «Название × количество = сумма» построчно, итоговую сумму и валюту сделки. Цена берётся уже со скидкой и налогом, итог — сумма «цена × количество» по всем позициям, то есть то, что платит клиент. По умолчанию берётся сделка, на которой запущен процесс; любую другую можно указать по ID. Работает и в элементах смарт-процессов с товарами. Если товаров нет, робот возвращает «Товары есть = Нет».

Какие параметры принимает робот?

Параметр Тип Обязательный? По умолчанию
Сделка select Текущая сделка, Сделка по ID — current
ID сделки (для режима «Сделка по ID») string —

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

Параметр Тип
Товары есть bool
Количество позиций int
ID товаров int
Названия товаров string
Количество по позициям double
Цены за единицу (со скидкой и налогом) double
Список товаров текстом text
Итоговая сумма double
Валюта string
Успешно bool
Ошибка string

Какие ошибки может вернуть робот?

Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.

  • Не удалось определить сделку. В режиме «Сделка по ID» укажите корректный ID; текущий элемент должен быть сделкой или элементом смарт-процесса.
  • Ошибка API при чтении товаров сделки.

Сценарий: отправить клиенту состав заказа

  1. Робот ставится на стадию «Счёт выставлен»
  2. Он возвращает список товаров текстом и итоговую сумму сделки
  3. Следующий робот отправляет клиенту письмо с этим списком и суммой к оплате

Похожие роботы