跳转到内容
FMX EPOS
下载
知识库首页

打印机和钱箱故障排除

先看 Back Office → Diagnostics(管理后台 → 诊断)中的 Printing(打印)卡片,再打开 Back Office → Printing → Print Queue(打印 → 打印队列)。重试任何任务之前,先检查打印机本身和它的 Windows 打印队列。收银机上的员工通过打印机横幅处理自己的任务。Back Office 页面需要管理员身份。

本终端某台打印机的任务,或本终端发出的任务需要有人处理时,收银机会显示类似 “Printer Kitchen 1: 2 jobs need attention” 的横幅,并带有 Open Print Jobs(打开打印任务)。任务失败、结果未知、没有打印机,或等了一分钟还没打印时,都会出现这个横幅。

  1. 点横幅,打开本终端的 Print Jobs(打印任务)。
  2. 阅读每个任务的状态、错误和处理建议。
  3. 选择处理方式:
    • Retry(重试)在同一台打印机上重新打印。从未打印过的任务会立即发送。
    • Retry All(全部重试)在同一台打印机上有多个失败任务时出现,会按从旧到新的顺序全部重新发送。
    • Send Elsewhere(改到其他打印机)在另一台同类型的打印机上打印。一台打印机上有多个任务时,Send All Elsewhere(全部改到其他打印机)和 Clear All(全部清除)会一起处理。
    • Clear Issue(清除问题)取消这个任务,不打印。它不会通知厨房、不会取消订单,也不会删除已经进入 Windows 打印队列的副本。
  4. 如果任务可能已经打印出来了,先检查打印机,再选择 Checked, Print 确认。要清除任务,选择 Confirm Clear Issue 确认。处理多个任务时,Send All Elsewhere 提供 Checked, Print All 或 Unprinted Only,Clear All 需要选择 Confirm Clear All。

处理一台打印机全部任务的操作,只作用于属于当前窗口的任务,包括列表中放不下的任务。在收银机的 Print Jobs 中,指本终端的任务;在桌台的 Print Jobs 中,指该桌台的任务。其他收银机在同一台打印机上的任务留给那台收银机处理,或在 Back Office → Printing → Print Queue 中处理,那里的 Retry All、Send All Elsewhere 和 Cancel All 覆盖所有终端。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

每张桌台也有自己的 Print Jobs 按钮,列出这张桌台的任务及其 Kitchen Ticket Copies(厨房单副本)。Print Copy(打印副本)会把已经打印过的厨房单再打印一次。只有厨房单模板中有 Copy Marker 元素时,副本上才会印 COPY。内置的厨房单模板都有这个元素,所以自己设计厨房单模板时请保留它。

  1. 确认打印机已开机并在线、有纸,没有盖子或切刀报错。
  2. 如果是 Windows 打印机,先从 Windows 打印一张测试页。如果是 TCP/IP ESC/POS 打印机,检查它的 IP 地址和端口。
  3. 打开 Back Office → Local Settings → Printers(本机设置 → 打印机)。如果列表中没有这台打印机,选择 Refresh Printers。在 Local Printers(本地打印机)下选中它,然后选择 Test Print(测试打印)。“Test receipt sent to printer.” 表示 FMX EPOS 已经发送;“Test print failed.” 会给出原因。
  4. 打开 Back Office → Printing → Terminal Printers(终端打印机),检查打印机的类型。新打印机默认是 Not Used(不使用)。如果后来安装的打印机不在列表中,在那里选择 Refresh。
  5. 小票问题:检查本终端 Local Settings → Printers 中的 Print Receipts On(小票打印到)。如果没有选择小票打印机,付款仍会完成,但收银机会提示 “Receipt failed: Select a registered receipt printer in Local Settings → Printers. The job waits in the print queue for a redirect.”。选择打印机后选择 Save Printer Settings,然后在 Back Office → Printing → Print Queue 或收银机的 Print Jobs 中用 Send Elsewhere 把等待中的小票发出去。这个任务没有打印机,所以不能使用 Retry。
  6. 打开 Printing → Print Rules(打印规则)。每种订单类型都有各自的 Kitchen Ticket、Labels 和 Receipt 勾选项,Receipt After Payment 可设为 Print Automatically、Do Not Print 或 Ask After Each Payment。只有在本终端 Local Settings → Printers 中勾选了 Print X/Z Reports Automatically,X 和 Z 报表才会自动打印。
  7. 厨房单问题:检查商品的 Kitchen Stations(厨房工作站),以及该工作站的 Printers(打印机)。没有启用工作站的商品使用默认工作站。
  8. 标签问题:确认商品已勾选 Print a Label for This Product(为此商品打印标签),然后根据是哪种操作打印的,检查工作站或本终端的标签打印机。

在线平台订单不使用 Print Rules,而是按 Back Office → Online Platforms 中各自连接的打印设置打印。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

Local Settings 中的测试打印只能证明 FMX EPOS 能把测试页发到所选的打印机,不能证明每个模板、路由、纸张尺寸或切纸设置都正确。要检查版式,请使用 Print Design 中的 Test Print。

在以下情况下,即使什么都没打出来,任务在 FMX EPOS 中也可能显示为已打印:

  • Windows 打印机的驱动不向 Windows 报告问题,FMX EPOS 就看不出异常。请同时检查 Windows 打印队列。
  • 网络(TCP/IP)ESC/POS 打印机一接收数据就算已打印。FMX EPOS 看不到它缺纸或盖子没合上,所以这时发出的任务会显示为已打印。请查看打印机本身。要补打缺失的单据,在桌台的 Print Jobs 中使用 Print Copy,或在收银机 Orders 中的订单上使用 Print Kitchen Ticket 或 Reprint Receipt。

如果打印机连不上或报告了问题,例如 Windows 打印机离线或缺纸,或网络打印机已关机,任务会保持 Pending(等待中)并自动重试,排在这台打印机后面的任务之前。请让负责打印它的终端保持运行,并修好打印机,任务随后会自动打印。

如果任务排队 30 分钟后(或上次有人重试后 30 分钟)仍未打印,FMX EPOS 会停止尝试,把它标为 Failed(失败),并显示 “Not printed: waited more than 30 minutes.”。拖了这么久的单子很可能已经手动重做,所以 FMX EPOS 不会自动打印。只有负责打印该任务的终端会做这个标记,所以那台终端关机期间,任务保持 Pending,等终端再次启动后才变为 Failed。

打印结果未知:任务可能已经打印出来了,所以 FMX EPOS 不会自动重试。在有人处理之前,这台打印机后面的任务都会排在它后面等待。

  1. 检查打印机的出纸口和厨房传菜口。
  2. 检查 Windows 打印队列或打印机的历史记录。
  3. 在 Back Office → Printing → Print Queue 中选择 View Content(查看内容),看看是哪张订单的哪份单据。
  4. 如果可以接受再打一份,选择 Retry 并确认 Checked, Retry。
  5. 要改用另一台兼容的打印机,选择 Send Elsewhere(改到其他打印机),选好 Destination Printer(目标打印机)后确认 Checked, Print。
  6. 如果不应该再打印新的一份,选择 Cancel(取消)并确认 Cancel Job。

Retry 和 Send Elsewhere 会重新开始一轮尝试,可能会打出重复的单子。

在收银机上,同一个任务在 Print Jobs 中:使用 Retry 或 Send Elsewhere 并确认 Checked, Print,或使用 Clear Issue 并确认 Confirm Clear Issue。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

Failed 的任务没有打印出来,FMX EPOS 也已停止尝试。状态下方的信息会写明原因:

  • “Not printed: waited more than 30 minutes.” 后面跟着打印机最后一次报错:任务没能及时打印,例如打印机一直离线。
  • “Not printed:” 后面跟着 Windows 给出的原因,括号中是打印机名称,例如 “Not printed: the printer is offline (Receipt 1).”。原因包括 “the Windows print queue is paused”、“the printer is set to Use Printer Offline in Windows”、“the printer is offline”、“the printer is not available”、“the printer is out of paper”、“the printer has a paper jam”、“the printer has a paper problem”、“the printer cover is open” 和 “the printer reports an error”。如果 30 分钟后最后一次报错仍是这个,任务就会以这条信息失败。
  • 有些任务会立即失败,因为再试一次也会以同样方式失败:
    • “Text-Only Compatibility cannot print a character in this job. Turn it off in Local Settings → Printers or use a Windows printer driver.”
    • “… is not a label printer. Set its type in Printing → Terminal Printers or change the station’s printers in Printing → Kitchen Stations.”
    • “Select a registered receipt printer in Local Settings → Printers.”(没有设置小票打印机时打印小票或签购单)或 “Select a label printer in Local Settings → Printers.”。请在 Local Settings → Printers 中选择打印机,再用 Send Elsewhere 发送等待中的任务。这个任务没有打印机,所以不能使用 Retry。
    • “The document is longer than the Windows driver’s paper size. Select a longer paper size or use ESC/POS printing.”
    • “No active default kitchen station is configured. Add one in Printing → Kitchen Stations.”

先解决原因。在 Windows 中打开打印机的队列,取消 Pause Printing(暂停打印)和 Use Printer Offline(脱机使用打印机),然后装纸或合上盖子。之后选择 Retry(或 Retry All),或用 Send Elsewhere 把任务发到另一台打印机;如果不需要副本,就选择 Cancel。重试或改发到类型不对的打印机会被拒绝,例如 “… is not a receipt printer. Choose a printer of that type.”。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

  • 小票、签购单、预结单以及 X 和 Z 报表都发到本终端的小票打印机。
  • 自动厨房单发到商品所属厨房工作站登记的小票类打印机。
  • 自动标签发到工作站的标签打印机。
  • 手动打印的标签发到本终端的 Print Labels On(标签打印到),但使用该行商品所属工作站的模板。厨房屏幕卡片上的 Labels 是例外:它在卡片所属工作站的标签打印机上打印。
  • 平台取消的工作站单按工作站路由打印。另外可以在 Integration Host 的小票打印机上给前台打印一份。

改正路由后,只对受影响的任务在队列中重试或转打。

直连的 ESC/POS 打印机,请检查 Print Width (Dots)(打印宽度,点数)和 Resolution(分辨率)。勾选 Text-Only Compatibility(纯文本兼容)时,打印机不能打印图形或标志,只能打印它自己字符集中的字符:

  • 商品名称、备注、顾客姓名和地址,退款单和刷卡单上的原因和参考号,以及区域、桌台、座位、上菜批次和备餐组名称中的字母,只要在字符集里,就按输入的样子打印,包括 é、ü、ñ 等常见带重音字母。其他字母去掉重音符号打印,表情符号和其他文字会被省略。
  • 其他所有文字都必须使用打印机有的字符:门店资料、在 Print Design 中添加的文字、员工和收银机名称,以及金额。其中只要有一个无法打印的字符,任务就会失败。例如,收银员姓名中有 ł 时,X 或 Z 报表会打印失败。
  • 过敏原绝不会被省略。如果打印机无法完整打印过敏原,这张单据会打印失败并说明原因。请关闭 Text-Only Compatibility,改用 Windows 打印机驱动程序,或选择 Send Elsewhere。

只有打印机支持图形模式时,才取消勾选 Text-Only Compatibility。

在 Print Design(打印设计)中,检查纸张宽度、边距、内容块大小,以及终端或工作站实际选用的是哪个模板。保存模板并不会把它分配到任何地方。

  1. 在 Terminal Printers 中确认打印机类型是 Label(标签)。ESC/POS 打印机不能用作标签打印机,请使用它的 Windows 驱动。
  2. 打开 Printing → Kitchen Stations(厨房工作站),编辑该工作站,检查 Label Printer(标签打印机)、Label Template(标签模板)、Label Copies(标签份数)和 Print Labels Automatically(自动打印标签)。
  3. 确认商品已勾选 Print a Label for This Product,并且在 Printing → Print Rules(打印规则)中该订单类型的 Labels(标签)规则已开启。平台订单则检查 Online Platforms 中该连接的 Automatically Print Labels。
  4. 手动打印的标签,检查本终端的 Print Labels On 设置。如果收银机提示 “No products in this order are configured to print labels.”,说明订单上没有设置了标签的商品。
  5. 查看打印队列:每张标签都有自己的一行,所以要检查有没有失败的行。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

  1. 确认钱箱连接到了 Local Settings → Printers 中 Cash Drawer → Connected Printer(钱箱 → 连接的打印机)所选的那台打印机。这里只列出本终端类型为 Receipt 的打印机。
  2. 确认 Connector Pin(接口针脚)与线缆一致,再检查 Pulse(脉冲)时长。
  3. 选择 Test Drawer(测试钱箱)。它使用当前显示的打印机、针脚和脉冲,即使尚未保存。“Drawer pulse sent. Check the cash drawer.” 表示 FMX EPOS 已发出脉冲。
  4. 如果测试能打开,选择 Save Printer Settings(保存打印机设置),让付款时使用同样的针脚和脉冲。如果现金付款后钱箱仍然不开,确认已勾选 Open After Cash Payment(现金付款后打开),然后再次保存。这个勾选项也会在现金退款、Paid In、Paid Out 和会员现金时打开钱箱。收银机上的 Open Drawer 按钮不受它影响。
  5. 如果测试打不开,先检查打印机驱动、钱箱线缆和硬件,再考虑改其他软件设置。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

钱箱是通过打印机打开的,所以小票能正常打印,不代表钱箱的针脚和线缆设置正确。如果在付款界面添加现金时钱箱没有打开,收银机会提示 “Cash payment added, but the cash drawer could not be opened: …”。这笔现金已经在付款界面上,不要再次添加。需要打开钱箱时使用 Open Drawer,然后照常选择 Confirm Payment 完成付款。只有设置了 Connected Printer,收银机上才会出现 Open Drawer 按钮,而且需要 No Sale (Open Drawer) 权限。