Пакет документов по сделке

Пакет документов — готовый к отправке ZIP-архив по сделке: все сгенерированные документы типа сделки плюс приложения, отобранные сводками. Собирается по кнопке на дашборде сделки, хранится в приложении и по желанию выгружается в элемент смарт-процесса Битрикс24.

• Что входит в пакет
• Настройка на типе сделки
• Сборка и скачивание архива
• Экспорт в смарт-процесс
• Приложения в пакете (сводки)
• Часто задаваемые вопросы

Что входит в пакет

Структура архива:

Папка	Содержимое
docx/	DOCX-версии документов, сгенерированных по шаблонам типа сделки
pdf/	PDF-версии (если PDF был получен при генерации)
Приложения/	Исходные документы-приложения, отобранные сводками (при включённом флаге «Добавлять приложения»)

В пакет попадают последние успешные задачи генерации по каждому шаблону типа сделки. Если по какому-то шаблону успешной генерации ещё не было — пакет недоступен (см. FAQ). Файлы, которые не удалось получить, пропускаются с предупреждением — сборка не прерывается.

Имя архива: <Название пакета>_<номер сделки>.zip (если название не задано — используется название типа сделки).

Настройка на типе сделки

Раздел Настройки/Типы сделок → карточка типа сделки → секция «Пакет документов»:

Поле	Назначение
Название пакета	Имя архива; если пусто — используется название типа сделки
Добавлять приложения	Добавляет в архив папку «Приложения/» с документами, отобранными сводками
Смарт-процесс для пакета	Смарт-процесс Битрикс24, в который выгружается пакет при экспорте
Поле для документов пакета	Файловое множественное поле смарт-процесса для сгенерированных документов
Поле для приложений пакета	Файловое множественное поле смарт-процесса для приложений

Правила заполнения

• Три поля смарт-процесса (смарт-процесс, поле документов, поле приложений) заполняются только вместе — все три или ни одного.
• Поля должны принадлежать выбранному смарт-процессу, иметь тип «Файл» и быть множественными.
• Если поля не появились в списке — нажмите Синхронизировать поля (при выбранном смарт-процессе кнопка синхронизирует поля именно этого типа).

Поведение кнопки синхронизации

• Смарт-процесс не выбран → кнопка «Синхронизировать» обновляет только список смарт-процессов.
• Смарт-процесс выбран → кнопка «Синхронизировать поля» обновляет поля выбранного смарт-процесса.

Сборка и скачивание архива

Кнопки находятся в блоке «Сгенерированные документы» на дашборде сделки (нижняя часть карточки).

1. Откройте карточку сделки → приложение AI Документы.
2. Нажмите Скачать пакет (ZIP).
3. В открывшемся окне дождитесь статуса «Архив готов» — сборка идёт в фоне, окно показывает прогресс автоматически.
4. Скачивание начнётся автоматически; если нужно — нажмите Скачать ещё раз.

Под кнопками отображаются: имя архива, количество документов и приложений, время последней сборки и предупреждения (например, о пропущенных приложениях).

Повторное нажатие

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

Экспорт в смарт-процесс

Выгружает пакет отдельным элементом смарт-процесса — удобно, чтобы передать все документы по сделке в рабочий процесс Битрикс24 (согласование, хранение, отправка контрагенту).

1. Убедитесь, что в настройках типа сделки заполнены все три поля смарт-процесса (см. таблицу выше).
2. На дашборде сделки нажмите Экспорт в смарт-процесс.
3. Дождитесь статуса «Элемент создан» и перейдите по кнопке Открыть элемент.

Что создаётся:

• новый элемент выбранного смарт-процесса с заголовком «Пакет документов для \<номер сделки>»;
• сгенерированные документы (PDF, при отсутствии — DOCX) — в поле для документов;
• приложения — в поле для приложений (если включено «Добавлять приложения»).

Каждый запуск экспорта создаёт новый элемент (дубли не перезаписываются).

Приложения в пакете (сводки)

Чтобы приложения (исходные документы сделки) автоматически отбирались в пакет, администратор настраивает сводные таблицы («сводки») с признаком «Возвращать ссылки на документы». Для каждой строки сводки ИИ указывает, из какого документа она взята — этот документ попадает в папку «Приложения/».

Если сводка без такого признака — приложение ищется по точному совпадению имени файла со значением строки. Не найденные строки попадают в предупреждения сборки и не прерывают её.

Часто задаваемые вопросы

Не вижу кнопок «Скачать пакет» / «Экспорт в смарт-процесс».

Возможные причины: (1) по сделке не выбран тип сделки или у типа нет шаблонов; (2) нет успешной генерации хотя бы по одному шаблону; (3) по сделке идёт фоновая операция (обработка, сводки, генерация, сборка архива или экспорт) — кнопки скрыты на её время и появятся автоматически. Кнопка «Экспорт» дополнительно требует заполненных полей смарт-процесса в настройках типа сделки.

Архив собирается заново каждый раз?

Нет. Готовый архив переиспользуется, пока по сделке не появятся новые генерации/сводки или не изменятся настройки. Скачивание готового архива доступно даже во время фоновых операций.

В предупреждениях «файл не найден». Что делать?

Строка сводки ссылается на документ, которого нет в сделке (например, приложение удалено). Проверьте состав приложений по сделке; строка будет пропущена, остальные документы в архив войдут.

Экспорт упал с ошибкой «не настроен».

Заполнены не все три поля смарт-процесса в настройках типа сделки, либо поля больше не соответствуют смарт-процессу (переименованы/удалены). Откройте тип сделки и сохраните настройку заново.