Роботека
Роботека · Роботы · Обновить сделку по ID

Обновить сделку по 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

Какие ошибки может вернуть робот?

Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.

  • Ошибка: не указан {id}
  • Ошибка: fields_json пуст
  • Ошибка: fields_json содержит невалидный JSON
  • Ошибка API

Сценарий: обновление сделки из процесса по контакту

  1. У контакта меняется стадия в воронке
  2. Робот обновляет связанную сделку: stageId и opportunity передаются в JSON
  3. Результат Y подтверждает обновление для следующего шага

Похожие роботы

Статьи по теме

Установить Опишите задачу — сделаем робота бесплатно