Online platforms and Integration Host troubleshooting
Fetching platform orders, sending due orders to the kitchen and pushing settings to platforms all run on one chosen terminal, the Integration Host. When that terminal is off or cannot reach the database, every till shows the banner No Integration Host is running. The Back Office steps below need an administrator.
Online orders are not polled and scheduled courses are not released. Check the host in Online Platforms.
Illustration, not a screenshot. The real screen can differ with the theme or version.
No terminal is fetching orders
Section titled “No terminal is fetching orders”- Open Back Office → Online Platforms.
- On the Integration Host card at the top, check which terminal is chosen under Integration Host. The list shows each terminal as Online or Offline.
Illustration, not a screenshot. The real screen can differ with the theme or version.
- Start the chosen terminal and check that it can reach the database in use.
- If another terminal has to take over, choose it and select Save Host.
- Wait a few seconds, then select Refresh on Back Office → Diagnostics and read the Integration Host card.
No other terminal takes over by itself. While no terminal is the Integration Host:
- platform orders are not collected, and new-order alerts do not sound;
- orders due at the kitchen and scheduled courses are not released;
- delivery routes are not worked out;
- settings are not pushed to the platforms;
- the automatic backup is not made;
- the shop’s own FMX ordering website, table QR ordering and in-store QR ordering show as closed and take no orders.
Choosing No Integration Host has the same effect.
A connection is not fetching orders
Section titled “A connection is not fetching orders”- Open its card under Online Platforms.
- Check that Enable Polling is ticked and that Default VAT for Unmapped Items is selected. Polling cannot be turned on without it (“Set … default VAT rate in Online Platforms before turning polling on.”).
- Check whether the most recent time passed on the Polling Schedule was a Stop time.
- For Uber Eats, check that All Orders Are Paid Through Uber Eats is ticked. Orders are not imported until it is.
- Select Test Connection.
- Check the time of the last check and the exact error in the till’s Platforms workspace (for example “3 failures in a row: …”) or in the Integration Host card in Diagnostics.
Just Eat
3 failures in a row: 401 Unauthorized
Illustration, not a screenshot. The real screen can differ with the theme or version.
After three failed checks in a row, every till shows a banner such as “Just Eat polling failing. Check Online Platforms”. A sign-in error such as “Just Eat Partner Centre rejected the username or password.” means the saved platform account details need correcting on the connection, for example after the password was changed on the platform.
While polling is off, every till shows an amber number on the Platforms button in the left rail instead of a corner warning, and the Platforms workspace shows which platform and why. The platform keeps taking orders, but FMX EPOS does not receive them. Staff with the Online Platform Trading and Order Settings permission can turn polling on or off from the till’s Platforms workspace.
If someone turns polling on or off by hand, it stays that way until the next Start or Stop time on the schedule; the schedule does not switch it back to match the current time. Nor does it catch up on times that passed while the Integration Host was switched off. If the host starts after a Start time, turn polling on by hand.
An order is in Exceptions
Section titled “An order is in Exceptions”- Open Back Office → Orders → Online Inbox and set Status to Exceptions.
- Read Needs Attention and the order details that were captured.
- If a menu mapping is missing, open Back Office → Menus → Platform Mapping.
- If the item is not listed, select Fetch Platform Menu. Choose the local product or option for it and select Save Mapping.
- Go back to the inbox and select Confirm & Print once every required item is mapped. The button stays unavailable until then.
Uber Eats · #A1B2C
One or more products or options are not mapped to an active local menu item.
Illustration, not a screenshot. The real screen can differ with the theme or version.
Accept as Sent accepts the order with the item details as the platform sent them, without creating a permanent confirmed mapping. The till has the same button. Use it only after checking the item’s price, VAT and kitchen station.
What Confirm & Print does depends on the platform. For Uber Eats it also accepts the order on Uber Eats. For Just Eat it only takes the order into FMX EPOS and prints it: nothing is sent to Just Eat, and FMX EPOS cannot reject a Just Eat order. If a Just Eat order cannot be made, deal with it on Just Eat.
An order that cannot be accepted
Section titled “An order that cannot be accepted”An order that could not be read in full is held for review and can never be accepted in FMX EPOS. This includes an order whose platform did not say how it was paid. Its Needs Attention gives the reason, and Confirm & Print does not appear for it.
- Read the original order on the platform.
- If the order was paid on the platform and the food still has to be made, select Enter by Hand on the till (in Orders → Online) and record it with Paid on Platform. See Enter a prepaid order by hand.
- Otherwise archive it: select Archive Unpaid Order on the till, then Confirm Archive, or in Back Office → Orders → Online Inbox select Archive and confirm Archive Order. An order that shows Paid on Platform can be archived only in the Back Office, which closes Enter by Hand for good and keeps its sale out of your reports. Archiving does not cancel the order on the platform. If the food still has to be made, enter the order on the till as a normal order.
Do not record a platform’s payment as cash or card. An order entered as a normal order counts in the shop’s own sales, not the platform’s, and it stops the Z report while it is unpaid.
A held order from the shop’s own website has no Archive. Answer it with Reject, so that the customer is told.
A scheduled order did not print
Section titled “A scheduled order did not print”- Check that the Integration Host was running before the order was due to go to the kitchen.
- Open Back Office → Printing → Print Rules and check Kitchen Release for the order’s channel, for example Platform Delivery, Platform Courier or Website Collection. Automatic sends the order straight away, Before Due sends it the number of minutes set in that channel’s Lead Time before it is due, and Manual waits for staff to send it from Orders → Kitchen Release on the till. With Automatic or Before Due, an ASAP order is sent straight away; with Manual, it also waits for staff.
- Open Orders → Online Inbox, set Status to Scheduled and check the order’s print status. This view lists pre-orders due today or tomorrow.
- Check Printing → Print Queue on the terminals it should print on.
- Use Print Now or Retry Printing only once you have checked whether anything has already printed.
Kitchen Release
Illustration, not a screenshot. The real screen can differ with the theme or version.
FMX EPOS sends only the tickets that have not already been queued, unless every earlier attempt at that ticket failed or was cancelled. Orders waiting for their release also appear under Upcoming on the kitchen screen. An order still waiting in the inbox to be accepted is not on the kitchen screen at all.
If an accepted pre-order missed its kitchen release and that business day has ended, FMX EPOS holds it for staff review instead of releasing old work automatically. The message says “Its business day ended before it reached the kitchen. Retry Printing sends it now.” Check with the customer and kitchen before using Retry Printing.
A cancellation needs attention
Section titled “A cancellation needs attention”For a normal platform cancellation, check the order and select Acknowledge Cancellation. For an order under Cancelled After Payment, find out whether the platform took the money back, add a note and select Reconciled. Reconciling does not remove the original platform payment from sales or from X and Z reports.
If a cancellation slip failed to print, recover it in the Print Queue, or select Retry Printing on the order in the inbox. Slips print only for orders that had already gone to the kitchen, and go to the kitchen stations when Print Cancellation Slip is ticked on the connection. An extra front-of-house copy can be turned on only on the Integration Host, with Print Platform Cancellation Slips on This Printer Too in Local Settings → Printers.
Settings show Differences or Failed
Section titled “Settings show Differences or Failed”In the Platforms workspace on the Integration Host’s till (other tills show each platform’s polling switch and last poll, and name the terminal that manages the settings):
- Open the platform card and read the status message.
- Check the local opening hours, lead times, radius, delivery mode and open/closed switches.
- Select Sync Now. This needs the Online Platform Trading and Order Settings permission.
- Read which step failed and which earlier steps were already sent.
Just Eat
Hours failed: the platform rejected the request (lead times pushed)
Uber Eats
Illustration, not a screenshot. The real screen can differ with the theme or version.
If a provider accepted some steps and rejected a later one, do not repeat all the changes. FMX EPOS sends a delivery radius to Just Eat only when the store’s Just Eat delivery area allows one; an area drawn as shapes on a map stays as it is on Just Eat.
Uber Eats has a single on/off switch for the whole store, which FMX EPOS controls only once a delivery mode is set. Which local switch it follows depends on the mode:
| Delivery mode | Uber Eats store follows |
|---|---|
| Uber couriers | Collection only. Closing Collection pauses all Uber Eats orders, deliveries included; closing Delivery does not stop Uber Eats orders. |
| Own staff | Delivery only. |
| Own staff + Uber | Both. Closing either one pauses the whole Uber Eats store. |
Uber Eats opening hours follow the local collection hours, and its preparation time follows the collection lead time.
For setting up connections and mapping, see Connect online ordering platforms.