Clearis Sylius Invoicing Plugin

A full replacement for the official sylius/invoicing-plugin, designed for Sylius 2 shops that need to comply with Spanish fiscal regulations (RD 1619/2012, AEAT libro registro de facturas emitidas, modelo 303/390). It also works perfectly well for shops outside Spain that simply want a configurable, modern invoicing layer.

The plugin coexists with the official plugin during a transition window (see the migration command) and ships a clean public event API so future VeriFactu / SII / TicketBAI integrations can hook in without forking the codebase.

What you get

• Configurable PDF templates per channel. Pure PHP rendering with Dompdf — no external binaries, no Wkhtmltopdf. Per-channel templates for both standard and rectifying invoices, with optional accent colour and shop logo per template.
• Per-channel atomic numbering with separate series for standard and rectifying invoices. Concurrent-safe emission (SELECT … FOR UPDATE). Customisable format with {year}, {number} and {prefix} placeholders. Optional yearly counter reset.
• Spanish NIF / CIF / NIE on every Sylius Address (optional field), validated server-side with the real control-digit algorithms.
• Rectifying invoices (factura rectificativa) with their own series and the five RD 1619/2012 reason codes (R1–R5). Total rectifications counter-entry the original; partial rectifications apply the supplied base/tax deltas only.
• Libro registro de facturas emitidas Excel export with the canonical Spanish VAT breakdown (0 % / 4 % / 10 % / 21 % / Otros), rectifying flag, "Rectifica a" column, currency, channel and customer tax ID.
• Configurable invoice trigger per channel: emit on order completed, on payment completed, on order shipped, or manually from the order view.
• Migration command from sylius/invoicing-plugin that preserves original invoice numbers, supports a multi-day coexistence window, and is idempotent.
• Public domain events (InvoiceIssuedEvent, InvoiceRectifiedEvent, InvoiceCancelledEvent) so third-party plugins can dispatch to VeriFactu, SII, TicketBAI, or any other tax-agency integration without modifying this plugin.
• Per-channel customer notification with the invoice PDF attached.

Quality

PHPStan at level: max, ECS following sylius-labs/coding-standard, PHPUnit suite green across PHP 8.2 / 8.3 / 8.4 in continuous integration. Full documentation available in the repository docs/ folder.