Редактирование количества и перенос товара между сущностями

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

Изменение количества товара в сделке, лиде, счёте, ком. предложении или смарт-процессе;
Прибавление или вычитание количества от существующих товарных позиций;
Добавление товаров из каталога в выбранную CRM сущность;
Удаление товаров из сущности;
Перенос товаров между разными сущностями (например, из лида в сделку);
Удаление дублирующихся товарных позиций в целевой сущности;
Копирование товаров из текущей сущности в целевую с изменением количества;
Корректировка остатков товаров в смарт-процессах;
Синхронизация товарных позиций между сделкой и счётом;
Автоматизация учёта товаров при конвертации лида в сделку.

Сценарий работы активити (робота) бизнес-процесса

Как работает активити (робот):
- Активити (робот) выполняет операции с товарными позициями: добавить, удалить, вычесть количество, прибавить количество, удалить совпадения;
- Поддерживаются сущности: Лид, Сделка, Счёт, Ком. предложение, Смарт-процессы;
- При включённой опции "Взять товары из текущей сущности" операции выполняются между текущей сущностью (где запущен БП) и целевой сущностью;
- Формат товаров: ID или ID##количество##цена##название;
- Активити (робот) работает через REST API Битрикс24.

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

Название поля	Описание и примеры использования
Операция	Обязательный параметр. Тип выполняемой операции. Доступные операции: - Добавить товар — добавление товара из каталога в сущность; - Удалить товар — удаление указанных товаров из сущности; - Вычесть количество — уменьшение количества существующего товара; - Прибавить количество — увеличение количества существующего товара; - Удалить совпадения — удаление из целевой сущности товаров, которые есть в текущей сущности.
Тип сущности	Обязательный параметр. Тип целевой сущности CRM. Поддерживаемые типы: Лид, Сделка, Счёт, Ком. предложение, Смарт-процесс (с выбором конкретного процесса). Примеры: для сделки выбирается "Сделка", для смарт-процесса "Расчёт и смета" выбирается соответствующий пункт из списка.
ID элемента сущности	Обязательный параметр. ID целевой сущности, с товарами которой выполняется операция. Примеры: - `{=Document:ID}` — ID текущей сущности из документа; - `55` — конкретный ID сущности; - `{=Variable:DEAL_ID}` — ID из переменной.
Взять товары из текущей сущности	При значении "Да" товары берутся из сущности, в которой запущен бизнес-процесс, и операции выполняются с целевой сущностью. При "Нет" работа идёт только с целевой сущностью и списком товаров. Пример: БП запущен в смарт-процессе №55, целевая сущность — Счёт №100. При "Да" товары из смарт-процесса 55 переносятся/вычитаются в счёте 100.
Товары	Список товаров. Формат: ID товара или ID##количество##цена##название. Примеры: - `30047` — только ID товара (для удаления или при количестве 1); - `30047##5` — товар 30047, количество 5; - `30047##2##1500##Услуга` — ID 30047, количество 2, цена 1500. Название "Услуга" не переименовывает товар в каталоге, а задаёт текст отображаемый в целевой сущности (в товарной позиции); - `{=Variable:PRODUCTS_LIST}` — список из переменной. При использовании переменной необходимо самостоятельно в рамках бизнес-процесса собрать все ID товаров, количества, цены и названия в переменную (множественное значение), а затем передать её в активити (робот). Несколько товаров: поле является массивом — каждый товар указывается отдельной строкой в списке значений. Для операций "Вычесть" и "Прибавить" количество в формате ID##N определяет, на сколько изменить.

Примеры использования активити (робота)

Описание	Решение
Добавить товар 30047 в текущую сделку, количество 3	Операция: Добавить товар. Тип сущности: Сделка. ID: `{=Document:ID}`. Товары: 30047##3
Вычесть 2 шт товара 30047 из текущего лида	Операция: Вычесть количество. Тип сущности: Лид. ID: `{=Document:ID}`. Товары: 30047##2
Прибавить 5 шт к товару 30047 в счёте	Операция: Прибавить количество. Тип сущности: Счёт. ID: `{=Variable:INVOICE_ID}`. Товары: 30047##5
Удалить товар 30047 из сделки	Операция: Удалить товар. Тип сущности: Сделка. ID: `{=Variable:DEAL_ID}`. Товары: 30047
Перенести товары из текущего смарт-процесса в сделку (прибавить)	Операция: Прибавить количество. Тип сущности: Сделка. ID: `{=Variable:TARGET_DEAL_ID}`. Взять товары из текущей сущности: Да
Удалить из целевой сущности товары, которые есть в текущей	Операция: Удалить совпадения. Тип сущности и ID целевой сущности. Взять товары из текущей сущности: Да
Вычесть 1 шт из товара в текущем смарт-процессе	Операция: Вычесть количество. Тип сущности: Смарт-процесс (текущий). ID: `{=Document:ID}`. Товары: 30047##1. Взять из текущей: Да
Добавить несколько товаров в ком. предложение	Операция: Добавить товар. Тип: Ком. предложение. ID: `{=Variable:QUOTE_ID}`. Товары — два отдельных элемента: 30047##2 и 30048##1##2000 (каждый товар в своей строке)
Скопировать товары из лида в сделку при конвертации	Операция: Прибавить количество. Тип: Сделка. ID: `{=Variable:NEW_DEAL_ID}`. Взять из текущей: Да (БП в лиде)
Корректировка остатка в смарт-процессе "Расчёт и смета"	Операция: Вычесть количество. Тип: Смарт-процесс (Расчёт и смета). ID: `{=Document:ID}`. Товары: 30047##1

Возвращаемые параметры данного активити:
- Результат выполнения;
- Текст ошибки.

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

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

Редактирование количества и перенос товара между сущностями