README

🧾 Laravel Invoice Engine

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.