Изменение предложения из счета (оплата, остаток)
Обновляет поля оплаты и остатка в предложении по данным счета.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для финансового координатора, который отражает оплату счёта в предложении. Сведения об оплате и остатке приходится переносить из счёта в предложение вручную. Робот обновляет соответствующие поля предложения, используя выбранный счёт и указанные коды полей.
Что делает и когда применять
Робот находит предложение, связанное со счетом, и увеличивает поле «Оплачено» на сумму счета, одновременно уменьшая поле «Осталось оплатить».
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Проверьте связь счёта с нужным предложением и подготовьте коды полей «Оплачено» и «Осталось оплатить». Это должны быть реальные поля подходящего типа, а не их заголовки из интерфейса.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Изменение предложения из счета (оплата, остаток)». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Проверьте связь счёта с нужным предложением и подготовьте коды полей «Оплачено» и «Осталось оплатить». Это должны быть реальные поля подходящего типа, а не их заголовки из интерфейса.
- Заполните ID счета, Код поля «Оплачено», Код поля «Осталось оплатить». Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
ID счета (elementId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Код поля «Оплачено» (fieldPaid) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Код поля «Осталось оплатить» (fieldMustPaid) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- ID счета (
elementId):801. - Код поля «Оплачено» (
fieldPaid):UF_CRM_PAID. - Код поля «Осталось оплатить» (
fieldMustPaid):UF_CRM_REMAINING.
При доступном связанном предложении его поля получают рассчитанные по данным счёта значения. Не подставляйте примерные коды без создания и проверки полей на своём портале.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
ID предложения (productId) |
целое число |
Статус (status) |
да/нет |
Ошибка (error) |
строка |
После успешного статуса сверьте предложение и дальнейший документ оплаты. Такой перенос не подтверждает фактическое поступление денег в банке: он использует сведения, уже сохранённые в CRM.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.