1. Purpose of the Analytics Dashboard

KaHero Analytics provides an overview of sales performance, transaction activity, top-selling items, cashier
duty, employee duty, and stock information. The dashboard also provides tools for selecting a device,
synchronizing data, and moving between dates.

2. Dashboard Features

3. How to Use the Dashboard

Step 1 – Select a Device

Tap the device/filter control at the top of the dashboard and select the device you want to review.

Step 2 – Resync the Data

Tap “Resync Data” after selecting the device. Allow the synchronization to finish before reviewing the figures.

Step 3 – Select the Date

The date is displayed below the top controls. Tap the left arrow to view a previous date or the right arrow to view a following date.

Step 4 – Review Sales Summary

Review Transactions, Net Sales, and Average Sales to get a quick view of the selected day's performance.

Step 5 – Review Transaction Activity

Use the activity panel to identify the times when transactions were recorded. Use the left and right arrows to navigate through activity periods.

Step 6 – Review Top Selling Items

Check the Top Items section to identify products with the highest sales activity. The displayed quantity and sales amount can help identify best-selling products.

Step 7 – Review Cashier Duty

Check the Shifts/Cashier Duty section to review cashier duty information shown for the selected date.

Step 8 – Review Employee Duty

Use the Employees section to access employee-duty information.

Step 9 – Check Stock

Use Item Stock or Modifier Stock from the bottom navigation to review inventory-related information.

Step 10 – Open Settings or Chat Support

Use Settings for available configuration options.

4. Understanding the Main Sales Figures

5. Recommended Workflow

For the most reliable review, first select the correct device, then resync the data. Confirm the date before interpreting the figures. Review the Sales Summary, Transaction Activity, Top Selling Items, and Cashier Duty sections. If figures appear incomplete, perform another data synchronization and verify that the correct device and date are selected.

6. Quick Reference

Top controls: Select Device → Resync Data → Select Date
Sales review: Transactions → Net Sales → Average Sales
Activity review: Transaction Activity → Top Selling Items → Cashier Duty
Other tools: Employees Duty → Item Stock → Modifier Stock → Settings → Chat Support.

Process at a glance

Part 1 — Customer website: Select product → Add to order → Checkout → Enter customer details → Review summary → Place order.
Part 2 — OTP and tracking: Retrieve the SMS OTP → Verify and place order → Save the tracking number → Open the top-right Track icon → Track your order.
Part 3 — POS: Register → Orders → Open the customer order → Move it through Pending, Confirmed, Preparing Order, Ready for Delivery/Pickup, and Completed → Print the order.

1. Place an order on the customer website

Steps

1. Open the Kahero Client Order Online website.
2. Select or punch the product (example: Coke), then tap Add. Adjust quantity if needed.
3. Open the cart and tap Proceed to Checkout.
4. Fill in the customer details: full name, phone number, email, delivery address, and any order notes. Choose the payment method.
5. Tap View Order Summary, review the items and total, then tap Place Order.

2. Verify the order and track it

1. After placing the order, the website asks for OTP verification. Check the customer's phone for the SMS from Kahero.
2. Enter the OTP in the Verify OTP prompt, then tap Verify & Place Order.
3. When the order confirmation appears, copy or record the tracking number shown in the message.
4. Tap the Track truck icon at the top-right of the website. Enter the tracking number and tap Track to view order status.

3. Process the online order in POS

1. In POS, open Register, then select Orders.
2. Find and select the customer’s online order. Review the customer, items, amount, and tracking/order reference.
3. Tap Mark as Confirmed (or select the Confirmed status) to confirm the order.
4. Update the order status in sequence as work progresses:

Pending → Confirmed → Preparing Order → Ready for Delivery/Pickup →Pay Order → Pay → Confirm Payment → Completed

5. When the order is completed, tap Print this order to print the order record

Reminder: Select the status that reflects the order’s actual progress. Mark Completed only after the order has been fulfilled.

Step 1 — Enable Online Catalog

1. In Backoffice, go to Settings > Features.

2. Find Online Catalog under Business Features.

3. Turn on the Online Catalog toggle

Step 2 — Configure the Online Store

1. Go to Settings > Online Store.

2. Fill in the required Online Store information.

3. Review the details before continuing.

Step 3 — Enable Dining Option & Create a Dining Option Fee

1. Go to Settings > Features.
2. Find Dining Option under Sales & Orders.
3. Turn on the Dining Option toggle.
4. Go to Miscelleneous > Dining Option Fee.
5. Add Dining Option Fee.

Step 4 — Fill in Dining Option Fee

1. Fill in the Dining Option Fee Details, including the name, type, and value.
2. Click Save Dining Option Fee.

Step 5 — Create and Enable the Dining Option

1. Go to Miscellaneous > Dining Option.
2. Click Add and fill in the Dining Option details.
3. Select the applicable Dining Option Fee.
4. Enable Available on Register.
5. Enable Show in Online Store.
6. Click Save Dining Option.

Step 6 — Set Pick-Up as the Default Dine Type

1. Go to Settings > Online Store.
2. Under Default Dine Type, select Pick-Up.

Step 7 — Upload the Store Logo and Cover also Add the Store Location

1. In Settings > Online Store, open the Appearance tab.
2. For Store Logo, click Browse and upload your logo.
3. For Store Cover, click Browse and upload your cover image.
4. Check the preview to confirm the images are displayed correctly.
5. Open the Location tab.
6. Fill in the store Address and Search Location information.
7. Review the map/location details.
8. Click Save Store Settings.

Step 8 — Copy and Share the Online Store URL

1. Go to Settings > Online Store.
2. Click the Attachment/Link icon beside the URL Name field.
3. Copy the generated Online Store URL.
4. Send the URL to the client so customers can order online.
5. You may also paste the URL into any webpage, social page, or other page that you have created.

Device: XPrinter + Tablet / POS Machine
Connection: Wi-Fi Router + Ethernet Cable

1. Before You Start

Use this manual when an XPrinter is connected through Ethernet/Wi-Fi but KaHero POS cannot print, cannot detect the printer, or a test print fails.

Quick checklist

• Printer has paper and the paper is loaded correctly.
• There is no paper jam.
• Power cable is securely connected.
• Ethernet cable is connected from the printer to the Wi-Fi router.
• Tablet/POS is connected to the same Wi-Fi network as the printer/router.
• KaHero POS is open and the correct printer configuration is saved.

2. Printer Has No Power / Does Not Print

Step 1 — Check the power connection

1. Turn the XPrinter off.
2. Reconnect the power cable firmly.
3. Turn the printer on.
4. Check whether the printer indicator lights respond.

Step 2 — Check paper and paper jam

1. Open the printer cover.
2. Confirm paper is installed correctly.
3. Remove any jammed paper.
4. Close the cover securely.

Step 3 — Check the Ethernet cable

1. Disconnect the Ethernet cable from the printer and router.
2. Reconnect both ends firmly.
3. If available, try another Ethernet cable or router port.

Expected result: The printer powers on normally and is physically connected to the network.

3. Printer Cannot Be Found / Wrong IP Address

Print the printer network configuration report

1. Switch the XPrinter OFF.
2. Press and hold the FEED button.
3. While holding FEED, switch the printer ON.
4. Wait for the printer to print the network configuration.
5. Release the FEED button after printing.

Locate the IP Address on the printed report. KaHero's Ethernet troubleshooting guide uses this report to verify the printer's network address.

Compare the network

• Check the Wi-Fi network used by the tablet/POS.
• Confirm the printer and tablet/POS are on the same local network/subnet.
• If the printer IP has changed, update the printer IP in KaHero POS.

4. KaHero POS Cannot Print

The official Ethernet setup flow includes adding the printer, selecting Ethernet, entering/searching the printer IP address, configuring paper width/DPI, enabling printer capabilities, and using Test Print.

Check these settings

• Printer Name: Use a clear name such as “Receipt Printer”.
• Connection Type: Ethernet.
• IP Address: Use the IP address printed by the XPrinter network report.
• Paper Width: Select the actual printer paper size, commonly 58mm or 80mm.
• DPI: KaHero's setup guide recommends 180 DPI for the supported configuration.
• Print Receipt / Print Order: Enable the capability required by the store.

Run Test Print

After saving or opening the printer configuration, use Test Print. If the test print succeeds, the printer connection and basic configuration are working.

If Test Print fails

• Recheck the IP address.
• Confirm the tablet/POS is connected to the correct Wi-Fi network.
• Confirm the printer and router are powered on.
• Reconnect the Ethernet cable.
• Restart the printer and router, then test again.

5. Test Print Works but Receipt Does Not Print

If Test Print works but a transaction does not print, check the printer capability and transaction flow.

Step-by-step

1. Open KaHero POS printer settings.
2. Confirm Print Receipt is enabled for the receipt printer.
3. Confirm the correct printer is selected for the intended function.
4. Save the configuration.
5. Close and reopen KaHero POS if needed.
6. Complete a small test transaction and check the receipt.

For kitchen/order printing, verify Print Order and the assigned printer/group/category configuration. KaHero supports separate printer capabilities for receipts, orders, cash drawer, and sticker labels.

6. Receipt Prints but Paper Size Looks Wrong

1. Check the paper roll width used by the XPrinter.
2. In KaHero printer settings, select the matching 58mm or 80mm paper width.
3. Save the setting.
4. Run Test Print again.

KaHero's Ethernet setup provides 58mm and 80mm receipt-width options.

7. Printer Disconnects or IP Changes

A printer may stop responding if its network address changes. Print a fresh network configuration report and compare the current IP address with the IP saved in KaHero POS.

Recommended support check

• Record the printer's current IP address.
• Record the IP address currently saved in KaHero POS.
• If they are different, update the printer configuration to the current IP.
• Run Test Print.
• If the issue returns repeatedly, ask the store/network administrator to check the router's IP assignment settings.

8. Basic KaHero App Troubleshooting

Before changing app data, confirm the device has a stable internet connection. KaHero's Basic Troubleshooting guide recommends checking internet connectivity first.

Try these in order

1. Close KaHero POS completely.
2. Reopen KaHero POS.
3. Check the printer configuration and IP address.
4. Run Test Print.
5. If the issue remains, restart the tablet/POS and printer.
6. Test again.

Important: Avoid clearing app storage unless the required account/data precautions have been completed. KaHero distinguishes Clear Storage, which removes app data, from Clear Cache, which removes temporary cached data.

9. Support Escalation Checklist

If the issue remains, collect the following information before escalating:
• KaHero account email.
• KaHero POS app version.
• Android tablet/POS model.
• XPrinter model.
• Connection type: Ethernet/Wi-Fi.
• Printer IP address from the network report.
• IP address saved in KaHero POS.
• Photo of the printer network configuration report.
• Photo/video showing the issue.
• Result of Test Print.
• Exact error message, if any.

Send the complete details to KaHero Technical Support so the team can reproduce and investigate the issue efficiently.

10. Quick Troubleshooting Flow

Use this quick decision guide during a client support session:

Before You Start

Please click this link to watch the video on how to set up your Ethernet printer.
https://drive.google.com/file/d/1fY5ZgNGNPrL_cllS4jjvWheOMiXKJPWF/view?usp=sharing

Step 1. Turn On XPrinter

Power on the XPrinter and wait until it is ready.

Step 2. Allow KaHero Permissions

Go to: Settings → Apps & Notifications → KaHero app → Permissions

Enable all permissions:
• Camera
• Location
• Microphone
• Notifications
• Storage

Step 3. Connect to Printer WiFi

Settings > WiFi > Connect to WiFi Printer.

Step 4. Configure Printer

Go to STA Settings > Select office WiFi > Enter WiFi password > Enable Obtain IP Address > Save.

Open browser and type 10.10.10.254

Username: admin Password: admin

Step 5. Restart Printer

Restart the printer. It will print the printer IP Address.

Step 6. Add Printer in KaHero

Open KaHero POS > Login Account > Login User > Menu > Device & Integrations > Printer > Add Printer

Interface: Ethernet - MAC Address: Enter the printed IP Address - Enable Receipt and Bill- Save.

Purpose:
Use Printer Order Groups to route selected product categories to a specific printer. This is useful when different categories need to print on different XPrinters.

Quick Setup Flow

Step 1 — Enable Printer Order Groups

First, enable the Printer Order Groups feature so you can create groups and assign categories to printers.
Path: Menu → Settings & Preferences → Features

1. Open the Menu.
2. Select Settings & Preferences.
3. Select Features.
4. Under Kitchen Management, find Printer order groups.
5. Turn the switch ON.

Step 2 — Create a Printer Group

Create a printer group and assign the product categories that should be routed to that group.
Path: Menu → Device & Integrations → Printer Groups

1. Open Device & Integrations.
2. Select Printer Groups.
3. Tap the + button to add a printer group.
4. Enter your preferred Group Name (example: Food).
5. Tap Select categories.
6. Check the categories you want this printer group to handle.
7. Tap Done, then tap the Save icon.

Step 3 — Add and Configure the XPrinter

After creating the printer group, add the XPrinter and assign the printer group to it.
Path: Menu → Device & Integrations → Printers →Add → Enter the Printer Name →Enable Print Order → Select Groups →Save

1. Open Device & Integrations.
2. Select Printers.
3. Tap the + button to add a printer.
4. Enter the Printer Name (example: Kitchen Printer).
5. Configure the printer connection and basic printer details as needed.
6. Scroll down to the Controls section.
7. Make sure Print Orders is enabled.
8. Under Printer Groups, tap to select a group.
9. Check the printer group you want this XPrinter to use, then tap Done.
10. Review the settings and tap the Save icon.

Before You Start

• Prepare two devices: one device running the KaHero POS app and one device for the KaHero KDS app.
• Connect the POS device and KDS device to the same Wi-Fi network.
• Make sure the KaHero POS app is updated to the required/latest version provided by KaHero Support.
• The KDS device must remain connected to the same network while using KDS.

Part 1 — Install and Get the KDS IP Address

Step 1 — Install KaHero KDS
Install the KaHero KDS app on the device that will be used as the Kitchen Display.

Step 2 — Open the KDS App
Open the KaHero KDS application after installation.

Step 3 — Open KDS Settings
Tap the Settings on the KDS screen.

Step 4 — Copy the IP Address
In Settings, locate the IP Address shown under the connected-device section. Use this exact IP address when configuring the Kitchen Display in KaHero POS.

Important: The IP address displayed here is the address to enter in KaHero POS. The IP address shown in the example image is for illustration only; use the IP address shown on your own KDS device.

Part 2 — Enable Kitchen Display in KaHero POS

Step 5 — Open KaHero POS Menu
On the POS device, open the KaHero POS app and open the Menu.

Step 6 — Enable Kitchen Display
Go to Settings & Preferences → Features. Find Kitchen display and turn it ON.

Step 7 — Open Kitchen Displays
Return to the Menu and go to Devices & Integrations → Kitchen Display.

Part 3 — Add and Configure the KDS

Step 8 — Add a Kitchen Display
In Kitchen Displays, select the option to add a new kitchen display.

Step 9 — Enter the Display Name
Enter a name that identifies the KDS device, such as Kitchen KDS or Kitchen 1.

Step 10 — Enter the IP Address
Enter the same IP address shown in the KDS app. Double-check every number before saving.

Step 11 — Select Categories
Tap Select categories. Check only the specific item categories that you want to appear on this KDS. For example,
select Drinks, Snacks, or other kitchen categories as needed.

Step 12 — Save the Configuration
Tap Done after selecting the categories, then save the Kitchen Display configuration.

Step 13 — Confirm Connection
Return to the Kitchen Displays list and verify that the KDS status shows Connected. This confirms that the POS can communicate with the KDS.

Required Devices

Connection Setup

Cash Drawer → cash drawer cable → XPrinter → USB → Tablet/POS Machine

The cash drawer must be connected to the cash-drawer port of the XPrinter. The XPrinter is then connected to the
Tablet/POS Machine. When a receipt is printed through KaHero POS, the XPrinter sends the drawer-open
command.

Step 1 — Connect the Cash Drawer to the XPrinter

Turn off the XPrinter before connecting the cables.

1. Locate the cash-drawer port on the XPrinter, commonly labeled DK or Cash Drawer.
2. Connect the cash drawer cable to the XPrinter's cash-drawer port.
3. Connect the other end of the cable to the Cash Drawer.
4. Turn on the XPrinter.

Step 2 — Connect the XPrinter to the Tablet/POS Machine

1. Connect the XPrinter to the Tablet/POS Machine using the USB cable.
2. Make sure the XPrinter is powered on.
3. Open the KaHero POS application.
4. Go to Menu → Device & Integration → Printer.
5. Add or select the connected XPrinter.
6. Select Receipt Printer.
7. Enable Receipt and Bill.
8. Enable Cash-drawer
9. Tap Save.

Expected Result

Troubleshooting

1. Make sure the XPrinter is powered on.
2. Check that the cash drawer cable is securely connected to the XPrinter and cash drawer.
3. Check that the XPrinter is properly connected to the Tablet/POS Machine.
4. Confirm that the correct XPrinter is selected in KaHero POS.
5. Confirm that Receipt Printer is selected and Receipt and Bill are enabled.
6. Close and reopen KaHero POS, then perform the test again.

Note: If the receipt prints but the cash drawer does not open, check the cash-drawer cable and the cash-drawer port on the XPrinter. The drawer must be connected to a supported cash-drawer port for the automatic-open function.

Required Equipment

Step 1: Allow KaHero App Permissions

Go to: Settings → Apps & Notifications → KaHero app → Permissions

Enable all permissions:
• Camera
• Location
• Microphone
• Notifications
• Storage

Step 2: Login to KaHero POS

1. Open the KaHero POS app.
2. Login to your account.
3. Select Store
4. Select User
5. Enter PIN

Step 3: Add Printer

1. Tap Add Printer.
2. Select Interface: USB.
3. Tap Search/Scan.
4. Select the XPrinter.
5. Printer Type: Sticker Printer/Receipt.
6. Sticker (Set Y Position to 50) / Receipt (Enable Receipt and Bill.)
7. Tap Save.

Troubleshooting

1. Make sure the XPrinter is powered on.
2. Check that the USB cable is properly connected to both the printer and the Tablet/POS Machine.
3. Disconnect and reconnect the USB cable, then try Search/Scan again.
4. Close and reopen the KaHero POS application.
5. Confirm that the correct XPrinter is selected.
6. Check that the correct Printer Type and Receipt/Bill options are enabled.

Important: If the XPrinter is not detected after checking the USB connection, please provide the device specifications and a screenshot or video of the printer settings so the setup can be checked.

1. Recommended Printers

2. Choosing the Printer

Receipt printing: Select a Thermal Receipt Printer.
• Sticker/label printing: Select a Thermal Sticker Printer.
• 80 mm receipt: ITPP047.
• 58 mm receipt: JP-58H, XP-58IIH, or POS-5890Y.
• 48 mm sticker: XP-236B.
• Bluetooth: JP-58H, XP-58IIH, or XP-236B.
• LAN: ITPP047.
• USB: All five listed models.

3. Basic Connection Guide

USB: Turn on the printer → connect it to the POS/tablet → confirm recognition → open KaHero POS → configure the printer→ test print.

Bluetooth: Turn on the printer → enable Bluetooth on the POS/tablet → pair with the printer → open KaHero POS Device & Integrations → select the paired printer → test print.

LAN: Connect the printer to the local network → ensure the POS and printer are on the appropriate network → identify the printer IP/network address → configure the LAN printer in KaHero POS → save and test print.

4. KaHero POS Printer Setup

1. Confirm the printer model and print width.
2. Confirm the required interface: USB, Bluetooth, or LAN.
3. Turn on and connect/pair the printer.
4. Open KaHero POS.
5. Go to Menu → Device & Integrations → Printer.
6. Add/select the appropriate printer interface.
7. Set the correct paper size/print configuration.
8. Enable the printer for Receipt/Bill or Sticker printing.
9. Save the configuration.
10. Perform a test print before live transactions.

Troubleshooting

Support tip: When requesting technical support, provide the printer model, connection type, POS/device model, KaHero POS version, and a photo or video of the issue when possible.

Before You Start

Step 1: Allow KaHero Permissions

Settings → Apps & Notifications → KaHero → Permissions

Enable all permissions:
• Camera
• Location
• Microphone
• Notifications
• Storage

Step 2: Login to KaHero POS

1. Open the KaHero POS app.
2. Login to your account.
3. Select Store
4. Select User
5. Enter PIN

Step 3: Enable Scanner in Register

Menu → Settings & Preferences → General → Register

Enable: Use Scanner on Scanning Barcode.

Step 4: Configure Barcode Scanner

Menu → Device & Integrations → Barcode Scanner

Select: Keyboard.

Step 5: Test the Scanner

Go to Register and scan a product barcode. The item should automatically appear in the POS.

Troubleshooting

Before You Start

Step 1: Pair the XPrinter with Bluetooth

1. Open Settings on your tablet or phone.
2. Tap Bluetooth.
3. Turn Bluetooth ON.
4. Select the XPrinter name.
5. Wait until the status shows Connected.

Step 2: Allow KaHero App Permissions

Go to: Settings → Apps & Notifications → KaHero App → Permissions

Enable all permissions:
• Camera
• Location
• Microphone
• Notifications
• Storage

Step 3: Login to KaHero POS

1. Open the KaHero POS app.
2. Login to your account.
3. Select Store
4. Select User
5. Enter PIN

Step 4: Add the Bluetooth Printer

Menu → Device & Integration → Printer

1. Tap Add Printer.

2. Select Interface: Bluetooth.

3. Tap Search/Scan.

4. Select the XPrinter name.

5. Scroll down.

6. Enable Receipt and Bill.

7. Tap Save.

Troubleshooting

Before You Start

Step 1: Pair the XPrinter via Bluetooth

1. Turn ON the XPrinter sticker printer.
2. Open Settings on your tablet/phone.
3. Tap Bluetooth and enable it.
4. Select the XPrinter name.
5. Wait until it shows Connected.

Step 2: Allow KaHero App Permissions

Go to: Settings → Apps & Notifications → KaHero app → Permissions

Enable all permissions:
• Camera
• Location
• Microphone
• Notifications
• Storage

Step 3: Login to KaHero POS

1. Open the KaHero POS app.
2. Login to your account.
3. Select Store
4. Select User
5. Enter PIN

Step 4: Add the Sticker Printer

Go to: Menu → Device & Integration → Printer

1. Tap Add Printer.
2. Select Interface: Bluetooth.
3. Tap Search/Scan.
4. Select the XPrinter name.
5. Printer Name: Sticker Printer.
6. Printer Type: Sticker Printer.
7. Scroll down.
8. Set Y Position to 50.
9. Tap Save.

Troubleshooting

• Back Office Setup
• Process

If you are not allowing non-admin users of KaHero POS to delete dine-in tickets, you can now set a pass code to prevent non-admin users from deleting them.

You can access this setting from the back office or app.kahero.co.

Back Office Setup

On the Navigation Menu, go to Settings, then click General. > Register Tab then turn on the "Require Passcode" and Enter a 4 digit passcode

Save your settings.

Process

Now that you have set a pass code, non-admin users are now unable to delete dine-in tickets.

Non-admin user creates a dine-in ticket.

Non-admin user saves dine-in ticket as open ticket.

Non-admin user attempts to delete saved dine-in ticket.

Non-admin user is sent to this window.

On the "Navigation Menu", click "Settings and Preferences", then select "General".

You can select "Language & Timezone Settings".

Click on the drop down beside "Receipt Date Format". Choose your desired format. After selecting your desired format, click "Save".

Create a transaction on the register. Then proceed to payment and receive your customer's payment.

The date on your printed receipts will display according to your desired format.