Изменение сделки из счёта
Обновляет поля сделки, непосредственно связанной с выбранным счётом.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для менеджера, обновляющего сделку из бизнес-процесса счёта. Согласованные сведения относятся к сделке, но процесс выполняется в счёте. Робот находит непосредственно связанную сделку и меняет выбранные поля без повторного поиска по названию.
Что делает и когда применять
Обновляет поля сделки, непосредственно связанной с выбранным счётом.
Пустые и непереданные значения сохраняют прежние данные. Принимает ID счёта и выбранные поля сделки, возвращает ID счёта и связанной сделки. Выбранные файлы заменяют прежний набор.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Передайте ID счёта с прямой связью на сделку. Дополнительные стандартные и пользовательские поля сделки подгружаются в установленную форму с вашего портала; выберите только нужные изменения.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Изменение сделки из счёта». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Передайте ID счёта с прямой связью на сделку. Дополнительные стандартные и пользовательские поля сделки подгружаются в установленную форму с вашего портала; выберите только нужные изменения.
- Заполните ID счёта. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
ID счёта (elementId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- ID счёта (
elementId):801.
Если счёт 801 напрямую связан со сделкой 501, действие относится к сделке 501, а результаты сохраняют оба ID. Пустые и непереданные значения сохраняют прежние сведения. Выбранные файлы заменяют существующий набор.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
ID счёта (productId) |
целое число |
ID сделки (dealId) |
целое число |
Статус выполнения (status) |
да/нет |
Пояснение ошибки (error) |
строка |
Передайте «ID сделки» в следующую проверку, а «ID счёта» оставьте для связи с исходным документом. При отсутствии прямой связи сначала исправьте её, не выбирая случайную сделку по похожему названию.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.