Invoices

Описание

payload-invoices выпускает пронумерованные счета и кредит-ноты для заказов, созданных через @payloadcms/plugin-ecommerce. Плагин подключается к любой коллекции заказов и добавляет две собственные коллекции: для документов счетов и для счётчиков, которые обеспечивают нумерацию по сериям и годам. Главное свойство нумерации ( отсутствие разрывов. Номер занимает операция compare-and-set над единственным документом-счётчиком, и эта запись выполняется внутри транзакции вызывающего кода. Если документ счёта не сохраняется, транзакция откатывает и счётчик, поэтому неудачная попытка не оставляет пропуска. Дополнительный уникальный индекс по полю номера защищает от дубликатов. Это работает только для документов, которые создаёт плагин, и на PostgreSQL (или MongoDB с replica set), где Payload выполняет каждый запрос в транзакции. Каждый счёт хранит зафиксированный снимок позиций. Цены считываются из продукта или варианта в валюте заказа в момент выпуска и фиксируются в документе, так что последующие изменения цен не влияют на уже выпущенные счета. Все суммы хранятся как целочисленные минорные единицы от ввода до сохранения. Плагин отклоняет дробные суммы вместо округления. Если суммы позиций не сходятся с итогом, в зависимости от настроек плагин либо добавляет строку корректировки с меткой, либо выбрасывает ошибку. PDF генерируется встроенным энкодером примерно из 200 строк, без runtime-зависимостей и без импорта payload в рантайме. Формат номера по умолчанию `SERIES-YEAR-00001` с ежегодным сбросом, кредит-ноты получают отдельную серию. Счета выпускаются через функции `issueInvoice` и `issueCreditNote`, либо автоматически через хук `afterChange`, привязанный к статусам заказа. PDF доступен по маршруту `GET /api/invoices/:id/pdf`. Компонентов админ-панели нет, что сохраняет совместимость при минорных обновлениях Payload.

О пакете

Имя пакета

payload-invoices

Последняя версия

1.0.1

Размер

75 кБ

Лицензия

MIT

Загрузок в неделю

4

Последняя публикация

21 авг. 2026 г.