itmosoft / laravel-quotes
Quote requests, supplier quotations, negotiation, and acceptance workflows for Laravel applications.
Requires
- php: ^8.3
- illuminate/contracts: ^12.0|^13.0
- illuminate/database: ^12.0|^13.0
- illuminate/support: ^12.0|^13.0
- illuminate/validation: ^12.0|^13.0
Requires (Dev)
- orchestra/testbench: ^10.0|^11.0
- phpunit/phpunit: ^11.5|^12.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Quote requests, supplier quotations, negotiation revisions, and acceptance workflows for Laravel 12 and 13.
Requirements
- PHP 8.3+
- Laravel 12 or 13
Installation
composer require itmosoft/laravel-quotes php artisan vendor:publish --tag=quotes-config php artisan migrate
Laravel package discovery registers the service provider automatically.
Create a quote
Buyer and seller are polymorphic participants. The package does not require a specific customer, company, or supplier model.
use ItmoSoft\Quotes\Models\Quote; $quote = Quote::create([ 'number' => 'QT-2026-0001', 'buyer_type' => App\Models\Company::class, 'buyer_id' => $company->id, 'seller_type' => App\Models\Supplier::class, 'seller_id' => $supplier->id, 'currency' => 'USD', 'buyer_notes' => 'Please quote delivery to our warehouse.', ]); $quote->items()->create([ 'product_type' => App\Models\Product::class, 'product_id' => $product->id, 'description' => $product->name, 'quantity' => 20, 'unit_price' => 15.50, 'tax_rate' => 5, ]);
Workflow
// Buyer submits a request for quotation. $quote->requestQuote(); // Seller prepares and issues the quotation. $quote->issue(validUntil: now()->addDays(14)); // Buyer accepts or rejects the issued quotation. $quote->accept(); // or: $quote->reject('Price is above budget');
A seller can revise an issued or rejected quote:
$quote->startRevision(); $quote->items()->delete(); // Add revised items, then issue the new revision. $quote->issue(now()->addDays(14)->toDateTimeString());
The revision counter increments when a new revision starts. Applications
should preserve prior commercial versions separately if a legally auditable
quote history is required.
Expiry
Quotes with a valid_until timestamp cannot be accepted or rejected after
expiry. Run expireIfDue() from a scheduled command to persist the expired
status for issued quotes whose validity period has elapsed.
Totals
Line subtotal, tax, and total are recalculated when a quote is issued. Applications should not trust client-supplied totals.
Scope boundaries
This package manages quote documents and their lifecycle. It does not implement authentication, authorization, notifications, approval chains, contract generation, payments, inventory reservations, or a full immutable audit trail. Enforce participant access and permissions in your application.
Testing
composer install
composer test
License
MIT.