HandyCafe Docs
owner cashier

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:

  1. An in-app alert at the top right with the table name, for example "New cafeteria order: Window 3".
  2. A sound if Play sound on new order is on under Cloud > Cafeteria.
  3. An increment of the pending-count badge on the Orders tab.
  4. 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

  1. Find the order card.
  2. Click Cancel.
  3. Confirm in the Cancel this order? dialog.
  4. 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.

  1. Click Charge to wallet.
  2. Select the member. The dialog shows the Order total, the Paid wallet balance and the Balance after charge.
  3. 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.