laravel-quotes maintained by itmosoft
ITMOSOFT Laravel Quotes
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.