从你的收银, 到第一张后厨票。

准备设备、核对收银、发送测试票。按六步完成 OneKDS 本地 TCP 接入。

开始之前

先确认,门店具备接入条件。

本指南适用于当前公开版已支持的本地 TCP/GB18030 文本接收路径。POS 品牌或配置了 IP 本身不能证明兼容;其他输出方式、图片票与未知模板须先咨询适配。

准备可运行 OneKDS 的 Android 触控设备、已确认的厨打格式与可配置测试输出的收银系统。核对收银与接收设备之间的实际网络路径可达,使用同一 Wi-Fi 名称不能证明相互可通信。

记录收银名称与版本、模板名称与版本、输出方式、设备型号和 Android 版本。安排获准的测试窗口,保留原有生产打印配置与纸单对照;本指南不要求停用原打印机。

开始之前

先准备这三样。

已勾选 0 / 3 项

勾选仅用于本页自查,具体适配仍需按步骤验证。

下载安装包开始接入
本页目录:六步接入与排查
01

核对收银与模板

记录收银系统名称、版本、输出方式及票据样本。在设置 → 模板支持范围确认当前支持条件。未知格式先咨询适配,不默认图片票可用。

完成标准:已确认系统与票据格式,保留生产打印路径。

接收成功 ≠ 自动识别全部业务。现有验证资料涉及惠管家文本厨打样本,不等于所有版本或所有POS均支持。
02

配置 OneKDS 接收

打开设置,查看本机实际 IPv4 与 TCP 监听端口。修改端口前停止接收,保存端口后点击“开始接收”。示例地址和端口不能直接当作门店配置。

完成标准:在预期的实际地址和端口开始监听。

03

核对收银发送目标

由获准人员将测试输出指向接收设备。具体菜单随收银系统与版本不同,核对实际 IP、端口和路由,不覆盖原生产打印设置。

完成标准:测试目标正确,现有营业打印保持可用。

04

发送一张测试票

标注“测试不制作”,记录发送时间和收银反馈。检查 OneKDS 最近接收、待做与待核对记录;打印机状态应答并不等于完整业务票据已到达。

完成标准:找到与本次发送对应的完整原始票据。

05

检查待做与异常核对

格式完整且业务明确的已支持票据可自动进入待做。需要人工核对时,打开待核对 → 查看并处理 → 核对后加入待做。核对桌台、菜品、数量、单位和原单/加单性质,填写核对人与依据。相似内容先对照,未知、残缺、重打或退菜不当作独立新增。

完成标准:支持范围内、依据完整的测试票进入待做。

06

验证操作与重启

使用测试票验证整票或部分完成、原票查看和记录留存。重开应用后检查接收意图,再发送一张独立测试票。接入档案记录系统、模板与核对依据,但不代表自动放行。

完成标准:操作数量符合预期,重新接收可核对;仍需门店长稳验证。

保存接入档案,留下核对依据。

在设置 → 接入档案记录收银系统与模板版本、输出配置、来源配置、核对人和依据。保存档案只是保留现场记录,不等于模板已获自动放行资格,也不能代替真实测试票和门店长稳验证。

保留证据,再排查

没有收到?按现象排查。

没有接收记录

核对监听状态、实际地址与端口、收银目标、发送时间及反馈。不凭猜测归因。

已有原票,未进待做

查看待核对原因,不重复发送或放行来凑待做数量。

文字或数量异常

保留原始票据、设备和模板版本,暂停该票放行,再提交格式核对。不能靠补默认数量或单位消除异常。

中断后恢复

设置 → 中断记录与核对,对照纸单与收银记录,确认来源关系再处理补发。

恢复监听不等于漏票自动补齐。不要先卸载、清空数据或修改未知设置。
整理接入问题