Zerra logo
Zerra logo|Livin
ID

ZerraLivin Documentation Settings

Cluster Fee

Configure the recurring fee a cluster's IPL bills are generated from, in one of three modes: flat, custom per resident, or in-house installment.

  • view
  • get
  • create
  • update
  • delete

What it’s for

A Cluster Fee is the fee definition that IPL Bill generates bills from. This is where you set how much residents owe, how often, and — for developer-financed installments — the repayment math.

Where to find it

Sidebar → Settings → Cluster Fee, at /admin/settings/cluster-fee.

Who can use it

  • See the menu item and open the page — needs view.
  • See the fee list — needs get.
  • Create, edit, delete — each needs its own permission.

On this screen

A table of fee definitions per cluster, with create, edit, and delete.

How to…

Create a flat fee

  1. Click create.
  2. Enter a name, description, cluster, and amount.
  3. Set how often it recurs: Monthly, Weekly, Daily, or One Time.
  4. Leave the custom and installment options off — this is the default mode, one amount for every resident.
  5. Save.

Create a custom fee per resident

  1. Turn on Custom Fee per Resident.
  2. Set an individual amount for each resident it applies to, instead of one shared amount.
  3. Save.

Set up an in-house installment

  1. Turn on the in-house installment option.
  2. Enter total debt, down payment, total installments (tenor), and the installment number.
  3. The monthly installment amount is calculated for you: round((total debt − down payment) / tenor).
  4. Save.

Attach a late fee

  1. Turn on the late fee option for this cluster fee.
  2. Pick which Late Fee configuration applies when a bill generated from this fee is paid late.

Field reference

FieldRequiredNotes
Name, clusterYes
DescriptionNo
RecurrenceYesMonthly / Weekly / Daily / One Time
Fee amountYes, unless Custom Fee is onCustom mode sets per-resident amounts instead
StatusYesActive / Inactive

Rules & statuses

These three modes are mutually exclusive, not stacked: Flat (one amount for everyone), Custom (a different amount per resident), or Installment (developer-financed, computed from debt/down payment/tenor). Which one is active is what decides how the amount is set and shown, everywhere this fee is used.

An Inactive fee stays configured but stops being used the next time bills are generated for its cluster.

  • IPL Bill — where bills generated from this fee are shown and collected.
  • Late Fee — the configuration a cluster fee can attach for late payments.