Последний документ в текущей сущности

Возвращает последний созданный документ в текущей сущности.

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

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

Робот полезен для сотрудника, который продолжает работу с последним документом текущей карточки. После генерации нужно получить документ для следующего шага без повторного поиска сущности. Робот читает последний созданный доступный документ текущего CRM-элемента.

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

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

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

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

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

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

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

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

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

Отдельных входных полей нет. Действие использует текущий CRM-элемент.

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

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

Добавьте действие в учебную карточку нужной сущности и проверьте возвращённые значения.

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

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

Результат	Какое значение получает следующий шаг
ID документа (documentId)	целое число
Номер документа (number)	строка
Название документа (title)	строка
Ссылка на скачивание (downloadUrl)	строка
ID шаблона (templateId)	целое число
Статус выполнения (status)	да/нет

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

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

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