jeffersongoncalves/laravel-erp-buying

ERP buying — suppliers, RFQs, supplier quotations and purchase orders for the Laravel ERP ecosystem

dev-main 2026-06-28 02:36 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^11.0|^12.0|^13.0
• illuminate/database: ^11.0|^12.0|^13.0
• illuminate/events: ^11.0|^12.0|^13.0
• illuminate/support: ^11.0|^12.0|^13.0
• jeffersongoncalves/laravel-erp-accounting: dev-main
• jeffersongoncalves/laravel-erp-core: dev-main
• jeffersongoncalves/laravel-erp-stock: dev-main
• spatie/laravel-package-tools: ^1.15

Requires (Dev)

• larastan/larastan: ^2.9|^3.0
• laravel/pint: ^1.0
• nunomaduro/collision: ^8.0
• orchestra/testbench: ^9.0|^10.0|^11.0
• pestphp/pest: ^3.0|^4.0
• pestphp/pest-plugin-laravel: ^3.0|^4.0

MIT

• Jefferson Gonçalves

• laravel
• ERP
• supplier
• procurement
• ERPNext
• purchase-order
• buying

README

Laravel ERP Buying

ERP buying — suppliers, RFQs, supplier quotations and purchase orders for the Laravel ERP ecosystem.

This package is the buying/procurement module of an ERPNext-native rebuild. It builds on laravel-erp-core, laravel-erp-accounting and laravel-erp-stock.

Features

• Masters — supplier groups (hierarchical) and suppliers, with polymorphic addresses and contacts from core.
• Request for Quotation — submittable RFQs with item lines and invited suppliers.
• Supplier Quotation — submittable quotations with item lines and live totals.
• Purchase Order — submittable orders with per-received / per-billed tracking and order status.
• Conversions — turn a Purchase Order into a stock Purchase Receipt or an accounting Purchase Invoice, and turn a Supplier Quotation into a Purchase Order.

Buying documents are commitments: they follow the ERPNext submit/cancel lifecycle but do not post to the general or stock ledger themselves. Inventory and accounting impact is realised only when the downstream Purchase Receipt or Purchase Invoice is submitted.

Installation

composer require jeffersongoncalves/laravel-erp-buying

Publish and run the migrations:

php artisan vendor:publish --tag="erp-buying-migrations"
php artisan migrate

Optionally publish the config:

php artisan vendor:publish --tag="erp-buying-config"

Conversions

use JeffersonGoncalves\Erp\Buying\Services\PurchaseOrderService;
use JeffersonGoncalves\Erp\Buying\Services\SupplierQuotationService;

$receipt = app(PurchaseOrderService::class)->createPurchaseReceipt($purchaseOrder);
$invoice = app(PurchaseOrderService::class)->createPurchaseInvoice($purchaseOrder);
$order = app(SupplierQuotationService::class)->createPurchaseOrder($supplierQuotation);

Testing

composer test

Changelog

Please see CHANGELOG for what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Jefferson Simão Gonçalves
• All Contributors

License

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