Вернуться к списку Вернуться к статьям
Статьи

Документы из смарт-процессов Битрикс24: настройка под заявку

«Фабрика документов» позволяет подготовить шаблон для выбранного смарт-процесса Битрикс24. Для этого нужно подключить действие приложения к нужному типу карточек, выбрать совместимый источник и вставить поля именно этого процесса. Шаблон сделки не становится подходящим для заявки только после смены названия.

Выберите один документ по заявке

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

Если вы ещё выбираете структуру процесса, прочитайте материал о реестре документов на смарт-процессах. Здесь рассматриваем формирование файла по уже существующей карточке.

Проверьте доступность процесса

Откройте настройки встроек CRM в приложении и найдите нужный тип карточек. Подключите предусмотренное действие формирования документов. Затем проверьте доступ сотрудника к контрольной заявке и её данным.

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

Сопоставьте поля

В документе Что нужно найти
Название заявки Поле текущего смарт-процесса
Клиент Связь с компанией или контактом
Описание работ Соответствующее поле заявки
Дополнительные условия Пользовательские поля этого типа
Таблица позиций Данные, доступные в выбранном сценарии

В синтаксисе приложения смарт-процесс имеет собственный корень вида dynamic_NNN, где номер должен соответствовать реальному типу. Это схема обозначения, а не выражение для слепого копирования. Точный путь берите из каталога своего портала.

Мастер выбора источника CRM и каталога переменных
Мастер выбора источника CRM и каталога переменных

Подготовьте совместимый шаблон

Создайте DOCX или XLSX с минимальным набором полей. При загрузке выберите нужный смарт-процесс среди сущностей шаблона. Проверьте, что в файле не остались выражения сделки, например deal.title, если они не относятся к вашему сценарию.

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

Запустите из контрольной карточки

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

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

Не считайте успешную тестовую генерацию на вручную заданных данных подтверждением связи со смарт-процессом. Для этого нужен именно запуск по карточке CRM.

Где возникают ошибки

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

Отдельно проверяйте таблицы и связанные задачи: набор данных зависит от типа сущности. Нельзя переносить выводы из одной карточки на все смарт-процессы без контрольного примера.

Частые вопросы

Можно ли использовать общий бланк для нескольких процессов?

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

Приложение создаст реестр и маршрут согласования?

В этой инструкции рассматривается генерация файла. Структура смарт-процесса, стадии и согласование настраиваются как отдельная задача CRM.

Подробные выражения и порядок установки доступны в инструкции «Фабрики документов». Обзор сценариев — на странице приложения.

Приложение из статьи

  • Фабрика документов

    Создавайте документы Word и Excel по своим шаблонам из данных CRM Битрикс24: поля, товары, реквизиты и связанные задачи.