technohub92 / laravel-fbr-di

dev-main 2026-10-09 07:07 UTC

Requires

• php: ^8.2 || ^8.3 || ^8.4 || ^8.5
• guzzlehttp/guzzle: ^7.8
• illuminate/console: ^10.0 || ^11.0 || ^12.0 || ^13.0
• illuminate/http: ^10.0 || ^11.0 || ^12.0 || ^13.0
• illuminate/support: ^10.0 || ^11.0 || ^12.0 || ^13.0

Requires (Dev)

• orchestra/testbench: ^8.0 || ^9.0 || ^10.0 || ^11.0
• phpunit/phpunit: ^10.0 || ^11.0 || ^12.0

MIT

• TechnoHub Team

Published on Packagist.org on 2026-10-09 07:25 UTC

README

Fluent, production-ready Laravel SDK for integrating Pakistani FBR PRAL Digital Invoicing (SRO 350/2024 & SRO 1832/2024) directly into any Laravel application, ERP, billing platform, or e-commerce shop.

Key Features

• Auto-Discovery: Installs in seconds with Laravel 10, 11, 12, and 13+.
• Fluent Invoice Builder: Intuitive, chained API (FbrDI::invoice()) for issuing PRAL certified invoices.
• Interactive CLI Setup: php artisan fbr:setup connects to the gateway and checks credentials interactively.
• Active Taxpayer Lookup: FbrDI::verifyTaxpayer('3520248796577') checks ATL compliance on the fly.
• Zero-Contamination Sanitizer: Automatically cleanses payloads to guarantee 100% PRAL v1.12 specification compliance.
• Automatic Sandbox / Production Toggle: Switch modes seamlessly via .env.

Installation

composer require technohub92/laravel-fbr-di

Interactive Setup

Run the setup command to configure your API key and verify connection:

php artisan fbr:setup

Or publish configuration manually:

php artisan vendor:publish --tag=fbr-di-config

🛠️ Configuration (.env)

FBR_DI_API_KEY=fbr_live_xxxxxxxxxxxxxxxxxxxxxxxx
FBR_DI_BASE_URL=https://invoicehub.pk/api
FBR_DI_ENVIRONMENT=sandbox # or 'production'

💻 Usage Examples

1. Issue an FBR Certified Invoice

use FbrDI\Facades\FbrDI;
use FbrDI\Builders\InvoiceItemBuilder;

$response = FbrDI::invoice()
    ->invoiceType('Sale Invoice')
    ->scenario('SN001')
    ->invoiceRefNo('INV-2026-0098')
    ->invoiceDate(now())
    ->buyer(fn ($buyer) => $buyer
        ->ntnOrCnic('4210112345671')
        ->businessName('Al-Madina Industrial Traders')
        ->province('Sindh')
        ->address('Plot 14, S.I.T.E Area, Karachi')
        ->registered()
    )
    ->addItem(fn (InvoiceItemBuilder $item) => $item
        ->hsCode('8471.3010')
        ->description('Enterprise Server Terminal')
        ->quantity(2)
        ->uom('Numbers')
        ->unitPrice(120000)
        ->taxRate(18.00)
    )
    ->submit();

if ($response->isSuccessful()) {
    $fbrInvoiceNumber = $response->fbrInvoiceNumber();
    $qrSvg = $response->qrSvg();
    $qrUrl = $response->qrUrl();
} else {
    logger()->error('FBR DI Error:', $response->errors());
}

2. Verify Taxpayer Active Status (ATL)

$taxpayer = FbrDI::verifyTaxpayer('3520248796577');

if ($taxpayer->isSuccessful()) {
    $data = $taxpayer->raw();
    // ['is_active' => true, 'business_name' => '...', 'category' => 'Corporate']
}

3. Artisan Commands

# Test gateway connection and check for SDK updates
php artisan fbr:test-connection

# Check ATL Active status from terminal
php artisan fbr:verify-taxpayer 3520248796577

📄 License

The MIT License (MIT). Please see License File for more information.