Orders

Introduction

The Orders screen works as a kitchen display system (KDS). It coordinates between the staff and the kitchen/bar. Open it by tapping the "Orders" button on the main screen. The screen supports two modes — embedded (within the sales screen) and standalone (with a hamburger menu and sign-out).

Screen Layout

The header shows:

• Orders — the screen title (with a back arrow in embedded mode, with a hamburger menu in standalone mode)
• Date and time — the current date and time on the right side of the header (updates every second)

Below the header is a toolbar:

• Search... — a search field for filtering orders by order number, item names, and notes
• Kitchen / Bar — two separate filter chips for prep stations (both on by default)
• Settings icon (tune) — a drop-down menu with additional options

Settings Menu

The settings menu (tune icon) contains:

• Current shift — a toggle (on by default). When active, only orders from the current register shift are shown. When turned off, all orders are shown.
• By time — sort by creation time (default, descending)
• By number — sort by order number
• By status — sort by order status

Tapping the active criterion again toggles the sort direction (ascending/descending).

Order Card

Each order is shown as a card. Voided orders have a red border.

Card header (3 columns):

1. Identity — a colored status dot, order number (e.g. "O1-075-0001"), status (e.g. "Status: Created"). Voided orders show the "VOID" prefix and a reference to the original order.
2. Context — table name (or "Quick tab"), customer (if assigned)
3. Times — Created (time with a colored background based on urgency), Modified (time of the last change). Times update automatically every 15 seconds.

The colored background of the creation time indicates urgency: green (under 5 minutes), orange (5–10 minutes), red (more than 10 minutes).

Order items:

Each item shows:

• A colored stripe on the left edge matching the status
• Quantity and unit (e.g. "2 pcs")
• Item name
• Modifiers (if any)
• Notes (in italics)
• Item status (e.g. "Status: Created")
• A button to move it to the next status (e.g. "Done")

Items are filtered according to the configured prep station filters (Kitchen/Bar). Items with no prep station or with the "All" prep station are always shown.

Bulk button:

To the right of the card is a tall button with a double-arrow icon (>>) and the name of the next status. It moves all items with the lowest active status to the next status at once. The button is hidden when all items are delivered or when the order is voided.

Order notes are shown below the items in italics (for non-voided orders only).

Order Statuses

An order moves through three main statuses:

Created (blue) — the order has just been placed and is waiting to be prepared.

Done (green) — the items are ready. The kitchen or bar taps the "Done" button.

Delivered (gray) — the order has been handed to the customer. The buttons are inactive (final status).

Voided (red) — the order or its items have been canceled.

The status of the whole order matches the lowest status among the active (non-voided) items.

Bump Workflow — Moving Statuses

The core principle of working with orders is "bump" — moving to the next status with a single tap.

Bump a single item: Tap the button on the item (e.g. "Done"). The item moves to the next status.

Bump the whole order: Tap the large bulk button on the right (>> icon). All items with the lowest active status move to the next status at once.

Unbump (revert status): A long tap on the bulk button shows a confirmation dialog and then moves all items with the lowest status back to the previous status.

Void an item: A long tap on the order item itself (not on the button) voids the item. If the item has a quantity greater than 1, a dialog opens for entering the voided quantity (partial void). For a quantity of 1, a confirmation dialog is shown.

Filtering by Department

The toolbar has two filter chips, "Kitchen" and "Bar" (both active by default):

• Kitchen — shows items with the "Kitchen" prep station
• Bar — shows items with the "Bar" prep station

Items with no prep station or with the "All" prep station are shown under any active filter. An order is shown if at least one of its items matches the active filters.

Bottom Filter Bar

At the bottom of the screen are four status filters:

• Created (blue) — on by default
• Done (green) — on by default
• Delivered (gray) — on by default
• Voided (red) — on by default

Tapping a filter turns it on/off (a check mark indicates active). If no order matches the filters, "No orders" is shown.

Practical Tips

If you have two displays (one in the kitchen, one in the bar), set the matching department filter on each. The kitchen sees only kitchen items, and the bar sees only drinks.

Special requests (notes such as "no salt" or "medium") appear directly on the order card in italics.

Items that have been waiting a long time have their creation time highlighted in color (green/orange/red) to flag the delay.

For Managers and Administrators

Permissions

Without the orders.bump permission, the bump buttons are hidden. Without the orders.void_item permission, items cannot be voided with a long tap.