Most HR and finance teams that offer staff loans or salary advances on ERPNext end up managing them in spreadsheets, ad-hoc journal entries and manual Additional Salary rows. ERPNext's core Loan Management (now split into the separate hrms/lending apps) is oriented toward formal lending products and full interest accrual, and its behaviour shifts between v14, v15 and v16 — so a simple case like "advance one month's salary, recover it over four payslips, and stop automatically when the balance hits zero" becomes fragile. The moment an employee leaves mid-schedule, takes a top-up loan, or requests early settlement, the manual approach drifts out of sync with the general ledger and with payroll.

ECOSIRE builds a dedicated Frappe app that models this properly on top of ERPNext. We ship a real installable app — its own module, DocTypes and hooks.py — rather than a pile of untracked customisations, so it upgrades cleanly and lives in a git repo you own. The core is an Employee Loan/Salary Advance DocType carrying a submittable workflow (Draft → Applied → Approved → Disbursed → Closed) governed by Frappe's Workflow engine and role-based permissions, plus a child Loan Installment table that computes each period's principal, interest and running balance. Approval and disbursement are wired through on_submit and on_update_after_submit doc events; a scheduler_events entry in hooks.py refreshes overdue and closing states on a daily cron.

Recovery is the part that has to be airtight. On each payroll run the app injects the due installment as a deduction component on the Salary Slip — either through a Salary Component whose amount is driven by a server-side formula, or via a Salary Slip doc-event hook that reads the employee's active schedule, posts the deduction, decrements the outstanding balance, and marks the installment paid. Interest (flat or reducing-balance), prepayments and lump-sum settlements are handled explicitly: an early payment re-amortises the remaining schedule and closes the loan when the ledger reaches zero. Every employee gets an outstanding-balance ledger and statement, and finance gets a portfolio report of all active loans, disbursed principal, recovered-to-date and remaining exposure. Whitelisted methods expose apply, approve and balance-enquiry over the Frappe REST API so an ESS portal or mobile flow can drive the same logic, and client scripts keep the loan form's live schedule preview in sync as the amount or tenure changes.

Because this is build-to-order, nothing is a generic download. We start from a short scoping call, confirm your exact rules — eligibility caps, interest policy, max concurrent loans, approval hierarchy, GL accounts and your ERPNext version (v15 or v16) — then build to that spec. You receive the installable app, install and configuration on your bench, technical and user documentation, UAT on a staging site with a rollback plan, and a post-go-live support window. Typical delivery is one working week from confirmed scope, and the source is handed over in a git repository you keep.