1. 配置问题 (Configuration Issues)

商家Logo设置：推荐Logo尺寸为512x512像素，格式为JPEG。需要在后台（Back office）的“设置”>“硬件”>“打印模板”中上传Logo图片并保存更改。
网络配置：
- 确保POS系统和打印机在同一网络下。有时即使在同一Wifi下，如果属于不同接入点(AP)也可能无法正常工作。
- 建议为打印机设置静态IP地址。如果使用动态IP，每次打印机重启后IP可能改变，需要在软件中更新设置。
- 需要检查POS设备的Wifi设置（IP地址、子网掩码、网关）是否与打印机设置匹配。如果POS设备是Wifi而打印机是LAN连接，它们的IP地址段需要匹配（例如同在192.168.x.x网段）。
打印机连接设置：
- 确认打印机连接方式（USB/网络/蓝牙）配置正确。USB连接通常比蓝牙更稳定。
- 检查打印机驱动是否正确安装。
- 确保在POS设置中选择了正确的打印机型号并已正确配对。对于非Sunmi内置打印机，可能需要选择“其他”型号，并通过LAN或USB连接。
- 建议将LAN打印机配置到一台主POS设备上。其他设备（如点餐平板）可以通过该主设备进行打印任务的同步和分发。将同一台打印机配置到多台设备上可能导致重复打印。
- 如果需要平板电脑直接连接打印机打印账单/收据，需要在平板电脑上单独配置该打印机。但某些打印机型号可能不支持连接到多台设备。
- 建议单台POS设备连接的打印机数量少于5台，可以将打印机分摊到不同的设备上以提高性能和稳定性。
- POS设备与支付设备（如PAX）需要在同一网络下才能连接；打印机网络IP也需与POS系统在同一网络下。如果POS通过Wifi连接的网络与打印机通过LAN连接的网络IP地址段不同，它们可能无法通信。
打印模板和内容设置：
- 检查打印模板设置是否完整，例如商家信息是否正确填写.
- 爱普生打印机可能需要选择“图形模式”（Graphic mode）进行正确打印。
- 调整打印分辨率（如从300改为180 DPI）可能影响打印效果和内容显示。
- 纸宽设置（如58mm/80mm）需要与实际纸卷匹配。
- 调整准备收据的对齐方式可在后台打印模板编辑器中设置。需要选择对应的模板（如80mm准备收据），点击收据主体，选择对齐方式。
- 可以在后台打印模板设置中控制哪些备注/附加项显示在临时收据上。
收银抽屉设置：收银抽屉通常需要连接到主POS设备或打印机。连接到主POS且是现金交易时，通常无需额外软件设置即可自动打开. 有时信号通过打印机发送。需要更新APK可能才能解决钱箱问题. Sunmi钱箱应该接收打印机信号.
其他设置：
- 如果在多个工作站使用收据打印机，需要关闭“打印来自其他设备的收据”(Print receipt from other devices)设置，以避免重复打印同一笔订单的收据。
- 可以在POS后台或设置中管理特定商品/修改项打印到特定的厨房打印机。如果整个类别已分配给特定打印机，则添加新产品时会自动绑定；如果类别中的产品分给不同打印机，则需要手动绑定。被排除在配置外的商品可能不会打印到该打印机。
- 关闭支付终端 (PAX) 的打印功能可以通过删除打印机配置或不放打印纸实现。不放纸可能导致终端报错并停止交易. 也可以在PAX终端的设置中关闭打印.
- Kiosk内置打印机在Windows系统运行Android虚拟机环境下可能无法穿透识别，建议切换模拟器（如Bliss OS）。
- 为了确保打印稳定性，建议所有打印机和POS设备都在同一本地网络内并使用静态IP。

2. Bug

打印机随机断开连接：USB或蓝牙打印机随机断开连接，需要重启设备或打印机才能恢复。尝试了多种品牌和设备，问题仍出现。有时可能与网络或WebSocket连接有关。清除应用数据/缓存会导致打印机设置丢失。
重复打印：一台或多台打印机重复打印旧订单，例如在结算时打印前两天的订单。可能与打印重试功能（Print retry）有关或软件向特定打印机多次发送打印任务.
特定商品不打印：某些商品（如Seared scallops）即使配置正确，也未能打印到指定的厨房打印机，但会发送到KDS。通过移除并重新添加商品到打印机配置中解决。
自动打印失效：打印机测试页正常，但自动打印（如订单生成时或支付后）不触发。可能是由于网络问题导致WebSocket断开，也可能是特定版本的问题.
不同设备打印冲突/问题：将打印机配置到主POS后，其他平板无法直接打印账单/收据，显示无法连接打印机。这可能是由于打印机型号不支持多设备连接，或设备之间竞争连接造成冲突。

3. 需求 (Feature Requests)

打印和收据定制：
- 在订单收据和支付设备或POS屏幕上显示卡支付价格（与现金价区分），或同时显示两种价格。目前订单收据不支持添加卡支付价格。
- 在收据上分别显示自动服务费（Gratuity）和小费（Tips）。目前显示为“Tips”。功能正在开发中。
- 在支付前（在支付设备或POS屏幕上）提示选择小费。目前是在支付后选择小费。Kiosk需要在刷卡前选小费，但改动较大，处理需要时间。
- 只在需要时打印结账收据，而非自动打印。可以通过禁用自动打印并在记录中手动打印实现。此功能正在开发中。
- 收据上需要显示小费金额。
- 现金支付收据上移除小费部分。
- 自动打印的收据上显示账单号 (Bill Number)。
- 允许平板电脑直接连接打印机打印账单/收据（如临时收据），而非必须通过主POS。希望能配置打印命令同时发送到多个打印机（如3台分散的打印机）。目前仅支持单点打印。
- 能够控制哪些备注/附加项显示在临时收据上。
- 简化收据布局，使其更易理解和清晰。
- 支持Star打印机双色打印（红色修改项/备注）。目前不支持，需要SDK集成和额外开发工作。
- 通过弹窗选择打印机进行打印。目前不支持，已反馈给团队.
- 打印Void和Refund的收据。已列为优先开发事项。
- 提供打印收据以供签名（客户手动加小费并签名）的功能。
报表和数据：
- 后台办公室应提供设置，以便将新添加的商品分配到特定打印机。
- 能够在后台查看USB和以太网打印机设置。
- 整合日结报告（Z报告），使其更结构化，包含详细的交易要素（如授权码、卡类型等）。需要针对热敏打印机优化格式（紧凑、右对齐、分隔线、字符宽度），支持希伯来语，可导出PDF，并包含可定制元素（商家名、收银员名、班次信息、货币符号）。
硬件和集成：
- 推荐用于杯子的不干胶标签打印机。推荐Xprinter Label Printer。
- 已支持Star打印机（SP700系列）。
- 已支持Epson打印机（TM-U220B）.
其他：
- 无论网络范围如何都能登录系统（离线模式），提及可解决websocket问题并帮助打印稳定性。离线模式正在开发中。

FAQ