Benefit plans and benefit accrual

A benefit plan is a project's ready-made list of the benefits the developer pays an allottee: corpus fund, transit rent, shifting charges, and whatever else the redevelopment terms promise. A rehab officer applies a plan to a draft offer and the plan's lines fill the offer's Benefits, worked out for that allottee. Benefit accrual happens later, on the accounting side: when a Member Benefits payout run is drafted, each benefit installment that has fallen due is booked as an expense and as a bill on the member's ledger, and the payout then settles those bills.

How it works in NirmaanOne

What a plan holds

Plans live on the project's Tenant Benefits tab, one list per project, each with a Plan name (unique in the project), an optional Description and an Active flag (inactive plans are hidden from the apply dialog). Each line of a plan is:

• a Benefit: a charge component of the Tenant Benefit kind (the seeded ones are Corpus Fund, Transit Rent and Shifting Charges; add more under Masters, Charge Components, or with New benefit type… on the offer). The picker lists Tenant Benefit components only.
• Worked out as: Fixed amount, the amount per installment; or Per sq ft of existing carpet, a rate per square foot of the allottee's existing carpet area.
• Amount / rate.
• Cadence: a calendar cadence, one of Lumpsum, Weekly, Monthly, Quarterly, Half-yearly or Yearly. Construction Linked is not offered. Custom Dates is offered in the plan editor, but an offer refuses a benefit line with that cadence when it is saved ("Custom Dates rows are dated through a payment plan, not a rule"), so don't use it on a plan.
• Installments, fixed to 1 for Lumpsum, required otherwise (Save stays greyed out with "line <n>: how many installments").
• Due day: 1 to 31, or -1 for the last day of the month, used for the second installment onwards on monthly and longer cadences.
• An Increase (optional, recurring cadences only): Percent or Fixed amount with the step, Every (months) (blank = 12) and Paid as (Spread into installments or Lumpsum at each anniversary); a percent step is Compounding unless unticked. This is how a rehab that runs for years carries a rent that rises every year. The increase belongs to the line, never to the component, so any recurring benefit your organization sets up can have one. On the plan it is only a default: Apply benefit plan offers the tick Apply the plan's increase too, so one allottee can get the same package with a flat rent, and every offer line keeps its own increase.
• A Note.

A benefit may appear once per plan (Save is greyed out with "A benefit appears twice"). No start date is stored: "The start date is typed on each offer", because transit rent usually starts when the family vacates.

Managing plans needs the Pricing Plans permissions (Create to add a plan, Edit to change its lines); the seeded Rehab Officer role can view and apply plans but not build them. Editing the lines also needs the View permission on Charge Components and on Bookings (for the cadences).

Applying a plan to an offer

On a draft offer, Apply benefit plan (needs the View permission on Pricing Plans) opens "Apply a benefit plan". Pick a plan and the dialog previews every line as it will land on this offer: "<benefit> · <cadence> × <n> · ₹<rate>/sq ft × <existing carpet>" with its amount per installment. Apply plan is blocked with "Choose a plan", "This plan has no benefits yet" or "Enter the existing carpet on the offer first: some benefits are per sq ft of it".

Applying fills the form: the offer's existing benefit lines are replaced by the plan's ("The offer's <n> benefit lines will be replaced by the plan's."), charges are not touched, and each line's First payment is left blank for you to type. Nothing is saved until you Draft offer or Save changes. The amount per installment for a per-square-foot line is the rate multiplied by the existing carpet area on the offer, rounded half-up to 2 places; a fixed line takes its amount as it is. The lines are copies: editing the plan later never changes offers already made, and deleting a plan leaves them in place ("Offers it was applied to keep their lines.").

From lines to a schedule

Each benefit line on the offer becomes a schedule of Installments rows of the amount: the first on the First payment date, the next ones one cadence apart with the Due day pinning the day of the month. A line with no first payment date has undated rows, which never fall due until someone dates them by hand. See Member offer (term sheet).

With an Increase, the steps are counted from the first payment: every Every (months) the installment becomes the stepped-up amount (10% compounding on ₹1,000 gives ₹1,100 in year two and ₹1,210 in year three; simple gives ₹1,200; a fixed ₹250 gives ₹1,250 then ₹1,500). Spread into installments writes that amount on each row of the period. Lumpsum at each anniversary keeps every installment at the first amount and adds one row per anniversary, marked "increase" with the note "Year 2 increase" (or "Period 2 increase" for a period other than 12 months), for the whole period's rise paid up front, so both ways add up to the same total. The line total and the offer's "Total benefits" are the sum of the rows, so a hand-edited or stepped-up schedule is what the letter and the payout runs show.

Benefit accrual in a payout run

Benefits are paid through Member Benefits payout runs, drafted from the promoter's books under Payments, Payout runs (the Create permission on Payments; approval needs the Approve permission). A run "due up to" an as-of date collects every benefit row that is:

• on an offer that is Issued, Accepted or Signed, on a project of the books' promoter;
• Pending or Partially Paid, dated, due on or before the as-of date, with an amount above 0.

Drafting the run accrues those rows first. For each member, one Journal voucher dated the run's as-of date posts, for every row, the outstanding amount to the expense ledger the benefit component is mapped to (with the project's cost centre) and credits the member's party ledger with one New Ref bill per row, numbered with the component code, the installment number and a short offer reference (RENT/2/…) and due on the row's date. The narration reads "Benefits accrued for <name> (member <no>) as of <date>". A component without a ledger mapping stops the member's payout: "Charge component <code> has no ledger mapping in books <name>"; map it under Chart of accounts, Component mappings. A partly paid row accrues only its unpaid remainder; a row already accrued is not accrued twice.

The run then drafts one Pending payout per member for the total, allocated row by row, to the member's primary active bank account (members with no active account are skipped on NEFT and similar modes: "The payee has no active bank account on file"). Clearing the payout posts the Payment voucher, which settles the bills Against Ref, so member payables age and reconcile bill by bill like receivables.

Nothing accrues unless a run is drafted: an issued offer with due rows has no accounting entries until then. Once any row is accrued or paid, the offer counts as having money: it can no longer be cancelled or deleted ("Money has been recorded against this termsheet…") and a plan cannot replace its benefit lines ("<benefit> already has money paid or accrued on this offer; the plan cannot replace the benefit lines").

Business reason

Every member of a society is usually promised the same package, so the rehab officer should type it once and apply it 48 times, while still being free to adjust one member's terms. Accruing on the due date, rather than on payment, puts the expense and the liability in the right month and gives the accountant a bill-wise view of what is owed to each member, the same way buyers' demands are tracked.

Example

Skyline Heights has the plan Society members – standard:

Benefit	Worked out as	Amount / rate	Cadence	Installments	Due day
Corpus Fund	Fixed amount	₹5,00,000	Lumpsum	1	—
Transit Rent	Per sq ft of existing carpet	₹55 per sq ft	Monthly	36	5
Shifting Charges	Fixed amount	₹40,000	Lumpsum	1	—

Mrs Kulkarni's draft offer records 512.50 sqft existing carpet (Mofa). Applying the plan previews "Transit Rent · Monthly × 36 · ₹55/sq ft × 512.50 sqft" at 55 × 512.50 = ₹28,187.50 per installment, and fills three lines. The rehab officer types the first payment dates (1 November 2026 for the rent, 15 November 2026 for the corpus and shifting) and drafts the offer.

The schedule: Corpus Fund ₹5,00,000.00 on 15 November 2026; Shifting Charges ₹40,000.00 on the same day; Transit Rent 36 rows of ₹28,187.50, #1 on 1 November 2026, #2 on 5 December 2026 (one month on, pinned to the 5th), #3 on 5 January 2027 and so on to #36 on 5 October 2029. Line total for the rent: 36 × ₹28,187.50 = ₹10,14,750.00. "Total benefits ₹15,54,750.00".

On 2 January 2027 the accountant drafts a Member Benefits run from Shree Ganesh Developers LLP's books, "Pay everything due on or before" 31 December 2026. Four of Mrs Kulkarni's rows are due by then: rent #1 and #2, the corpus and the shifting. The run posts one Journal dated 31 December 2026:

Ledger	Dr	Cr	Bill
Corpus Fund expense	₹5,00,000.00		CORPUS/1/…
Shifting Charges expense	₹40,000.00		SHIFTING/1/…
Transit Rent expense	₹28,187.50		RENT/1/…
Transit Rent expense	₹28,187.50		RENT/2/…
Mrs Sunita Kulkarni		₹5,96,375.00	four New Ref bills

with every expense line tagged with the Skyline Heights cost centre (the books have mirrored their projects), and drafts one payout of ₹5,96,375.00 to her primary bank account. Once cleared with the bank's UTR, the four bills are settled. The next run, due up to 31 January 2027, picks up rent #3 only: ₹28,187.50. Had the rent line been saved without a first payment date, none of its rows would ever appear in a run.

Where you see it

• Tenant benefits: building the project's plans.
• Society & Tenants: Apply benefit plan in the offer drawer, the benefit lines and their schedules.
• Allottee: the offers with their benefits.
• Charge components: the Tenant Benefit components.
• Component mappings: the expense ledger each benefit posts to.
• Payout runs and Payout run: the Member Benefits run that accrues and pays.
• Payment, Voucher and Ledger report: the payout, the accrual Journal and the member's bill-wise ledger.

Related

• Member offer (term sheet)
• Allottees: society members, landowners and PAP tenants
• Charge components
• Entitlement
• Tenant benefits
• Payout runs