Earnings & settlements

Earnings and settlement reports answer two questions every week: what did each outlet earn? and where is the cash? When drivers collect cash on delivery, money physically moves through people’s hands — these reports track it per outlet and per driver, so end-of-week reconciliation lives in the dashboard instead of a spreadsheet. Outlet owners and drivers see their own numbers in the partner app; the admin dashboard holds the full picture plus payout recording.

Earnings reports

Two views each for outlets and drivers:

Report	Route	What it shows
Outlet earnings	`/reports/outlet-earnings`	Aggregated earnings per outlet over a date range
Outlet earnings list	`/reports/outlet-earnings-list`	The underlying order-by-order entries
Driver earnings	`/reports/driver-earnings`	Aggregated earnings per driver
Driver earnings list	`/reports/driver-earnings-list`	Order-by-order driver entries

Use the aggregated views for the weekly picture and the list views when a number looks off and you need to trace it to specific orders.

Settlement balances

A settlement balance is the running amount between you and an outlet or driver — built up from earnings owed on one side and cash they’ve collected on your behalf on the other. The classic case: a driver collects cash on delivery all week; that cash sits with the driver until you settle.

Outlet balances: Dashboard → Reports → Settlement Balance (/reports/settlement-balance/outlet)
Driver balances: /reports/settlement-balance/driver

Each balance view shows the current net position per outlet or driver, with a payout action to record a settlement directly from the row — when you hand a driver their earnings (or they hand over collected cash), record it there and the balance updates immediately.

Settlement transactions

Every recorded settlement becomes a transaction you can audit later:

/reports/settlement-transactions/outlet — outlet settlement history
/reports/settlement-transactions/driver — driver settlement history

If a driver disputes a balance, the transaction list plus the driver earnings list reconstructs exactly how the number was reached.

What outlet owners and drivers see

The same numbers are visible to the people they concern, in the partner app:

Outlet owners — Partner app → Reports shows their outlet’s earnings and settlement history.
Drivers — in driver mode, each driver sees their own earnings and settlement balance.

This transparency cuts most settlement arguments off before they start: the driver sees the same balance you do, updated as orders complete and settlements are recorded.

Pending refunds

Refunds that have been approved but not yet completed are listed under Dashboard → Reports → Pending Refunds (/reports/pending-refunds). Review this regularly — a refund stuck here is a customer still waiting for money. See Editing orders & refunds for how refunds are issued and Cancelling orders for cancellation refunds.

A simple weekly routine

Open the driver settlement balance view and settle each driver — record the payout (or cash hand-over) against their balance.
Check pending refunds and clear anything outstanding.
Skim the outlet earnings report against your gateway payouts and the payment-wise report — totals should reconcile.
Spot-check one driver’s balance against their transaction list, just to keep the habit of trusting verified numbers.

Troubleshooting

Symptom	Try this
A driver’s balance looks too high	Open `/reports/driver-earnings-list` and `/reports/settlement-transactions/driver` for that driver — compare collected-cash orders against recorded settlements
A payout was recorded with the wrong amount	The transaction list is your audit trail — record a correcting settlement and note what happened
Outlet earnings don’t match gateway payouts	Gateways pay out on their own schedule; compare matching date ranges, and remember refunds reduce payouts
Driver says the app shows a different number	Have them refresh the partner app; balances update as orders complete and settlements are recorded