Order Management
Orders in HandyCafe are used to sell products (food, drinks, accessories, and any other items your internet cafe or gaming center offers). The order system tracks every sale from creation through approval, payment or rejection, with full integration into the cash report and cashier shift tracking.
Order Lifecycle
Every order follows a straightforward lifecycle:
New order --> Pending approval --> Approved --> Closed (paid)
| |
+----> Rejected <--+
- Pending approval: The order has arrived (from a customer's PC or entered at the counter) and waits for a cashier to accept it. Items can still be added, removed or changed.
- Approved: The cashier accepted the order and handed the items over. Where the money comes from depends on the customer's plan (see Approving an Order).
- Closed: Payment has been received and recorded. A transaction record is created. The order cannot be modified after closing.
- Rejected: The order has been voided. No payment is collected and no stock is deducted. Rejected orders remain in the history for auditing purposes but do not affect revenue calculations.
Order List
The Orders page has no tabs. A toolbar at the top holds a date range selector (Today, Yesterday, Last 7 Days, Last 30 Days, This Month, Last Month, Custom), a search field (Search order no, seat or member), a barcode field and the New Order button.
Below the toolbar, a summary strip shows how many orders are waiting (for example "3 orders awaiting approval"), how long the oldest one has waited and how many orders arrived today.
The list itself is split into two sections:
| Section | Shows |
|---|---|
| Payment not collected | Every order that is still open: orders waiting for approval and approved orders whose money has not been collected yet. This section is always shown, whatever date range you pick |
| Handled today | Orders already closed or rejected within the selected date range. Long ranges show the first 60 rows and a note that tells you how many more are hidden |
Each row shows the seat (computer, console or bill), the amount, a wait badge and, for orders waiting for approval, a one-tap Approve button. Click a row to open its details on the right, with the item lines, subtotal, VAT and Grand Total.
The Orders page lists cafeteria orders only. USB copy, print and AI chat charges do not appear here. They are shown under the session they belong to and are collected with it at checkout.
Creating a New Order
- Navigate to the Orders page.
- Click the New Order button.
- Optionally pick a seat in Select device (optional). The list contains connected computers, running consoles and open bills. Leave it empty for a counter sale.
- Optionally add a note in Note (optional) (e.g., a table number or special instructions like "no ice").
- Click Create Order. The order opens in the details panel, ready for items.
Adding Items to an Order
Select an open order, then use the Add product panel next to the order details:
- Search or browse products: Type in the search field or filter by category. Items that ran out show an out of stock tag.
- Select a product: Click the product to add it. The default quantity is 1. Adding a product that is already on the order asks whether to raise its quantity.
- Scan a barcode: With a USB scanner connected, scan the product barcode. The Scan barcode... field in the toolbar catches the scan and adds the matching product to the selected order.
The unit price comes from the product catalog on the Cafe Menu tab of the Stock page.
Modifying Items
While an order is still open, you can modify its items in the details panel:
- Change quantity: Use the Increase quantity and Decrease quantity buttons on the item line.
- Remove items: Use the Remove item button on the line and confirm.
Once an order is closed or rejected, its items cannot be modified.
Order Total
The order total is automatically calculated from all items in the order:
Line Total = Quantity x Unit Price
Order Total = Sum of all Line Totals
The details panel shows each line with its product name, quantity, unit price and line total, followed by the Subtotal, the included VAT and the Grand Total. The total updates in real time as you add, remove or change items.
Approving an Order
An order waiting for approval shows one primary button. Its label depends on where the order came from:
| Button | When it appears | What happens |
|---|---|---|
| Approve | A customer placed the order from a computer or console | The order is accepted and the items are handed over. Payment follows the customer's plan (see the table below) |
| Approve and Collect | The order is not tied to any device (a counter sale) | Approving opens the payment screen |
| Charge to Account | A cashier entered the order for a seat | There is nothing to approve. The order is written to that seat's account |
A line under the buttons tells you in advance where the money will come from:
| Customer's plan | Result of approval |
|---|---|
| Member session | Deducted from the member's wallet on approval |
| Prepaid guest session | Deducted from the remaining prepaid time on approval |
| Postpaid session | Charged to the seat and collected when the session ends |
| Bill | Added to the bill and collected when the bill is settled |
| Counter sale | The payment screen opens |
Collecting Payment
A counter sale that is still open after approval keeps a Collect Payment button:
- Select the order.
- Click Collect Payment.
- Select the payment method. The available payment methods are configured in Payment Methods.
- Confirm the payment.
When payment is collected:
- A transaction record is created in the system.
- The transaction is linked to the current cashier's shift.
- The revenue appears in the Cash Report.
- The order moves to the Handled today section and can no longer be modified.
An order with a zero total is closed without a payment after you confirm the prompt.
The details panel also offers Print receipt for every order, including closed ones.
Rejecting an Order
If an order needs to be voided:
- Select the order.
- Click Reject Order.
- Confirm the rejection.
When an order is rejected:
- No payment is collected and no stock is deducted.
- The order moves to the Handled today section with a Rejected status.
- It remains in the system for auditing purposes.
- Rejected orders do not affect revenue calculations or the Cash Report.
Rejecting stays available after approval where the charge can be reversed (a member wallet or prepaid time). For an order that was already approved and handed over, the confirmation button reads Write Off Delivered Order. Writing it off drops the order from the bill and no payment is collected.
Wait Time
Open orders show how long they have been waiting (for example "7 min"). The badge turns amber after 5 minutes and red after 15 minutes. The row gets a matching colored edge. The details panel shows when the order was placed ("Just now", "12 min ago", "1 h 5 min ago").
This makes it easy to spot orders that have waited too long.
Order Notifications (Client-Originated Orders)
When a customer places an order from their client PC (using the client application's ordering feature):
- A notification appears on the server application with a sound alert.
- Clicking the notification opens an approval dialog with the order details, the originating PC and the same Approve and Reject Order buttons. When more orders are queued, the dialog shows how many more are waiting and a Next order button.
- For a counter sale, the dialog offers Open in Orders instead, which opens the Orders page so you can collect payment there.
This feature enables customers to order food and drinks without leaving their station, improving the customer experience and reducing wait times.
For a member who placed the order from their PC, the wallet is not charged when the order is placed. The cashier confirms the handoff with Approve. That action debits the order total from the member's paid wallet balance. Bonus credits are reserved for session and time use and are never used for orders. A rejected order never touches the member's balance.
For a prepaid guest, approval deducts the order total from the session's remaining prepaid value at the hourly rate. The guest's remaining time goes down accordingly.
Settlement Switches
Two settings on the General settings page control this behaviour. Both are on by default. See System Options.
| Setting | When off |
|---|---|
| Pay member orders from the wallet | The wallet is never touched. Member orders stay open and are collected at the counter when the session ends |
| Pay prepaid session orders from the paid amount | The prepaid amount buys time only. Orders stay open and are collected at the counter |
When a member or voucher session ends while open orders remain, the payment screen opens for the order total only. The session time itself is still settled against the member account or the voucher.
Balance Is Checked Before the Order Is Accepted
While the matching settlement switch is on, a customer order is rejected at the moment it is placed if the balance does not cover it. Nothing reaches the counter. A cashier never prepares an order that cannot be paid for. With the switch off there is no balance to check. The order is accepted and collected at the counter.
| Session type | What is checked |
|---|---|
| Member session | The paid wallet balance. Bonus credit does not count |
| Prepaid guest session | The money value of the remaining session time |
Orders already placed and not yet approved are subtracted from the same budget. Two orders that each fit the balance but do not fit together are not both accepted.
On the client, the ordering screen shows the arithmetic while an order is pending: the wallet balance, the pending orders subtracted from it and the amount actually available. The confirm button is disabled while the cart exceeds what is available. The snapshot refreshes when the cashier approves a pending order.
The customer sees one of:
- Insufficient balance. Please see the cashier. for a member session.
- Not enough session credit. Please see the cashier. for a prepaid guest session.
Required Permissions
Order management is available to cashiers with the appropriate permissions. The ability to create, view, and manage orders is controlled through the cashier role system.
Owners (Admin role) always have full access to all order management features.
Order History and Reporting
All orders, whether closed or rejected, are stored in the system and contribute to reporting:
- Closed orders appear in the Cash Report as revenue transactions.
- Order items are tracked individually, allowing you to see which products sell the most.
- Cashier attribution: Every order records which cashier created and closed it, enabling per-cashier performance tracking.
- The Cash Report can filter transactions by category to show order-related revenue separately from session revenue.