User guide · Modules

Restaurant & kitchen

The back-of-house view of the POS: today's numbers, the order board and kitchen display that move tickets from new to served, and the menu with sold-out switches, prices and recipes.
Whole guide

Purpose and who uses it

Restaurant MgrHotel Manager

Kitchen staff work the order board and kitchen display; the restaurant manager keeps the menu honest.

Restaurant / POS is where orders are cooked and the menu is managed; the ringing and paying happens on the POS terminal. Tickets flow from the till onto the Order board here, the kitchen advances them through preparing and ready, and the waiter marks them served. The Menu tab lists every category and item for the selected outlet with a sold-out switch, and shows supervisor notes left over from the menu import.

Like the terminal, this screen is guarded by the Payments module: View only reads the boards, Can edit advances tickets and changes menu items.

Screen anatomy

KPI row, outlet switch, five tabs: Kitchen display (the default), Order board, Tickets, Tables, Menu.

Restaurant / POS, Order board
123458
  1. 1
    Head and KPIs
    “Restaurant / POS · Kitchen orders, room service and daily sales”, then Orders today · In kitchen · Ready to serve · Sales today (closed tickets created today).
  2. 2
    New Orders
    Purple column: open tickets with kitchen status new.
  3. 3
    Preparing
    Amber column: being cooked.
  4. 4
    Ready
    Blue column; the fourth column, Served, is green.
  5. 5
    Order card
    Room N / Table N / TKT code, the live items (“Chips ×2”), minutes since opened, total, a Room Service · Dine-in · Walk-in tag and the advance button (Start cooking · Mark ready · Mark served).
  6. 8
    Toolbar
    Kitchen display (jumps to that tab) and Open POS terminal (goes to /pos).
  • Outlet switch: the same buttons as the terminal; the board and menu show one outlet at a time.
  • Tickets (the default): every open ticket of the outlet plus the recent closed ones in one table (ticket, table or room, guest, covers, items, total, kitchen status, opened). Tap a heading to sort; the Kitchen heading filters by status; the last column advances an open ticket, and tapping an open row opens that order on the till.
  • Order board: four kanban columns; cards can be dragged one column to the right or advanced with the button.
  • Menu: the outlet's items as a paged list (Table, Cards or By category), searchable and filterable by category, availability and popular; inline cells for category, price, popular and 86; a drawer for the full item; Add item and Categories dialogs; and, when any exist, a MENU_NOTES side card of unresolved supervisor flags with a Resolved button.
  • Tables: the floor as status cards (Free, Seated, Order open, Bill out, Needs bussing) filtered by state and zone. Free, Seated and Needs bussing are set by hand; Order open and Bill out follow the ticket, and closing a bill leaves the table at Needs bussing until it is cleared.
  • Kitchen display (the first tab and the default): the screen at the pass. Three shelves, To make, Ready to serve and Today, a station switch (Kitchen, Bar, All stations) carrying the number of items each board still owes, a Sound on / off chip, and large cards that show every line for that station with its accompaniments and notes, a Ready button per line (Undo once pressed), how long the order has waited, and one big button for the next step. A new order chimes; an order nobody has started taps every minute. Shares from a bill split by amount and the copies an even split keeps for billing never appear here.

Without an outlet the page shows “No POS outlet configured for this hotel.”

Working an order

Restaurant Mgr

New → preparing → ready → served, one step at a time, from the board, the kitchen display or the till.

  1. 1
    The ticket appears
    As soon as a waiter creates a ticket at the till it shows under New Orders with “No items yet” until lines are added. Room-service tickets are labelled Room N; table tickets Table N; walk-ins by code.
  2. 2
    The till sends
    Send on the terminal marks the lines sent and moves a new ticket to Preparing. Lines added afterwards show up on the card as they are sent.
  3. 3
    Start cooking (kitchen)
    If the ticket is still in New Orders, e.g. lines were rung but never sent, the kitchen presses Start cooking. This marks every line on the ticket sent and moves it to Preparing.
  4. 4
    Ready, one plate at a time
    On the kitchen display each line has a Ready button; the line turns green on the till at once. When the last kitchen line is ready the ticket moves to Ready by itself and the waiter is told. Undo puts a line back to cooking (and the ticket back to Preparing).
  5. 5
    Mark ready
    Food is plated: press Mark ready (board or kitchen display) to stamp every line at once. The Ready to serve KPI counts these. The till takes no money for a kitchen dish until it reads ready.
  6. 6
    Mark served
    The runner delivers and presses Mark served on the board. The card sits in Served until the ticket is settled at the till, which takes it off the open-ticket board.

The kitchen display

Restaurant MgrChef

The screen at the pass: every line of the order for this station, with accompaniments and notes, how long it has waited, and the day's history.

It is the first tab of Restaurant / POS and the screen the page opens on. Each card is one order: where it is (Table 4, Room 07, walk-in), its code, covers and guest, the outlet, and a timer that counts from the moment the first line was fired (green, then amber after 15 minutes, red after 30). Underneath, every line the station has to make, as the cook reads it: 2× Stir Fry Chicken, then the accompaniments on their own line (“+ Chips, Extra sauce”) and any note from the till in amber (“no peanuts”). Lines the waiter has not sent yet are shown faded with a “not sent yet” tag, so nothing is cooked early.

Shelves and the station switch
FieldTypeNotes
To makenew · cookingOrders with something for this station that is not ready yet, longest wait first. The button does the next thing for this station only: Start cooking (or Start pouring at the bar), then Mark ready, then Mark served. It never moves the other station's lines on the same ticket.
Ready to servereadyPlated and waiting for a runner. Mark served clears it. The order board's Ready column shows the same tickets.
Todayserved · paid · cancelledEvery order the station worked on today, newest first, with its items, outcome and the opened / done times. This is the kitchen's history; it fills itself from the server whenever the page reloads.
Kitchen · Bar · All stationsswitchEach menu category belongs to a station (Menu tab → Categories). The board is the station's, not the outlet's: the kitchen sees the hotel's food whichever menu sold it, the bar its drinks, and a ticket with both appears on both screens with only its own lines. All stations shows everything. The screen remembers the station it was left on.

“Nothing to make” means the pass is clear. The timers keep moving without a refresh; new orders and changes arrive live from the till.

Tables and room service

Tables belong to an outlet and are picked at the till; the board labels each ticket by room, table or code.

There is no separate floor map on this screen. Tables are defined per outlet (number, zone, seats) and are assigned to a ticket on the terminal with Pick table, which groups them by zone and colours them by status (free · seated · open · bill · dirty). The order board uses that assignment to label cardsTable N and tag them Dine-in; a ticket linked to an in-house room shows Room N andRoom Service; anything else is a Walk-in shown by its code.

Room-service tickets can be settled with Charge to Room at the till, which posts the food, service charge and VAT onto the guest's folio, see Payments & folios.

Kitchen statuses

Four kitchen states on every ticket; only forward moves, one step each.

Kitchen (KDS) status
Kitchen (KDS) statusSend / Start cookingMark readyMark servedNew OrdersPreparingReadyServed
  • New Orders → Preparing (Send / Start cooking)
  • Preparing → Ready (Mark ready)
  • Ready → Served (Mark served)
What each status means
FieldTypeNotes
New OrdersStart cookingTicket opened at the till; nothing fired yet, or fired but not acknowledged.
PreparingMark readyThe kitchen is cooking. Send from the till moves a new ticket here automatically.
ReadyMark servedPlated and waiting at the pass.
ServedfinalDelivered to the table or room. Final.

The KPI tiles derive from these: In kitchen counts preparing, Ready to serve counts ready,Orders today counts tickets created today (any status), Sales today sums today's closed tickets. The board shows open tickets only; a settled ticket leaves the board whatever its kitchen state.

Menu item fields

What an item carries, from the create/update API.

Menu item
FieldTypeNotes
Outlet *The outlet whose menu the item belongs to.
Category *Must belong to the same outlet, otherwise “Category does not belong to outlet”.
Name *1–120 charsCopied onto ticket lines when rung, so renaming does not rewrite old tickets.
Price *whole shillingsBase price; modifier deltas add or subtract per option.
Description≤ 500 charsShown at the top of the modifier sheet on the till.
AvailablebooleanDefault true. False = sold out: hidden on the till and refused.
PopularbooleanDefault false. Starred on the tile and listed under the Popular rail.
Recipe lines≤ 20 × (stock item, qty > 0)Replaced as a whole on each save; depleted from stock at settle.

Permissions

Restaurant · View reads the boards and menu; Kitchen · Can edit runs the pass; Restaurant · Full owns prices, dishes and categories.

Restaurant and Kitchen levels per role (default)
RoleRestaurantKitchen
Super AdminFullFull
Hotel ManagerFullFull
ReceptionistEditNone
AccountantViewNone
Housekeeping MgrNoneNone
MaintenanceNoneNone
Restaurant MgrFullFull
HR ManagerNoneNone
SecurityNoneNone
WaiterEditView
ChefViewEdit
HousekeeperNoneNone
CashierFullView
None No accessView View onlyEdit Can editFull Full access
  • Open the screen, read boards, tickets, menu, notes, recipes: Restaurant · View only (the Chef, the Accountant).
  • Start cooking / Mark ready / Mark served, Ready on a line, drag cards: Kitchen · Can edit (the Chef) or Restaurant · Can edit (the Waiter, the desk). Marking an order ready, by the button or by its last line, sends a personal “Order ready” alert to the waiter who took it, with a chime on their device.
  • Mark sold out / back on sale, resolve notes: Restaurant · Can edit.
  • Create or delete dishes, change prices, names, categories or options, set recipes, add or rename categories: Restaurant · Full access (the Restaurant Manager).

Receptionists (Restaurant · Can edit) can ring a room-service order and move a card; they cannot change the menu.

Tips

Timing, the till link, live updates and sold-out discipline.

Errors you may see

Messages from the kitchen-status and menu endpoints, verbatim.

409Cannot move KDS from <from> to <to>
Why
Kitchen status only advances one step forward (new → preparing → ready → served).
Fix
Press the advance button on the card; do not skip or reverse columns.
400Category does not belong to outlet
Why
An item was created with a category from a different outlet.
Fix
Pick a category listed under the same outlet.
404Menu item not found
Why
The item was removed while your page was open.
Fix
Reload the Menu tab.
404Stock item not found
Why
A recipe line references a stock item that no longer exists.
Fix
Choose a current stock item in Inventory.
404Note not found
Why
The menu note was already resolved and removed, or belongs to another hotel.
Fix
Reload; nothing else to do.
403Your role (<role>) has "View only" on Payments; this action needs "Can edit".
Why
Your Payments level is too low for the button.
Fix
Ask a Restaurant Manager; see User Roles.

Terms

KDS, 86, pass, recipe, cover.

KDS
Kitchen display system, the kitchen status on a ticket and the screens that show it.
Sold out
Off the menu for now (kitchen slang: 86'd). A sold-out dish is hidden on the till and cannot be rung.
Pass
Where plated food waits for a runner; the Ready column.
Recipe
Stock item quantities consumed per portion of a menu item; depleted when the ticket settles.
Room service
A ticket linked to an in-house room; can be charged to the guest folio.