silvershop-suite / invoicing

1.1.0 2026-10-19 18:05 UTC

Requires

• php: ^8.3
• dompdf/dompdf: ^3.0
• lekoala/silverstripe-cms-actions: ^2.0
• silvershop-suite/ledger: *@dev
• silvershop/core: ^6
• silverstripe/framework: ^6.0

Requires (Dev)

• phpunit/phpunit: ^11.0
• silverstripe/sqlite3: ^4

Suggests

• silvershop-suite/store-profile: Central shop identity (name, address, VAT, logo) shared with shipping labels and other modules.

BSD-3-Clause

• Remy Vaartjes
• SilverShop-Suite Contributors

• ecommerce
• invoice
• silverstripe
• Accounting
• silvershop

Published on Packagist.org on 2026-10-19 19:27 UTC

README

Immutable financial documents (invoices, and later credit memos) for SilverShop, with overridable templates.

When a payment is captured, an immutable ShopInvoice is issued: a numbered snapshot of the order's item lines and its adjustment lines (discount / tax / shipping / any modifier module — read via the generic OrderModifier interface, so no coupling to those modules). The lines reconcile to the order total by construction.

Builds on silvershop-suite/ledger (the append-only posting trail); this module adds the line-item documents on top.

Overriding the invoice template

The module ships templates/SilverShop/Invoicing/Invoice.ss. Override it by placing a file at the same path in your project or theme — no code change:

app/templates/SilverShop/Invoicing/Invoice.ss
themes/<your-theme>/templates/SilverShop/Invoicing/Invoice.ss

$Invoice->forTemplate() renders through the SilverStripe theme cascade, so the most specific template wins. (PDF output — rendering this same HTML to PDF — is a planned follow-up.)

What it adds

• ShopInvoice / ShopInvoiceLine — immutable, numbered (INV-00001), item + modifier snapshot.
• PaymentInvoiceExtension — issues an invoice on payment capture (idempotent per payment).
• OrderInvoiceExtension — a read-only Invoices tab on the order.
• InvoiceAdmin (/admin/invoices) — global, filterable, Order/Customer columns, CSV export, no import.

Ledger integration

When silvershop-suite/ledger is installed, every invoice and credit memo is linked to its matching posting entry (by payment), so the ledger references the source document and its CMS Document column shows the invoice number. The link is established whichever side is created second — the document after the entry (via InvoiceService / CreditMemoService) or the entry after the document (via PostingEntryDocumentExtension) — and is wired automatically under a moduleexists: silvershop-suite/ledger config guard. Without the ledger module everything is a silent no-op, so invoicing works standalone.

Licence

BSD-3-Clause.

Credits

Built and maintained by Remy Vaartjes ([e-mail]) — part of the SilverShop-Suite.