PHPackages tomatophp/filament-invoices - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. tomatophp/filament-invoices ActiveLibrary[Payment Processing](/categories/payments) tomatophp/filament-invoices =========================== Generate and manage your invoices / payments using multi currencies and multi types in FilamentPHP 4.0.0(4mo ago)993.9k↓25%17[1 PRs](https://github.com/tomatophp/filament-invoices/pulls)MITPHPPHP ^8.2|^8.3|^8.4CI passing Since Aug 20Pushed 4mo ago2 watchersCompare [ Source](https://github.com/tomatophp/filament-invoices)[ Packagist](https://packagist.org/packages/tomatophp/filament-invoices)[ GitHub Sponsors](https://github.com/3x1io)[ RSS](/packages/tomatophp-filament-invoices/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (8)Dependencies (18)Versions (10)Used By (0) [![Screenshot](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/fadymondy-tomato-invoices.jpg)](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/fadymondy-tomato-invoices.jpg) Filament Invoices Manager ========================= [](#filament-invoices-manager) [![Latest Stable Version](https://camo.githubusercontent.com/04f2e08890ab2afd8ab36f0d44d114b9b1cffc3684ada5d3e05a16b279d5416d/68747470733a2f2f706f7365722e707567782e6f72672f746f6d61746f7068702f66696c616d656e742d696e766f696365732f76657273696f6e2e737667)](https://packagist.org/packages/tomatophp/filament-invoices)[![License](https://camo.githubusercontent.com/570db479174fc625ffb9d39d91e3e40b9e9fd22bfb6a9531402cfd1789f31073/68747470733a2f2f706f7365722e707567782e6f72672f746f6d61746f7068702f66696c616d656e742d696e766f696365732f6c6963656e73652e737667)](https://packagist.org/packages/tomatophp/filament-invoices)[![Downloads](https://camo.githubusercontent.com/bbda5411ab567e53381aaa8f5e31b42c5e7d520b9bab7de210c25ee1cf248282/68747470733a2f2f706f7365722e707567782e6f72672f746f6d61746f7068702f66696c616d656e742d696e766f696365732f642f746f74616c2e737667)](https://packagist.org/packages/tomatophp/filament-invoices) Generate and manage your invoices / payments using multi currencies and multi types in FilamentPHP Features -------- [](#features) - Generate Invoices - Manage Invoices - Print Invoices - Invoices Facade Class - Invoices Morph From/For - Invoices Payments - Support Multi Type - Support Multi Currency - Support Multi Status - Status Manager - Invoices Widgets - Send Invoice via Email (with PDF attachment) - Export Invoice as PDF (DomPDF) - Invoice Templates (5 built-in templates, extensible via Factory Pattern) - Invoice Settings (Settings Hub integration) - Print Pay Slip for Payments Screenshots ----------- [](#screenshots) [![Home](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/home.png)](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/home.png)[![Create](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/create.png)](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/create.png)[![Edit](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/edit.png)](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/edit.png)[![View](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/view.png)](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/view.png)[![Print](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/print.png)](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/print.png)[![Logs](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/logs.png)](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/logs.png)[![Status](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/status.png)](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/status.png)[![Payments](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/payments.png)](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/payments.png)[![Payment Amount](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/payment-amount.png)](https://raw.githubusercontent.com/tomatophp/filament-invoices/master/arts/payment-amount.png) Installation ------------ [](#installation) ``` composer require tomatophp/filament-invoices ``` after install your package please run this command ``` php artisan filament-invoices:install ``` finally register the plugin on `/app/Providers/Filament/AdminPanelProvider.php` ``` ->plugin(\TomatoPHP\FilamentInvoices\FilamentInvoicesPlugin::make()) ``` ### Enable Settings Hub [](#enable-settings-hub) To enable the Invoice Settings page in the Settings Hub, use the `useSettingsHub()` method: ``` ->plugin( \TomatoPHP\FilamentInvoices\FilamentInvoicesPlugin::make() ->useSettingsHub() ) ``` Don't forget to publish the settings migration: ``` php artisan vendor:publish --tag="filament-invoices-settings-migrations" php artisan migrate ``` Using ----- [](#using) to start use this plugin you need to allow 2 types of users or table to fill the invoices from / for after you prepare your models use this Facade class like this on your `AppServiceProvider` or any other service provider ``` use TomatoPHP\FilamentInvoices\Facades\FilamentInvoices; use TomatoPHP\FilamentInvoices\Services\Contracts\InvoiceFor; use TomatoPHP\FilamentInvoices\Services\Contracts\InvoiceFrom; public function boot() { FilamentInvoices::registerFor([ InvoiceFor::make(Account::class) ->label('Account') ]); FilamentInvoices::registerFrom([ InvoiceFrom::make(Company::class) ->label('Company') ]); } ``` after that you can use the plugin on your filament admin panel Invoice Templates ----------------- [](#invoice-templates) The package comes with 5 built-in invoice templates: - **Classic** - Traditional professional invoice layout - **Modern** - Contemporary design with gradient header - **Minimal** - Clean and simple design - **Professional** - Business-oriented with sidebar - **Creative** - Bold and colorful design ### Register Custom Templates [](#register-custom-templates) You can register your own templates using the Factory pattern: ``` use TomatoPHP\FilamentInvoices\Services\Templates\TemplateFactory; use TomatoPHP\FilamentInvoices\Contracts\InvoiceTemplateInterface; // In your service provider boot method TemplateFactory::register('my-custom', MyCustomTemplate::class); ``` Your custom template class must implement `InvoiceTemplateInterface`: ``` use TomatoPHP\FilamentInvoices\Contracts\InvoiceTemplateInterface; use TomatoPHP\FilamentInvoices\Services\Templates\AbstractTemplate; class MyCustomTemplate extends AbstractTemplate { public function getName(): string { return 'my-custom'; } public function getLabel(): string { return 'My Custom Template'; } public function getDescription(): string { return 'A custom invoice template'; } public function getViewPath(): string { return 'my-package::templates.custom'; } } ``` Export Invoice as PDF --------------------- [](#export-invoice-as-pdf) You can export invoices as PDF from: - The invoice view page (Export PDF button) - The invoices table (row action) - Bulk export multiple invoices as ZIP ### Programmatic PDF Generation [](#programmatic-pdf-generation) ``` use TomatoPHP\FilamentInvoices\Services\PdfGenerator; $pdfGenerator = app(PdfGenerator::class); // Generate PDF content $pdfContent = $pdfGenerator->generate($invoice, 'modern'); // Stream to browser return $pdfGenerator->stream($invoice, 'classic'); // Download file return $pdfGenerator->download($invoice, 'professional'); ``` Send Invoice via Email ---------------------- [](#send-invoice-via-email) Send invoices via email with PDF attachment from: - The invoice view page (Send Email button) - The invoices table (row action) - Bulk send to multiple invoices Email settings can be configured in the Invoice Settings page, including: - Default email subject and body templates - CC/BCC addresses - From name and email ### Available Placeholders [](#available-placeholders) Use these placeholders in email subject and body: - `{uuid}` - Invoice number - `{company_name}` - Your company name - `{customer_name}` - Customer name - `{total}` - Invoice total amount - `{currency}` - Currency code - `{due_date}` - Due date ### Programmatic Email Sending [](#programmatic-email-sending) ``` use TomatoPHP\FilamentInvoices\Mail\InvoiceMail; use Illuminate\Support\Facades\Mail; Mail::to('customer@example.com')->send(new InvoiceMail( invoice: $invoice, template: 'modern', cc: 'accounts@company.com', subject: 'Your Invoice #{uuid}', body: 'Dear {customer_name}, please find your invoice attached.' )); ``` Invoice Settings ---------------- [](#invoice-settings) The Invoice Settings page (accessible via Settings Hub when enabled) allows you to configure: ### Company Information [](#company-information) - Company name, logo, address - Phone, email, tax ID ### Default Settings [](#default-settings) - Default currency - Default tax rate - Default payment terms (days) ### Email Configuration [](#email-configuration) - From name and email - Email subject and body templates - CC/BCC addresses ### PDF Options [](#pdf-options) - Default template - Paper size (A4, Letter, Legal) - Terms and conditions text Use Facade Class To Create Invoice ---------------------------------- [](#use-facade-class-to-create-invoice) you can use this Facade class to create invoice like this ``` \TomatoPHP\FilamentInvoices\Facades\FilamentInvoices::create() ->for(\App\Models\Account::find(1)) ->from(\App\Models\Account::find(2)) ->dueDate(now()->addDays(7)) ->date(now()) ->items([ \TomatoPHP\FilamentInvoices\Services\Contracts\InvoiceItem::make('Item 1') ->description('Description 1') ->qty(2) ->price(100), \TomatoPHP\FilamentInvoices\Services\Contracts\InvoiceItem::make('Item 2') ->description('Description 2') ->qty(1) ->discount(10) ->vat(10) ->price(200), ])->save(); ``` Publish Assets -------------- [](#publish-assets) you can publish config file by use this command ``` php artisan vendor:publish --tag="filament-invoices-config" ``` you can publish views file by use this command ``` php artisan vendor:publish --tag="filament-invoices-views" ``` you can publish languages file by use this command ``` php artisan vendor:publish --tag="filament-invoices-lang" ``` you can publish migrations file by use this command ``` php artisan vendor:publish --tag="filament-invoices-migrations" ``` Other Filament Packages ----------------------- [](#other-filament-packages) Checkout our [Awesome TomatoPHP](https://github.com/tomatophp/awesome) ### Health Score 52 — FairBetter than 96% of packages Maintenance75 Regular maintenance activity Popularity38 Limited adoption so far Community19 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 69.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~69 days Recently: every ~115 days Total 8 Last Release 144d ago Major Versions v1.0.6 → 4.0.02025-12-19 PHP version history (2 changes)v1.0.0PHP ^8.1|^8.2 4.0.0PHP ^8.2|^8.3|^8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/2147eb2fca7ab5f0124d0fafd88ba2d2a5dfa3a0036fb8872d1084b7cba29366?d=identicon)[fadymondy](/maintainers/fadymondy) --- Top Contributors [![fadymondy](https://avatars.githubusercontent.com/u/11937812?v=4)](https://github.com/fadymondy "fadymondy (23 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![megoxv](https://avatars.githubusercontent.com/u/87904671?v=4)](https://github.com/megoxv "megoxv (2 commits)")[![pvictorlv](https://avatars.githubusercontent.com/u/10038242?v=4)](https://github.com/pvictorlv "pvictorlv (1 commits)")[![hammadzafar05](https://avatars.githubusercontent.com/u/75698921?v=4)](https://github.com/hammadzafar05 "hammadzafar05 (1 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")[![OccTherapist](https://avatars.githubusercontent.com/u/28587659?v=4)](https://github.com/OccTherapist "OccTherapist (1 commits)") --- Tags crmfilament-pluginsinvoicesphplaravelpaymentsinvoicesfilamentfilament-plugintomatophptomato-php ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/tomatophp-filament-invoices/health.svg) ``` [![Health](https://phpackages.com/badges/tomatophp-filament-invoices/health.svg)](https://phpackages.com/packages/tomatophp-filament-invoices) ``` ### Alternatives [tomatophp/filament-payments Manage your payments inside FilamentPHP app with multi payment gateway integration 542.3k](/packages/tomatophp-filament-payments)[tomatophp/filament-pwa get a PWA feature on your FilamentPHP app with settings from panel 8115.8k](/packages/tomatophp-filament-pwa)[tomatophp/filament-ecommerce Build your own ecommerce store with FilamentPHP with the Power of Tomato CMS Builder 964.4k1](/packages/tomatophp-filament-ecommerce)[tomatophp/filament-settings-hub Manage your Filament app settings with GUI and helpers 5746.1k9](/packages/tomatophp-filament-settings-hub)[tomatophp/filament-language-switcher Switch between languages on your app using user base column on database 3422.8k1](/packages/tomatophp-filament-language-switcher)[tomatophp/filament-api Generate APIs from your filament resource using single line of code 507.1k1](/packages/tomatophp-filament-api) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)