Laravel ERP Core

ERP core — companies, currencies, units, and the submittable-document foundation for the Laravel ERP ecosystem.

This package is the foundation of an ERPNext-native rebuild. It ships the master-data Eloquent models, migrations, enums, and the reusable "submittable document" concerns (IsSubmittable, HasNamingSeries, HasCompany) that every other erp-* package builds upon.

Features

• Master Data Models — Companies, currencies, currency exchange rates, units of measure, UOM conversions, fiscal years, departments, designations, brands, terms & conditions, addresses, and contacts
• Submittable Documents — ERPNext-style Draft → Submitted → Cancelled lifecycle via the IsSubmittable concern, with immutability guarantees and ledger-posting hooks
• Naming Series — Pattern-based document identifiers (SINV-.YYYY.-) with safe, per-series incrementing counters
• Polymorphic Addresses & Contacts — Attach addresses and contacts to any model
• Customizable Models — Override any model via config while maintaining contract compliance (ModelResolver pattern)
• Table Prefix — Configurable table prefix to avoid naming collisions (default: erp_)
• Contracts & Events — PostsToLedger, SubmittableDocument, DocumentSubmitted, DocumentCancelled
• Translations — English and Brazilian Portuguese

Compatibility

Installation

composer require jeffersongoncalves/laravel-erp-core

Publish and run the migrations:

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

Publish the config (optional):

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

Submittable Documents

Add the IsSubmittable concern to any model with a docstatus column cast to DocStatus:

use Illuminate\Database\Eloquent\Model;
use JeffersonGoncalves\Erp\Core\Concerns\IsSubmittable;
use JeffersonGoncalves\Erp\Core\Contracts\SubmittableDocument;
use JeffersonGoncalves\Erp\Core\Enums\DocStatus;

class SalesInvoice extends Model implements SubmittableDocument
{
    use IsSubmittable;

    protected $casts = ['docstatus' => DocStatus::class];
}

$invoice->submit();   // Draft → Submitted, dispatches DocumentSubmitted
$invoice->cancel();   // Submitted → Cancelled, dispatches DocumentCancelled

A submitted document is immutable: any update (other than the controlled transition to cancelled) or delete throws a DomainException. If the model also implements PostsToLedger, postLedgerEntries() is called on submit and reverseLedgerEntries() on cancel.

Naming Series

use JeffersonGoncalves\Erp\Core\Concerns\HasNamingSeries;

class SalesInvoice extends Model
{
    use HasNamingSeries;

    protected function namingSeriesPattern(): ?string
    {
        return 'SINV-.YYYY.-';
    }
}

// On create with an empty `name`: SINV-2026-00001, SINV-2026-00002, ...

Database Tables

All tables use the configured prefix (default: erp_):

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.