Rider App (Delivery & Waiter Mobile)

Note: Delivery is mainly run from the counter delivery queue (see Deliveries). The rider app still works alongside it.

Plain-English summary#

The rider app (Android + iOS) is the phone in your delivery rider's pocket — and, in waiter mode, the same app takes dine-in orders at the table. A rider signs in with email and password, picks the organisation and outlet, and sees the delivery queue. They tap Mark as Enroute when leaving with an order (this also assigns unassigned orders to them), then Settle at the door to record the payment (cash, card, or transfer with a slip photo) if the order isn't already paid, and finally Mark as Delivered. At the end of the shift they hand over the cash they collected so the cashier can accept it into the register session. Updates appear live, just like on the POS.

When you'd use this#

• Setting up a new delivery rider or waiter on the app
• Answering "the rider marked it delivered — where's the cash?" (the handover and acknowledge steps)
• Working out why a rider can't log in (role needed) or can't see orders (organisation/outlet selection)
• Understanding what the rider sees at each order status

Walkthrough — the rider's loop#

1. See the queue — the delivery home lists the outlet's delivery orders with status tabs Open / Ready / Enroute / Delivered and a search box. A separate Assigned Orders screen shows the rider's own orders. Header icons: unassigned orders, assigned orders, cash on hand, more.
2. Get assigned — or self-assign — a dispatcher can assign the order from the counter's driver-assignment window (see Deliveries), and it appears in the rider's app. Or the rider opens an unassigned order and taps Mark as Enroute, which assigns it to them and updates the status in one step.
3. Settle (collect payment) — once the order is Enroute and not yet paid, the main button changes to Settle. It opens the payment sheet: pick Cash, Card or Transfer (Transfer asks for a photo of the slip from the camera or gallery). The amounts must add up to the order total before you can confirm. The sheet has Pay (records the payment) and Pay & Close (records it and closes the order). Cash settlements add to the rider's Cash On-Hand.
4. Delivered: once the order is paid, the button changes to Mark as Delivered; tap it at the customer. An order that was already paid goes straight from Enroute to Mark as Delivered. The POS delivery queue shows these changes live. Only the rider moves delivery orders along — kitchen "served" updates don't.
5. Cash On-Hand — the dollar icon shows total cash held, completed-order counts, a weekly calendar, and each day's transactions.
6. Handover — at end of shift, Handover Cash fills in the amount held (you can change it for a partial handover). Confirm to hand it over.
7. Acknowledge (cashier side) — the handed-over cash appears in the register session's Delivery Cash tab, where the cashier accepts it into the session's Expected balance. Rider cash that isn't acknowledged shows as an unexplained difference when the session closes. See Cash Handling and Deliveries.

Waiter mode (brief)#

The same app can take dine-in orders: pick a table from the floor plan, browse the menu with variants and add-ons, confirm the order with customer, discount and sector options, update each item's kitchen status, print receipts and kitchen tickets (KOTs), and join a register session. It works like the counter POS.

Key concepts#

• Self-assign with Mark as Enroute — marking an unassigned order enroute assigns it to the rider in one step. Dispatch from the counter is optional.
• Settle ≠ Delivered — Settle records the money; Delivered means the food arrived. The button goes Mark as Enroute, then Settle if the order is unpaid, then Mark as Delivered.
• Cash On-Hand — the running total of cash the rider holds. It goes up with cash settlements and down with handovers. The cashier's acknowledgement (session Delivery Cash tab) is what moves it into the register's Expected balance.
• Roles decide modes — the Delivery Driver (or Delivery Rider) role gives the delivery half of the app, the Waiter (or Server) role gives waiter mode. Both roles = both tabs.
• Status tabs — Open / Ready / Enroute / Delivered.

Common questions#

Q: How does a rider get the app? A: Ask your organisation admin for the current build — it's not in the app stores. The Driver tile in the admin app switcher is marked "coming soon", so Foodops doesn't link to the app yet.

Q: What does a rider log in with? A: Email and password. Any valid account can sign in, but the account needs the Delivery Driver or Delivery Rider role to get the delivery half of the app (or Waiter or Server for waiter mode). With neither role, the app shows no Waiter or Delivery tabs.

Q: The rider logs in but sees no orders. Why? A: Check (1) the right organisation and outlet are selected (the Organizations list in the profile menu, and the Switch Outlet screen), (2) the order is a delivery order in that outlet's queue, (3) the phone is online — the app doesn't load anything offline.

Q: Does the rider have to be assigned by the cashier? A: No — the counter can assign from the driver window, but a rider can also open an unassigned order and tap Mark as Enroute to take it.

Q: How does the rider record a cash payment? A: Open the order → Settle → choose Cash → confirm. The amount is added to their Cash On-Hand automatically.