# 零售门店运营

管理商品、会员、余额充值和收银订单，在经营看板查看销售额、销售成本、付款方式和充值趋势。

可下载测试接入包，包含中文 YAP、记账服务及完整接入说明。请在易企办测试工作区连接并验收收银、充值和异常恢复。

三张预览图使用虚构数据演示单店运营，金额以人民币计。

## 商品、库存与收银

登记商品名称、条码、类别、进货成本、零售单价和库存。开单时选择商品与数量，可关联会员等级与折扣。订单台账汇总应收金额和销售成本，订单明细逐项记录商品与数量。

## 单一付款与组合付款

收银时可记录现金、信用卡、支付宝、Apple Pay、PayPal 或会员余额。组合付款把实收金额分到多条付款记录。每笔都需要有效的付款方式和金额，各项合计应等于订单应收。使用会员余额时只扣除由余额支付的金额。支付渠道字段用于记录收银结果。

## 会员等级与余额充值

维护会员编号、等级、折扣与期初余额。收银员录入实际到账的充值金额和方式，并可按门店规则调整会员等级。充值使用现金、信用卡、支付宝、Apple Pay 或 PayPal。会员详情用于核对余额及关联充值记录。充值列表按营业日期倒序显示，补录时以表单填写的充值日期为准。

## 经营看板

从当日订单查看销售额、成本和订单数，并观察近 30 天销售、付款方式与充值变化。订单、付款和商品明细通过订单编号核对。

## 配置顺序

1. 维护商品条码和会员编号，确保二者分别唯一。录入期初库存、等级折扣和会员期初余额。金额保留两位小数。折扣以原价比例表示，例如 0.95 表示九五折。
2. 用现金全额、会员余额全额、现金与余额组合三种订单核对应收与实收。核对商品库存减量、订单明细、各笔付款记录与余额变化。
3. 用同一会员测试连续充值及充值时调整等级。核对充值合计、期末余额及等级折扣。
4. 根据门店营业时区核对当日订单，并抽样核对近 30 天的销售、成本、付款方式和充值统计。

## 对账示例

组合付款预览中的订单应收 131.10 元，其中现金收 11.10 元，会员余额支付 120.00 元。核对订单台账应有一笔 131.10 元的订单，付款记录应有两笔，两件商品各减一件库存。会员余额从 1,206.15 元变为 1,086.15 元。

若随后充值 20.25 元，再充值 35.50 元，余额应为 1,141.90 元。每笔充值都应登记金额、方式和充值日期。保持原等级时，充值记录应显示原等级名称。调整等级时，核对档案中的等级和折扣，以及充值记录中的新等级名称。

测试时用「零售收银」登记订单，用会员详情的「会员充值」录入充值。为收银员配置这两个入口的使用权限，订单台账的直接维护权限按门店职责单独配置。

## 验收自动记账

原版在提交后自动执行收银或充值流程。在测试工作区，分别核对这些结果：

| 场景 | 应观察到的结果 |
| --- | --- |
| 组合付款金额正确，其中一笔付款方式为空或不在选项中 | 停止登记。订单、付款、库存和会员余额都保持原值。 |
| 组合付款的每笔金额和方式都正确 | 订单台账显示「组合付款」，付款明细分别保留各笔实际方式和金额。 |
| 充值方式为空、超出选项，或使用会员余额给同一档案充值 | 停止登记。余额、会员等级和充值台账保持原值。 |
| 使用有效方式充值 | 会员余额按实收金额增加，充值台账记录相同的方式、金额和日期。 |

新记账服务用记录版本协调库存与会员余额的更新，并按原流水编号记录步骤。本地模拟验证了两笔订单争抢最后一件库存、重复充值、扣减后断线和付款记录写入后断线。

「今日订单」按营业日期匹配。「近 30 天订单」以及看板中的同期指标按含今天的 30 个自然日计算。本地已核对当天、窗口起始日及未来日期的筛选边界。目标租户需核对营业时区和实际显示。

## 并发与重试验收

服务会先合计同一订单中重复商品的数量，并按当前库存、价格和会员折扣计算实收。记账过程使用专用控制记录协调每笔收银和充值，库存与余额写入均校验 `RowVersion`。

断线或结果不明时，以原流水编号核对订单、付款、库存和会员余额。服务会对照记录核对已经完成的步骤，再恢复未完成的步骤。新增结果未知时，由管理员确认原请求的结果后再继续。测试接入包内附字段映射和恢复说明。

在目标工作区分别验证两笔订单争抢最后一件商品、两次提交同一订单、连续充值及记账中途断线。易企办实际导入、HTTP 请求映射和接口权限需在该工作区验证。

[查看带记录版本的库存扣减接口示例](/developers/api/examples#versioned-stock-update)

[Yeeflow 原站模板](https://www.yeeflow.com/templates/apps/retail-management)