常见问题与故障排查
本页按「屏幕上出现了什么」组织，每条给出成因与处理动作。需要完整步骤时点进对应功能文档。
一、登录与注册
| 现象 | 成因 | 处理 |
|---|---|---|
| 打开地址后浮出「注册机器」面板 | 这台设备第一次使用，终端未注册 | 按实施方给的方式注册：有 32 位授权码走「分店授权码」页签，无需客户码与短信；详见 终端注册与登录 |
| 提示「授权码应为32位，请重新扫码或手输」 | 授权码少填或多了空格 | 授权码固定 32 位，重新扫码或整段粘贴 |
| 提示「分店激活码不能用作注册码，请输入开发商注册码或改用授权码方式」 | 页签选错：把分店激活码填进了「注册码注册」 | 改点「分店授权码」页签提交 |
| 提示「请输入10位客户码」 | 「注册码注册」页签的客户码没填 | 客户码由总部提供，固定 10 位 |
| 点「获取验证码」没反应、手机也没收到 | 「查询分店」还没完成，按钮此时是禁用状态，点击是空操作 | 等「查询分店」返回后再点，点后必须看到按钮变成倒计时秒数才算真发出 |
| 提示「效验码不正确!」 | 短信验证码填错或已过期 | 短信码一次一用、几分钟过期，重新获取后立刻填 |
| 登录后报「网络不可用」 | 选了默认演示账套，那台服务器连不上 | 在账套下拉里选门店实际所属的账套再登录 |
| 提示「会话已失效，请重新登录」 | 登录态过期 | 重新登录；收银中未结算的购物车会保留在本机 |
| 提示「会话未就绪：后端服务器地址为空，请重新登录」 | 本机配置里服务器地址为空 | 退出登录后重新登录；仍为空则回终端信息面板核对服务器地址 |
| 提示「请输入用户名和密码」 | 输入框为空 | 补齐后提交 |
二、绑定与权限
| 现象 | 成因 | 处理 |
|---|---|---|
| 顶栏一直显示橙色「收银机未绑定」 | 终端注册成功，但还没绑定本店的一台收银机。单据流水按收银机隔离，没绑定就出不了单 | 点头像打开终端信息面板，点「绑定收银机」，在列表里选一台未被占用的机号；详见 终端注册与登录 |
| 点商品、点收款都没反应 | 未绑定收银机时的拦截，提示「请先绑定收银机：单据流水按收银机隔离，共用机号会撞号」 | 同上，先绑定收银机 |
| 绑定弹窗里每台都标「[已使用] … 已绑定其他设备」 | 本店登记的收银机号已被其它设备占用 | 点「＋ 注册新收银机并绑定本设备」为本机注册一台新机（列表中显示为「可绑定机器 ✓」），再点「完 成」提交；暂时不处理可点「暂不绑定」，但绑定前无法加购开单；机号不够时找总部增登记 |
| 想换一家门店收银 | 分店由注册授权绑定，弹窗里改不了。原文提示「分店由注册授权绑定，不可在此切换。如需更换分店：请在登录页使用新分店的授权码重新注册」 | 联系总部生成新店授权码，重新注册终端 |
| 打折、改价、退单时弹「请输入主管账号和密码进行授权（此授权仅对本次操作有效）」 | 该操作需要主管权限 | 让主管输账号密码授权；授权只对当次操作有效，下一单仍需再授 |
| 提示「你的临时折扣权限不足，最多只能打」 | 主管给的临时折扣权限低于你要打的折扣 | 改按允许的折扣率，或找更高权限账号授权 |
| 提示「授权失败」 | 主管账号密码错或该账号无此权限 | 核对账号，必要时在后台给账号开权限 |
三、点单与结算
| 现象 | 成因 | 处理 |
|---|---|---|
| 提示「库存不足，无法结算」「库存不足无法销售」 | 该商品本店可用库存不够 | 先在门店后台调库存，或改卖替代品；库存口径见 SAAS门店后台系统 的库存相关文档 |
| 提示「储值/券抵扣需联网结算，请恢复网络或改用现金收款」 | 网络断开，储值与券必须在线核销 | 恢复网络，或本单改走现金；脱机边界见 脱机收银与网络异常 |
| 提示「支付渠道未同步，无法扫码收款（需在线）」 | 在线收款渠道没同步到本机 | 刷新收银台重新同步；持续失败联系总部核对渠道配置 |
| 提示「聚合渠道未接入，无法扫码收款」 | 该账套没接入聚合收款 | 改走已开通的收款方式，或找总部开通 |
| 提示「该收款方式未关联支付渠道」 | 收银台里这个收款方式在后台没配渠道 | 到门店后台给该收款方式关联渠道 |
| 提示「正在结算，请勿重复点击」 | 上一笔结算还没返回 | 等结果，不要连点，连点会重复发起 |
| 提示「存在未收敛支付单，禁止重复发起」 | 有一笔在线支付结果还没确认 | 先处理那笔未收敛的支付，见下一条 |
| 提示「该笔结果确认中，请勿重复扫码；确认后自动到账补票，可先接待下一位」 | 扫码支付结果在确认中 | 换接待下一位顾客，这笔确认后自动补票；结果确认前不要重新扫码，防止重复收款 |
| 提示「收款行已足额，无需再扫码」「已足额收款，无需扫码」 | 应收已经收满 | 直接结算，不必再扫 |
| 提示「发起失败，请重新扫码」「网络异常，请重新扫码」 | 支付请求没发出去 | 让顾客重新出示付款码再扫一次 |
| 提示「取货回写失败：网络异常（零售单已落，请勿重复取货）」 | 网络抖动导致回写失败，但零售单已经生成 | 不要重复点取货；联网后回订单页核对该单状态 |
| 提示「该预订单正在取货中或已完结，不能重复取货」 | 该单已被处理 | 回订单页看当前状态，别重复操作 |
| 提示「取货单不支持挂单，请直接结算」 | 取货单不允许再挂 | 直接结算 |
| 挂单列表里是空的，提示「暂无挂单」 | 本机没有挂起单据，或挂单记在别的收银机号下 | 换回原来那台收银机查看 |
四、会员与卡券
| 现象 | 成因 | 处理 |
|---|---|---|
| 提示「会员不存在」 | 手机号/卡号输错，或该会员属别的分店体系 | 核对号码；扫码枪输入后要按 ✓ 或回车才提交 |
| 会员卡刷不出来 | IC 读卡器未启用或未接 | 参数设置 → 会员页设置里打开「自动开启IC读卡（刷卡查会员）」，见 终端与参数设置 |
| 券核销失败 | 券已用、过期，或本店不可用 | 在券核销弹窗里核对券状态；核销流程见 会员与卡券 |
| 断网时会员查不到 | 脱机只能用本机缓存 | 恢复网络后再查 |
五、打印与钱箱
| 现象 | 成因 | 处理 |
|---|---|---|
| 小票不出纸，打印机下拉显示「未绑定 未注册打印机（在壳端 HardwareConfig 注册）」 | 网页版不直接驱动本地打印机，打印机要先在桌面壳端注册 | 在壳端 HardwareConfig 注册打印机，再回参数设置选机与模板 |
| 提示「未配置小票打印机，无法开钱箱」 | 开钱箱走小票机指令，没绑打印机就开不了 | 先在打印设置绑定收银小票机 |
| 提示「云打印通道无钱箱接口，不支持开钱箱」 | 选的是云打印机，云通道没有开箱指令 | 换成本机驱动的小票机通道 |
| 提示「未配置打印机端口/名称」 | 打印机参数没填全 | 回打印设置补齐端口/名称 |
| 提示「云打印机未绑定」「芯烨云打印机未绑定」「请在参数设置选择飞鹅云打印机」 | 参数设置里选了云打印类型但没绑定具体机器 | 在打印设置里按 SN 绑定对应云打印机 |
| 提示「纸型不一致：打印机…」 | 模板纸宽与实际纸卷不符 | 换成与纸卷一致的打印模板 |
| 提示「正在打印，请勿重复点击」 | 上一张还在打 | 等待完成 |
| 提示「打印失败」「壳打印失败」「浏览器打印异常」 | 通道或设备问题 | 进异常概况 → 打印异常，逐张「补打」，见 脱机收银与网络异常 |
| 提示「清机条打印失败：」 | 清机条输出失败 | 检查打印机绑定后重发清机条，见 交接班与清机 |
六、界面与设备
| 现象 | 成因 | 处理 |
|---|---|---|
| 商品格太小、触屏点不准 | 显示比例与字号按默认值 | 参数设置 → 界面设置里调分类字号、商品字号、分类行高与最小商品按钮宽度；本机再单独调显示比例 |
| 换一台机器界面又变小了 | 显示比例属终端级设置，只对本机生效 | 每台机器各设一次 |
| 副屏没有画面 | 未启用双屏或本机没接第二块显示器 | 参数设置 → 副屏客显里启用双屏并选模板 |
| 摄像头不弹出来扫码 | 未打开自动扫码 | 参数设置 → 扫码设置里打开「自动打开扫码」；扫码枪属键盘输入，不需要这个开关 |
| 页面卡住、数字不刷新 | 常驻定时器与后端同步状态错乱 | 点顶部「刷新」重载本机数据 |
| 界面右侧「后台」点了提示「仅壳环境支持打开后台」 | 网页版收银台不提供后台入口 | 后台功能直接在浏览器打开门店后台地址 |
七、数据与对账
| 现象 | 成因 | 处理 |
|---|---|---|
| 顶栏不是「已同步」 | 本机还有单据没传上去 | 进异常概况 → 传输异常，逐张「立即上传」 |
| 交班数与总部报表对不上 | 本机有未上传单据就交了班 | 交班前先确认「已同步」且异常概况三项计数为 0 |
| 脱机收的单据找不到了 | 清理浏览器数据、换浏览器或重装系统会清掉本机存储 | 脱机单据当天必须传完；不要在营业中清理浏览器数据 |
| 提示「请求超时，请检查网络后重试」「连接超时，请检查网络后重试」 | 网络到服务器链路慢或断 | 检查网络；持续超时改走现金并留挂单，联网后补录 |
| 提示「同步返回为空，请检查登录与会话」 | 登录态或会话异常 | 退出重新登录 |
| 提示「分店会话建立失败（下次登录流程重试）」 | 分店上下文没建立 | 刷新或重新登录；仍失败核对终端绑定的分店是否正确 |
八、报障前要准备的信息
联系技术支持时，把下面几项一并发过去，可以省掉一轮来回：
- 收银台左上角头像 → 终端信息面板里的分店名称与编号、终端编号、服务器地址；
- 页面底部或面板上的软件版本号（形如 v1.1026.8）；
- 异常概况三个页签的计数与行内失败原因；
- 出现问题的小票号/订单号与发生时间；
- 一张能看清提示语的屏幕截图（注意遮挡顾客手机号）。