Zerra logo

ZerraLivin Documentation General

IPL Bill

Generate periodic resident charges, record their payment, and review manual-transfer receipts before confirming them.

  • view
  • get
  • create
  • update

What it’s for

This is where each resident’s periodic charge — called “IPL” (Iuran Pengelolaan Lingkungan, a recurring community fee) — gets created, paid, and checked. Generate a cluster’s bills for the period, record how each one was paid, and review the payment receipts residents upload when they pay by manual transfer.

Where to find it

Sidebar → GeneralIPL Bill, at /admin/bill-resident.

Who can use it

  • See the menu item and open the page — needs view.
  • See the bill list and summary — needs get.
  • See the Generate Bills button — needs create.
  • Record a payment, approve or reject a receipt — needs update. Without it, those actions aren’t offered at all.

On this screen

Four summary cards up top: Total Bills, Paid, Unpaid, Total Paid. Below that, filters for status, billing period (or “All months” to search everything), and a search box for the resident’s name, phone, or email.

Each row in the table has a detail action, plus either Update Payment or Review receipt — which one you see depends on the bill’s state.

How to…

Generate this period’s bills

  1. Click Generate Bills.
  2. Confirm the month and year (it defaults to the current period).
  3. Generate.

Heads up: this can create bills for every resident in the cluster at once — there’s no way to pick just one.

Record a payment yourself

  1. On a bill, click Update Payment.
  2. Enter the paid date, payment method, and amount.
  3. Optionally attach evidence (PNG/JPG/WebP, up to 2MB).

Use this for bills you’re settling directly — not for something a resident already submitted. That’s Review Receipt, below.

Review a resident’s receipt

A bill sitting in Waiting Verification — meaning a resident just submitted a receipt — shows Review receipt instead of Update Payment.

  1. Compare the resident’s receipt against your bank statement.
  2. Choose one:
    • Approve — confirms the payment. The form is pre-filled with the minimum amount required (see Rules below).
    • Reject — clears the receipt and puts the bill back to Unpaid so the resident can try again. No reason is recorded.

Field reference

FieldNotes
Paid dateDetermines whether the late fee applies
Payment methodRequired to record a payment
Amount paidOn approval, must meet the minimum shown on screen
Payment evidenceOptional when you record it yourself; shown read-only when it’s a resident’s submitted receipt

Rules & statuses

Status shownWhat it means
PaidPayment confirmed
UnpaidNo confirmed payment yet
Waiting VerificationA resident’s receipt is waiting for you to check it — still counted as unpaid everywhere

Waiting Verification only happens in clusters where residents pay by manual transfer. Clusters on the online payment gateway skip this step entirely — there’s nothing for you to review.

How the minimum approval amount is calculated: the bill’s fee, plus the late fee — but only if the paid date is after the due date. The screen calculates this for you and won’t let you approve below it.

  • Cluster Fee (Settings) — sets the fee amount these bills are generated from.
  • Late Fee (Settings) — sets the late-fee amount used in the calculation above.
  • See the full payment flow → — a step-by-step walkthrough from a resident selecting a bill to its Paid status landing on this dashboard.