Изменение сделки по ID

Обновляет выбранные стандартные и пользовательские поля сделки по её ID.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

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

Робот полезен для администратора CRM, которому нужно обновить пользовательские поля найденной сделки. Из внешнего шага получен ID сделки, а стандартного короткого набора полей недостаточно. Робот обновляет выбранные стандартные и пользовательские поля, доступные в установленной форме портала.

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

Обновляет выбранные стандартные и пользовательские поля сделки по её ID.

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

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

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

Укажите ID существующей сделки. После установки выберите подгруженные поля для изменения. Пустые и непереданные значения сохраняют прежние сведения; числовой ноль и логическое «Нет» учитываются как значения.

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

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Изменение сделки по ID». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Укажите ID существующей сделки. После установки выберите подгруженные поля для изменения. Пустые и непереданные значения сохраняют прежние сведения; числовой ноль и логическое «Нет» учитываются как значения.
3. Заполните управляющие входы и нужные подгруженные поля по таблицам и учебному примеру ниже. Для каждого ID выберите результат подготовки, для списков — доступный вариант вашей формы. Одних ID или переключателя недостаточно, чтобы задать новые сведения.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

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

Вначале заполните управляющие входы:

Поле	Как заполнить
ID сделки (elementId)	Числовой ID изменяемой сделки, например 501, из поиска/создания сделки или подготовленного поля связи. Ссылку, название и ID счёта вместо него не передавайте.

Выберите хотя бы одно подгруженное поле и задайте новое значение, например «Название» = Поставка панелей — согласовано. Сам elementId указывает получателя, но не задаёт изменений. Пустые и непереданные поля сохраняют прежние данные; числовой ноль и логическое «Нет» учитываются.

Как заполнять дополнительные поля вашего портала

Подписи и набор пользовательских полей зависят от настроек CRM. Найдите нужное поле по подписи в своей форме; код чужого пользовательского поля не переносите на свой портал. Для каждого выбранного поля используйте подходящий способ:

Вид поля	Какие данные вводить и пример
Текст, название, комментарий	Текст, например Доставка согласована. Для комментария передайте полное новое содержимое: автоматического дописывания к прежнему тексту нет.
Целое число	Например 10; без единиц измерения и дробной части. Для связи со сделкой — её ID, например 501, из результата поиска/создания.
Дробное число, сумма	Например 12500.50, без обозначения валюты. Для обычной суммы валюта выбирается отдельно, если такое поле есть в форме.
Да/нет	Выберите «Да» или «Нет». Логическое «Нет» и числовой ноль являются значениями, а не просьбой пропустить поле.
Сотрудник, ответственный	Выберите сотрудника в форме. При подстановке используйте числовой ID, например 23; формат user_23 также принимается. ФИО и ID отдела не заменяют ID сотрудника.
Несколько сотрудников, наблюдатели	Добавьте каждого нужного сотрудника отдельно, например с учебными ID 24 и 25. Из предыдущего шага передавайте список, а не текст 24,25. Для поля с готовым списком сотрудников выбирайте доступные варианты.
Выпадающий список	Выберите реальный вариант в форме. Если подставляете результат, нужен ID/код этого варианта; учебный ID 7 допустим только если такой вариант существует. Его название не всегда равно сохраняемому значению.
Воронка и стадия	Сначала определите воронку получателя, затем выберите её стадию из доступных вариантов. В учебном счёте код стадии может выглядеть как DT31_34:N, в сделке — NEW или C4:NEW; конкретные коды должны существовать на вашем портале и соответствовать нужной воронке.
Валюта	Выберите доступную валюту, например RUB. Не вводите произвольную подпись «рубли» вместо кода при подстановке.
Пользовательское поле «Деньги»	Введите сумму и код валюты через вертикальную черту: число, вертикальная черта, код валюты. Другой поддерживаемый способ — сумма 12500 в основном поле и RUB в соседнем выборе валюты. Не заполняйте только соседнюю валюту без суммы.
Пользовательская CRM-связь	Для учебной сделки 501 можно передать D_501, для контакта 201 — C_201, компании 101 — CO_101. Либо укажите числовой ID и выберите тип в соседнем поле. Не путайте ID и тип: один и тот же номер может принадлежать разным карточкам.
Дата/время	Выберите требуемую дату штатным календарём поля, например дату согласованного срока. Если подставляете значение, берите поле/результат того же типа даты; текст «завтра» не заменяет конкретную дату.
Файл	Укажите публичный HTTP/HTTPS адрес и имя через ##. Например синтаксис https://example.com/document.pdf##Документ.pdf; это учебный адрес, замените его URL своего доступного файла. Локальный путь, ID файла Диска и закрытая страница просмотра не заменяют публичный URL. Выбранные файлы заменяют прежний набор.
Несколько значений	Добавьте каждое значение через элементы множественного поля. Не помещайте их в одну строку через запятую. Пустые элементы списка не допускаются. При замене файлов подготовьте сразу весь набор, который должен остаться.

Пример значения пользовательского денежного поля — скопируйте только значение внутри блока:

12500|RUB

Это относится к пользовательскому полю типа «Деньги». Не вставляйте строку с валютой в обычную числовую «Сумму».

Для собственной CRM-связи со смарт-процессом выбирайте его тип из доступного списка. Не вычисляйте его префикс по названию и не используйте D_ для произвольного смарт-процесса. Нужен ID элемента именно выбранного типа.

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

Есть доступная учебная сделка 501. Нужно изменить её название и ответственного, не трогая стадию и прочие данные.

1. В «ID сделки» подставьте 501 из результата поиска сделки.
2. В подгруженном «Название» укажите Поставка панелей — согласовано.
3. В «Ответственный» выберите сотрудника с учебным ID 23. Если значение приходит из предыдущего шага, передайте ID сотрудника; user_23 также поддерживается.
4. Поля воронки и стадии оставьте непереданными. При необходимости смены стадии выберите фактический вариант своей воронки: например, для учебной воронки 4 допустим код C4:NEW, только если он действительно есть в списке.
5. Если требуется заменить наблюдателей, выберите весь нужный список сотрудников, например с ID 24 и 25; не набирайте строку 24,25. Если наблюдателей менять не нужно, не передавайте поле.

Ожидается обновление названия и ответственного именно сделки 501. Пустые поля не очищают прежние значения. Для пользовательского денежного поля используйте строку 12500 с выбранной валютой RUB или отдельный пример формата выше; для пользовательской связи с учебным контактом — C_201 при наличии такого контакта. Эти дополнительные поля заполняйте только если они реально есть в вашей форме и относятся к задаче.

Файловое поле требует доступного публичного URL и имени; все выбранные файлы подготавливаются до изменения сделки и заменяют прежний набор. Отсутствие нового файла означает сохранение прежних сведений, а не создание пустого вложения. Пример иллюстрирует способ настройки и не является отчётом о выполнении на портале.

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

Результат	Какое значение получает следующий шаг
Статус выполнения (status)	да/нет
Пояснение ошибки (error)	строка

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

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

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