手动换电¶
概述¶
手动换电是标准服务员电池换电流程的变体，专为无法通过正常 M-Pesa QR/自动化渠道确认付款的情况而设计。它遵循与常规服务员流程相同的 6 步流程，但使用手动付款录入代替——Odoo 付款确认步骤被跳过。
对此小程序的访问由 externalswap 小程序标识符控制。只有当活跃的服务账户（SA）已被授予 externalswap 小程序时，它才会出现在角色选择界面上。
何时使用手动换电¶
在以下情况下使用手动换电流程：
- 付款是通过自动 M-Pesa 渠道之外的方式收取的（如现金、银行转账或第三方收据）。
- 标准服务员付款 QR 扫描不可用或不适用。
- 换电站在手动付款协议下运营。
工作流程¶
手动换电流程遵循与标准服务员流程相同的 6 步进程：
| 步骤 | 名称 | 描述 |
|---|---|---|
| 1 | 客户 | 通过 QR 扫描或订阅 ID 识别客户 |
| 2 | 归还 | 通过 BLE 扫描并归还旧电池 |
| 3 | 新建 | 通过 BLE 分配新电池 |
| 4 | 审核 | 确认费用明细 |
| 5 | 付款 | 手动录入付款参考 |
| 6 | 完成 | 完成交易并查看收据 |
关键区别：步骤 5 — 付款¶
在标准服务员流程中，步骤 5 提示客户扫描 M-Pesa QR 码，应用等待 Odoo 的确认。
在手动换电流程中：
- 不向客户展示 QR 码。
- 服务员直接输入手动付款 ID/参考号。
- 后端记录付款，而不经过自动 M-Pesa 确认流程。
访问权限¶
- 小程序标识符：
externalswap - 路由：
/attendant/manual-swap - 需要使用员工凭据登录（与标准服务员小程序相同）。
- 活跃的服务账户必须已分配
externalswap小程序。
注意事项¶
- 所有 BLE 读取、MQTT 报告和费用计算与标准服务员流程完全相同。
- 如果客户的配额覆盖全部费用，在两种流程中付款步骤都会自动跳过。
- 如果手动换电磁贴未出现在您的角色选择界面上，请联系您的管理员。