Получение товара из сущности

Активити (робот) "Получение товара из сущности" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

Получение списка товарных позиций из сделки, лида, счёта или смарт-процесса;
Формирование таблицы товаров для отправки в письме или сообщении;
Анализ и обработка товаров в бизнес-процессе;
Перенос товаров между сущностями CRM;
Формирование отчётов по товарным позициям;
Проверка наличия товаров в сущности перед выполнением действий;
Получение ID товаров для дальнейшей обработки в итераторе.

Как работает активити (робот):
- Активити (робот) получает все товарные позиции из указанной сущности CRM;
- Результат можно вывести в виде таблицы (HTML или BBCode);
- Поддерживается настройка отображения количества, цены и суммы;
- Возвращается массив ID товаров для дальнейшей обработки в итераторе;
- Активити (робот) работает через REST API Битрикс24.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Тип Сущности	Обязательный параметр. Выбор типа сущности, товарные позиции которой будут получены. Поддерживаемые типы: Лид; Сделка; Счет; Ком. предложение; Смарт-процесс.
ID сущности	Обязательный параметр. ID сущности, из которой будут взяты товарные позиции. Примеры: - `{=Document:ID}` - ID текущей сущности из документа; - `123` - конкретный ID сущности; - `{=Variable:DEAL_ID}` - ID из переменной.
Тип Сущности (при выбранных смарт-процессах)	Этот параметр работает только если в поле "Тип сущности" выбрано "Смарт-процесс". Позволяет выбрать из списка конкретный смарт-процесс для получения товаров.
Способ вывода таблицы	Позволяет вывести результат в виде таблицы. Доступные способы: - `HTML` - для использования в письмах и документах; - `BBCode` - для использования в комментариях и сообщениях Битрикс24.
Включить количество в таблицу	Включение данных о количестве товара в выводимую таблицу. Варианты: да/нет.
Включить цену в таблицу	Включение данных о цене товара в выводимую таблицу. Варианты: да/нет.
Включить сумму в таблицу	Включение данных об общей сумме товара в выводимую таблицу. Варианты: да/нет.
Делать отладочные сообщения в журнал БП	Вывод отладочных данных в журнале бизнес-процесса. Варианты: да/нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для информирования пользователя в истории о том, что БП остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для определения, нужно ли ожидать реакции от активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Данная опция позволяет ограничить срок ожидания ответа. Технические особенности платформы Битрикс24 иногда создают ситуацию с большой очередью запросов. Для того чтобы не останавливать дальнейшие действия, можно установить своё время ожидания.

Примеры использования:

№	Сценарий	Тип сущности	ID сущности	Способ вывода
1	Получить товары из текущей сделки	Сделка	`{=Document:ID}`	HTML
2	Получить товары из лида	Лид	`{=Variable:LEAD_ID}`	HTML
3	Получить товары из счёта	Счет	`{=Variable:INVOICE_ID}`	BBCode
4	Получить товары из ком. предложения	Ком. предложение	`{=Variable:QUOTE_ID}`	HTML
5	Получить товары из смарт-процесса	Смарт-процесс	`{=Document:ID}`	HTML
6	Сформировать таблицу для письма	Сделка	`{=Document:ID}`	HTML (с ценой и суммой)
7	Получить ID для итератора	Сделка	`{=Document:ID}`	-
8	Таблица для комментария	Сделка	`{=Document:ID}`	BBCode
9	Проверка наличия товаров	Лид	`{=Document:ID}`	-
10	Анализ товаров в другой сделке	Сделка	`{=Variable:OTHER_DEAL_ID}`	HTML

Возвращаемые параметры для данного активити:

Товарные позиции (products_table) - таблица с товарами в выбранном формате (HTML или BBCode);
ID товаров (массив) (product_ids_array) - массив ID товаров для использования в итераторе;
Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Важно:
- Если в возвращаемых параметрах с названием "ID товаров (массив)" есть нули, то позиция не является товаром, а является текстовым описанием;
- Такое является следствием ручного ввода товара, а не выбором его из списка;
- Пользователь, от имени которого запускается активити, должен иметь права на просмотр товаров в указанной сущности.

Ваша корзина пуста

Получение товара из сущности