> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nyumbazetu.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Owner statements
> How an owner statement is built, how to read it, and how to schedule generation.
**Owners → Statements → `/owner-statements`** Beta
An owner statement is the periodic account of what an owner's property earned, what it cost, what
you charged for managing it, and what is payable to them.
## Structure of a statement
A statement is built at **invoice grain, per unit**, with a running balance:
```
Brought forward (B/F)
+ income invoiced / collected on the owner's units
− management commission
− expenses attributed to those units
= Net payable
→ Carried forward (C/F)
```
The **brought forward → carried forward** running balance is what makes consecutive statements
reconcile: last period's C/F is this period's B/F. If they do not match, something was generated
out of order or a period was reopened.
## Reading a statement
| Element | Meaning |
| --------------------- | ------------------------------------------------------------------------- |
| **Summary** | The period, the owner, and the headline figures. |
| **Account activity** | Movements by unit, at invoice grain. |
| **Service-type rows** | Income and cost split by what it was for. |
| **Line detail** | Drill into any line to its source invoice, payment or expense. |
| **Commission** | The management fee, with the rule source that produced it. |
| **Closing balance** | What is carried into the next period. |
| **Net payable** | What is due to the owner, subject to the contract's minimum disbursement. |
| **Linked documents** | The generated PDF and anything attached. |
| **Timeline** | Generation, regeneration and delivery events. |
Use the drill-down. An owner querying a figure is almost always querying one line, and the line
detail takes you straight to the invoice or expense behind it.
## Generating statements
Ensure invoices are issued, payments are allocated and expenses are recorded. A statement
generated over incomplete data has to be regenerated.
Use **Generate statements** for a period, either for one owner or in bulk.
Check the commission lines, the expense attribution, and that B/F matches last period's C/F.
**Download latest PDF** from the owner or the statement.
## Schedules
**Owners → Schedules → `/owner-statement-schedules`** automates the cadence.
A schedule defines when statements are generated for which owners, following the contract's
cadence and settlement lag. From the schedules list you can **create a schedule** and **run now**
for an off-cycle generation.
Scheduled generation removes the month-end scramble, but it does not remove the review step —
statements should still be checked before they reach an owner.
## What drives the numbers
| Figure | Comes from |
| ----------- | ------------------------------------------------------------------------------------- |
| Income | Invoices on leases against units in the contract's scope, for service types in scope. |
| Commission | The contract's commission terms **as at the statement period**, versioned. |
| Expenses | Expenses attributed to the owner's units or blocks. |
| B/F | The previous period's C/F. |
| Net payable | Closing balance, subject to the minimum-disbursement threshold. |
The single most common cause of a wrong owner statement is **expense attribution**. An expense
recorded at branch level with no unit or block never reaches any owner's statement, and the cost
silently stays with you.
## Regenerating a statement
Regenerate when the underlying data was genuinely wrong — a missing expense, a mis-allocated
receipt. Regeneration is recorded on the statement's timeline.
Do not regenerate to reflect a **term change** that took effect later; versioned commission terms
exist precisely so that a historical statement keeps the terms that applied at the time.
## Common problems
| Symptom | Cause |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| B/F does not match last C/F | Statements generated out of order, or a prior period was regenerated after this one was produced. |
| Income lower than expected | Units missing from contract scope, or invoices raised against the wrong unit. |
| Commission missing on some income | The service type is not in the contract's scope. |
| Costs missing | Expenses not attributed to a unit or block. |
| Owner sees a zero balance despite activity | No statements generated for the period. |
## Next steps
Pay the net payable.
The terms behind the commission line.