Создание сделки с товарами

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

Автоматическое создание сделок на основе данных из лидов или других сущностей;
Создание сделок с предзаполненными товарными позициями;
Автоматизация процесса конвертации лида в сделку с товарами;
Создание сделок при интеграции с внешними системами (1С, интернет-магазины);
Массовое создание сделок с определёнными параметрами;
Создание сделок в определённом направлении (воронке);
Автоматическое назначение ответственного и привязка к контактам/компаниям.

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

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

Основные параметры:

Название поля	Описание и примеры использования
Название сделки	Название создаваемой сделки. Примеры: - `Сделка от {=System:Date}`; - `Заказ №{=Variable:ORDER_NUMBER}`; - `{=Document:TITLE}` - название из текущего документа.
Направление (воронка)	ID направления (воронки), в котором будет создана сделка. Примеры: - `0` - общая воронка (по умолчанию); - `1`, `2`, `3`... - ID конкретного направления; - `{=Variable:CATEGORY_ID}` - из переменной.
Стадия сделки	Символьный код стадии, на которой будет создана сделка. Примеры: - `NEW` - стадия "Новая"; - `C1:NEW` - стадия "Новая" в воронке 1; - `{=Variable:STAGE_ID}` - из переменной.
Ответственный	ID ответственного за сделку. Примеры: - `{=Document:ASSIGNED_BY_ID}` - ответственный из текущего документа; - `user_25` - конкретный пользователь; - `{=User:ID}` - текущий пользователь.
Контакт	ID контакта для привязки к сделке. Примеры: - `{=Document:CONTACT_ID}` - контакт из текущего документа; - `{=Variable:CONTACT_ID}` - из переменной; - `123` - конкретный ID.
Компания	ID компании для привязки к сделке. Примеры: - `{=Document:COMPANY_ID}` - компания из текущего документа; - `{=Variable:COMPANY_ID}` - из переменной; - `456` - конкретный ID.
Сумма	Сумма сделки (заполняется автоматически из товаров). Примеры: - `{=Variable:AMOUNT}`; - `100000`.
Валюта	Код валюты сделки. Примеры: - `RUB` - рубли; - `USD` - доллары; - `EUR` - евро.
Источник	Код источника сделки из справочника CRM. Примеры: - `WEB` - веб-сайт; - `CALL` - звонок; - `{=Document:SOURCE_ID}` - из документа.
Комментарий	Комментарий к сделке. Примеры: - `Создано автоматически {=System:Date}`; - `{=Document:COMMENTS}`.

Параметры товарных позиций:

Название поля	Описание и примеры использования
Товары (массив)	Массив товарных позиций для добавления в сделку. Каждый элемент содержит ID товара, количество, цену. Формат: `[{"PRODUCT_ID": 123, "QUANTITY": 2, "PRICE": 1000}]`
ID товара	ID товара из каталога Битрикс24. Примеры: - `{=Variable:PRODUCT_ID}`; - `123`.
Количество	Количество товара. Примеры: - `{=Variable:QUANTITY}`; - `1`.
Цена	Цена товара за единицу. Примеры: - `{=Variable:PRICE}`; - `1000`.
Скидка	Размер скидки на товар (в процентах или абсолютном значении).
Ставка НДС	Ставка налога для товара. Примеры: - `20` - 20% НДС; - `0` - без НДС.

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

№	Сценарий	Название	Направление	Ответственный
1	Создание из лида	`{=Document:TITLE}`	`0`	`{=Document:ASSIGNED_BY_ID}`
2	Создание в конкретной воронке	`Новая сделка`	`2`	`user_1`
3	Создание с привязкой к контакту	`Заказ клиента`	`0`	`{=User:ID}`
4	Создание с товарами	`Заказ №{=Variable:ORDER_NUM}`	`0`	`{=Variable:MANAGER_ID}`
5	Создание из интеграции	`Заказ из интернет-магазина`	`1`	`user_10`
6	Создание на определённой стадии	`Горячая сделка`	`0`	`{=Document:ASSIGNED_BY_ID}`
7	Создание с суммой	`Сделка на {=Variable:AMOUNT} руб.`	`0`	`{=User:ID}`
8	Создание с комментарием	`Сделка по рекомендации`	`0`	`{=Variable:RESPONSIBLE_ID}`
9	Создание с источником	`Входящий звонок`	`0`	`{=Document:ASSIGNED_BY_ID}`
10	Создание с UTM-метками	`Сделка из рекламы`	`0`	`user_5`

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

ID сделки (deal_id) - числовой идентификатор созданной сделки;
Успех операции (success) - Y при успехе, N при ошибке;
Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Важно:
- При создании сделки с товарами сумма рассчитывается автоматически;
- Для добавления товаров нужно указать ID товаров из каталога Битрикс24;
- Пользователь должен иметь права на создание сделок в указанном направлении;
- При указании стадии учитывайте направление (например, C1:NEW для воронки 1).

Рекомендации:
- Используйте переменные для динамического формирования названия сделки;
- При интеграции с внешними системами сохраняйте внешний ID в пользовательском поле для связи;
- Для массового создания сделок используйте итератор с паузами между операциями.

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

Создание сделки с товарами