PHPackages                             crmleaf/fnf-calculator - 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. crmleaf/fnf-calculator

ActiveLibrary

crmleaf/fnf-calculator
======================

Full and final settlement: dues, gratuity, leave, notice pay and deductions.

v1.0.0(today)00[1 PRs](https://github.com/CrmLeaf/fnf-calculator/pulls)MITPHPPHP ^8.2CI passing

Since Aug 14Pushed todayCompare

[ Source](https://github.com/CrmLeaf/fnf-calculator)[ Packagist](https://packagist.org/packages/crmleaf/fnf-calculator)[ Docs](https://www.indpayroll.com/free-tools/fnf-calculator)[ RSS](/packages/crmleaf-fnf-calculator/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (5)Versions (3)Used By (0)

F&F Settlement Calculator
=============================

[](#ff-settlement-calculator)

Full and final settlement: dues, gratuity, leave, notice pay and deductions.

Assembles a full and final settlement end to end: salary for the days worked, gratuity, leave encashment, notice pay or notice recovery, other earnings and recoveries, then the deductions on the lot.

One of the [CRMLeaf payroll tools](https://github.com/crmleaf). The arithmetic and the dated statutory rate tables live in [`crmleaf/payroll-core`](https://github.com/crmleaf/payroll-core); this package is the thin skin that makes one calculator installable, mountable and embeddable on its own.

Note

A wrong figure or an out-of-date rate is almost always a [`payroll-core`](https://github.com/crmleaf/payroll-core/issues) matter, since that is where the tables live. Anything about this tool's routes, views or browser asset belongs here.

Install
-------

[](#install)

**Composer** - Laravel auto-discovers the service provider, so this is the whole setup:

```
composer require crmleaf/fnf-calculator
```

**npm** - the same calculation, re-exported from `@crmleaf/payroll-js` so you can install this one tool and nothing else:

```
npm install @crmleaf/fnf-calculator
```

Note

Not on npm yet. The script-tag route below needs no registry and works today. Installing this package straight from git will not resolve `@crmleaf/payroll-js`, which is not published yet either.

**A plain script tag** - no build step, no bundler, no server. Build the browser bundle once and serve the file yourself:

```

const result = CrmleafPayroll.fnf({
  monthlyGross: 75000,
  monthlyBasic: 30000,
  joiningDate: "2018-06-01",
  lastWorkingDate: "2025-08-14",
  leaveDaysBalance: 18,
});
console.log(result.explain);

```

`payroll.min.js` is the single-file browser build. Get it by running `npm run build` in [`@crmleaf/payroll-js`](https://github.com/crmleaf/payroll-js) and copying `dist/payroll.min.js`into whatever your site serves as static assets.

> A hosted CDN build is coming soon, which will reduce this to a single URL. Serving the file yourself works today and keeps working afterwards - it is the only option that needs no third-party request, so plenty of projects will want to stay on it.

### See it working first

[](#see-it-working-first)

`demo/index.html` in this repository is a working copy of F&F Settlement Calculator in one file: the form, the calculation and the working, with no build step and no server. Drop `payroll.min.js` beside it and open it from disk.

```
cp /path/to/payroll-js/dist/payroll.min.js demo/
open demo/index.html
```

Nothing on that page reaches the network, which is the point: it is a calculator people paste salary figures into.

Use it
------

[](#use-it)

**Plain PHP**, no framework and no container:

```
use Crmleaf\Payroll\Calculators\FnfCalculator;
use Crmleaf\Payroll\Money;

$result = (new FnfCalculator())->calculate(
    monthlyGross: Money::fromRupees(75_000),
    monthlyBasic: Money::fromRupees(30_000),
    joiningDate: new \DateTimeImmutable('2018-06-01'),
    lastWorkingDate: new \DateTimeImmutable('2025-08-14'),
    leaveDaysBalance: 18,
);

echo $result->explain();      // the formula with the real operands in it
echo $result->workings();     // every step, one per line, with its citation
print_r($result->toArray());  // snake_case, ready for JSON
```

**Laravel** - resolve it from the container, or type-hint it anywhere:

```
use Crmleaf\Payroll\Calculators\FnfCalculator;

public function show(FnfCalculator $calculator)
{
    return $calculator->calculate(
        monthlyGross: Money::fromRupees(75_000),
        monthlyBasic: Money::fromRupees(30_000),
        joiningDate: new \DateTimeImmutable('2018-06-01'),
        lastWorkingDate: new \DateTimeImmutable('2025-08-14'),
        leaveDaysBalance: 18,
    )->toArray();
}
```

**Blade** - one component, no controller:

```

```

**HTTP** - off by default. Publish the config and turn the route on:

```
php artisan vendor:publish --tag=fnf-calculator-config
```

```
// config/fnf-calculator.php
'route' => ['enabled' => true, 'prefix' => 'tools'],
```

```
curl -X POST https://example.test/tools/fnf-calculator \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"monthly_gross":75000,"monthly_basic":30000,"joining_date":"2018-06-01","last_working_date":"2025-08-14","leave_days_balance":18}'
```

The JSON response carries the figures, the working and the statutory citations:

```
{
  "tool": "fnf-calculator",
  "data": { "…": "every figure, snake_case, with a *_formatted twin" },
  "explain": "the formula with the real operands substituted",
  "working": [{ "label": "…", "amount": 0, "formula": "…", "citation": "…" }],
  "citations": ["…"]
}
```

**JavaScript**:

```
import { fnf } from '@crmleaf/fnf-calculator';

const result = fnf({
  monthlyGross: 75000,
  monthlyBasic: 30000,
  joiningDate: "2018-06-01",
  lastWorkingDate: "2025-08-14",
  leaveDaysBalance: 18,
});
```

No server needed
----------------

[](#no-server-needed)

The maths here is arithmetic over versioned rate tables, so it runs anywhere. The published asset binds the markup and computes in the browser:

```
php artisan vendor:publish --tag=fnf-calculator-assets
```

```

   …

```

If the browser build is absent the script does nothing and the form posts to the server instead, so the page works either way.

Inputs
------

[](#inputs)

FieldTypeRequiredDefaultNotes`monthly_gross`money (₹)Yes`75000``monthly_basic`money (₹)Yes`30000``joining_date`date (YYYY-MM-DD)Yes`"2018-06-01"``last_working_date`date (YYYY-MM-DD)Yes`"2025-08-14"``unpaid_days`integerNo`0``leave_days_balance`integerNo`18``notice_period_days`integerNo`60``notice_days_served`integerNo`60`Short notice becomes a recovery; notice waived by the employer becomes notice pay.`other_earnings`money (₹)No-Incentives, reimbursements or an ex gratia amount.`recoveries`money (₹)No-Advances, asset dues or a training bond.`separation_reason`one of `resignation`, `retirement`, `superannuation`, `termination`, `retrenchment`, `death`, `disablement`No`"resignation"``covered`booleanNo`true``state`stringNo`"Karnataka"``as_of`date (YYYY-MM-DD)No-Optional fields you leave out are omitted from the call entirely, so the calculator's own documented defaults apply.

Every figure here rests on a statutory rate, so the call takes `as_of`. Set it and the calculation runs on the rates in force on that date, which is what makes a prior year recomputable rather than merely rememberable.

Statutory basis
---------------

[](#statutory-basis)

Payment of Gratuity Act 1972; Income-tax Act 1961 section 10(10AA); the Shops and Establishments Act of the state for the settlement deadline; the professional tax schedule of the state for the final month.

Rates are data, not code: they live in dated tables with a cited source in `crmleaf/payroll-core`, so a rate change is a new dated entry rather than an edit to a constant.

Important

This package implements our reading of the applicable statutes and is provided without warranty. It is a calculation library, not tax advice. Verify against your own compliance obligations before relying on the output for statutory filing.

Publishing
----------

[](#publishing)

TagPublishes`fnf-calculator-config``config/fnf-calculator.php``fnf-calculator-views``resources/views/vendor/fnf-calculator``fnf-calculator-assets``public/vendor/fnf-calculator`Licence
-------

[](#licence)

[MIT](LICENSE) © CRMLeaf. Use it commercially, embed it, fork it.

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/315788704?v=4)[crmleaf](/maintainers/crmleaf)[@CrmLeaf](https://github.com/CrmLeaf)

---

Top Contributors

[![andolasoftuser196](https://avatars.githubusercontent.com/u/145565449?v=4)](https://github.com/andolasoftuser196 "andolasoftuser196 (8 commits)")

---

Tags

exitfull-and-finalindiapayrollsettlementindiaexitpayrollsettlementfull-and-final

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/crmleaf-fnf-calculator/health.svg)

```
[![Health](https://phpackages.com/badges/crmleaf-fnf-calculator/health.svg)](https://phpackages.com/packages/crmleaf-fnf-calculator)
```

###  Alternatives

[phplang/scope-exit

Emulation of SCOPE\_EXIT construct from C++

1913.6M4](/packages/phplang-scope-exit)[razorpay/magento

Razorpay Magento 2.0 plugin for accepting payments.

3080.1k1](/packages/razorpay-magento)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)