Orders
The Orders tab (page title Cafeteria Orders) is the live dashboard for every cafeteria order placed by your customers. New orders are pushed from the cloud as soon as they are placed. Each one raises an in-app alert, an optional sound and a pending-count badge on the tab header.
Layout
| Area | Purpose |
|---|---|
| Status filter | All, Placed, Confirmed, Preparing, Ready and Served. The page opens on Placed. Cancelled and refunded orders do not have their own filter. |
| Date filter | Limits the list to a period. It opens on Today. Pick another preset or a custom range. |
| Refresh | Reloads the list from the cloud on demand. |
| Order cards | One card per order. Each card shows the table name or code, the order time, the status, the items with their item status, the payment method and payment status, the total and the action buttons. |
Live Updates
The server keeps a relay connection to the cloud. Every new order triggers:
- An in-app alert at the top right with the table name, for example "New cafeteria order: Window 3".
- A sound if Play sound on new order is on under Cloud > Cafeteria.
- An increment of the pending-count badge on the Orders tab.
- A kitchen ticket print if Auto-print incoming orders is on under Cloud > Cafeteria. The ticket prints on the printer assigned to the Cafeteria kitchen ticket job under Settings > Printers.
New orders flash briefly on the dashboard. Alerts are app-wide. You receive them while you work in another part of HandyCafe. The connection badge at the right of the Cafeteria tab bar shows Connected, Connecting… or Offline. While the relay is offline the list still refreshes every 5 seconds.
Call the Cashier
Customers can press Call the cashier on the QR menu. The server shows a warning alert "Cashier called" with the table name and any note. This alert stays on screen until a staff member dismisses it. It uses the orders notification category. Muting system notices does not silence it. It plays the same sound as a new order when Play sound on new order is on. A table can call once a minute. Nothing is stored for a call. The alert is the only record.
Order Lifecycle
Every order moves through a defined sequence of states.
| State | Meaning |
|---|---|
| Placed | The customer submitted the order. No staff action yet. |
| Confirmed | Staff acknowledged the order. |
| Preparing | The kitchen is working on the order. |
| Ready | The order is ready for service or pickup. |
| Served | The order has been delivered to the customer. |
| Cancelled | The order was cancelled by staff. It is retained for history. |
| Refunded | A post-payment refund has been issued. |
The action button on each order card shows the next step: Confirm, Start preparing, Mark ready or Mark served. Advancing is one click. The new status is displayed immediately. If the server rejects the change, the status reverts and an error appears.
Per-Item Status
Some orders have multiple items that finish at different times. For example, a burger is ready before a pizza. Per-item status lets you track each line independently.
Each item has its own Item status picker with five options: Waiting, Preparing, Ready, Served and Cancelled. The customer menu shows the status next to each line. The customer can see which items are ready or on the way.
Cancelling an Order
- Find the order card.
- Click Cancel.
- Confirm in the Cancel this order? dialog.
- The order moves to Cancelled. The customer sees the cancelled status.
Cancellation is a full-order action. To cancel a single line, set that line's item status to Cancelled instead.
Charging an Order to a Member Wallet
When Enable Cafeteria Wallet Charge is on under Settings > General (Members section), open orders that are not yet paid show a Charge to wallet button.
- Click Charge to wallet.
- Select the member. The dialog shows the Order total, the Paid wallet balance and the Balance after charge.
- Confirm the charge.
The order is marked paid with a Wallet charged badge. An insufficient balance blocks the charge. See Member Wallet.
Settlement
To close a table and take payment for all its open orders at once, use Settle check on the Tables tab. The Payment method picker lists the active methods configured in Settings > Payment Methods. Tips and a note are optional. See Tables and QR Codes for the full flow.
Tips
- Use the status filter to split workload. One screen filtered to Preparing shows the kitchen queue. Another screen on Ready shows what needs delivery.
- Settle check is the fastest way to close a table. Use Cancel on individual orders only for explicit mistakes.
- Train staff to advance status consistently. The dynamic preparation time estimator learns from these signals. Skipped states reduce its accuracy.
- Dismiss a Cashier called alert only after someone has gone to the table.