Если счёт отправился без номера заказа, не начинайте с настройки счётчика документов. Номер счёта и номер связанного заказа — разные поля. Найдите одну отправку и проследите связь от invoice до order, затем до данных шаблона. Пустой блок в PDF может означать отсутствующую связь, неправильный ключ или слишком раннюю генерацию.

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

Внутренний ID не заменяет внешний номер

# условный контракт данных рендеринга
invoice.id: inv-test-1
invoice.number: INV-2026-001
order.id: order-test-1
order.number: WEB-2026-015
document.order_reference: WEB-2026-015

Это схема примера, не конфигурация конкретной CMS. Внутренний ID используется для связи объектов, а order_reference предназначен для отображения читателю. Значение нельзя брать из «последнего созданного заказа» или текущей сессии менеджера: параллельные операции могут подставить чужой объект.

ГраницаЧто сравнить
Базаinvoice.order_id и нужный заказ
Подготовка DTOorder.number и document.order_reference
Шаблоножидаемое имя ключа
Фоновая задачаID и версия снимка
ОтправкаID принятого артефакта

Связь проверяем до появления PDF

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

Запретите выпуск там, где номер обязателен, до прохождения проверки. Сообщение должно назвать отсутствующее поле и объект, а не скрыть его пустой строкой. Если счёт по договору законно не относится к заказу, примените другой тип документа вместо искусственного номера. Эти правила определяет ваш процесс, а не PDF-библиотека.

Очередь должна знать, какой документ она выпускает

Задача генерации хранит стабильный ID счёта и выбранную версию данных. Перед чтением объекта дождитесь завершения транзакции, которая создаёт заказ и его связь. Иначе worker может стартовать раньше, чем нужная запись становится доступной. При временном отказе базы задача повторяется, но повтор не должен создавать новый счёт и назначать другой номер.

  1. Сопоставить invoice и order по внутренней связи.
  2. Снять обезличенный DTO до рендеринга.
  3. Сравнить ключ шаблона с ключом DTO.
  4. Сверить время создания связи и запуск worker.
  5. Проверить, что отправитель взял именно проверенный артефакт.

Если номер меняется позже, решите, нужно ли перевыпускать документ или сохранять первоначальный снимок. Не читайте текущие значения во время каждого повторного скачивания незаметно для пользователя. Идентичный URL с меняющимся PDF осложняет сверку переписки и платёжных оснований.

Перевыпуск — отдельное управляемое действие

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

Ошибочные уже отправленные файлы соберите по ID артефакта и версии шаблона. Выпуск исправленной версии не означает повтор платежа или нового заказа. Сохраните исходник, связь версий и журнал уведомления; откат возвращает выбранный артефакт, а не удаляет историю отправок.

Для разбора пригодятся обезличенная связь invoice/order, DTO, имя поля шаблона, время запуска задачи и ID отправленного PDF. Эти данные показывают точное место потери номера без передачи реквизитов клиента, полной базы и почтовой переписки.

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