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

Обновляет выбранные стандартные и пользовательские поля существующего счёта.

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

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

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

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

Обновляет выбранные стандартные и пользовательские поля существующего счёта.

Выберите, сохранять ли прежние значения при пустом вводе. В режиме «В любом случае» явно переданные пустые поля очищаются; непереданные поля сохраняются. Файлы заменяются выбранным набором.

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

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

Укажите ID счёта и способ заполнения полей. Дополнительные стандартные и пользовательские поля появляются в установленной форме по данным вашего портала. Для режима EVER проверьте каждое явно передаваемое пустое поле: оно может быть очищено.

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

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

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

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

Поле	Как заполнить
ID счёта (invoiceId)	Числовой ID существующего счёта, например 801, из выхода создания/поиска счёта. Не его печатный номер и не ID сделки.
Способ заполнения полей (chooseMethod)	NEVER — пропускать пустые значения; EVER — очищать явно переданные пустые необязательные поля. Непереданные поля сохраняются.

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

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

Подписи и набор пользовательских полей зависят от настроек 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 элемента именно выбранного типа.

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

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

1. В «ID счёта» подставьте 801 из результата создания счёта.
2. Выберите «Способ заполнения полей» → «Не перезаписывать пустым значением» (NEVER).
3. В подгруженное «Название» введите Панели — условия подтверждены.
4. Если форма содержит изменяемый комментарий, введите Доставка согласована на 20 ноября.. Это полное новое содержимое комментария.
5. Остальные изменяемые поля не передавайте. Если нужно также обновить сумму, задайте числовое 20000 и доступную валюту RUB в соответствующих полях.

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

Для осознанной очистки необязательного комментария отдельно выберите EVER и передайте в него пустое значение. При NEVER такой ввод пропускается. Если поле вообще не передано, оно сохраняется в обоих режимах; обязательные поля очищать нельзя. Для множественного поля в режиме очистки пустой список удаляет его значения, для файлов выбранный набор заменяет прежний целиком. Сначала убедитесь, что в набор включены все файлы, которые нужно сохранить.

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

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

Связывайте дальнейшие действия с успешным статусом. Если изменение касается документа к оплате, перечитайте или откройте счёт после запуска и убедитесь, что обязательные сведения сохранились.

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

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