michael-orenda/fiscal

A Laravel 12 fiscal management module providing fiscal years, periods, closing rules, period locking, and API endpoints for accounting systems.

Maintainers

Details

github.com/michael-orenda/fiscal

Homepage

Source

Issues

Installs: 0

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

pkg:composer/michael-orenda/fiscal

v1.0.0 2025-12-06 11:09 UTC

Requires

Requires (Dev)

MIT 5a0bd0539b10b4ce1dab1a35c1e28e6c738f5dc8

  • Michael Orenda <rminchrist.woop@gmail.com>

laravelAccountingERPfiscalfiscal yearlaravel-packagemicrofinancesaccofinancial periodsgeneral ledgerperiod closingperiod locking

This package is auto-updated.

Last update: 2025-12-06 11:13:43 UTC

README

michael-orenda/fiscal is a lightweight Laravel 12 package for managing fiscal years, fiscal periods, and date validation for financial systems. It is designed as a reusable module for accounting, microfinance, ERP, and SACCO applications.

This package focuses on:

  • Generating fiscal years
  • Generating fiscal periods (Monthly, Quarterly, 4-4-5, or fully custom)
  • Opening, closing, and locking periods
  • Validating dates against fiscal rules
  • Providing clean API endpoints

Installation

composer require michael-orenda/fiscal

Configuration

php artisan vendor:publish --provider="MichaelOrenda\Fiscal\Providers\FiscalServiceProvider"

Database Migrations

Creates fiscal_years and fiscal_periods.

Usage Example

$fiscal = app(MichaelOrenda\Fiscal\Services\FiscalService::class);
$year = $fiscal->createYear('2025-01-01', 'monthly');

API Endpoints

  • GET /api/orenda/fiscal/years
  • POST /api/orenda/fiscal/years
  • GET /api/orenda/fiscal/years/{id}
  • POST /api/orenda/fiscal/periods/{id}/close
  • POST /api/orenda/fiscal/periods/{id}/lock
  • POST /api/orenda/fiscal/periods/{id}/open
  • POST /api/orenda/fiscal/validate-date