Self-order kiosk

Goal

Let guests build an order on a kiosk terminal and send it to the kitchen; payment stays at the counter unless your policies say otherwise.

Who it is for

Staff who set up the device (pos.view); guests use the kiosk UI. Profile must include capability self_order_kiosk.

Preconditions

• Terminal preferably register_type kiosk, active, with open session if your settle path requires it.
• Capability enabled on the POS profile; order types allowed in kiosk policies (dine_in / takeaway).
• Menu / modifiers published for restaurant layouts.

Steps

1. Open Self-Order Kiosk (/kiosk). Staff picks terminal (stored as bos.kiosk.terminal_id).
2. Flow: loading → setup → welcome → order type → menu (+ modifiers) → review → confirmation.
3. Optional guest name when policy require_guest_name is on.
4. Submit creates a restaurant order with send: true and metadata.source: 'kiosk' (POST /v1/pos/restaurant/orders) — typically pay at counter.
5. Idle timeout (default ~90s, min 20) resets to welcome.

Result

Kitchen receives the ticket; guest sees confirmation. Staff settles payment on frontline/waiter as configured.

Hard stops

• Self-ordering is not enabled (capability missing).
• No suitable terminal / inactive register.
• Item sold out (86) or off menu.

Related

• Kitchen display
• Run a sale
• Terminals