ID сделки в счете

Возвращает ID сделки, из которой сделан счет.

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

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

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

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

Робот пригодится, когда логика бизнес-процесса счета зависит от сделки, из которой он был создан.

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

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

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

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

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

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

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

Поле в настройках	Что передать	Обязательность и исходное значение
ID счета (elementId)	Формат: целое число.	Необязательно. Значение по умолчанию в настройках не задано

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

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

• ID счета (elementId): 801.

Если счёт 801 связан со сделкой 501, результатом будет ID 501. Сам робот не проверяет оплату и не переносит поля сделки; он только помогает получить связь для последующего действия.

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

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

Подставьте «ID сделки» в действие чтения или изменения сделки после проверки статуса. Пустой результат не заменяйте ID счёта: эти идентификаторы относятся к разным сущностям.

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

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