Reports
The Reports page (previously called Cash Report) is the central financial analysis tool in HandyCafe. It provides a comprehensive view of your internet cafe's revenue, breaking down transactions by time, category, device, cashier, and payment method. Use it to monitor daily performance, analyze trends, and export data for external accounting.
Click Reports in the left sidebar to open it. For deeper analysis by topic, use the Analytics page. For closing the day, use the Day-End Summary.
Summary Cards
At the top of the page, summary cards give you an instant snapshot of key financial metrics for the selected date range:
| Card | Description |
|---|---|
| Net Revenue | The combined value of all transactions in the selected period. Refunds are subtracted. |
| Avg. Amount | The mean transaction amount. Useful for understanding typical spending. |
| Debt Accrued (period) | Net debt members took on in the period. It is a receivable, not revenue. |
| Outstanding Debt (total) | All member debt still unpaid right now. |
| Transactions | The number of individual transactions processed. |
| Sessions | The number of sessions in the period. |
| Avg. Duration | The mean session length. |
| Total Duration | The combined length of all sessions. |
The two debt cards appear only when no category or computer filter is applied. These cards update dynamically as you change the date range or apply filters. When a comparison is active, each card shows a change badge.
Charts
The charts cover the whole selected period.
- Cumulative Net Revenue shows how revenue builds up over the period.
- Revenue Distribution by Hours and Revenue Distribution by Days show when the money comes in. Use them to find peak hours and peak days, and slow periods that might benefit from promotions.
- Top Earning Categories is a pie chart of revenue by transaction category, such as Sessions, Consoles, Orders, Cafeteria, Vouchers, Wi-Fi, Wallet Top-up, Package Sale, Subscription, Printing and Equipment.
Period Comparison
The Compare selector next to the date filter compares the range with the Previous period or with the Same weekdays 52 weeks ago. The revenue chart then draws the baseline period, the cards show change badges and a Period Comparison table lists the current value, the baseline, the difference and the change for each metric. The comparison is not available to a cashier who can only view today's data.
Distributions
- Session Length Distribution groups sessions by how long they lasted and shows the median and the 90th percentile.
- Basket Size Distribution groups orders by their total amount and shows the median basket.
Forecast
The Forecast panel estimates the coming days from your own history. Each day is the average of the same weekday over the last 8 weeks. It is an estimate, not a commitment. With little history the panel warns that the estimate is weak. The forecast is part of advanced reporting and is not shown to a cashier who can only view today's data.
Device Earnings
The Device Earnings section breaks down revenue by individual PC or console:
- Top Earning Devices: A ranked list of PCs and consoles by total revenue generated. Identifies your most profitable stations.
- Most Used Devices: Devices ranked by use. Shows which stations are in highest demand.
This data helps you make informed decisions about:
- Which devices to upgrade or replace.
- Where to add more stations if specific types are consistently busy.
- Which devices may have issues (e.g., a station with low usage might have a hardware problem).
Session History
The Session History table lists the most recent PC sessions in the range with Device, Member, Cashier, Duration, Amount, Payment Method, Start Time and End Time. This view is particularly useful for reconciling session revenue and identifying pricing issues.
Last 20 Transactions
The Last 20 Transactions table shows the most recent transactions:
| Column | Description |
|---|---|
| Date | When the transaction occurred (date and time). |
| Device | The station the transaction belongs to. |
| Type | The category of transaction, for example Sessions, Orders or Vouchers. |
| Note | The associated session, order, or voucher details. Voucher rows show the voucher username and a short ID. |
| Amount | The monetary value of the transaction. |
The charts and cards cover the whole period, while this table lists only the latest rows. An administrator can open Edit transaction on a row to correct its category, payment method, date and time, amount or note. The corrected row counts in every total of the report.
Date Filtering
The date filter offers these presets:
| Preset | Period |
|---|---|
| Today | The current business day |
| Yesterday | The previous business day |
| Last 7 Days, Last 30 Days, Last 60 Days, Last 90 Days | The past 7, 30, 60 or 90 days including today |
| This Week, Last Week | The current or previous week |
| This Month, Last Month | The current or previous month |
| This Quarter | The current calendar quarter |
| This Year | January 1 to today |
| Custom | A start and end date you pick |
Days follow the business day start hour set in Settings > General. A custom range is useful for reviewing a particular promotion period, holiday week, or any other time window.
Additional Filters
Beyond date filtering, the page supports several additional filter dimensions:
Filter by Computer
The All Computers list shows only transactions related to a specific PC or console. The filter list and the session table show each station by the display name given to it on the main page, sorted alphabetically, rather than a raw hostname or MAC address. Useful for:
- Analyzing the revenue generated by a particular station.
- Investigating billing issues reported by a customer at a specific PC.
- Comparing utilization rates between different areas of the cafe.
Filter by Cashier
The All Cashiers list narrows the report to transactions processed by one staff member. Useful for:
- Reviewing individual cashier performance.
- Investigating discrepancies in a particular shift.
- Comparing revenue between cashiers working similar shifts.
For a cashier's till shifts and takings, use the Day-End Summary.
Filter by Category
The All Categories list shows only transactions of a specific type. Select Vouchers to review prepaid voucher sales without noise from other categories.
Multiple filters can be combined. For example, you could view "all session payments from PC-01 processed by Cashier John in the last 7 days."
Export
Click Export CSV and choose where to save the file. HandyCafe writes the session history for the current filters to a CSV file, up to 500 sessions. The columns are Session ID, Device, Member, Duration (Minutes), Amount, Payment Method, Cashier, Start Time and End Time. The file opens directly in Microsoft Excel, Google Sheets or LibreOffice Calc.
This is useful for:
- Monthly accounting and bookkeeping.
- Sharing financial summaries with business partners.
- Performing advanced analysis that goes beyond the built-in charts.
For tax figures, use the Tax tab on the Analytics page.
Required Permissions
Access to the Reports page is controlled by the Reports permission category:
| Permission | Access Level |
|---|---|
| REPORT_PAGE_VIEW | Can access the Reports page. Without this, the page is not visible. |
| REPORT_DISPLAY_TODAY | Can view only today's data. Date filters are restricted to the current day. |
| REPORT_DISPLAY_FULL | Can view the complete historical data. All date presets and custom ranges are available. |
A cashier with REPORT_PAGE_VIEW and REPORT_DISPLAY_TODAY can review today's totals but cannot access yesterday's data or any historical reports. This is the typical setup for regular staff.
A cashier with REPORT_DISPLAY_FULL can access all date ranges and view the complete financial history. This should be reserved for owners, managers, or senior staff who need full visibility.
See Cashier Roles & Permissions for details on configuring these permissions.