Переход основной сделки по стадиям дочерних

Перемещает основную сделку на нужную стадию, когда все дочерние сделки прошли выбранный этап.

Для кого и какую проблему решает

Робот полезен для координатора составного заказа с основной и дочерними сделками. Основная сделка должна двигаться только после готовности всех частей заказа. Робот проверяет связанные дочерние сделки по выбранному этапу и переводит основную по заданному правилу.

Что делает и когда применять

Робот связывает основную сделку с дочерними: когда все дочерние сделки проходят выбранный этап, основная сделка автоматически переходит на нужную стадию.

Что подготовить

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

В дочерней сделке нужно поле основной, а в основной множественное поле дочерних. Укажите их реальные коды, ожидаемый этап дочерних и целевую стадию основной в её воронке. Отдельно решите, считать ли проигранные дочерние прошедшими этап.

Как настроить и использовать

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Переход основной сделки по стадиям дочерних». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. В дочерней сделке нужно поле основной, а в основной множественное поле дочерних. Укажите их реальные коды, ожидаемый этап дочерних и целевую стадию основной в её воронке. Отдельно решите, считать ли проигранные дочерние прошедшими этап.
3. Заполните Поле с основной сделкой (код поля в дочерней сделке, например UF_CRM_1750000001), Множественное поле с дочерними сделками (код поля в основной сделке), Стадия, которую должны пройти все дочерние сделки (код стадии, например PREPARATION или C1:PREPARATION), Стадия, на которую перейдет основная сделка (код стадии ее воронки), Считать проигранные дочерние сделки прошедшими этап. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

Параметры робота

Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.

Поле в настройках	Что передать	Обязательность и исходное значение
Поле с основной сделкой (код поля в дочерней сделке, например UF_CRM_1750000001) (mainDealField)	Формат: строка.	Обязательно. Значение по умолчанию в настройках не задано
Множественное поле с дочерними сделками (код поля в основной сделке) (childrenField)	Формат: строка.	Обязательно. Значение по умолчанию в настройках не задано
Стадия, которую должны пройти все дочерние сделки (код стадии, например PREPARATION или C1:PREPARATION) (requiredStageId)	Формат: строка.	Обязательно. Значение по умолчанию в настройках не задано
Стадия, на которую перейдет основная сделка (код стадии ее воронки) (targetStageId)	Формат: строка.	Обязательно. Значение по умолчанию в настройках не задано
Считать проигранные дочерние сделки прошедшими этап (countLostAsPassed)	Формат: выбор из списка. Варианты: Y: Да; N: Нет.	Обязательно. По умолчанию: Y

Учебный пример

Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.

• Поле с основной сделкой (код поля в дочерней сделке, например UF_CRM_1750000001) (mainDealField): UF_CRM_MAIN_DEAL.
• Множественное поле с дочерними сделками (код поля в основной сделке) (childrenField): UF_CRM_CHILD_DEALS.
• Стадия, которую должны пройти все дочерние сделки (код стадии, например PREPARATION или C1:PREPARATION) (requiredStageId): PREPARATION.
• Стадия, на которую перейдет основная сделка (код стадии ее воронки) (targetStageId): EXECUTING.
• Считать проигранные дочерние сделки прошедшими этап (countLostAsPassed): N.

Переход основной произойдёт только при выполнении проверяемых условий для нужного набора дочерних. По умолчанию признак учёта проигранных Y, но в учебном примере выбран N, чтобы проигрыш сам по себе не открывал переход.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
Основная сделка перемещена (moved)	да/нет
ID основной сделки (mainDealId)	целое число
Всего дочерних сделок (childrenTotal)	целое число
Прошло стадию (childrenPassed)	целое число
Причина результата (reason)	строка
Ошибка (error)	строка

Проверьте «Перемещена», количество дочерних и прошедших этап, а также причину решения. Ошибка связи или несовпадение воронки требуют исправления данных, а не принудительного перехода основной сделки.

Ошибки и ограничения

Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.