Looking to hire Laravel developers? Try LaraJobs

laravel-quotes maintained by itmosoft

Description
Quote requests, supplier quotations, negotiation, and acceptance workflows for Laravel applications.
Last update
2026/11/17 13:04 (dev-main)
License
Links
Downloads
2

Comments
comments powered by Disqus

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.