红包投放规则
红包投放规则用来定小程序商城发红包的口径:这一轮红包总共多少钱、单个红包最多多少、最少几个人领、什么时间段投放。规则生效后由商城侧按它发放红包,本页同时把该方案已发放的红包和每一笔领取明细只读列出来,方便核对营销花费。
一、功能概述
菜单位置:O2O业务 → 商城活动 → 红包投放规则(页面地址 /admin/o2o/wxredpacketrule/)

| 用途 | 说明 |
|---|---|
| 定投放口径 | 红包总金额、单个红包上限、最少领取人数 |
| 定投放期 | 开始时间 / 结束时间 |
| 控状态 | 未生效 / 生效 / 删除三态流转 |
| 看已发放红包 | 编辑窗口下方只读列出该方案发出的红包及领取进度 |
| 看领取明细 | 双击红包行弹出明细,逐笔看谁领了多少 |
本页只定规则、看结果,不在这里手动发红包。 红包的实际发放由商城侧按生效规则触发。
二、界面布局说明
列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、打印 |
| 搜索框 | 按方案名称、备注模糊搜 |
| 列表 | 方案ID、方案名称(超链)、开始时间、结束时间、红包总金额、单个红包上限、最少领取人数、状态 |
| 排序 | 默认按方案ID倒序 |
编辑窗口
点「新增」或点方案名称打开编辑窗口,表单分组标题为「红包方案」:
| 字段 | 说明 |
|---|---|
| 方案名称 | 必填 |
| 开始时间 / 结束时间 | 日期时间选择器,生效时必填 |
| 红包总金额 | 金额,两位小数 |
| 单个红包上限 | 金额,两位小数 |
| 最少领取人数 | 数值 |
| 状态 | 下拉,必填;提示「生效 / 未生效 / 删除(删除=逻辑删除,不物理删行)」 |
| 备注 | 多行文本 |
已发放红包(只读)
编辑窗口下方只读表格「已发放红包」,提示「双击红包行查看领取明细」,无数据时显示「该方案暂无已发放红包」。列:
红包编号、创建时间、文字、创建人编号、创建人、红包类型、总金额、最终营销金额、已领红包金额、余额、参与人数、已领红包数量、剩余红包个数、状态、领完时间、超时未领完关闭时间、是否最终状态。
双击某行弹出「红包明细」,列:红包编号、明细编号、状态、金额、会员卡号、持卡人、领取时间、超时未领退回时间;无数据时显示「暂无领取明细」。
三、业务操作步骤
步骤 1:建规则
点「新增」,填方案名称,选开始/结束时间,填红包总金额、单个红包上限、最少领取人数,状态先留「未生效」,保存。
步骤 2:生效
把「状态」改为「生效」并保存。生效时后端逐项校验:
| 报错原文 | 原因 |
|---|---|
| 开始日期不能为空 | 没填开始时间 |
| 结束日期不能为空 | 没填结束时间 |
| 结束日期不能小于开始日期 | 时间倒挂 |
| 【红包总金额】不能为空 / 【红包总金额】必须大于0 | 总金额没填或 ≤0 |
| 【单个红包上限】不能为空 / 【单个红包上限】必须大于0 | 单个上限没填或 ≤0 |
| 【最少领取人数】不能为空 / 【最少领取人数】必须大于0 | 人数没填或 ≤0 |
| 方案状态不允许从当前状态变更! | 状态流转不合法 |
步骤 3:核对发放与领取
规则生效、商城侧发出红包后,回到该方案编辑窗口,在「已发放红包」里看每个红包的总金额、已领金额、余额与剩余个数;双击红包行看逐笔领取明细,确认哪些会员领了、有没有超时退回。
步骤 4:调整或收尾
要改口径,先把状态改回「未生效」(取消生效)再编辑;活动结束不再投放,把状态改为「删除」(逻辑删除)。已发放红包与领取明细是历史运行数据,不随规则状态变化而清除。
四、字段详细说明
1)规则主表字段
| 界面字段 | 落库字段 | 含义 |
|---|---|---|
| 方案ID | fCaseId | 规则主键 |
| 方案名称 | fCaseName | 规则名 |
| 开始时间 / 结束时间 | fStartTime / fEndTime | 投放时间窗 |
| 红包总金额 | fMaxMoney | 本轮红包总预算 |
| 单个红包上限 | fMaxMoneyOfPacket | 单个红包金额上限 |
| 最少领取人数 | fMinPersionCountOfPacket | 成包所需最少领取人数 |
| 状态 | fState | 1 生效 / 0 未生效 / -1 删除 |
| 备注 | fRemark | 说明文字 |
状态流转:未生效 → 生效 / 删除;生效 → 未生效(取消生效)/ 删除;删除 → 未生效(取消生效)。
2)已发放红包枚举
| 列 | 取值 |
|---|---|
| 红包类型 | 普通红包(均分) / 拼手气红包(随机) |
| 状态 | 生效 / 领出金额 / 已领完 / 超时未领完关闭 |
「余额」「剩余红包个数」按总金额减已领、参与人数减已领数量算出;红包状态为「超时未领完关闭」时,余额与剩余个数按 0 计。
3)领取明细枚举
| 状态 | 含义 |
|---|---|
| 未领取 | 份额尚未被领 |
| 已领 | 会员已领取 |
| 已领未充值 | 已领但金额尚未充值到账 |
| 超时未领退回 | 超时未领,金额退回 |
五、典型使用场景
场景一:节日拼手气红包。 红包总金额设一笔预算,单个红包上限封顶,最少领取人数设一个成包门槛,时间窗给节日当天。会员在商城领拼手气红包,金额随机。
场景二:核对营销花费。 活动结束后打开该方案,在「已发放红包」按「最终营销金额」「已领红包金额」核对实际花出去多少,双击红包行抽查领取明细。
场景三:排查没到账。 会员反映领了红包没到账,双击对应红包行,看明细状态是否为「已领未充值」或「超时未领退回」,据此判断是充值延迟还是超时退回。
六、权限控制与前置条件
- 本页为网页端新迁移的编码窗体,无独立 ERP 菜单权限映射项,可见性跟随 O2O业务 分组;菜单按账套已开通的模块范围显示,看不到菜单时请联系深圳市安仕达管理软件有限公司确认开通范围。
- 前置条件:商城开通与同步条件满足(见开通与同步链路),红包发放由商城侧按生效规则执行。
- 「已发放红包」「红包明细」均为只读,本页不提供手动发放、作废或补领操作。
七、常见问题
问:能在这里直接给某个会员发红包吗? 答:不能。本页只定投放规则并查看发放结果,实际发放由商城侧按生效规则触发。
问:「余额」和「剩余红包个数」怎么算的? 答:余额 = 总金额 − 已领红包金额;剩余个数 = 参与人数 − 已领红包数量。红包被「超时未领完关闭」后,这两项按 0 显示。
问:规则删除后,已发放的红包记录还在吗? 答:在。删除是逻辑删除,只影响规则本身;已发放红包与领取明细是历史运行数据,仍可查看。
问:生效时提示金额必须大于0? 答:红包总金额、单个红包上限、最少领取人数三项在生效时都必填且要大于 0,逐项补齐后再保存生效。
