Common Problems and How to Fix Them
Introduction
Each problem below starts with what you see, then explains Why it happens, how to Fix it, and When to contact support. Support is at 0718569505 or info@olininnovations.co.ke.
Printing
Read Printers and Print Management first if you are new to printing. Web prints go through the print agent on a computer in your business.
A lodge receipt or bill never prints
Why: Lodge receipts and bills are sent to the print agent on the computer that the Accommodation printer is attached to. Nothing comes out when:
- the agent is not running on that computer (it is off, closed, or not set to start with the computer), or
- the computer name is not one that any agent has registered, so no agent picks the job up, or
- no Accommodation printer has been chosen. You then see "Accommodation printer not configured. Please configure in Print Management."
Fix:
- Open Print Management > Printers. Find the accommodation printer. Its Last Seen column should show a green Online badge. If not, start the print agent on that computer and keep it running.
- Open the Accommodation tab and check Receipt Printer is set to the right printer.
- Open the Print Jobs tab and press Refresh. Jobs waiting here mean no agent is collecting them. When the agent comes back online it collects them.
- Reprint the receipt.
When to contact support: The agent shows Online and the printer is right, but jobs stay in Print Jobs. Or old lodge receipts from before an update are still waiting.
A print fails, then works when you try again
You see a red Print failed message: "(title) did not print. Check the printer, then reprint."
Why: The printer could not be reached on the network at that moment, for example a connection that timed out. The agent already tries 3 times, a couple of seconds apart, before giving up. A weak Wi-Fi signal, a loose cable, a switch that is busy or a printer whose address keeps changing all cause this.
Fix:
- Check the printer is on and has paper, and its cable or Wi-Fi is fine.
- In Print Management > Printers check the IP Address and Port are right (port 9100 for most printers).
- Ask whoever looks after your router to reserve a fixed address for the printer, so its address does not change.
- Press the print button again.
When to contact support: It happens several times a day even after the checks above.
The kitchen ticket does not print
Why: One of these:
- Order Ticket Printing is switched off for the department in Admin > Settings. No kitchen or bar ticket prints at all.
- The department has no Order printer for this till's computer (and no Bill printer to fall back on). The Settings screen shows an amber No order printer badge for departments with none.
- This browser is Not Identified under Print Management > Computer ID, so Hotel360 does not know which printers belong to this till.
- The agent on the printer's computer is not running.
Fix: Check each of those in turn. See Users, Roles and Settings and Printers and Print Management.
When to contact support: All of the above is right and a ticket still does not print.
Counter or drinks items print in the kitchen
Why: Items go to a station only when their sub-category has Print orders at set to that station and the department has an order printer with that station name. If the station has no printer, those items fall back to the kitchen ticket. This is deliberate, so nothing is lost.
Fix:
- In Print Management > Department Printers, add an Order printer to the department with the station name in Station (optional) (for example Counter). Check the table shows an amber Station: Counter badge.
- Edit the sub-category (POS > Products > Add Product > + next to Subcategories) and set Print orders at to the station. The drop-down only appears once the station printer exists.
- Check the station printer's computer has its agent running.
See Order Stations.
When to contact support: The station printer exists and the sub-category is set, but items still print in the kitchen.
"No bill printer configured for this computer"
Why: Hotel360 looks for a Bill printer for this till's computer in the department you are working in. It does not find one. Either this browser has no computer name, or the department has no Bill printer for that computer. You may also see "No bill printer for computer '…'. Configure one in Print Management."
Fix: Open Print Management > Computer ID and choose this computer's name. Then in Department Printers add a Bill printer for this computer to the department you are in.
When to contact support: The computer name is not in the list, which means no agent has ever connected from it.
Bills and Payments
Sales and collections show different figures
Why: They answer different questions. Sales are counted when a bill is raised. Collections are counted when the money is received. A bill raised on Monday and paid on Tuesday is Monday's sale and Tuesday's collection. So a day with many credit sales has low collections, and a day when old bills are settled has high collections.
The Sales & Collections report makes this visible. It shows how much of the period's collections settled bills raised on earlier, closed days (an amber figure). Deposit stays are counted as sales night by night, and unused deposits that were refunded are taken off collections. The Dashboard follows payments, not billing, so it can differ from the Daily Sales report.
Fix: Compare like with like. To see what is still unpaid, use Outstanding Bills or Receivables under Reports > Financial Reports. See Financial Reports and The Dashboard.
When to contact support: A bill's payment is clearly missing from collections, or a figure does not move at all after a payment.
The report "day" does not start at midnight
Why: Your department has an End of Day rollover time. A business day then runs from one rollover to the next, for example 04:00 to 04:00. A sale at 02:30 belongs to the day before. The rollover comes from, in this order:
- the time set by hand the last time the day was closed on Reports > Stock Reports > End of Day (Day rolls over at),
- else the automatic End of Day time in Admin > Settings,
- else midnight.
When a rollover is set, the time boxes in report filters are ignored, so the day boundary stays the same for everyone.
Fix: To go back to calendar days, type 00:00 in Day rolls over at when you next close the day (a time you leave untouched is not saved). To change the time, change it there or in Admin > Settings > Automatic End of Day. See Users, Roles and Settings.
When to contact support: A report ignores the rollover you set.
An M-Pesa STK payment is not found yet
You see "Payment is still processing. Please wait and check again.", "Payment confirmed, waiting for transaction details..." or "No matching transactions found".
Why: The customer has not entered their PIN yet, the confirmation from the bank or M-Pesa has not reached Hotel360 yet, or the payment went to a different till or account.
Fix:
- Ask the customer to complete the prompt on their phone.
- Wait a few seconds and check again. You see "Payment received! Processing bill..." when it comes through.
- If the customer already has the M-Pesa message, choose Search Transaction and type the M-Pesa code (or the last characters shown in the box). Pick the matching payment.
- For Co-op Bank, Hold for Verification lets you record the full transaction code and settle later.
- If it says "Payment failed or was cancelled. Please try again or use another method.", send it again or use another payment mode.
Do not take the money again by cash until you are sure the first payment failed. Check Office > Transactions first.
When to contact support: The customer has paid, the message shows, and the payment never appears in Transactions.
"Cannot add items" because of a pending bills limit
You see "Cannot add items. You have reached your personal (or global) pending bills limit of …".
Why: The business has switched on a limit on how much a staff member may leave unpaid, and this person's pending bills have reached it.
Fix: Clear or settle some pending bills, then try again. A manager can change the limit under Admin > Settings > Pending Bill Limit.
When to contact support: The total shown does not match the bills you can see.
Accommodation
You cannot take more than the balance on a booking
You see "Payment amount cannot exceed balance of …".
Why: A normal payment can only cover what is owed now: the room balance plus any unpaid bills charged to the room.
Fix: If the guest wants to pay in advance, take the payment as a lump-sum deposit. In the payment window switch on Take as lump-sum deposit, then enter the Deposit Amount. It can be more than the balance. It is used night by night, and anything unused is refunded at checkout. This option only appears when:
- Allow lump-sum deposits is switched on under Accommodation > Settings,
- you have the Take lump-sum deposits permission, and
- the booking is active (the guest is in the house).
A deposit covers the room only. Bills charged to the room are paid separately. A deposit cannot be complimentary. See Payments, Deposits and Checkout.
When to contact support: The switch is on, you have the permission, and the option still does not appear.
A booking shows "Deposit used up"
Why: The guest paid a deposit, and the stay has now cost more than the deposit. The next nights are owed as an ordinary balance. The row shows the balance as Bal:. At checkout the window says "Deposit used up: N still owed".
Fix: Collect the balance with Process Payment before or at checkout.
When to contact support: The balance shown does not match the nights stayed.
A paid booking shows "Bills unpaid"
Why: The room itself is paid, but there are bills charged to the room (a meal or drinks put on the guest's room) that are still owed. The Bal: figure is what those bills still owe, after any part-payments. Bills charged to a room stay the guest's debt until paid.
Fix: In the checkout window the Bills charged to room list shows each bill. Use Clear Bill on those bills on the Bills tab, or Process Payment on the booking, before the guest leaves.
When to contact support: The bills are paid and the badge still shows.
Stock
Stock did not go down after a sale
Why: In Admin > Departments > ⋯ > Department Settings:
- Track Stock is off for the department. Sales then neither check nor reduce stock.
- Production Mode is Auto (deduct at end of day). Nothing is deducted at the till. The End of Day closure works out what was used from the day's sales.
Fix: If the department should track stock, switch Track Stock on. For Auto mode, stock updates when End of Day is closed (Reports > Stock Reports > End of Day). See Users, Roles and Settings.
When to contact support: Both settings are as intended and stock still does not move.
The Dashboard shows the wrong number of low-stock items
Why: An item is counted as low when its stock is at or below its Order Level. Items with an Order Level of 0 and no stock are counted, and items you never set an Order Level for will not warn you before they run out.
Fix: Set a sensible Order Level on each item (POS > Products > ⋯ > Edit). See Products, Categories and Prices.
When to contact support: The count does not change after you correct the Order Levels and receive stock.
The Stock Sheet report is empty
Why: The Stock Sheet compares an opening and a closing End of Day snapshot. If the day has not been closed, there is nothing to compare.
Fix: Close the day on Reports > Stock Reports > End of Day, then pick the opening and closing snapshots in the Stock Sheet.
When to contact support: Snapshots exist and the sheet is still empty.
Access and Menus
A user cannot see a menu item
Why: There are two possible reasons:
- Permission. The user's role does not have the permission for that module. For example, Open Production shows Production and Open Expenses shows Expenses. Introduction lists the permission for each item.
- Plan. The business is on the Basic Plan, and the module is Premium-only: Suppliers, Production, Conferences, Services, Payroll, Hotspot, Membership and Messaging. If someone opens it by its address anyway, they land on the Dashboard with "That’s a Premium feature. Upgrade your plan to unlock it." Hotspot also needs Wi-Fi vouchers switched on in Admin > Settings.
Fix: For permission, an administrator ticks it on the role under Admin > User Groups. For plan, contact support to upgrade.
When to contact support: The permission is ticked, the plan is Premium, and the item is still missing.
A newly added permission is not available to anyone
Why: When Hotel360 adds a new permission, it is not on any role. Even the owner's role does not have it until someone ticks it.
Fix: Open Admin > User Groups, choose Edit on the role, find the permission in its group and tick it, then press Update Role. If you cannot find it in the list at all, it has not been created for your business yet.
When to contact support: You cannot find the permission in the role editor.
You open a page and land somewhere else
Why: You opened a page your role is not allowed to use. Hotel360 does not show an error. It sends you to the first page you can use. If you can use none, you are signed out.
Fix: Ask an administrator for the permission. See above.
When to contact support: You are signed out every time you sign in and do not know why.
You are sent to Settings and cannot do anything else
Why: Your password is still the default, 12345, perhaps because your administrator just created or reset your login. Hotel360 will not let you use any other page until you change it.
Fix: Go through Settings > Password, enter 12345 as your Current password and choose a new one. Avoid easy ones: 1234, 1111, 5555 and runs of numbers are refused. See Changing Your Password.
When to contact support: The page does not let you save even with a good password.
Everyone sees "Subscription Expired"
Why: The business's subscription end date has passed.
Fix: Contact support to renew. See Subscription Expired.
When to contact support: Always.