前台收银打印机和扫码器的接入
文档介绍了前台收银系统打印机和扫码器的接入方法。打印机部分包括：通过后台打印机设置安装C-Lodop服务、配置本地小票和商品标签、支付成功后自动打印，以及常见问题排查；设置仅保存在当前浏览器并按门店保存。扫码器部分包括：区分商品条码、付款码、核销码用途，USB键盘模式和串口方案接入，以及使用排查要点。
1. 前台收银系统的打印机接入
操作路径：【后台】→【前台收银】→工作台右侧【打印机设置】。
使用前准备：
连接打印机，按照厂家说明安装对应驱动，确认系统能识别设备并正常打印测试页。
进入前台收银，确认当前【收银门店】。
打开【打印机设置】，按页面提示安装或启动 C-Lodop 打印服务；安装完成后点击【重新检测】。
配置本地小票：
开启【启用本地小票】，在【默认打印机】中选择实际使用的设备。
按纸张和实际需求设置【小票纸宽】及【打印份数】。如需零售小票使用另一台打印机，可设置【零售指定打印机】；未指定时沿用默认打印机。
点击【设置打印内容】，按订场、次卡、零售分别选择需要显示的信息并调整顺序。
选择要测试的打印机，先检查【预览测试小票】，再点击【打印测试小票】确认实际出纸、内容和版式。
测试符合要求后点击【保存设置】。测试不会自动保存参数，保存设置也不会立即提交一张小票。
打印设置仅保存在当前浏览器，按门店分别保存，不会自动同步到其他电脑。换电脑、换浏览器或清除相关浏览器数据后，请重新检查设置。检测到 C-Lodop 只代表本地服务可以连接，不等于打印机已经就绪或实际出纸。
支付成功后自动打印：
整单小票需先启用本地小票，再打开【支付成功自动打印】，选择适用业务并保存。
订场、次卡和零售已接入支付成功后的自动打印；场地计时暂未接入，不应仅根据设置列表判断已支持。
仅创建、分享或挂账未收款的订单，不应当作支付成功的自动打印结果。
整单小票和商品标签的自动打印分别控制。开启小票自动打印，不代表同时开启了标签自动打印。
商品标签打印：
进入【设置打印内容】，按需要开启【奶茶标签模式】。
打开【标签打印机设置】，选择对应的标签打印机，并按实际标签纸配置参数。
按需要设置标签的自动打印选项，测试实际出纸效果并保存配置。
商品标签使用独立的标签打印机配置，可与整单小票同时使用；不要把【零售指定打印机】的小票配置与标签打印机混为一项。
常见问题：
未检测到本地服务：确认 C-Lodop 已安装并启动，按页面提示检查浏览器访问本地服务的条件，然后重新检测。
打印机不在列表中：先检查系统是否识别设备，再点击【刷新列表】，确认名称与实际设备一致。
纸宽、内容或走纸不合适：先检查驱动、纸张、测试目标及是否使用零售独立参数，再进行测试调整；不同机型的走纸和切刀效果需要实测。
任务显示“已提交”但没有出纸：先检查实际设备、纸张及系统打印队列。“已提交”仅表示服务接受了任务。
任务显示“结果未知”：先检查实际出纸情况，不要连续补打。当前页面的打印任务不会在刷新或关闭页面后自动恢复。
2. 前台收银系统的扫码器接入
先区分扫码用途：
商品条码：在【零售】页面扫描，用于查找、选择商品。
付款码：进入订单的【付款码支付】流程后，扫描顾客出示的微信或支付宝付款码，等待系统返回支付结果。
核销码：在场地看板、售卡等支持核销的页面扫描，用于核销对应订单或凭证。
USB 键盘模式接入：
将扫码器连接电脑，按设备说明设置为 USB 键盘模式。
建议先使用 Enter（回车）作为扫码结束符，便于完成一轮标准测试。不同设备的配置方式以厂家说明为准。
在普通文本工具中先检查扫码内容是否完整、是否出现乱码或额外字符。测试付款码时不要保存或分享实际码内容。
回到前台收银，确认当前门店，在对应业务页面或收款弹窗中测试识别结果。
USB 虚拟串口／串口方案（推荐）：
如门店采用串口方案，请先由技术人员确认扫码工具与当前后台版本兼容，再按设备和工具说明配置。
已确认使用欧轩【扫码枪串口驱动工具】的门店，可连接扫码器后，在工具中选择对应串口、按既定方案配置追加字符，再点击连接并检查接收预览。
工具接收到内容后，还需要回到前台收银完成实际识别测试。仅在工具预览中看到内容，不代表后台业务已经核销或收款成功。
原提供的扫码枪串口驱动工具下载入口：前往下载。使用前请确认工具版本及适用设备。
键盘模式和串口方案是不同的接入方式，不能套用同一组连接参数或结束符要求。设备性能、输入法、工具版本和当前页面状态都可能影响识别，应以实际门店测试结果为准。
使用与排查：
扫描付款码前先进入对应收款流程，并按页面提示将光标移出其他输入框。
需要扫码核销时，先处理或关闭正在进行的收款、订单弹窗，避免将核销码送入付款码支付流程。
扫码后等待系统结果；处理中不要连续扫描同一码。是否收款或核销成功，应以系统明确返回的结果和订单状态为准。
扫码内容不完整或识别失败：依次检查连接模式、结束符、输入法、码类型、当前门店和页面提示，再重试。
串口工具配置示意图：
