Looking to hire Laravel developers? Try LaraJobs

laravel-purchase-orders maintained by itmosoft

Description
Purchase order management for Laravel applications, with supplier-linked orders, line items, approvals, and partial goods receiving.
Last update
2026/11/17 12:58 (dev-main)
License
Links
Downloads
2

Comments
comments powered by Disqus

ITMOSOFT Laravel Purchase Orders

Supplier-linked purchase order management for Laravel 12 and 13.

Requirements

  • PHP 8.3+
  • Laravel 12 or 13
  • itmosoft/laravel-suppliers ^1.0

Installation

composer require itmosoft/laravel-purchase-orders
php artisan vendor:publish --tag=purchase-orders-config
php artisan migrate

Laravel package discovery registers the service provider automatically.

Basic usage

use ItmoSoft\PurchaseOrders\Models\PurchaseOrder;

$order = PurchaseOrder::create([
    'supplier_id' => $supplier->id,
    'currency' => 'USD',
    'expected_at' => now()->addDays(10),
    'notes' => 'Initial stock replenishment',
]);

$order->items()->create([
    'product_type' => App\Models\Product::class,
    'product_id' => $product->getKey(),
    'description' => $product->name,
    'quantity' => 25,
    'unit_cost' => 12.50,
    'tax_rate' => 5,
]);

$order->recalculateTotals();
$order->submit();
$order->approve();

Receiving goods

A receipt records what physically arrived. Multiple receipts can be attached to one approved purchase order, allowing partial deliveries.

$receipt = $order->receive([
    [
        'purchase_order_item_id' => $order->items()->first()->id,
        'quantity' => 10,
        'notes' => 'First delivery',
    ],
], receivedAt: now(), reference: 'GRN-1001');

After receiving, the order moves to partially_received or completed depending on whether all ordered quantities have been received. Receipt quantities cannot exceed the remaining ordered quantity.

Status lifecycle

  • draft: editable; can be submitted or cancelled.
  • submitted: awaiting approval; can be approved or cancelled.
  • approved: ready for receiving; can be received or cancelled if nothing has been received.
  • partially_received: some quantities received; can receive more or complete.
  • completed: all quantities received.
  • cancelled: terminal state.

Approval and receipt operations are intended to be called from application authorization-controlled workflows. This package does not implement user permissions, approval chains, inventory posting, or supplier portal access.

Money and quantity handling

Amounts are stored as decimal strings with two decimal places. Quantities are stored to three decimal places. The package calculates line subtotal, tax, and grand total on the server when recalculateTotals() is called. Applications should not trust client-submitted totals.

Configuration

Publish config/purchase-orders.php to customize model classes and table names.

Testing

composer install
composer test

Scope boundaries

This package manages purchasing documents and receiving records. It does not automatically increase inventory, create supplier invoices, pay suppliers, or synchronize external accounting systems. Connect those operations through application-level listeners or services.

License

MIT.