门店收银 App（Android）· 帮助中心

功能概述

收银 App 是 Web 门店收银的移动端形态，适合餐饮档口、零售柜台使用 Android 平板或手机。

模块	说明
点餐	触屏点选分类与商品、选规格、购物车、提交订单
金额收银	数字键盘输入金额，扫顾客付款码扣款
扫码枪收款	USB OTG 或蓝牙扫码枪（键盘模式）扫 18 位微信付款码
收款记录	查看历史订单与商品明细

工程目录（实施）：core/uniapp-cashier/
后端 API：api/cashier/*（与 Web 共用 CashierPosService、微信付款码服务）

前置条件

与微信付款码收银相同：独立小程序、自有商户号、APIv3 已配置。
商家后台商品库已维护分类、价格、库存、货号（见商品扫码收银）。
店员使用商家子账号（MchAccount）登录 App。
Android 6+ 设备，建议平板横屏使用；收款建议配 USB 扫码枪。

安装与配置

实施人员用 HBuilderX 打开 core/uniapp-cashier，修改 config/index.js 中的 API 地址与默认站点 ID（_acid）。
云打包或本地打包生成 Android APK，安装到门店设备。
首次打开：输入站点 ID、店员账号、密码登录。
若提示「付款码收银尚未配置」，请先在商家 Web 后台完成 APIv3 设置。

日常使用流程

餐饮点餐收款

打开 App → 点餐页点选分类与商品（触屏，无需扫商品码） → 购物车确认 →「提交并收款」 → 扫码枪扫顾客微信付款码 → 支付成功

金额收款

金额页 → 数字键盘输入金额 → 点「收款」 → 扫顾客微信付款码 → 支付成功

扫商品条码加购

餐饮场景不需要扫商品码，直接在 App 上点选菜品即可。零售若需扫商品条码，请使用 Web 门店收银或另配方案。

Android 如何连接扫码枪

App 本身不驱动扫码枪硬件，只要扫码枪工作在键盘模式（HID），Android 就会把它当作外接键盘：

连接方式	说明
USB OTG 有线枪	平板 Type-C + OTG 转接头，插入扫码枪；多数即插即用
蓝牙扫码枪	系统蓝牙配对，模式选 HID/键盘；配对后全局可输入
商米 / 联迪等一体机	内置扫码头，通常也是键盘模式输出到当前输入框

购买时确认：支持 USB HID 键盘模式，不要选「串口/COM 模式」（需专用驱动，本 App 不支持）。
使用时：先让收款页输入框获得焦点，再扫顾客付款码；扫满 18 位自动发起扣款。

扫码原理说明

本 App 只通过扫码枪收微信付款码，商品加购靠触屏点选。

微信付款码（18 位）— 扫码枪

方式	原理	建议
USB / 蓝牙扫码枪	枪内解码付款码 → 通过 USB/蓝牙模拟键盘按键，把 18 位数字输入到 App 收款框 → App 校验格式 → 提交后端 → 微信 V3 扣款。	推荐；Android 与 PC 用法相同，无需 App 集成硬件 SDK
摄像头	本 App 餐饮版不使用摄像头扫付款码。	—

整体数据流（与 Web 相同）

App 界面（扫码 / 点选） ↓ HTTPS 商家服务器 api/cashier/pos/*（建单、算价、扣库存） ↓ 微信支付 V3 付款码接口（仅扫付款码时） ↓ 支付成功 → 写收款记录 → App 展示结果

重要：App 内不保存 APIv3 密钥、不直连微信；密钥只在商家服务器，与 Web 收银一致。

API 接口一览

路由	说明
`api/cashier/login/index`	店员登录
`api/cashier/pos/menu`	分类菜单
`api/cashier/pos/scan-goods`	条码解析商品
`api/cashier/pos/create-order`	创建待支付单
`api/cashier/pos/pay`	付款码扣款
`api/cashier/pos/query`	查单
`api/cashier/pos/orders`	收款记录

公共参数：_acid（站点 ID）、access_token、_mch_id。

常见问题

摄像头打不开或提示无权限？

餐饮版 App 不使用摄像头，可忽略此项。

扫商品提示未找到？

确认商品后台货号/条形码与包装一致，参见商品扫码收银货号配置说明。

扫付款码没反应？

金额页需先输入金额再扫；点餐需先「提交并收款」；须使用完整 18 位付款码；建议使用 USB 扫码枪。

与 Web 收银数据是否互通？

互通。同一商户、同一套订单表与收款记录，Web 与 App 可交替使用。