Обновить сделку по ID
Робот «Обновить сделку по ID» изменяет любую сделку по её идентификатору из любого контекста бизнес-процесса в Битрикс24. Поля для изменения передаются в виде JSON в формате camelCase (title, stageId, opportunity, assignedById и другие). Возвращает признак успеха Y/N для условного перехода в процессе. Работает через универсальный CRM-метод crm.item.update.
Робот обновляет произвольную сделку по её ID, даже если бизнес-процесс запущен на другом элементе CRM — контакте, лиде или задаче. Идентификатор сделки и набор полей задаются явно: поля передаются строкой JSON в формате camelCase (например {"title":"Новое название","stageId":"C1:WON","opportunity":50000,"assignedById":5}). Обновление выполняется универсальным методом crm.item.update, поэтому доступны все поля сделки, включая пользовательские. Типовые случаи: при смене стадии контакта обновить связанную сделку, проставить ответственного и сумму по данным из внешней системы, массово менять стадию сделок из родительского процесса. Возвращает признак Успешно (Y/N): Y при успешном обновлении, N при пустом ID, пустом или невалидном JSON либо ошибке API — сравните его в условии следующего шага.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| ID сделки | int | да | |
| Поля для обновления (camelCase JSON): {"title":"New deal","stageId":"C1:WON","assignedById":5,"opportunity":50000} | string | да |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Успешно (Y/N) | string |
Сценарий: обновление сделки из процесса по контакту
- У контакта меняется стадия в воронке
- Робот обновляет связанную сделку: stageId и opportunity передаются в JSON
- Результат Y подтверждает обновление для следующего шага