在线平台和 Integration Host 故障排除
拉取平台订单、把到时的订单送去厨房,以及向平台推送设置,都在一台选定的终端上运行,这台终端就是 Integration Host。它关机或连不上数据库时,每台收银机都会显示横幅 No Integration Host is running。下面的 Back Office 步骤需要管理员身份。
Online orders are not polled and scheduled courses are not released. Check the host in Online Platforms.
示意图,不是截图。实际界面可能因主题或版本而有所不同。
没有终端在拉取订单
Section titled “没有终端在拉取订单”- 打开 Back Office → Online Platforms(管理后台 → 在线平台)。
- 在顶部的 Integration Host 卡片上,查看 Integration Host 下选的是哪台终端。列表中每台终端都标有 Online 或 Offline。
示意图,不是截图。实际界面可能因主题或版本而有所不同。
- 启动选定的终端,并确认它能连上正在使用的数据库。
- 如果要换另一台终端接手,选中它并选择 Save Host(保存主机)。
- 等几秒钟,然后在 Back Office → Diagnostics(诊断)上选择 Refresh(刷新),查看 Integration Host 卡片。
其他终端不会自动接手。没有终端担任 Integration Host 时:
- 不拉取平台订单,新订单提醒也不会响;
- 到时的订单和预约的上菜批次不会放行到厨房;
- 不规划外送路线;
- 设置不会推送到平台;
- 不执行自动备份;
- 门店自己的 FMX 点餐网站、桌台扫码点餐和店内扫码点餐显示为关闭,不接收订单。
选择 No Integration Host 的效果相同。
某个连接拉不到订单
Section titled “某个连接拉不到订单”- 在 Online Platforms 下打开它的卡片。
- 确认已勾选 Enable Polling(启用轮询),并且已选择 Default VAT for Unmapped Items(未映射商品的默认税率)。不选它就无法开启轮询(提示 “Set … default VAT rate in Online Platforms before turning polling on.”)。
- 检查 Polling Schedule(轮询时间表)上最近经过的时间点是否是 Stop(停止)。
- 如果是 Uber Eats,确认已勾选 All Orders Are Paid Through Uber Eats。不勾选就不会导入订单。
- 选择 Test Connection(测试连接)。
- 在收银机的 Platforms(平台)工作区(例如 “3 failures in a row: …”)或诊断页的 Integration Host 卡片中,查看最近一次检查的时间和具体错误。
Just Eat
3 failures in a row: 401 Unauthorized
示意图,不是截图。实际界面可能因主题或版本而有所不同。
连续三次检查失败后,每台收银机都会显示类似 “Just Eat polling failing. Check Online Platforms” 的横幅。登录错误,例如 “Just Eat Partner Centre rejected the username or password.”,表示连接上保存的平台账号信息需要更正,例如在平台上改过密码之后。
轮询关闭期间,每台收银机不会显示角落警告,而是在左侧栏的 Platforms 按钮上显示琥珀色数字;Platforms 工作区会显示是哪个平台以及原因。平台照常接单,但 FMX EPOS 收不到。有 Online Platform Trading and Order Settings 权限的员工可以在收银机的 Platforms 工作区开关轮询。
如果有人手动开启或关闭了轮询,这个状态会一直保持到时间表上的下一个 Start 或 Stop 时间;时间表不会按当前时间把它切换回来。它也不会补上 Integration Host 关机期间错过的时间点。如果主机在某个 Start 时间之后才启动,请手动开启轮询。
订单进入了 Exceptions
Section titled “订单进入了 Exceptions”- 打开 Back Office → Orders → Online Inbox(订单 → 在线收件箱),把 Status(状态)设为 Exceptions(异常)。
- 阅读 Needs Attention(需要处理)以及已获取的订单详情。
- 如果缺少菜单映射,打开 Back Office → Menus → Platform Mapping(菜单 → 平台映射)。
- 如果列表中没有该商品,选择 Fetch Platform Menu(获取平台菜单)。为它选择对应的本地商品或选项,然后选择 Save Mapping。
- 回到收件箱,所有必需的商品都映射好后,选择 Confirm & Print(确认并打印)。在此之前这个按钮不可用。
Uber Eats · #A1B2C
One or more products or options are not mapped to an active local menu item.
示意图,不是截图。实际界面可能因主题或版本而有所不同。
Accept as Sent(按原样接单)会按平台发来的商品信息接单,不会建立永久的已确认映射。收银机上也有同一按钮。只有在核对过商品的价格、增值税和厨房工作站之后才使用它。
Confirm & Print 的作用因平台而异。对 Uber Eats,它还会在 Uber Eats 上接受订单。对 Just Eat,它只把订单收进 FMX EPOS 并打印:不会向 Just Eat 发送任何内容,FMX EPOS 也不能拒绝 Just Eat 订单。如果某张 Just Eat 订单做不了,请在 Just Eat 上处理。
无法接受的订单
Section titled “无法接受的订单”无法完整读取的订单会被搁置复核,在 FMX EPOS 中始终无法接受。平台没有说明付款方式的订单也属于这一类。它的 Needs Attention 会写出原因,也不会出现 Confirm & Print。
- 在平台上查看原始订单。
- 如果订单已在平台付款,餐品仍需制作,在收银机上(Orders → Online 中)选择 Enter by Hand(手动录入),并用 Paid on Platform(已在平台支付)记录。参见手动录入预付订单。
- 否则就归档订单:在收银机上选择 Archive Unpaid Order,再选择 Confirm Archive;或在 Back Office → Orders → Online Inbox 中选择 Archive 并用 Archive Order 确认。显示 Paid on Platform 的订单只能在 Back Office 中归档,归档后 Enter by Hand 永久关闭,这笔销售也不计入报表。归档不会在平台上取消订单。如果餐品仍需制作,在收银机上把它当作普通订单录入。
不要把平台的付款记为现金或刷卡。作为普通订单录入的订单计入门店自己的销售,不计入平台销售;未付款期间,它会挡住 Z 报表。
门店自己网站上被搁置的订单没有 Archive。请用 Reject 答复,让顾客收到通知。
预约订单没有打印
Section titled “预约订单没有打印”- 确认订单该送厨房之前,Integration Host 一直在运行。
- 打开 Back Office → Printing → Print Rules(打印 → 打印规则),查看该订单渠道的 Kitchen Release(厨房放行),例如 Platform Delivery、Platform Courier 或 Website Collection。Automatic 会立即送出订单,Before Due 会在到期前按该渠道 Lead Time 中设定的分钟数送出,Manual 则等员工在收银机的 Orders → Kitchen Release 中送出。设为 Automatic 或 Before Due 时,ASAP 订单立即送出;设为 Manual 时,ASAP 订单同样等员工送出。
- 打开 Orders → Online Inbox,把 Status 设为 Scheduled(预约),查看这张订单的打印状态。这个视图列出今天或明天到期的预订单。
- 在应该打印的终端上查看 Printing → Print Queue(打印队列)。
- 只有确认过是否已经打印出东西之后,才使用 Print Now(立即打印)或 Retry Printing(重新打印)。
Kitchen Release
示意图,不是截图。实际界面可能因主题或版本而有所不同。
FMX EPOS 只会发送还没有排队的单据,除非该单据之前每次尝试都失败或被取消。等待放行的订单也会出现在厨房屏幕的 Upcoming(即将送厨)中。仍在收件箱等待接受的订单完全不会出现在厨房屏幕上。
如果已接受的预订单错过了厨房放行,而那个营业日已经结束,FMX EPOS 会把它留给员工复核,而不会自动放行过时的单子。提示为 “Its business day ended before it reached the kitchen. Retry Printing sends it now.”。使用 Retry Printing 之前,请先与顾客和厨房确认。
取消订单需要处理
Section titled “取消订单需要处理”普通的平台取消,核对订单后选择 Acknowledge Cancellation(确认取消)。对于 Cancelled After Payment(付款后取消)下的订单,先弄清平台是否已经把钱退回,添加备注后选择 Reconciled(已核对)。标为已核对不会把原来的平台付款从销售额或 X 和 Z 报表中去掉。
如果取消单打印失败,请在打印队列中恢复,或在收件箱中该订单上选择 Retry Printing。取消单只会为已经送过厨房的订单打印;连接上勾选了 Print Cancellation Slip(打印取消单)时,会发到各厨房工作站。只有在 Integration Host 上,才能通过 Local Settings → Printers(本机设置 → 打印机)中的 Print Platform Cancellation Slips on This Printer Too 再给前台打印一份。
设置显示 Differences 或 Failed
Section titled “设置显示 Differences 或 Failed”在 Integration Host 那台收银机的 Platforms 工作区中(其他收银机显示每个平台的轮询开关和最近一次轮询,并说明由哪台终端管理设置):
- 打开平台卡片,阅读状态信息。
- 检查本地的营业时间、准备时间、外送半径、外送方式和开关店开关。
- 选择 Sync Now(立即同步)。这需要 Online Platform Trading and Order Settings 权限。
- 看清是哪一步失败了,以及前面哪些步骤已经发送成功。
Just Eat
Hours failed: the platform rejected the request (lead times pushed)
Uber Eats
示意图,不是截图。实际界面可能因主题或版本而有所不同。
如果平台接受了前面的步骤,却拒绝了后面的某一步,不要简单地把所有修改再推送一遍。只有门店的 Just Eat 外送区域允许时,FMX EPOS 才会把外送半径发给 Just Eat;在地图上画出的区域在 Just Eat 上保持不变。
Uber Eats 对整个门店只有一个开关,只有设置了外送方式后 FMX EPOS 才会控制它。它跟随哪个本地开关,取决于外送方式:
| 外送方式 | Uber Eats 门店跟随 |
|---|---|
| Uber couriers | 只跟随 Collection。关闭 Collection 会暂停所有 Uber Eats 订单,包括外送;关闭 Delivery 不会停止 Uber Eats 订单。 |
| Own staff | 只跟随 Delivery。 |
| Own staff + Uber | 两者都跟随。关闭任意一个都会暂停整个 Uber Eats 门店。 |
Uber Eats 的营业时间跟随本地的自取时间,准备时间跟随自取准备时间。
关于设置连接和映射,请参见连接在线订餐平台。