脱机收银与网络异常
一、功能概述
1. 功能简介
门店网络不稳定是常态：路由器重启、宽带欠费、店内施工挖断线，都会让收银台连不上服务器。收银台对这件事的设计是「先做生意、后补数据」——网络断开时不锁界面、不清购物车，而是转入脱机收银，把单据写进这台设备的本地存储；网络恢复后自动补传，补传失败的进「异常概况」让人工重试。收银员要会看顶栏的同步状态，店长要会查异常概况里哪几张小票还没上云、哪几张打印失败。
需要划清的一条线是：脱机能收的是不依赖在线服务的钱。现金、挂单可以照收；储值卡扣款、券核销、扫码在线收款必须联网，断网时会被挡下。
功能路径：收银 → 顶栏同步状态徽标 / 收银区「异常概况」卡片 → 点击查看明细
2. 核心用途
- 断网不断生意：网络异常时继续点单、收银、挂单，不因连不上服务器停摆；
- 数据不丢：本地暂存单据，联网后自动上传，避免手工补录；
- 异常可见：用顶栏徽标与异常概况计数，一眼看出有没有欠账；
- 精准补传：对某一张上传失败的单据点「立即上传」单独重试，不用等全量；
- 补打小票：打印失败的单据在「打印异常」页签里逐张「补打」。
3. 整体结构
- 顶栏同步状态徽标：位于左上角门店区，显示「已同步」「同步中」「离线」等状态；
- 异常概况卡片：收银区中部的统计卡，列出支付异常、打印异常、传输异常三个计数，标题右侧提示「点击查看明细」；
- 异常概况弹窗：三个页签——支付异常、打印异常、传输异常，每个页签是一张异常单据列表，行内含单号、业务名、状态、时间与错误原因，右侧为重试按钮。
二、界面与状态说明
顶栏同步状态
| 状态 | 含义 |
|---|---|
| 已同步 | 本机与服务器数据一致，无欠账 |
| 同步中 | 正在拉取或补传，稍候即回「已同步」 |
| 离线 | 当前处于脱机收银，单据暂存本机 |
异常概况卡片
| 项 | 说明 |
|---|---|
| 支付异常 | 在线支付结果待确认的单据数；当前版本显示「--」，弹窗内提示「暂无支付异常（二期接入）」 |
| 打印异常 | 本机打印失败、等待补打的小票数 |
| 传输异常 | 尚未成功上传云端的单据数 |
三项计数都是 0 时说明本机没有欠账；任一非 0 就点卡片进弹窗看明细。
异常概况弹窗
| 页签 | 行内容 | 按钮 | 空态文案 |
|---|---|---|---|
| 支付异常 | 二期开放 | — | 暂无支付异常（二期接入） |
| 打印异常 | 小票号、业务名称、状态「打印失败」、时间、错误原因 | 补打（点击后变「补打中…」） | 暂无打印失败记录 |
| 传输异常 | 单号、所属业务、状态「待上传」或「上传失败」、创建时间、小票号、「已重试 N 次」、失败原因 | 立即上传（点击后变「上传中…」） | 暂无未上传单据 |
「已重试 N 次」与失败原因直接写在行内，是判断「这张单为什么老传不上去」的第一手信息。
三、脱机收银的行为边界
断网瞬间会发生什么
收银过程中网络断开，界面顶部出现提示「网络已断开：脱机收银中，单据暂存本地、联网后自动上传」，或「网络异常，脱机收银中：单据暂存本地、联网后自动上传」。此后：
- 商品、会员、价格等基础资料用本机缓存，界面照常点单；
- 结算只放行不依赖在线服务的收款方式，现金、挂单可继续；
- 单据落到本机待上传队列，顶栏同步状态转「离线」，异常概况的传输异常计数增加。
进店时同步失败
打开收银台就取不到基础资料时，页面提示「进店同步失败，使用本地缓存继续收银（离线：仅现金/挂单）」，或「同步失败，使用本地缓存」。这意味着用的是上一次缓存的商品与价格——门店当天改过价、上新品时，脱机状态下看不到最新结果。
首次同步就失败（本机还没有任何缓存）时提示「首次同步失败：请检查网络与登录」，此时无法收银，需先恢复网络。
脱机时不能做什么
| 操作 | 脱机时的结果 |
|---|---|
| 储值卡扣款、券抵扣 | 提示「储值/券抵扣需联网结算，请恢复网络或改用现金收款」 |
| 扫码在线收款 | 收不了，钱进不来，改走现金或挂单 |
| 会员查询 | 只能用本机缓存的会员，新会员查不到 |
| 预订单取货回写 | 可能提示「取货回写失败：网络异常（零售单已落，请勿重复取货）」——零售单已在本地生成，不要重复取货，联网后回异常概况核对 |
| 打印 | 可以打印，但打印失败会进「打印异常」等待补打 |
网络恢复后
- 收银台自动补传待上传队列，成功后提示「网络已恢复，已补传」；
- 补传失败时提示「网络已恢复，但补传失败，请稍后在异常概况中重试」，此时必须人工进异常概况逐张处理；
- 单据上传成功前不会出票，提示口径是「单据暂存待上传，网络恢复后自动出票」「单据尚未上传成功，上传后自动出票」；
- 上传通道本身没准备好时提示「上传通道未就绪」。
四、常见操作
断网后继续收银
- 看到「脱机收银中」提示，先确认顾客用现金还是稍后补扫码；
- 正常点单，收款方式选现金；顾客钱不够或不愿等的，点「挂单」把购物车留在本机；
- 网络恢复后用「找单（挂单列表）」调回这单结清——挂单记在本机的收银机号下，换一台机器看不到，提示「当前挂单」「暂无挂单」都属正常；
- 回顶栏确认状态回到「已同步」。
排查为什么还有单据没上传
- 收银 → 异常概况卡片 → 看传输异常计数；
- 点卡片打开弹窗，切到「传输异常」页签；
- 逐行看「已重试 N 次」与失败原因：原因里是网络类报错就点「立即上传」重试，是数据类报错（如单号冲突）需联系总部；
- 全部处理完，页签显示「暂无未上传单据」后关闭弹窗，回顶栏确认「已同步」。
补打打印失败的小票
- 收银 → 异常概况卡片 → 打印异常计数非 0；
- 打开弹窗切到「打印异常」页签，核对小票号与业务名称；
- 先确认打印机已在参数设置里绑定且在线（见 终端与参数设置）；
- 点对应行的「补打」，按钮变「补打中…」，成功后该行从列表消失。
交班前确认没有欠账
交接班前必须把本机数据传干净，否则班次统计与总部口径不一致：
- 看顶栏是否「已同步」；
- 打开异常概况，确认打印异常与传输异常都为 0；
- 有欠账先按上面两步处理，处理不掉时记下小票号，交班备注后再交班，流程见 交接班与清机。
五、常见问题
问：断网了能不能继续收银？ 答：能。收银台自动转脱机收银，单据暂存本机、联网后自动上传。但脱机时只有现金与挂单可走，储值、券抵扣、扫码在线收款都要等网络恢复。
问：脱机收的钱会不会丢？ 答：单据写在本机浏览器存储里，网络恢复后自动上传。风险在于换浏览器、清理浏览器数据或重装系统会清掉本地存储，所以脱机收的单据不要拖到当天结束，务必在交班前确认「已同步」。
问：顶栏一直显示「同步中」不动怎么办？ 答：说明补传卡住了。刷新收银台（顶部「刷新」）重新触发同步；仍不动就打开异常概况看传输异常，逐张点「立即上传」，看行内的失败原因判断是网络还是数据问题。
问：提示「首次同步失败：请检查网络与登录」，界面是空的？ 答：这台设备本机还没有任何基础资料缓存，脱机也收不了。检查网络与登录状态后重新进入；确认网络正常仍失败，联系总部核对该分店的资料是否已下发。
问：异常概况里支付异常显示「--」，是不是坏了？ 答：不是。支付异常明细当前版本未开放，弹窗内提示「暂无支付异常（二期接入）」，在线支付的结果确认由系统自动处理。
问：小票没打出来，顾客已经走了怎么办？ 答：进异常概况的「打印异常」页签找到该张小票点「补打」。若列表里没有，说明打印任务本身没失败，是打印机没纸或没绑定，去参数设置的打印设置里核对。
问：能不能强制把某张单立刻传上去？ 答：可以，异常概况 → 传输异常 → 该单行右侧「立即上传」。按钮变「上传中…」，成功后该行消失；失败会保留在列表并更新「已重试 N 次」与失败原因。