Finance teams running payroll on ERPNext hit a wall the moment they need a defensible end-of-service liability. ERPNext HR handles salary structures, payroll entries, and leave, but it has no native concept of a country-specific gratuity formula, no periodic accrual of the growing EOSB liability, and no final-settlement statement that reconciles gratuity, unpaid leave, notice-period adjustments, and outstanding dues into a single signed document. Most teams end up maintaining fragile spreadsheets that auditors distrust and that break the moment an employee resigns before completing a year, is terminated, or is paid in a different currency from the ledger.

ECOSIRE builds a proper Frappe app for this — a self-contained module you own outright, not a customization bolted onto core. At its heart is a Gratuity Rule DocType that encodes each jurisdiction's math as configurable slabs (for example UAE's 21-days-per-year for the first five years then 30 days thereafter, KSA's half-month/full-month split, Qatar's three-weeks minimum), including caps, eligibility thresholds, resignation-versus-termination multipliers, and the daily-wage basis. A scheduled End of Service Accrual job runs on a scheduler_events hook and posts periodic provision entries against a configurable liability account, so your balance sheet always reflects the true EOSB exposure rather than a year-end scramble. When an employee is separated, a Final Settlement DocType assembles the full FNF: earned gratuity, encashed or clawed-back leave, notice-period pay-in-lieu, pro-rated allowances, and deductions — all recomputed server-side.

Technically, the app ships as a versioned Frappe app installed with bench get-app and bench install-app. Calculation logic lives in whitelisted Python methods (@frappe.whitelist()) so it is callable from the Frappe REST API for downstream integrations and from client scripts on the form. hooks.py document events (on_submit, validate) keep GL postings and the linked Journal Entry in lockstep, while permission rules and a dedicated Role Profile keep gratuity provisioning visible only to HR and finance. Multi-currency settlement uses ERPNext's exchange-rate framework so an expatriate paid in USD but ledgered in AED settles at the correct booked rate. Print Formats produce an audit-ready settlement statement, and the whole thing is built and tested against Frappe/ERPNext v15 and v16.

Because this is build-to-order, nothing is a black box. We start with a short scoping call to confirm which countries, wage bases, and liability accounts you need, then build against your exact requirements. Typical delivery is one working week from confirmed scope. You receive the full source code, a UAT deployment on staging with a rollback plan, installation on your bench, technical and user documentation, a training session, and a post-go-live support window — plus the git repository so your team can extend it independently.