Пересборка PDF документа
Пересборка — это повторная генерация PDF для уже существующей записи документа: заново подставляются данные заказа (в т. ч. актуальные позиции, реквизиты, шаблон печати), при этом номер и дата документа берутся из текущей записи документа, а набор позиций — из сохранённого при создании состава (payload документа), если он был; иначе подтягиваются все позиции заказа так, как заложено в логике платформы.
Используйте пересборку, если PDF устарел визуально после изменений в заказе, шаблоне типа документа, шрифтах или настройках печати, либо если файл отсутствует или повреждён.
См. также: Как создать документ, Как посмотреть или скачать документ.
Где находится действие
Кнопка «Пересобрать PDF» (иконка обновления) доступна:
- в таблице «Документы» внутри карточки заказа — в строке документа;
- в таблице списка документов заказов (если пользуетесь этим экраном);
- в шапке страницы просмотра отдельного документа.
Перед выполнением открывается подтверждение с заголовком «Пересборка PDF» и текстом вроде «Заново соберём PDF из заказа.»
Как выполнить
- Откройте нужный документ (из заказа или из списка).
- Нажмите «Пересобрать PDF».
- Подтвердите действие в модальном окне.
- Дождитесь уведомления: при успехе — «PDF пересобран»; при ошибке — «Не удалось пересобрать PDF» с кратким текстом причины.
После успеха обновите просмотр (встроенный предпросмотр на странице документа или повторное открытие PDF в новой вкладке), чтобы увидеть актуальный файл.
Что именно обновляется
- На диск записывается новый бинарный PDF (по существующему или новому относительному пути в хранилище — по логике версии).
- В записи документа обновляются служебные данные печати (
payload: блоки печати, налоговое представление, идентификаторы позиций и т. п.), чтобы они соответствовали последнему рендеру.
Номер документа и дата при пересборке не меняются сами по себе — меняется содержимое PDF под уже зафиксированными реквизитами документа. Если нужно изменить номер или дату, сначала отредактируйте документ на экране «Изменить», затем при необходимости снова выполните пересборку, чтобы PDF совпал с новыми значениями.
Когда пересборка особенно полезна
- после правки шаблона типа документа или модуля печати;
- после обновления платформы (изменилась вёрстка / шрифты);
- после существенных правок заказа (ФИО, адрес, состав строк), если в PDF должны отразиться новые данные при том же номере документа;
- если скачивание или просмотр сообщают об отсутствии файла — пересборка создаёт файл заново.
Ограничения и внимание
- Пересборка не заменяет юридическую перерегистрацию документа: если по процессу нужен новый номер, создайте новый документ или измените номер вручную в допустимых пределах политики, затем пересоберите PDF.
- Если пересборка падает с ошибкой, текст уведомления и логи сервера помогут поддержке найти причину (нет заказа, нет типа, ошибка шаблона и т. д.).
Правка только номера/даты
После сохранения формы «Изменить» счётчик нумерации в базе подстраивается, но файл PDF сам не обновляется. Если в печати должен отображаться новый номер или состав данных — выполните «Пересобрать PDF».