The Hotel360 Phone App
- Introduction
- Signing In
- Finding Your Way Around
- Taking an Order (POS)
- Working with Bills
- Accommodation
- Printers
- Reports
- The AI Screen
- Payment Capture
Introduction
The Hotel360 phone app lets waiters, cashiers and the front desk work from a phone or a handheld till: take orders, print bills, collect payments, manage bookings and look at reports. It shows only what your role allows, so two people can see different buttons on the same screen. If a button below is missing for you, ask your manager to check your role under Administration (see Users, Roles and Settings).
This chapter is a tour of the screens as they appear in the app. For what each action does in the system, see Working with Bills, Booking a Room and Printers and Print Management.
Signing In
- Open the app and enter your Phone Number (for example
0712345678) and Password. - Tap Sign In.
If a field is empty the app says "Please fill in all fields." If the details are wrong you see Login Failed with the reason from the server, or "Login failed. Check your credentials."
Choosing a Store and Department
- If you own more than one store, you first see Select your store. Tap the store to work in. Later you can switch from the top bar, where the store name (with a shop icon) is shown.
- If you belong to one department, the app opens it for you.
- If you belong to several departments, the app opens the first one, unless your business has switched on "ask for department at login". Then you see Select your department; tap one.
- With several departments, a ⇄ Department name button appears in the top bar of the POS, Bills, Accommodation and Menu screens. Tap it to go back to the list. Your bills, products and reports follow the department you chose.
After signing in the app opens the Dashboard if you can view it, otherwise POS if you can take orders, otherwise Accommodation if you can see bookings, otherwise the Menu.
Changing Your Password
If your account still has its first password, the app will not let you in until you change it. Fill in Current password, New password and Confirm new password, then tap Update password. You can also do this any time from Menu > Settings > Change password. If the new passwords differ the app says "The new passwords do not match."
To leave the app, tap Logout in the top bar (or Sign Out at the bottom of Menu > Settings) and confirm.
Finding Your Way Around
The bottom bar has up to four tabs:
| Tab | What it is |
|---|---|
| POS | Take a new order or add to a saved bill. |
| Bills | Find, open, pay, merge and reprint bills. |
| Lodge | The Accommodation screen. Shown only if you have the Create bookings or See all bookings and amounts permission. |
| Menu | A grid of everything else. |
The Menu grid is split into Operations, Reports, Office and Account. A card appears only if your role allows it and, for some cards, your plan includes it (Inventory, Purchasing, Production, Services, Hotspot and Messaging are Premium features). Cards you may meet include Dashboard, Hotel360 AI, Products, Stock, Expenses, Accounts, Customers, the report cards Financial, Sales, Inventory, Restock Order and Accommodation, then Print Management, Printer Setup, Payment Capture, Hotspot / Wi-Fi, Transactions, Messaging, Administration, Notifications and Settings. Hotel360 AI, Printer Setup, Notifications and Settings are shown to everyone. If nothing is available for your role you see "No additional features are available for your role."
Taking an Order (POS)
You need the Take orders permission to save a new bill. Without it the cart shows "🔒 You don't have permission to create bills".
- Open the POS tab. Category buttons run across the top. Tap one to see its products.
- To find something quickly, type in Search products.... The search covers every category and shows "N results across all categories".
- Tap a product to add one to the cart. A green number on the product shows how many are in the cart. Each card also shows its price and "Stock: N".
- If a product is a meal with choices (a combination with options), a sheet opens first: "Choose the options for this item." Pick the required options and confirm. If you miss one the app says "Choose options".
- Tap the green cart button at the bottom right (it shows the item count and total, for example "🛒 3 · KES 1,450").
- In the cart, use + and − to change quantities. For items sold by fraction (for example by weight) the row lets you type a quantity or an amount instead. Clear empties the cart.
- Type the Table (it shows "N/A" if left empty) and, if needed, Chef instructions such as "no onions, extra spicy". The chef instruction is printed on the kitchen order ticket.
- Tap Save or Save & Print.
What the two buttons do:
- Save creates the bill, prints the kitchen order ticket (if an order printer is set up) and prints the cashier's copy (only if your business uses the bill watermark / cashier copy setting). You see "Bill #1234 created".
- Save & Print does the same and also prints the guest's copy of the bill. You see "Bill #1234 saved & printed".
- If printing fails the bill is still saved. The app says "Bill Saved" and "Bill #1234 created but print failed: ..." followed by the reason. Reprint later from the bill (see Opening a Bill).
Note
If auto logout is on for this phone, the app signs you out as soon as the sale is saved, and the message adds "Signing out — auto logout is on for this device." This suits a shared till. Under Menu > Settings > This Device you can switch Auto logout after each sale on or off, but only a user with the Change auto-logout on a device (mobile app) permission can. Others see "Only a manager can change this."
Adding Items to a Saved Bill
- Open the bill in Bills and tap ➕ Add items. It appears only on a pending bill that you created, when you have the Add items to an open bill permission, and, if the guest copy was already printed, the Add items after printing permission as well.
- If your cart already holds items the app asks "Replace current cart?". Tap Replace to continue.
- The POS opens with a yellow strip: "Adding items to a saved bill — add items, then Add to Bill." It lists what is already on the bill (read only). Tap Cancel on the strip to stop.
- Pick the new items and open the cart. The buttons are now Add to Bill and Add & Print.
- The kitchen receives a ticket with only the added items. You see "Items added to bill #1234."
Working with Bills
Finding a Bill
Open the Bills tab. The list opens on today's bills for your department.
- Type an invoice number in Search invoice #... and press search on the keyboard.
- Change the From and To dates.
- Tap a status chip: All, Pending, Partial, Cleared, Hold. Pending needs the See pending bills permission and Cleared needs See cleared bills.
- Tap Filters for From time, To time, Payment method (Cash, Co-op, Card, M-Pesa, Other) and, for managers who have See every user's bills, Staff (My bills, All staff or one person). Without that permission you only see bills you created yourself.
- The line "Page total: KES ..." sums the bills on the page.
- Each row shows the invoice number, time, status, table, waiter and total. A part-paid bill also shows "Paid: KES ... · Balance: KES ...".
- The 🏷️ button opens Tagged Bills, where bills with the same tag (for example "Table 5", across departments) are grouped and can be printed together with 🖨 Print combined.
- The ⏳ button appears only if Co-op Bank is set up. It opens Pending Co-op, the payments you put on hold for verification. Cancel it stops waiting for one, and the bill stays unpaid.
Opening a Bill
Tap a bill to see its items, total, payments and balance. The buttons shown depend on the bill's status and your permissions:
| Button | What it does | Needs |
|---|---|---|
| Void (beside an item) | Removes that item from a pending bill and puts its stock back. If it was the last item the bill is cancelled. | Cancel a bill or void an item |
| ➕ Add items | See above. | Add items to an open bill |
| 🖨 Reprint Bill | Prints the guest copy again ("Bill sent to printer"). | Reprint a bill |
| Add tag / Tag: ... | Groups this bill with the same guest's bills in other departments. Optional, 50 characters. | Add items to an open bill |
| 📶 Issue Wi-Fi voucher | Prints a guest Wi-Fi code. Shown only when the bill qualifies. | Issue a Wi-Fi voucher on a bill |
| Clear / Pay Bill | Opens Record Payment. | Add items to an open bill |
| Bill to Waiter | Charges the unpaid bill to the waiter's payroll ("Mark this bill for waiter deduction?"). | Bill to waiter |
| Charge to Account | Opens a list of customers and in-house guests; tap Charge → on one. | Add items to an open bill |
| Split Bill | Divides a pending, unpaid bill into two or more bills. | Split a bill |
| Comp (on the house) | Settles the bill at no charge. A reason is required. | Comp (on the house) |
| Cancel Bill | Deletes the bill and restores stock. A reason is required. | Cancel a bill or void an item |
Recording a payment. Tap Clear / Pay Bill, type the Amount, pick a payment method, and tap Record Payment. The payment methods are the ones your business registered. Cash needs the Accept cash permission ("You don't have permission to clear with cash"). Methods other than cash need a Transaction reference / code, unless the method is linked to a bank or M-Pesa feed, in which case you pick the matching incoming payment from a list or search by reference, phone or code. For Co-op Bank you can also choose STK Push (needs Send STK push), Search, or Hold (waits for the payment to arrive, then clears the bill by itself). You see "Payment recorded" or "Payment received and bill cleared". For the rules behind payments see Payments and Transactions.
Cancel and Comp both ask for a reason of at least 3 characters ("Please enter a reason (at least 3 characters)."). Tap one of the ready-made reasons, such as "Wrong item entered" or "Customer left" (cancel), or "Manager comp" and "VIP guest" (comp), or type your own.
Split Bill. Enter, for each item, how many go on each new bill; each item must add back to its original quantity. Tap Split ("Split into 2 bills.").
Merging Bills
You need the Merge bills permission. On the Bills tab tap Select (or press and hold a bill), tick two or more bills, then tap Merge Selected. The window shows which bill survives: the oldest one keeps its number, table and waiter, and the others are closed as "Merged into #...". Tap Merge bills to confirm. With fewer than two ticked the app says "Select at least two bills".
Accommodation
The Lodge tab (titled Accommodation) shows three counters at the top: Occupied, Due Out and Arrivals, then the list of bookings. Filter with All, Active, Checked Out or Cancelled, or search "booking # or guest". Each row shows the booking number, guest, room, dates, payment status (PAID, PARTIAL or unpaid) and the total. A row can also carry DEPOSIT, REFUND DUE or DEPOSIT USED UP. Without the See all bookings and amounts permission you only see your own recent bookings and no money figures.
Room Status by Floor (for users who can create bookings or manage rooms) shows every room by floor: green for available, red for occupied, grey for maintenance or out of service. Tap a free room to start a booking for it. People with room management rights also get + Add Room and Room Types, and can press and hold a room to edit or delete it.
Making a Booking
You need the Create bookings permission. Tap + New Booking.
- Guest information. Type the guest's name. If the guest has stayed before, suggestions appear; tap one to fill in the phone, ID number, nationality and car registration. Name and Phone are required.
- Dates. Set Check-In and Check-Out (today and tomorrow by default). The app counts the nights (at least 1). Then set Adults and Children.
- Select Room. Tap a Floor, then a room. Only rooms free for those dates are shown, with the room type and nightly rate. If none are free you see "No rooms available for the selected dates."
- Package. Choose Bed Only, Half Board, Full Board, Both or Special. For anything except Bed Only a Package Price box appears.
- Discount. The Discount box appears only if you have the Give discounts on bookings permission.
- Check the summary: Room Rate (nights times the room rate) plus Package minus Discount gives the Total. Tap Create Booking.
If something is missing the app says "Please fill in guest name, phone, and select a room." On success you see "Booking LB-20261112-0001 created" and the booking opens.
Payments, Deposits and Refunds
Open a booking to see the guest, stay, pricing (Room Rate, Package, Discount, Total, Paid, Balance) and the list of PAYMENTS. Buttons along the bottom depend on your permissions and the booking:
| Button | When it shows | What it does |
|---|---|---|
| Record Payment | Active booking with a balance, and you can edit bookings | Opens Record Payment. Choose the amount and method, optionally a REFERENCE, then Submit. You cannot pay more than the balance ("Amount exceeds outstanding balance."). |
| Deposit | Active booking, deposits are switched on in Accommodation Settings and you have Take lump-sum deposits | Opens Take Deposit. The amount may be more than the balance. It is used night by night; anything unused is refunded at checkout, and it covers the room only. |
| Refund Deposit | Checked-out booking with unused deposit and you have Refund unused deposits | Opens Refund Unused Deposit. Enter the AMOUNT (KES) (up to the unused amount), choose PAID BACK BY and an optional reference, then Record Refund. It is recorded as money paid out today. |
| 🏢 Charge to Account | Active booking not yet on a customer account | Puts the room bill on a customer's account. |
The pricing box shows Deposit taken and Deposit left (or Unused (refund due) once checked out). When the deposit runs out it says "Deposit used up: further nights are owed as a balance." In the payment list a deposit is marked "· Deposit" and a refund "· Refund".
A payment method called Complimentary (On the house) appears only if you have the Comp (on the house) permission. It is not offered for deposits.
See Payments, Deposits and Checkout for how these figures are worked out.
Extending, Checking Out and Cancelling
- Extend (active booking with a fixed check-out date). Pick the New check-out date; the window shows New nights, New total and Extra due now. Tap Confirm Extension. Open (no check-out) bookings cannot be extended.
- Checkout asks "Mark this booking as checked out?" then says "Guest checked out".
- Cancel (needs Cancel bookings) asks for a Reason for cancellation; tap Cancel Booking. A reason is required.
- Card, Bill and 🖨 Print print the guest card, guest bill and receipt.
Printers
The app can print to three kinds of printer: the phone's built-in printer (on handheld till devices), a Bluetooth printer paired with the phone, or a network printer (a thermal printer on the shop's Wi-Fi or cable, usually on port 9100). If the phone cannot reach a network printer, the app can hand the job to the print agent (see Printers and Print Management).
Choosing This Phone's Printer
This is the phone's default printer. Open Menu > Settings, then the Printer box.
- The list shows Built-in Printer and the department's network printers. Tap one to select it ("Printer Selected").
- For a Bluetooth printer, first pair it in the phone's own Bluetooth settings. Then tap + Find Bluetooth Printer and choose it. If none is found you see "No Bluetooth printers - Pair your printer in the phone's Bluetooth settings first, then try again."
- Tap 🖨 Test Print to print a test page.
- Remove clears the choice. With no printer selected the box says "No printer selected — bills won't print from this device".
Built-in and Bluetooth printers have no automatic cutter. When one action prints several slips, the app pauses with Tear off the slip and waits until you tap Continue printing.
Printer Setup and Routing
Open Menu > Printer Setup. Everyone can open it.
Add Direct-IP Printer. Enter a Name, the IP Address (for example 192.168.89.5) and the Port (9100 unless your printer says otherwise), then tap Add Printer. The printer appears under My Printers, where Test sends a test page and Remove deletes it. Printers added here are saved on the server, so your other phones see them too.
Bill Routing. Under Bill Routing · Department name each kind of print has a list. Pick the printer that should print it, or leave Use default / server printer:
| Row | Prints |
|---|---|
| Bill (customer copy) | The guest's bill. |
| Cashier copy | The cashier's control slip. It prints only when the bill watermark setting is on; the row says "(currently off)" when it is not. |
| Order / Kitchen | The kitchen order ticket. |
| Lodge receipt | Accommodation receipts and bills. |
| Order — Counter (one row per station) | Order tickets for that station, for example Order — Counter or Order — Bar. |
The Order —
Note
The routing lists offer the Built-in Printer, printers you added in My Printers, and the department's network printers. A Bluetooth printer cannot be picked here. To use Bluetooth, make it the phone's default printer in Menu > Settings (see above).
When a Print Does Not Come Out
The app picks a printer in this order: the routing row for that department and print type, then the phone's default printer from Menu > Settings, then the printer the server has set for the department. An order ticket for a station is stricter: it uses that station's routing row, then the station printer's address from the server, then the print agent, and never the phone's default printer (so counter orders cannot land in the kitchen).
- If a network printer cannot be reached, the app quietly sends the job to the department's print agent, which prints over the shop computer's own connection. This works even if the phone's Wi-Fi is off. If that fails too, you see the first error followed by "Print agent fallback also failed: ...".
- With no printer and no agent you see "No printer configured. Go to Settings → Printer to select one."
- A network printer that does not answer gives "Print timed out — check printer connection."; a Bluetooth printer that is off gives "Bluetooth is off — turn it on to find your printer."
Menu > Print Management (needs Open Print Management) shows the shop's computers and printers, whether each is online and when it was last seen (Printers tab), and the print agent's jobs filtered by Pending, Processing, Completed and Failed (Jobs tab).
Reports
Reports need the See all reports permission (the stock reports can also be opened with the stock reports permission). Open Menu and tap a card under Reports. Each card has tabs across the top:
| Card | Tabs |
|---|---|
| Financial | Daily Sales, Sales & Collections, Cashier Collections, Outstanding Bills, Receivables, Profit & Loss, Accommodation |
| Sales | Products Sales, Services Sales |
| Inventory | Stock Flow, Production Store, Stock Received, Stock Sheet, Spoilage, Purchase Orders and more |
| Restock Order | The daily restock list. |
| Accommodation | Room Summary, Occupancy Report, Discount Report |
Every tab works the same way:
- Set From and To (and Time, where shown) and tap Apply. Most reports start from today; the accommodation ones from the first of the month.
- A summary box gives the totals, then one card per row, for your current department.
- Daily Sales and Profit & Loss have Export PDF, which opens the phone's share sheet.
The numbers match the web reports; see Financial Reports, Sales Reports, Stock Reports and Accommodation Reports for how they are worked out.
The AI Screen
Menu > Hotel360 AI lets you ask questions about your business in plain words, such as "Sales per department yesterday", "Top waiter this week", "Which rooms are occupied now?" or "Which items are out of stock?". Tap an example to ask it, or type under Ask a question… and tap Send. While it works you see "Looking into it…". Under each answer, a short list shows what it looked up (✓ for success).
- New chat (top right) starts a fresh conversation. Your last conversation is remembered when you come back.
- A small note under the box shows "N questions left today". When it reaches zero the box is replaced by "Today's questions are used up. The count starts again tomorrow."
- Offline, you see "I could not reach Hotel360. Check your connection and try again."
The examples and answers follow what your role is allowed to see. More in Hotel360 AI Assistant.
Payment Capture
Payment Capture turns one Android phone, the one that receives your business's M-Pesa and Equity payment messages, into a source of incoming payments. Cashiers then pick those payments when clearing a bill instead of typing codes. It needs the Register phones for M-Pesa SMS capture permission, and the card is under Menu > Payment Capture.
- On the phone that receives the messages, open Menu > Payment Capture. Read How it works. Only messages that confirm a payment (for example "Confirmed. Ksh1,000.00 received from …") are sent; other messages are not sent.
- Edit Name for this phone (for example "Till phone") and tap I agree, use this phone.
- If asked "One more step", tap Open settings and allow notification access.
- Check the Status box: Registered, Notification access (Allowed) and Battery optimisation. If battery optimisation is On, tap Open battery settings, find Hotel360 and choose "Don't optimise" or "Unrestricted", otherwise the phone may stop the app in the background.
- The Activity box shows Payments recorded, Waiting to send, Last payment message and Last sent. If messages are waiting, tap Send now. The app also sends queued messages every time it opens.
- To stop, tap Stop using this phone and confirm. Payment messages are then no longer sent.
Warning
If the phone is switched off, offline, or the app is stopped by battery saving, payments received in that time are not captured until it is back on. Leave this phone charged and connected.
"Not available on this phone" means the phone is not Android or the app is out of date.