PDF Invoices
PDF invoices for OXID eShop 7.x: create invoices with sequential numbers, a data snapshot and Dompdf, attach them to order emails and manage them in the admin. Installation, configuration, template.
This documentation always describes the latest published version.
Live Demo: Try this and other plugins live — no installation, no risk: demo.markus-michalski.net
PDF Invoices
PDF invoice generator for OXID eShop 7.x. The module creates PDF invoices with sequential numbers for orders, stores them in the shop, attaches them to the order emails and provides a tab in the admin area for managing them.
A snapshot of the order data is stored with every invoice. The PDF can be re-created from it at any time, independent of later changes to the order.
graph TD
A["Order email is sent"] --> B{"Email attachment matches recipient?"}
B -->|"No"| X["Email without invoice"]
B -->|"Yes"| C{"Invoice exists?"}
C -->|"Yes"| H["Attach PDF to email"]
C -->|"No"| D{"Auto-generate enabled?"}
D -->|"No"| X
D -->|"Yes"| E["Create invoice: number, snapshot, PDF with Dompdf, storage"]
E --> H
M["Admin: Create Invoice"] --> E2["Create invoice: number, snapshot, PDF with Dompdf, storage"]
E2 --> Z["PDF stored (end, no attachment)"]
Documentation
| Page | Content |
|---|---|
| Installation | Composer installation, activation, directory permissions, update |
| Configuration | Settings, when an invoice is created, admin tab |
| Template and Variables | Invoice layout, payment blocks, all variables |
| Extending | Chain extensions, order methods, services |
| Privacy | Stored data, access protection, retention |
| Troubleshooting | PDF creation, attachment, integrity errors, logo, bank details |
| Technical | Flow, number assignment, storage, database, snapshot |
Features
| Feature | Description |
|---|---|
| PDF creation | A4 invoice from a Twig template, created with Dompdf |
| Email attachment | Attached to the order confirmation for the customer and/or the notification for the shop owner |
| Sequential number | Format {prefix}{year}-{number}, counter per shop and year |
| Data snapshot | Order data is captured at creation, the PDF can be re-created from it |
| Integrity check | SHA-256 hash per PDF, verified on reading |
| Admin tab | Create, download, send by email and regenerate the invoice |
| Payment information | Separate blocks for prepayment, invoice and SEPA direct debit |
| Multi-shop | Invoices and counters are kept per shop |
Requirements
| Requirement | Note |
|---|---|
| OXID eShop | 7.x |
| PHP | 8.2+ |
| Dompdf | dompdf/dompdf ^2.0, installed through Composer |
| License | Required |
License
Commercial License - Single installation license:
- CE/PE License: One OXID eShop installation
- EE License: One OXID eShop installation incl. all subshops
Development and staging environments included. 12 months free updates.
See LICENSE file for complete terms.
Support
For questions and support: Markus Michalski, Email: support@markus-michalski.net