Печатная форма должна строиться из зафиксированного snapshot заказа, а не заново пересчитывать скидки и налоги при каждом скачивании. Сначала сформируйте JSON документа с номером, датой, сторонами, строками и итогами, затем передайте его в отдельный HTML-шаблон и только после этого печатайте PDF.

Для серверной генерации Chromium/Puppeteer используйте `page.pdf()`: он рендерит страницу с print media. Закрепите версию runtime, дождитесь загрузки fonts и задайте размер через CSS `@page` вместе с `preferCSSPageSize`, иначе обновление браузера или шрифта может незаметно изменить переносы.

Данные документа замораживаются отдельно

Поле snapshotИсточникПочему нельзя считать при печати
Номер и датаСистема нумерации документовПовторное открытие не меняет идентификатор
Наименование и ценаСтрока заказа на момент фиксацииКаталог позже редактируется
Скидка и налогРезультат расчётного движкаНовые правила не переписывают прошлый документ
Реквизиты сторонВерсия профиля на датуАдрес и название могут измениться
Валюта и округлениеPayment/order snapshotТекущий курс не относится к старому заказу
Версия шаблонаTemplate registryМожно объяснить внешний вид документа

Если заказ ещё редактируется, формируйте preview с явной пометкой. Финальный документ создаётся после бизнес-события и получает собственную версию; исправление оформляется новой версией или корректировочным документом по правилам продукта.

Print CSS управляет листом и разрывами

@page {
  size: A4;
  margin: 16mm 14mm 18mm;
}

@media print {
  .screen-only { display: none; }
  .order-row { break-inside: avoid; }
  thead { display: table-header-group; }
  tfoot { display: table-footer-group; }
  body { font-family: 'Inter', sans-serif; }
}

Не ставьте `break-inside: avoid` на огромный контейнер: браузер не сможет поместить его на лист и результат будет непредсказуем. Защищайте небольшие строки, подпись и блок итогов; длинное описание товара разрешайте переносить.

Генератор ждёт контент, а не таймер

Откройте локальный защищённый render URL или передайте HTML напрямую, дождитесь `document.fonts.ready` и явного признака `data-render-ready`. Таймер «подождать секунду» ломается под нагрузкой. Внешние картинки предварительно загрузите или встройте как контролируемые assets.

  • Отключите произвольные внешние URL в шаблоне, чтобы не получить SSRF.
  • Установите timeout и ограничение размера HTML/PDF.
  • Используйте printBackground, если фон несёт смысл, а не декор.
  • Не передавайте cookie пользователя headless-браузеру без необходимости.
  • Удаляйте временные файлы после сохранения результата в document storage.

Длинные данные проверяются заранее

Эталонный набор должен включать длинное имя компании, несколько языков, пустой optional field, 1 и 100 строк, крупные суммы, отрицательную скидку если она допустима, QR/штрихкод и подписи. Откройте PDF на desktop и mobile viewer, затем напечатайте хотя бы один образец.

Сравнение только по размеру файла бесполезно. Извлеките текст для проверки суммы и номера, посчитайте страницы и добавьте визуальный diff отрендеренных PNG с допустимым порогом. Изменение шрифта и Chromium обновляйте осознанно.

Повторная генерация не меняет документ

Два запуска для одного snapshot должны дать одинаковые бизнес-данные и ожидаемую верстку. Если нужен новый вид, сохраните template version. Кэшируйте готовый PDF по document version, но не по изменяемому order ID без версии.

Для разбора подготовьте обезличенный snapshot, HTML/CSS template, версию Puppeteer/Chromium и проблемный PDF. Реальные реквизиты клиента, подписи и токены доступа следует заменить.

Проверенные источники