PHPackages azaharizaman/nexus-payable - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. azaharizaman/nexus-payable ActiveLibrary[Utility & Helpers](/categories/utility) azaharizaman/nexus-payable ========================== Nexus Payable Package - Framework-agnostic accounts payable management v0.1.0-alpha1(1mo ago)02↓100%1MITPHPPHP ^8.3 Since May 5Pushed 1mo agoCompare [ Source](https://github.com/azaharizaman/nexus-payable)[ Packagist](https://packagist.org/packages/azaharizaman/nexus-payable)[ RSS](/packages/azaharizaman-nexus-payable/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependenciesVersions (2)Used By (1) Nexus\\Payable ============== [](#nexuspayable) [![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)[![PHP Version](https://camo.githubusercontent.com/c8d8dad6beb757a2b8acba331d16140813699543b88a37af0a81f20bd35f61de/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e332532422d626c7565)](https://php.net) Framework-agnostic accounts payable, vendor bill management, 3-way matching, and payment processing for the Nexus ERP system. Overview -------- [](#overview) The `Nexus\Payable` package provides comprehensive accounts payable (AP) functionality including: - **Vendor Management**: Complete vendor lifecycle with configurable payment terms and matching tolerances - **Bill Processing**: Vendor bill submission via manual entry or CSV import (OCR planned for Phase 2) - **3-Way Matching**: Automated matching of Purchase Orders, Goods Received Notes, and Vendor Invoices - **Payment Scheduling**: Automated due date calculation with early payment discount tracking - **GL Integration**: Seamless posting to `Nexus\Finance` general ledger - **Multi-Currency Support**: Full currency conversion via `Nexus\Currency` - **Audit Trail**: Comprehensive change tracking via `Nexus\AuditLogger` Key Features ------------ [](#key-features) ### Enterprise-Grade AP Management [](#enterprise-grade-ap-management) - **Per-Vendor Tolerance Configuration**: Configure quantity and price variance thresholds per vendor - **Flexible Payment Terms**: Net 30, 2/10 Net 30, COD, and custom terms - **Multi-Currency Bills**: Store bills in original currency with base currency equivalent - **Payment Reconciliation**: Automatic matching of payments to GL postings - **Aging Reports**: 30/60/90-day vendor aging analysis ### 3-Way Matching Engine [](#3-way-matching-engine) The matching engine validates vendor bills against: 1. **Purchase Order (PO)** from `Nexus\Procurement` - Expected quantity and agreed price 2. **Goods Received Note (GRN)** from `Nexus\Inventory` - Actual received quantity 3. **Vendor Invoice** - Billed quantity and price Configurable per-vendor tolerance rules prevent GL posting when variances exceed thresholds. ### Payment Processing [](#payment-processing) - Automated payment scheduling with due date calculation - Early payment discount tracking and alerts - GL journal entry generation via `Nexus\Finance` - Payment approval workflows (optional via `Nexus\Workflow`) - Bank transfer file generation (Phase 2) Architecture ------------ [](#architecture) This package follows the **Nexus Architecture Principle**: "Logic in Packages, Implementation in Applications." ### Package Layer (Pure PHP) [](#package-layer-pure-php) - **Framework-agnostic**: No Laravel dependencies - **Business Logic**: All AP rules, matching algorithms, payment calculations - **Interfaces**: Defines data structures and persistence contracts - **Value Objects**: Immutable domain objects (PaymentTerm, MatchingTolerance, etc.) - **Services**: PayableManager, MatchingEngine, PaymentScheduler for orchestration ### Application Layer (Laravel/Atomy) [](#application-layer-laravelatomy) - **Eloquent Models**: Vendor, VendorBill, VendorBillLine, BillMatching, PaymentSchedule - **Repository Implementations**: Concrete persistence implementations - **Database Migrations**: Schema definitions - **Service Provider**: IoC container bindings - **API Controllers**: RESTful endpoints for AP operations Installation ------------ [](#installation) ``` composer require azaharizaman/nexus-payable:"*@dev" ``` Requirements ------------ [](#requirements) - **PHP**: ^8.3 - **Dependencies**: - `azaharizaman/nexus-finance` - General ledger integration - `azaharizaman/nexus-period` - Fiscal period validation - `azaharizaman/nexus-uom` - Unit of measurement (currency) - `azaharizaman/nexus-currency` - Multi-currency support - `azaharizaman/nexus-audit-logger` - Change tracking - `psr/log` - Logging interface Core Concepts ------------- [](#core-concepts) ### Vendor Management [](#vendor-management) ``` use Nexus\Payable\Contracts\PayableManagerInterface; $payableManager = app(PayableManagerInterface::class); // Create vendor with payment terms and tolerance $vendor = $payableManager->createVendor([ 'code' => 'VEND-001', 'name' => 'ABC Supplies Ltd', 'payment_terms' => 'net_30', 'qty_tolerance_percent' => 5.0, 'price_tolerance_percent' => 2.0, 'tax_id' => '12-3456789', 'bank_details' => [ 'account_number' => '1234567890', 'bank_name' => 'ABC Bank', 'swift_code' => 'ABCMYKL' ] ]); ``` ### Bill Submission [](#bill-submission) ``` // Submit vendor bill for matching $bill = $payableManager->submitBill([ 'vendor_id' => $vendor->getId(), 'bill_number' => 'INV-2025-001', 'bill_date' => '2025-11-20', 'due_date' => '2025-12-20', 'currency' => 'USD', 'lines' => [ [ 'description' => 'Office Supplies', 'quantity' => 100, 'unit_price' => 25.00, 'gl_account' => '5100-10', 'po_line_reference' => 'PO-2025-001-L1' ] ] ]); ``` ### 3-Way Matching [](#3-way-matching) ``` use Nexus\Payable\Contracts\ThreeWayMatcherInterface; $matcher = app(ThreeWayMatcherInterface::class); // Perform matching against PO and GRN $matchResult = $matcher->match($bill->getId()); if ($matchResult->isMatched()) { // Bill can be posted to GL $payableManager->postBillToGL($bill->getId()); } else { // Review variances manually $variances = $matchResult->getVariances(); } ``` ### Payment Processing [](#payment-processing-1) ``` // Schedule payment $schedule = $payableManager->schedulePayment($bill->getId()); // Process payment and post to GL $payment = $payableManager->processPayment($schedule->getId(), [ 'payment_date' => '2025-12-15', 'payment_method' => 'bank_transfer', 'bank_account' => '1000-01', 'reference' => 'PAY-2025-001' ]); ``` Directory Structure ------------------- [](#directory-structure) ``` src/ ├── Contracts/ # 6 Interfaces │ ├── PayableManagerInterface.php │ ├── VendorRepositoryInterface.php │ ├── VendorBillRepositoryInterface.php │ ├── ThreeWayMatcherInterface.php │ ├── PaymentSchedulerInterface.php │ └── PaymentAllocationInterface.php ├── Services/ # Business logic │ ├── PayableManager.php │ ├── VendorManager.php │ ├── BillProcessor.php │ ├── MatchingEngine.php │ ├── PaymentScheduler.php │ └── PaymentProcessor.php ├── ValueObjects/ # Immutable domain objects │ ├── VendorBillNumber.php │ ├── PaymentTerm.php (enum) │ ├── MatchingTolerance.php │ ├── VendorStatus.php (enum) │ ├── BillStatus.php (enum) │ ├── MatchingStatus.php (enum) │ └── PaymentStatus.php (enum) └── Exceptions/ # Domain exceptions ├── PayableException.php (base) ├── VendorNotFoundException.php ├── BillNotFoundException.php ├── BillAlreadyMatchedException.php ├── MatchingToleranceExceededException.php ├── ThreeWayMatchFailedException.php ├── InvalidPaymentTermException.php ├── PaymentScheduleException.php └── InsufficientCreditException.php ``` Integration with Nexus Packages ------------------------------- [](#integration-with-nexus-packages) ### Required Dependencies [](#required-dependencies) - **Nexus\\Finance**: GL journal entry posting for AP liability and expense accounts - **Nexus\\Period**: Fiscal period validation for bill dating - **Nexus\\Uom**: Currency management and conversion - **Nexus\\Currency**: Exchange rate resolution for multi-currency bills - **Nexus\\AuditLogger**: Audit trail for all AP state changes ### Optional Dependencies [](#optional-dependencies) - **Nexus\\Procurement**: Purchase Order data for 3-way matching - **Nexus\\Inventory**: Goods Received Note data for 3-way matching - **Nexus\\Workflow**: Multi-level payment approval workflows - **Nexus\\DataProcessor**: OCR for automated bill data extraction (Phase 2) - **Nexus\\EventStream**: Event sourcing for payment lifecycle (large enterprises) Consumed By ----------- [](#consumed-by) - **Nexus\\Accounting**: Financial statement generation (AP aging reports) - **Nexus\\Export**: Payment advice document generation Performance Requirements ------------------------ [](#performance-requirements) - Bill submission and validation: < 200ms per bill - 3-way matching: < 500ms for 100-line bill - Payment scheduling: < 100ms per payment - GL posting: < 300ms (via Finance package) - Vendor aging report: < 3s for 10,000 bills Security & Compliance ------------------------- [](#security--compliance) - **Immutable Bills**: Once matched and posted, bills cannot be modified (reversal only) - **Tenant Isolation**: All data scoped to tenant ID - **Audit Trail**: All state changes logged to `Nexus\AuditLogger` - **Field-Level Encryption**: Bank details encrypted at rest - **RBAC Integration**: Authorization via `Nexus\Identity` (application layer) Roadmap ------- [](#roadmap) ### Phase 1 (Current - V1.0) [](#phase-1-current---v10) - ✅ Vendor management with configurable tolerances - ✅ Manual bill submission and CSV import - ✅ 3-way matching engine - ✅ Payment scheduling and GL integration - ✅ Multi-currency support ### Phase 2 (Future) [](#phase-2-future) - ⏳ OCR integration via `Nexus\DataProcessor` - ⏳ Payment approval workflows via `Nexus\Workflow` - ⏳ Bank transfer file generation - ⏳ Automatic payment reminders - ⏳ Vendor portal for self-service bill submission ### Phase 3 (Enterprise) [](#phase-3-enterprise) - ⏳ Event sourcing via `Nexus\EventStream` - ⏳ Advanced analytics and forecasting - ⏳ Batch payment processing - ⏳ ACH/wire transfer integration Testing ------- [](#testing) ``` # Run package tests vendor/bin/phpunit packages/Payable/tests # Run application integration tests php artisan test --filter=Payable ``` --- 📖 Documentation --------------- [](#-documentation) ### Package Documentation [](#package-documentation) - **[Getting Started Guide](docs/getting-started.md)** - Quick start guide with prerequisites, core concepts (3-way matching, payment terms), and first integration - **[API Reference](docs/api-reference.md)** - Complete documentation of all 21 interfaces, 5 enums, 2 value objects, and 8 exceptions - **[Integration Guide](docs/integration-guide.md)** - Laravel and Symfony integration examples with complete code - **[Basic Usage Example](docs/examples/basic-usage.php)** - Simple vendor bill creation and payment processing - **[Advanced Usage Example](docs/examples/advanced-usage.php)** - 3-way matching, payment scheduling, variance handling ### Additional Resources [](#additional-resources) - `IMPLEMENTATION_SUMMARY.md` - Implementation progress, architecture, and metrics - `REQUIREMENTS.md` - Detailed requirements (128 requirements documented) - `TEST_SUITE_SUMMARY.md` - Test coverage strategy and planned tests (83 tests) - `VALUATION_MATRIX.md` - Package valuation metrics ($190,710 estimated value) - See root `ARCHITECTURE.md` for overall system architecture - See `docs/NEXUS_PACKAGES_REFERENCE.md` for integration with other Nexus packages --- License ------- [](#license) MIT License - see LICENSE file for details. Support ------- [](#support) Part of the Nexus ERP Monorepo. - Main Documentation: See package `docs/` folder - Architecture: See root `/ARCHITECTURE.md` - Package Reference: See `docs/NEXUS_PACKAGES_REFERENCE.md` ### Health Score 36 — LowBetter than 79% of packages Maintenance93 Actively maintained with recent releases Popularity3 Limited adoption so far Community11 Small or concentrated contributor base Maturity34 Early-stage or recently created project Bus Factor1 Top contributor holds 76.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 36d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/117408?v=4)[Azahari Zaman](/maintainers/azaharizaman)[@azaharizaman](https://github.com/azaharizaman) --- Top Contributors [![azaharizaman](https://avatars.githubusercontent.com/u/117408?v=4)](https://github.com/azaharizaman "azaharizaman (464 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (141 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)") ### Embed Badge ![Health badge](/badges/azaharizaman-nexus-payable/health.svg) ``` [![Health](https://phpackages.com/badges/azaharizaman-nexus-payable/health.svg)](https://phpackages.com/packages/azaharizaman-nexus-payable) ``` ### Alternatives [tackk/cartographer A PHP sitemap generation tool. 325492.4k3](/packages/tackk-cartographer) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)