Android staff app
The FMX EPOS Android app connects directly to a paired till on the restaurant network. It has the same ordering screens as the browser view. It also pairs with the till and trusts that till’s certificate without installing it on the phone, updates itself from the till, runs full screen and has its own text size.
Requirements
Section titled “Requirements”- Android 8.0 or later.
- A running FMX EPOS till on the same restaurant network.
- Staff Mobile Ordering active on the store licence.
- Mobile App ticked under Remote Access in Back Office → Local Settings → Security on the till. Only an Administrator can change it, in the desktop app on the till PC.
- A till that keeps the same local address, with HTTPS port 5139 reachable.
- The current app package from that till.
The app and the Till have separate version numbers. The till’s Mobile App page shows the app version it offers (App Version) and the oldest version it accepts (Oldest App Accepted).
Download and install
Section titled “Download and install”The till’s Back Office → Local Settings → Mobile App page has two cards: Pair the Mobile App at the top, for pairing the app, and Install the App below it, for downloading it.
Pair the Mobile App
- Till
- Front Till
- Addresses
- 192.168.1.20
- Pairing Code
- K7QD-2MXP-9ZAF
Install the App
- App Version
- 1.5.14
- Oldest App Accepted
- 1.5.12
Illustration, not a screenshot. The real screen can differ with the theme or version.
- On the till, open Back Office → Local Settings → Mobile App.
- On the Android device, scan the Install the App QR code for the till’s address on the shop Wi-Fi, or open the
/mobile/appaddress shown under it. - The phone’s browser warns that the connection is not private, because the till’s certificate is not yet trusted. Check that the address matches the till and continue only to that address. If the browser will not let you continue, open the same download page on the till or another trusted Windows computer, download the APK there and copy it to the Android device in the way the business normally moves files.
- On the Install the App page, select Download App.
- If Android asks, allow the browser or file app to install unknown apps. Allow this only for the app you used to download FMX EPOS.
- Open the downloaded APK and choose Install.
- Open FMX EPOS.
Android may warn that the app did not come from its usual app store. Before you install it, check that the file came from the restaurant’s own till. If the page says “The Android app is missing from this till.”, the till’s installation does not include the app: contact FMX EPOS support.
Pair with the till
Section titled “Pair with the till”- Keep the Android device on the same restaurant network as the till.
- On the till’s Mobile App page, find the Pair the Mobile App card with its QR code, Addresses and Pairing Code.
- In the app, on Pair With the Till, select Scan Code and scan that QR code. Without the camera, select Enter Manually, type one of the till’s addresses under Till Address and the code under Pairing Code, and select Pair.
- Wait while the app checks the till and saves the pairing.
- Check that the Enter Your PIN screen appears with the till’s name, for example “FMX EPOS · Front Till”. After pairing by hand, it shows the address you typed instead, for example “FMX EPOS · 192.168.1.20”.
Illustration, not a screenshot. The real screen can differ with the theme or version.
If pairing fails, the app says why:
| Message | What to do |
|---|---|
| This is not a till’s pairing code. | Scan the QR code on the till’s Pair the Mobile App card again. |
| Enter the till’s address as shown on the till, such as 192.168.1.20. | Type one of the addresses listed under Addresses on the till. |
| Enter the 12-character pairing code shown on the till. It has no O, I, 0 or 1. | Type the code again exactly as shown. |
| The code names no address. Check the till’s network and show the code again. | The till found no network address when it showed the code. Check that the till PC is connected to the restaurant network, then open the Mobile App page again. |
| This till’s certificate does not match the code. Show the code on the till again. | Open the Mobile App page on the till again and pair with the code now shown. |
| The till at this address did not prove it holds the certificate. Pair again on the shop’s Wi-Fi. | Something other than the till answered at that address. Connect the phone to the shop’s own Wi-Fi, check the address and pair again. |
| The till could not be reached. Connect this phone to the shop’s Wi-Fi and try again. | Check the Wi-Fi, the address and that FMX EPOS is running on the till. |
| The camera is not available. Choose Enter Manually, or allow FMX EPOS to use the camera in Android settings. | Allow the camera, or select Enter Manually. |
During pairing the app pins the till’s root certificate, so the certificate does not need to be installed on the whole device. This does not help the phone’s browser with the first APK download. Camera access is optional, because you can type the till address, pairing code and membership card numbers instead.
If the till’s local address changes, select Pair With Another Till on the PIN screen and pair again with the new address. If the till was replaced or its certificate changed, pair again. Do not accept an unexpected certificate as if it were the old till. The PIN screen then says “The till cannot be reached. Check this phone is on the shop’s Wi-Fi. If the till has moved or been reinstalled, choose Pair With Another Till.” or “This phone cannot confirm it has reached the right till. Check the till’s address and this phone’s date and time. If the till was reinstalled or moved to another PC, choose Pair With Another Till.”
Sign in and take orders
Section titled “Sign in and take orders”- Enter the staff member’s cashier PIN. With a fixed PIN length (set on the till under Back Office → Users → PIN Length), the app signs in on the last digit. Otherwise, press Sign In.
- Choose a table, or select New Takeaway Order and change the order type to collection or delivery on the Details tab if needed. The app offers only the order types the store keeps under Order Types in Back Office → Sales Settings → Order Rules; with Takeaway alone, the order type buttons do not appear.
- Add products, options, notes and allergy information. A meal deal opens its own sheet: pick one item under each choice, set the number of Meals and select Add Meal.
- On a table, use seats, courses and course firing where the restaurant works that way. The item actions also offer Takeaway or Eat In for unsent items.
- On a takeaway, collection or delivery order, add customer, address or membership details on the Details tab.
- Send a table’s new items, or hold or send a takeaway order.
The screens and steps are the same as in the browser view: see Take an order and Hold, send and finish at the till.
The app follows the store’s current catalogue, order rules, licence, staff accounts and staff permissions. If an action such as firing a course is set to Require Authorisation for staff, the app opens its own Manager Approval sheet with the reason. A manager types their PIN under Manager PIN and selects Approve. Cancel stops the action. An action blocked for staff is refused with the reason, and a manager has to sign in to do it.
The app runs full screen and the Android Back button does nothing, so staff cannot leave it by accident. To close it, select Exit at the bottom of the pairing or PIN screen and confirm Exit FMX EPOS? with Exit.
Limits
Section titled “Limits”The Android app does not take payment, refund orders, print receipts, apply coupons, comps or manual discounts, take manual prices, change delivery and bag fees, mark products sold out, or move, merge or close tables. Do these on the till. A linked membership still applies the member’s discount.
Staff can still add to an item the till has made free, or to an order with a 100% order discount. The till checks the extra free amount when it takes payment, and a staff cashier may need a manager’s PIN then. See Give items free of charge.
The app is not an offline till. It can keep its current basket through a short loss of connection, but it cannot load new data or complete anything until it reaches the paired till and that till reaches the restaurant database.
When the app auto-locks, it tries to save a table draft or hold an eligible takeaway order. That still needs a live connection to the store. If it cannot save, the app stays signed in and shows Auto lock delayed. with the reason, so save or send the order yourself.
Connection recovery
Section titled “Connection recovery”While staff are signed in, a Wi-Fi symbol beside their name turns amber when the connection to the till is unstable, and red and crossed out when it is lost. When the app cannot reach the till, it says “The till cannot be reached. Check this phone is on the shop’s Wi-Fi.” When the till is reached but gives no answer in time, it says “The till did not answer in time. Check whether this was saved before trying again.” The PIN screen keeps trying every few seconds.
- Bring the device back onto the restaurant network.
- Check that the paired till is running.
- Check that Mobile App is still ticked in the till’s Security settings.
- If Only Allow Listed IP Addresses is on, check that the Android device’s current IP address is listed under Allowed IP Addresses. The list takes one complete IPv4 or IPv6 address per line, so give the device a fixed address or a DHCP reservation.
- Keep the app open while it reconnects.
- If the till’s address or certificate has changed, pair again from the pairing screen.
- Before you build a basket again, check whether its last hold or send reached the till.
If the app says “The till ended this sign-in. Sign in again. Anything you had not saved is gone.”, sign in with your PIN again.
If it says “Cannot connect to the database. Check the connection and sign in again.” or “The till could not answer just now. Try again shortly.”, the phone reached the till but the till cannot reach the restaurant database. While staff are signed in, the same problem shows as “The database is offline. Try again shortly.” or “The database is unavailable. Keep this page open and retry when the connection returns. Mobile orders are not saved offline.” Check the database connection on the till first.
A kitchen-only terminal cannot take sales from the app, and refuses with “This computer is a kitchen-only terminal and takes no phone orders. Connect the phone to a till.” A host-stand-only terminal refuses with “This computer is a host-stand-only terminal: it takes no orders. Use a till.” Pair with a terminal that is licensed and set up as a till.
Update the app
Section titled “Update the app”The PIN screen checks whether the app version suits the paired till.
- If the till requires a newer app, the screen says, for example, This app is version 1.5.3. The till needs app version 1.5.12 or later. Update the app to sign in. The PIN keypad is hidden until the app is updated.
- If a newer app is available but not required, it says App version … is available from the till., and staff can update when convenient.
- If the till is too old for the app, signing in fails with The till is version …; this app needs version … or later. Update the till. Update the till through your normal update process.
- If the till requires a newer app but does not carry one, the screen says the till has no app installer and offers no update. Contact FMX EPOS support to update the till.
This app is version 1.5.3. The till needs app version 1.5.12 or later. Update the app to sign in.
Illustration, not a screenshot. The real screen can differ with the theme or version.
To update:
- On the PIN screen, select Update to followed by the new version number. The app downloads the package from the paired till.
- If Android asks, allow FMX EPOS to install apps.
- Confirm the installation in the Android installer.
- Open FMX EPOS again and check that the PIN screen no longer asks for an update.
An update of the same FMX EPOS app keeps the existing pairing. If Android says the package cannot update the installed app, do not remove the working app until support has checked the package and the pairing.
Permissions
Section titled “Permissions”- Camera is used for pairing and for scanning cards and codes. Everything can also be entered by hand.
- Install unknown apps is used only to install an APK from the till. Android controls it separately for each app that installs packages.
- Network access is needed to reach the paired till.
Do not grant unrelated permissions that Android or another app asks for. FMX EPOS does not need access to photos or contacts for staff ordering.
Hold, send and finish at the till
Section titled “Hold, send and finish at the till”Holding, sending, course firing, seats and taking over a table work as in the browser view. See Hold, send and finish at the till for the steps and the results to check after sending.
In short: Hold saves a takeaway order without sending it, Send then Send to Kitchen saves it unpaid and releases it to the kitchen, and payment and the receipt happen at the till. On a table, Send sends only new items. If the result says Saved · Unpaid · Kitchen send needs checking or reports a print failure, the order is already saved: check it on the till and do not create it again.
Changed prices and phone settings
Section titled “Changed prices and phone settings”If the app says “Menu prices have changed. Check the updated order, then try again.”, it has refreshed the affected new lines. Review their prices and options, then choose Retry Save, Hold or Send again. The app delays auto-lock while this confirmation is needed. Lines already saved at the till keep their stored prices.
On the PIN screen, Text Size sets the app’s text to 85%, 100%, 115%, 130% or 150%. If the app says that the phone’s Android System WebView is too old, update Android System WebView or Chrome to version 94 or later, then open FMX EPOS again. The app can ask to pin its screen. Without managed-device setup, Android still allows the user to unpin it.
Sign Out is the icon at the top right of the home screen. It signs the staff member out and gives back any table they had open; it does not save anything, so hold or send work first. To leave an order unsaved, use the back arrow: the app asks before it discards unsaved items, for example Return to Orders? for a takeaway order that has not been saved. A saved table bill or held order remains at the till.