README

stacss/laravel-upd — Laravel package для генерации PDF-документов:

УПД
акта сверки
счета на оплату

Пакет использует barryvdh/laravel-dompdf, считает НДС через встроенный VatCalculator и отдает готовый Barryvdh\DomPDF\PDF.

Совместимость

Поддерживаются:

PHP 8.1+
Laravel 10
Laravel 11
Laravel 12

Пакет не заявляет поддержку всех версий Laravel. По текущим constraints в composer.json поддерживаются только illuminate/support ^10|^11|^12.

Установка

Установка в обычный Laravel-проект:

composer require stacss/laravel-upd

Публикация конфига и шаблонов:

php artisan vendor:publish --tag=upd-config
php artisan vendor:publish --tag=upd-views

Быстрый старт

УПД

use Stacss\LaravelUpd\UpdRenderer;

$renderer = app(UpdRenderer::class);

$pdf = $renderer->pdf([
    'document' => [
        'number' => '123',
        'date' => now(),
        'status' => 1,
    ],
    'seller' => config('upd.seller'),
    'buyer' => [
        'name' => 'ООО Покупатель',
        'inn' => '1234567890',
        'kpp' => '123456789',
        'address' => 'г. Москва',
    ],
    'items' => [
        [
            'name' => 'Тестовый товар',
            'code' => 'TST-001',
            'unit' => 'шт',
            'unit_code' => '796',
            'quantity' => 2,
            'price' => 100,
            'vat_rate' => 20,
            'price_type' => 'net',
        ],
    ],
]);

$pdf->save(storage_path('upd.pdf'));

Акт сверки

use Stacss\LaravelUpd\ReconciliationRenderer;

$renderer = app(ReconciliationRenderer::class);

$pdf = $renderer->pdf([
    'act_date' => now(),
    'period' => [
        'from' => now()->startOfMonth(),
        'to' => now()->endOfMonth(),
    ],
    'left' => [
        'full_name' => 'ООО Ромашка',
        'short_name' => 'ООО Ромашка',
        'director_post' => 'генерального директора',
        'director_full' => 'Иванова Ивана Ивановича',
        'director_short' => 'Иванов И. И.',
        'director_sign_note' => 'Иванов ' . now()->format('d.m.Y'),
        'basis' => 'Устава',
    ],
    'right' => [
        'full_name' => 'ООО Покупатель',
        'short_name' => 'ООО Покупатель',
        'director_post' => 'генерального директора',
        'director_full' => 'Петрова Петра Петровича',
        'director_short' => 'Петров П. П.',
        'director_sign_note' => 'Петров ' . now()->format('d.m.Y'),
        'basis' => 'Устава',
    ],
    'opening' => [
        'date' => now()->startOfMonth(),
        'balance' => 0,
    ],
    'closing' => [
        'date' => now()->endOfMonth(),
        'balance' => 10000,
    ],
    'operations' => [
        [
            'title' => 'Накладная №1',
            'debit' => 10000,
            'credit' => 0,
        ],
    ],
]);

$pdf->save(storage_path('reconciliation.pdf'));

Счет на оплату

use Stacss\LaravelUpd\InvoiceRenderer;

$renderer = app(InvoiceRenderer::class);

$pdf = $renderer->pdf([
    'document' => [
        'number' => '15',
        'date' => now(),
        'due_date' => now()->addDays(5),
        'base' => 'Оплата по счету за товары',
        'contract' => 'Договор №5 от 01.01.2026',
    ],
    'seller' => [
        'name' => 'ООО Ромашка',
        'short_name' => 'ООО Ромашка',
        'inn' => '7700000000',
        'kpp' => '770001001',
        'ogrn' => '1027700000000',
        'address' => 'г. Москва, ул. Пример, д. 1',
        'phone' => '+7 (999) 123-45-67',
        'email' => 'info@example.ru',
    ],
    'seller_bank' => [
        'bank_name' => 'ПАО Сбербанк',
        'bik' => '044525225',
        'account' => '40702810900000000001',
        'corr_account' => '30101810400000000225',
    ],
    'buyer' => [
        'name' => 'ООО Покупатель',
        'short_name' => 'ООО Покупатель',
        'inn' => '7800000000',
        'kpp' => '780001001',
        'address' => 'г. Санкт-Петербург, ул. Тестовая, д. 5',
    ],
    'items' => [
        [
            'name' => 'Товар 1',
            'brand' => 'ACME',
            'code' => 'ABC-001',
            'unit' => 'шт',
            'unit_code' => '796',
            'quantity' => 2,
            'price' => 1000,
            'vat_rate' => 20,
            'price_type' => 'net',
        ],
    ],
    'payment' => [
        'comment' => 'Без доверенности. Оплата означает согласие с условиями поставки.',
    ],
    'signatures' => [
        'director' => 'Иванов И.И.',
        'accountant' => 'Петров П.П.',
    ],
]);

$pdf->save(storage_path('invoice.pdf'));

Примеры документов

Счет на оплату

УПД

Формат данных для счета

Обязательные поля:

document.number
document.date
seller.name
seller_bank.bank_name
seller_bank.bik
seller_bank.account
items[*].name
items[*].unit
items[*].quantity
items[*].price

Опциональные поля:

весь блок buyer
document.due_date
document.base
document.contract
seller.short_name
seller.ogrn
seller.phone
seller.email
seller_bank.corr_account
items[*].brand
items[*].code
items[*].unit_code
payment.purpose
payment.vat_text
payment.comment
signatures.director
signatures.accountant

Примечания:

если buyer не передан, счет все равно будет сгенерирован
если payment.purpose не передан, пакет сформирует строку автоматически
если payment.vat_text не передан, пакет сформирует его из рассчитанного НДС
колонки Бренд и Код выводятся только если хотя бы у одной позиции есть непустые значения
brand нормализуется из brand, brand_name, manufacturer, vendor
code нормализуется из code, sku, article

Конфигурация

Файл config/upd.php:

return [
    'seller' => [
        'name' => 'АВТОиностранец',
        'inn' => '',
        'kpp' => '',
        'address' => '',
        'phone' => '',
    ],

    'default_vat_rate' => 20.0,
    'default_price_type' => 'net',

    'view' => 'laravel-upd::upd',
    'reconciliation_view' => 'laravel-upd::reconciliation',
    'invoice_view' => 'laravel-upd::invoice',

    'bank_details' => [
        'bank_name' => '',
        'bik' => '',
        'account' => '',
        'corr_account' => '',
    ],

    'invoice_defaults' => [
        'base' => '',
        'contract' => '',
        'comment' => '',
    ],
];

Если опубликованы шаблоны

Если вы уже публиковали views пакета в проекте-потребителе, Laravel будет использовать их вместо шаблонов из vendor.

После обновления шаблонов пакета перепубликуйте их:

php artisan vendor:publish --tag=upd-views --force
php artisan view:clear

Если вы меняли опубликованные шаблоны вручную, перепубликация с --force их перезапишет.

Тестирование

composer test

Стиль кода

Проверка:

composer cs

Исправление:

composer cs-fix

Лицензия

MIT

stacss / laravel-upd

Maintainers

Package info

Statistics

Security

README

Совместимость

Установка

Быстрый старт

УПД

Акт сверки

Счет на оплату

Примеры документов

Счет на оплату

УПД

Формат данных для счета

Конфигурация

Если опубликованы шаблоны

Тестирование

Стиль кода

Лицензия