Изменение счета

Изменяет указанные поля существующего счета.

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

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

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

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

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

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

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

Укажите ID счёта и выберите правило для пустых значений. В режиме NEVER пустой ввод не должен затирать прежние сведения; EVER используйте только при намеренном изменении, в том числе очистке.

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

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

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

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

Поле в настройках	Что передать	Обязательность и исходное значение
ID счета (invoiceId)	ID существующего счёта, например 801, из выхода «ID счета» робота создания или поиска счетов. Не путайте его с отображаемым номером счёта и ID сделки.	Обязательно. Значение по умолчанию в настройках не задано
Способ заполнения полей (chooseMethod)	Выберите «Не перезаписывать пустым значением» (NEVER) для изменения только заполненных входов. «Перезаписывать в любом случае» (EVER) включает очистку явно переданной пустой строкой. Непереданное поле сохраняется в обоих режимах.	Обязательно. Значение по умолчанию в настройках не задано
Название (title)	Текст названия, например Учебный счёт за панели или Поставка панелей — согласовано. Это новое название карточки, не её ID.	Необязательно. Значение по умолчанию в настройках не задано
ID компании (companyId)	Числовой ID компании, например 101. Возьмите ID выбранной компании из результата её поиска или из сохранённого поля связи. Нужна компания этого портала; название организации и вся ссылка карточки не подходят.	Необязательно. Значение по умолчанию в настройках не задано
ID контакта (contactId)	Числовой ID контакта, например 201. Получите его из результата поиска контакта или подготовленной связи с контактом. ID компании и ID контакта — разные значения, даже если оба относятся к одному клиенту.	Необязательно. Значение по умолчанию в настройках не задано
Сумма (opportunity)	Число, например 20000 или 20000.50, без пробелов-разделителей, знака рубля и текста. Валюту укажите отдельно. Передавайте сумму в выбранной валюте, а не строку 20 000 руб..	Необязательно. Значение по умолчанию в настройках не задано
Валюта (currencyId)	Код доступной валюты, например RUB. Возьмите код валюты из настроек CRM или результата предыдущего шага. Для суммы в рублях в учебном примере используется RUB; на портале эта валюта должна быть доступна.	Необязательно. Значение по умолчанию в настройках не задано
Стадия (stageId)	Точный код стадии счёта, например DT31_34:N в учебной воронке 34, где такой код существует. Это пример формата, не универсальная стадия вашего портала. Возьмите фактический код из настройки стадий/результата получения данных счёта; надпись «Новый» код не заменяет.	Необязательно. Значение по умолчанию в настройках не задано
Комментарий (comments)	Обычный текст комментария, например Доставка согласована на 20 ноября.. Для изменения используйте полное новое содержимое: робот не дописывает фразу к прежнему комментарию автоматически.	Необязательно. Значение по умолчанию в настройках не задано

Откуда брать значения и что оставить без изменения

Числа 101, 201, 501, 801 и ID сотрудников в примерах условные. В рабочем процессе сначала получите нужный ID поиском, созданием элемента или из подготовленного поля; в редакторе робота выберите подстановку соответствующего результата. Не копируйте номер из другого портала. Если следующий шаг возвращает несколько ID, сначала выберите нужный элемент: одиночный вход не принимает весь список.

Необязательные поля заполняйте по задаче. Не добавляйте чужую компанию, контакт или стадию только для повторения примера. Для учебной настройки можно оставить необязательное поле непереданным; это отличается от явной передачи пустого значения.

Для стадии счёта сначала убедитесь, что код относится к выбранной воронке счетов. Код DT31_34:N в примерах предполагает существование учебной воронки 34 и её стадии; у вас может быть другой код. Если стадию менять не требуется, не передавайте stageId. Не подменяйте эту настройку стадией сделки.

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

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

Поле	Значение
ID счета	801
Способ заполнения полей	«Не перезаписывать пустым значением» (NEVER)
Название	Панели — условия подтверждены
ID компании	101, только если счёт нужно связать именно с этой доступной компанией
ID контакта	201, только если нужен этот доступный контакт
Сумма	20000
Валюта	RUB
Стадия	Не передаётся; для смены стадии подставьте её реальный код, пример формата DT31_34:N
Комментарий	Доставка согласована.

Ожидается обновление переданных полей счёта 801. Для реального сценария оставьте непереданными компанию и контакт, если существующие связи менять не нужно.

Чтобы проверить смысл режима, рассмотрите необязательный комментарий Старый текст. При NEVER явно пустой комментарий не заменяет его. При EVER явно пустой комментарий запрашивает очистку. Если вход comments вовсе не передан, старый текст сохраняется в обоих режимах. Обязательные поля самого счёта не следует очищать. Не запускайте изменение, в котором нет ни одного нового значения: одних ID и режима недостаточно.

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

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

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

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

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