Изменение Сделки

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

Автоматическое обновление полей сделки на основе данных из других систем или документов;
Массовое изменение сделок (стадия, ответственный, сумма, вероятность) по определённым условиям;
Автоматизация перехода сделок между стадиями в зависимости от событий;
Обновление данных сделки после выполнения определённых действий (подписание договора, оплата и т.д.);
Синхронизация данных сделки с внешними системами;
Автоматическое назначение ответственного в зависимости от суммы, типа или других параметров;
Расчёт и применение НДС и скидок к товарам сделки;
Прикрепление файлов к сделке из других сущностей CRM.

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

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

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

Название поля Описание и примеры использования

Название поля	Описание и примеры использования
ID Сделки (o_deal_id)	Обязательное поле. В данном поле необходимо указать числовой идентификатор (ID) сделки, которую необходимо изменить. Примеры: - `123` - изменить сделку с ID 123; - `{=Document:ID}` - изменить текущую сделку из документа; - `{=A1988_22222_92566_99999:search_results}` - изменить сделку из результата предыдущего активити; - `{=Iterator:Value}` - изменить сделку для каждого элемента в итераторе. Важно: Если ID сделки указан в формате [123] (в квадратных скобках), активити автоматически извлечёт числовое значение.

ID Сделки (o_deal_id)

Обязательное поле. В данном поле необходимо указать числовой идентификатор (ID) сделки, которую необходимо изменить.

Примеры:
- 123 - изменить сделку с ID 123;
- {=Document:ID} - изменить текущую сделку из документа;
- {=A1988_22222_92566_99999:search_results} - изменить сделку из результата предыдущего активити;
- {=Iterator:Value} - изменить сделку для каждого элемента в итераторе.

Важно: Если ID сделки указан в формате [123] (в квадратных скобках), активити автоматически извлечёт числовое значение.

Параметры для работы с полями сделки:

Название поля	Описание и примеры использования
Название (TITLE)	В данном поле можно указать новое значение названия сделки. Примеры: - `Договор поставки №123`; - `={Договор {={=Document:ID}}}`; - Для очистки поля передайте пробел: `={ }`
Тип (TYPE_ID)	В данном поле можно изменить тип сделки. Значения берутся из справочника CRM. Примеры: - `SALE` - тип "Продажа"; - `COMPLEX` - тип "Комплексная сделка". Символьный код типа можно найти в CRM - Настройки - Типы сделок или использовать специальное активити.
Стадия сделки (STAGE_ID)	В данном поле можно изменить стадию сделки. Примеры: - `NEW` - стадия "Новая"; - `QUALIFICATION` - стадия "Квалификация". Как узнать символьный код стадии: 1. Добавьте штатное активити "Изменение документа"; 2. Выберите поле "стадия"; 3. Нажмите F12 и выберите инструмент "выбор элемента страницы"; 4. Найдите нужную стадию в списке. ВАЖНО! НЕЛЬЗЯ изменить одновременно направление и стадию сделки. Делайте это поочерёдно в отдельных активити.
Направление (CATEGORY_ID)	ВАЖНО! Активити (робот) не может изменить направление сделки, т.к механизм REST API Б24 не позволяет это делать напрямую. Используйте штатное активити "Смена направления сделки" или "Изменение документа".
Вероятность (PROBABILITY)	В данном поле можно изменить вероятность заключения сделки (от 0 до 100). Примеры: - `={50}` - установить вероятность 50%; - `={{=min({=Variable:PROBABILITY} + 50, 100)}}` - увеличить вероятность на 50; - `={0}` - сбросить вероятность.
Сумма (OPPORTUNITY)	В данном поле можно изменить предполагаемую сумму. Поле заполняется автоматически из товарного раздела. Примеры: - `={100000}` - установить сумму 100 000; - `={{={=Variable:OPPORTUNITY} * 1.1}}` - увеличить сумму на 10%; - Для очистки: `={"##"}` Важно: Изменение суммы вручную может конфликтовать с автоматическим расчётом из товаров.
Валюта (CURRENCY_ID)	В данном поле можно изменить валюту расчётов. Примеры: - `RUB` - рубли; - `USD` - доллары США; - `EUR` - евро.
Ставка налога (TAX_VALUE)	В данном поле указывается ставка налога (в процентах). Примеры: - `={20}` - установить ставку НДС 20%; - `={0}` - установить ставку 0%. Важно: Работает только если настроено поле "Способ начисления НДС" (i_active_nds).
Компания (COMPANY_ID)	В данном поле можно изменить привязанную компанию. Примеры: - `={123}` - привязать компанию с ID 123; - `{=Document:COMPANY_ID}` - из текущего документа; - Для отвязки передайте 0.
Контакты (CONTACT_IDS)	В данном поле можно изменить привязанные контакты. Можно указать несколько ID через запятую. Примеры: - `={456,789,101112}` - привязать несколько контактов; - `{=Document:CONTACT_IDS}` - массив из документа. Важно: Это поле заменяет все существующие связи. Для добавления контакта сначала получите текущие через "Получение данных Сделки".
Ответственный (ASSIGNED_BY_ID)	В данном поле можно изменить ответственного за сделку. Примеры: - `={user_25}` - назначить пользователя с ID 25; - `={25}` - также можно указать только ID; - `{=Document:ASSIGNED_BY_ID}` - из документа. Важно: В поле должен быть только ID без лишних символов (или в формате user_ID).
Дата начала (BEGINDATE)	В данном поле можно изменить дату начала сделки. Примеры: - `={01.01.2025 00:00:00}`; - `{=System:NowLocal}` - текущая дата и время.
Дата завершения (CLOSEDATE)	В данном поле можно изменить предполагаемую дату завершения. Примеры: - `={31.12.2025 23:59:59}`; - `={{=dateadd({=Variable:CLOSEDATE}, "30d")}}` - на 30 дней позже.
Источник (SOURCE_ID)	В данном поле указывается источник сделки. Примеры: - `WEB` - Веб-сайт; - `CALL` - Звонок; - `EMAIL` - Email.
Комментарий (COMMENTS)	В данном поле можно изменить комментарий сделки. Примеры: - `Важная сделка`; - `={{={=Variable:COMMENTS} & " \| Дополнительная информация"}}` - добавить к существующему.
UTM-метки	Поддерживаются поля: UTM_SOURCE, UTM_MEDIUM, UTM_CAMPAIGN, UTM_CONTENT, UTM_TERM. Примеры: - `google` - рекламная система; - `cpc` - тип трафика.
Завершена (CLOSED)	Примеры: - `Y` или `1` - сделка завершена; - `N` или `0` - сделка не завершена.
*Пользовательские поля (UF_)**	Активити автоматически создаёт параметры для всех пользовательских полей вашего портала.

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

№	Сценарий	ID Сделки	Изменяемое поле	Значение
1	Сменить стадию	`{=Document:ID}`	STAGE_ID	`QUALIFICATION`
2	Назначить ответственного	`{=Document:ID}`	ASSIGNED_BY_ID	`user_25`
3	Установить сумму	`{=Variable:DEAL_ID}`	OPPORTUNITY	`={500000}`
4	Привязать компанию	`{=Document:ID}`	COMPANY_ID	`={123}`
5	Изменить название	`{=Document:ID}`	TITLE	`Договор №{=Document:ID}`
6	Установить вероятность	`{=Document:ID}`	PROBABILITY	`={75}`
7	Добавить комментарий	`{=Document:ID}`	COMMENTS	`Обработано: {=System:Date}`
8	Изменить дату завершения	`{=Document:ID}`	CLOSEDATE	`={{=dateadd({=System:Now}, "14d")}}`
9	Установить источник	`{=Document:ID}`	SOURCE_ID	`WEB`
10	Завершить сделку	`{=Document:ID}`	CLOSED	`Y`

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

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

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

Важно:
- Нельзя изменить направление сделки через это активити - используйте штатные средства Битрикс24;
- Нельзя одновременно изменить направление и стадию - делайте это в разных активити;
- При изменении суммы вручную учитывайте, что она может быть перезаписана при изменении товаров;
- Пользователь, от имени которого запускается активити, должен иметь права на изменение сделки.

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

Изменение Сделки