Перейти к содержимому

Пересборка PDF документа

Пересборка — это повторная генерация PDF для уже существующей записи документа: заново подставляются данные заказа (в т. ч. актуальные позиции, реквизиты, шаблон печати), при этом номер и дата документа берутся из текущей записи документа, а набор позиций — из сохранённого при создании состава (payload документа), если он был; иначе подтягиваются все позиции заказа так, как заложено в логике платформы.

Используйте пересборку, если PDF устарел визуально после изменений в заказе, шаблоне типа документа, шрифтах или настройках печати, либо если файл отсутствует или повреждён.

См. также: Как создать документ, Как посмотреть или скачать документ.

Где находится действие

Кнопка «Пересобрать PDF» (иконка обновления) доступна:

  • в таблице «Документы» внутри карточки заказа — в строке документа;
  • в таблице списка документов заказов (если пользуетесь этим экраном);
  • в шапке страницы просмотра отдельного документа.

Перед выполнением открывается подтверждение с заголовком «Пересборка PDF» и текстом вроде «Заново соберём PDF из заказа.»

Как выполнить

  1. Откройте нужный документ (из заказа или из списка).
  2. Нажмите «Пересобрать PDF».
  3. Подтвердите действие в модальном окне.
  4. Дождитесь уведомления: при успехе — «PDF пересобран»; при ошибке — «Не удалось пересобрать PDF» с кратким текстом причины.

После успеха обновите просмотр (встроенный предпросмотр на странице документа или повторное открытие PDF в новой вкладке), чтобы увидеть актуальный файл.

Что именно обновляется

  • На диск записывается новый бинарный PDF (по существующему или новому относительному пути в хранилище — по логике версии).
  • В записи документа обновляются служебные данные печати (payload: блоки печати, налоговое представление, идентификаторы позиций и т. п.), чтобы они соответствовали последнему рендеру.

Номер документа и дата при пересборке не меняются сами по себе — меняется содержимое PDF под уже зафиксированными реквизитами документа. Если нужно изменить номер или дату, сначала отредактируйте документ на экране «Изменить», затем при необходимости снова выполните пересборку, чтобы PDF совпал с новыми значениями.

Когда пересборка особенно полезна

  • после правки шаблона типа документа или модуля печати;
  • после обновления платформы (изменилась вёрстка / шрифты);
  • после существенных правок заказа (ФИО, адрес, состав строк), если в PDF должны отразиться новые данные при том же номере документа;
  • если скачивание или просмотр сообщают об отсутствии файла — пересборка создаёт файл заново.

Ограничения и внимание

  • Пересборка не заменяет юридическую перерегистрацию документа: если по процессу нужен новый номер, создайте новый документ или измените номер вручную в допустимых пределах политики, затем пересоберите PDF.
  • Если пересборка падает с ошибкой, текст уведомления и логи сервера помогут поддержке найти причину (нет заказа, нет типа, ошибка шаблона и т. д.).

Правка только номера/даты

После сохранения формы «Изменить» счётчик нумерации в базе подстраивается, но файл PDF сам не обновляется. Если в печати должен отображаться новый номер или состав данных — выполните «Пересобрать PDF».

База знаний для EMS-платформы PlatParts.