离线模式

本指南介绍当 Hivive iOS POS 在没有互联网连接的情况下运行时，商家可以做什么、不能做什么。

离线模式旨在网络临时中断期间维持店内的基本销售运转。它并不能完全替代在线 POS、管理后台、支付服务商、会员系统或报表工具。

快速摘要

当离线模式可用时，员工可以继续使用缓存的菜单数据创建简单的 POS 订单、获得本地订单号、收取现金或已缓存的自定义付款方式、进行本地打印，并在网络恢复后由应用自动同步离线订单。

离线期间，POS 无法处理银行卡或终端机付款、查询会员、使用积分、退款、编辑服务器订单、更新库存、接收扫码或自助点餐机订单、更新 KDS、实时接收线上订单，也无法查看实时报表。

使用条件

离线模式只有在以下条件全部满足时才能使用：

• Hivive 已为该商家账户启用离线模式。
• 启用离线模式后，该 iPad 至少在线登录过一次。
• 自那次在线登录后，用户没有退出登录。
• POS 已经加载过员工所需的数据，例如菜单、商品、餐桌、员工、附加费、折扣和自定义付款方式。
• 离线订单在同步完成前，始终使用同一台 iPad。

如果员工第一次登录就处于离线状态，应用会要求先连接互联网。

哪些数据会被缓存

离线模式只能使用 iPad 已经加载过的数据。取决于员工在线时打开过哪些页面，缓存数据可能包括：

• 商家设置。
• 菜单、商品、商品选项、餐桌、楼层和位置。
• 附加费、折扣和自定义付款方式。
• 员工登录和打卡所需的员工记录。
• 最近加载过的订单列表和订单详情。

如果断网前没有加载过某项数据，离线时它可能不可用。在计划内断网前，请先在线打开重要的 POS 页面，让 iPad 获取最新数据。

离线时可以做什么

功能	离线可用？	说明
登录	受限	仅当离线模式已启用、且同一台 iPad 曾成功在线登录后才可用。
浏览菜单和商品	可用（来自缓存）	应用使用最后缓存的菜单、商品、选项、楼层和餐桌。
创建 POS 订单	可用	订单保存在本地，带有离线订单 ID 和本地订单号。
添加备注	可用	备注随本地订单保存，稍后同步。
输入散客姓名/电话	可用	仅作为订单文字信息，不会关联到会员档案。
应用商家附加费	可用（来自缓存）	使用 iPad 最后加载的附加费规则。
应用自动折扣或折扣码	可用（来自缓存）	使用 iPad 最后加载的折扣规则。自定义折扣同样可用。
收取现金付款	可用	付款记录在本地并排队等待同步。
收取自定义付款	可用（如已缓存）	自定义付款方式必须在断网前已加载。
打印厨房单、发票、收据或取餐号	通常可用	打印机已配置好且 iPad 可以连接到它时可用。依赖互联网的打印机可能无法工作。
现金结账时打开钱箱	通常可用	通过已连接的本地打印机/钱箱正常工作。
保存员工上下班打卡	受限	仅对已加载到 POS 的员工有效，打卡事件稍后同步。
查看最近订单	受限	显示缓存的订单列表/详情，以及该 iPad 上的本地离线订单。
恢复网络后同步	可用	网络恢复后，离线订单、排队的钱箱结账事件和打卡事件会自动发送。

离线时不能做什么

功能	离线不可用	原因
首次登录	无法登录	应用必须先在线验证账户，之后才能离线登录。
银行卡付款	无法处理	Stripe、Square、Tyro、Zeller、网络终端机和手动银行卡流程都需要互联网/服务器确认。
刷卡附加费	无法应用	刷卡附加费属于在线银行卡付款流程。
退款	无法处理	退款操作需要服务器和/或支付服务商。
注册会员查询	无法搜索、扫码、创建、编辑或删除会员	离线模式下会员数据仅在线可用。
会员积分	无法对会员账户赚取/兑换积分	离线时积分查询和奖励兑换被禁用。
编辑现有订单	无法通过常规编辑流程更新已下单订单	订单编辑需要服务器。请在结账前修改购物车，必要时创建新订单。
取消/删除订单	无法取消或隐藏订单	这些操作需要服务器。
拆分账单或换桌	无法可靠完成	这些流程会编辑服务器订单，应在线操作。
商品和库存更新	无法更新商品库存、选项或商品详情	POS 可以使用缓存数据销售，但无法发布库存/菜单变更。
弹窗消息和店铺设置	无法更新设置	设置变更需要服务器或管理后台。
报表和销售统计	无法加载实时数据	销售报表、现金销售、银行卡销售和交易汇总需要服务器。
钱箱班次管理	无法开始、结束或获取当前班次	现金结账事件可以排队，但班次管理和对账应在线完成。
终端机配对/设置	无法配对、解除配对或检查网络读卡器状态	读卡器设置需要互联网和服务商 API。
设备更换/账户变更	无法更换设备或刷新账户访问权限	设备和账户校验需要服务器。
副 POS（Slave POS）打印	无法通过主 POS 打印	副 POS 依赖互联网将打印任务发送到连接打印机的主设备。
电子邮件收据	无法发送	邮件发送在服务器端完成。
服务器重印	无法获取未缓存的订单	重印错过的线上订单需要访问服务器。
扫码点餐	无法接收新的扫码订单	顾客扫码点餐需要互联网和服务器连接。
自助点餐机	无法接收新的自助点餐机订单	自助点餐机订单需要互联网和服务器连接。
KDS	无法接收或更新厨房订单	厨房显示屏更新需要互联网和服务器连接。
线上订单实时更新	无法实时接收	Websocket 更新和线上订单打印需要网络连接。
跨设备可见性	离线订单无法在多台 iPad 之间共享	每台 iPad 各自保存本地离线数据，直到重新联网。

重要限制

缓存数据可能过期

离线订单使用 iPad 上已存储的数据。如果 iPad 离线期间，菜单价格、库存、附加费、折扣、员工密码或自定义付款方式在管理后台发生了变更，这些变更在 iPad 重新联网并刷新之前都不会生效。

这意味着员工可能卖出线上已标记为售罄的商品、错过新创建的折扣，或使用旧的附加费规则。

离线订单按其当前状态同步

离线结账会创建本地订单并排队等待同步到服务器。如果 iPad 重新联网时订单仍未付款，它会以未付款订单的形式同步。如果已通过现金或自定义付款方式完成付款，付款状态和付款详情也会一并同步。

对于柜台结账的商家，重新联网后未付款的离线订单会出现在管理后台，但仍需完成付款，订单才会计入已付款销售。

银行卡付款不属于离线付款

应用不会在离线状态下授权或扣款银行卡。除非支付服务商在线确认，否则不要认为银行卡付款已完成。断网期间，请只使用现金或经过认可的自定义付款方式。

离线订单号是本地生成的

离线订单号在 iPad 上即时生成，以便餐厅在断网期间继续运营并打印订单号。

这些订单号仅在该 iPad 本地有效，可能与以下号码重复：

• 另一台离线 iPad 生成的订单号。
• 该 iPad 离线期间在线创建的订单号。
• 之前某次本地离线序列生成的订单号。

这是正常现象。订单同步回服务器时会保留本地离线订单号。如果旧版本应用同步的离线订单没有订单号，服务器可能会在同步时分配一个。

一台 iPad 不知道另一台 iPad 离线时做了什么

如果两台 POS 设备同时离线，每台设备只能看到：

• 自己本地的离线订单。
• 自己之前已缓存的服务器订单。
• 自己之前在线会话缓存的菜单和设置数据。

一台离线 iPad 上录入的订单，在该 iPad 重新联网并同步之前，不会出现在另一台 iPad 上。

副 POS 打印需要互联网

副 POS（Slave POS）的设计是由一台主 POS 设备连接所有打印机，其他 iPad 通过互联网将打印任务发送给主设备。由于这一传递需要网络连接，离线模式下应视副 POS 打印为不可用。

断网期间，需要打印的订单请使用连接打印机的主 POS，或使用有自己直连打印机的设备。副 iPad 在网络恢复之前无法通过主 POS 打印。

未同步的数据保存在设备上

离线数据存储在 iPad 本地。正常的应用重启不会丢失数据，但如果在同步前删除应用、抹掉设备或设备损坏，数据可能丢失。

请尽快恢复网络，并保持应用打开足够长的时间，让待同步订单完成同步。

推荐的断网工作流程

1. 保持 POS 登录状态，断网期间不要退出登录。
2. 使用缓存菜单照常接单。
3. 对离线创建的订单，在顾客付款时收取现金或使用已缓存的自定义付款方式。
4. 如果打印机可以连接，就在本地打印厨房单/收据。
5. 如果员工需要在同步前取消、修改或赠送某个离线订单，请在应用之外手动记录。
6. 网络恢复后，保持 POS 打开并在线，直到待同步订单全部完成同步。
7. 同步后检查管理后台，确认离线订单和已付款销售正确显示。

计划内断网前的准备

在预期的网络中断之前：

• 在每台可能需要离线模式的 iPad 上完成在线登录。
• 打开 POS 菜单，刷新菜单、商品、餐桌、楼层、附加费和折扣。
• 如果员工断网期间可能需要查看最近订单，请先打开订单列表。
• 如果离线时需要使用自定义付款方式，请先打开一次付款页面。
• 在断网前让员工登录或打开需要员工数据的流程，以加载员工数据。
• 不要指望断网期间使用副 POS 打印；请计划使用连接打印机的主 POS 或直连打印机。
• 确认本地打印机和钱箱在不依赖互联网的情况下正常工作。

网络恢复后

iPad 重新联网后，应用会自动尝试同步，并定期重试待同步的任务。

同步后：

• 离线订单会以其当前状态生成服务器记录。
• 本地离线订单 ID 会映射到服务器订单 ID。
• 离线订单号会保留在同步后的服务器订单上。
• 钱箱结账事件和员工打卡事件会被发送。
• 已同步的本地订单记录会在设备上暂存一段时间，之后自动清理。

如果重新联网后订单没有出现在管理后台，请保持 iPad 在线并保持应用打开。如果仍未同步，请在删除应用或退出登录之前联系 Hivive 客服。