vivek-mistry / laravel-invoice-engine

Global invoice engine for Laravel (tax, currency, number to words)

Maintainers

Details

github.com/vivek-mistry/laravel-invoice-engine

pkg:composer/vivek-mistry/laravel-invoice-engine

1.0.0 2025-12-18 14:41 UTC

Requires

php: ^8.2||^8.3||^8.4||^8.5
orchestra/testbench: ^10.0.0||^9.0.0
phpunit/phpunit: *

Requires (Dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT d1b022cc84d4ee7c3b49fc53059009bc3b896dba

Vivek Mistry <vickymistry1818.woop@gmail.com>

php invoice laravel Laravel-Invoice invoice-engine

dev-main
1.0.0

This package is auto-updated.

Last update: 2025-12-18 14:42:25 UTC

README

Global invoice utilities for Laravel

Tax
Discounts
Currency
Number to Words

🚀 Features

🌍 Multi-country tax (GST, VAT, Sales Tax)
💸 Percentage & flat discounts
🔢 Number to words (locale-based)
💱 Currency formatting (Intl)
🔄 Inclusive & exclusive tax
🧪 Fully tested (PHPUnit)
⚡ Fluent, developer-friendly API

🛠️ Installation

Install the package via Composer:

composer require vivek-mistry/laravel-invoice-engine

⚙️ Configuration (Optional)

php artisan vendor:publish --tag=invoice-config

🧮 Basic Usage

use Invoice;

Invoice::amount(1000)
    ->country('IN')
    ->taxRate(18)
    ->summary();

💸 Percentage Discount

Invoice::amount(1000)
    ->discountPercent(10)
    ->taxRate(18)
    ->summary();

💱 Flat Discount

Invoice::amount(1000)
    ->discountPercent(10)
    ->taxRate(18)
    ->summary();

🔄 Inclusive Tax

Invoice::amount(1180)
    ->inclusive(true)
    ->taxRate(18)
    ->summary();

🔢 Number to Words

Invoice::amount(1250)->words();

🌍 Supported Regions

🇮🇳 India (GST)
🇺🇸 USA (Sales Tax)
🇬🇧 UK (VAT)
🇪🇺 EU (VAT)
🇦🇪 UAE (VAT)

🧪 Testing

vendor/bin/phpuit

Change Logs

Initial Release

Credits

Vivek Mistry - Project creator and maintainer

License

MIT License. See LICENSE for details.