Skip to content

红包投放规则 ​

红包投放规则用来定小程序商城发红包的口径:这一轮红包总共多少钱、单个红包最多多少、最少几个人领、什么时间段投放。规则生效后由商城侧按它发放红包,本页同时把该方案已发放的红包和每一笔领取明细只读列出来,方便核对营销花费。

一、功能概述 ​

菜单位置:O2O业务 → 商城活动 → 红包投放规则(页面地址 /admin/o2o/wxredpacketrule/)

红包投放规则列表:表格列为方案ID、方案名称、开始时间、结束时间、红包总金额、单个红包上限、最少领取人数、状态

用途说明
定投放口径红包总金额、单个红包上限、最少领取人数
定投放期开始时间 / 结束时间
控状态未生效 / 生效 / 删除三态流转
看已发放红包编辑窗口下方只读列出该方案发出的红包及领取进度
看领取明细双击红包行弹出明细,逐笔看谁领了多少

本页只定规则、看结果,不在这里手动发红包。 红包的实际发放由商城侧按生效规则触发。

二、界面布局说明 ​

列表页 ​

区域内容
工具栏新增、导出、打印
搜索框按方案名称、备注模糊搜
列表方案ID、方案名称(超链)、开始时间、结束时间、红包总金额、单个红包上限、最少领取人数、状态
排序默认按方案ID倒序

编辑窗口 ​

点「新增」或点方案名称打开编辑窗口,表单分组标题为「红包方案」:

字段说明
方案名称必填
开始时间 / 结束时间日期时间选择器,生效时必填
红包总金额金额,两位小数
单个红包上限金额,两位小数
最少领取人数数值
状态下拉,必填;提示「生效 / 未生效 / 删除(删除=逻辑删除,不物理删行)」
备注多行文本

已发放红包(只读) ​

编辑窗口下方只读表格「已发放红包」,提示「双击红包行查看领取明细」,无数据时显示「该方案暂无已发放红包」。列:

红包编号、创建时间、文字、创建人编号、创建人、红包类型、总金额、最终营销金额、已领红包金额、余额、参与人数、已领红包数量、剩余红包个数、状态、领完时间、超时未领完关闭时间、是否最终状态。

双击某行弹出「红包明细」,列:红包编号、明细编号、状态、金额、会员卡号、持卡人、领取时间、超时未领退回时间;无数据时显示「暂无领取明细」。

三、业务操作步骤 ​

步骤 1:建规则 ​

点「新增」,填方案名称,选开始/结束时间,填红包总金额、单个红包上限、最少领取人数,状态先留「未生效」,保存。

步骤 2:生效 ​

把「状态」改为「生效」并保存。生效时后端逐项校验:

报错原文原因
开始日期不能为空没填开始时间
结束日期不能为空没填结束时间
结束日期不能小于开始日期时间倒挂
【红包总金额】不能为空 / 【红包总金额】必须大于0总金额没填或 ≤0
【单个红包上限】不能为空 / 【单个红包上限】必须大于0单个上限没填或 ≤0
【最少领取人数】不能为空 / 【最少领取人数】必须大于0人数没填或 ≤0
方案状态不允许从当前状态变更!状态流转不合法

步骤 3:核对发放与领取 ​

规则生效、商城侧发出红包后,回到该方案编辑窗口,在「已发放红包」里看每个红包的总金额、已领金额、余额与剩余个数;双击红包行看逐笔领取明细,确认哪些会员领了、有没有超时退回。

步骤 4:调整或收尾 ​

要改口径,先把状态改回「未生效」(取消生效)再编辑;活动结束不再投放,把状态改为「删除」(逻辑删除)。已发放红包与领取明细是历史运行数据,不随规则状态变化而清除。

四、字段详细说明 ​

1)规则主表字段 ​

界面字段落库字段含义
方案IDfCaseId规则主键
方案名称fCaseName规则名
开始时间 / 结束时间fStartTime / fEndTime投放时间窗
红包总金额fMaxMoney本轮红包总预算
单个红包上限fMaxMoneyOfPacket单个红包金额上限
最少领取人数fMinPersionCountOfPacket成包所需最少领取人数
状态fState1 生效 / 0 未生效 / -1 删除
备注fRemark说明文字

状态流转:未生效 → 生效 / 删除;生效 → 未生效(取消生效)/ 删除;删除 → 未生效(取消生效)。

2)已发放红包枚举 ​

列取值
红包类型普通红包(均分) / 拼手气红包(随机)
状态生效 / 领出金额 / 已领完 / 超时未领完关闭

「余额」「剩余红包个数」按总金额减已领、参与人数减已领数量算出;红包状态为「超时未领完关闭」时,余额与剩余个数按 0 计。

3)领取明细枚举 ​

状态含义
未领取份额尚未被领
已领会员已领取
已领未充值已领但金额尚未充值到账
超时未领退回超时未领,金额退回

五、典型使用场景 ​

场景一:节日拼手气红包。 红包总金额设一笔预算,单个红包上限封顶,最少领取人数设一个成包门槛,时间窗给节日当天。会员在商城领拼手气红包,金额随机。

场景二:核对营销花费。 活动结束后打开该方案,在「已发放红包」按「最终营销金额」「已领红包金额」核对实际花出去多少,双击红包行抽查领取明细。

场景三:排查没到账。 会员反映领了红包没到账,双击对应红包行,看明细状态是否为「已领未充值」或「超时未领退回」,据此判断是充值延迟还是超时退回。

六、权限控制与前置条件 ​

  • 本页为网页端新迁移的编码窗体,无独立 ERP 菜单权限映射项,可见性跟随 O2O业务 分组;菜单按账套已开通的模块范围显示,看不到菜单时请联系深圳市安仕达管理软件有限公司确认开通范围。
  • 前置条件:商城开通与同步条件满足(见开通与同步链路),红包发放由商城侧按生效规则执行。
  • 「已发放红包」「红包明细」均为只读,本页不提供手动发放、作废或补领操作。

七、常见问题 ​

问:能在这里直接给某个会员发红包吗? 答:不能。本页只定投放规则并查看发放结果,实际发放由商城侧按生效规则触发。

问:「余额」和「剩余红包个数」怎么算的? 答:余额 = 总金额 − 已领红包金额;剩余个数 = 参与人数 − 已领红包数量。红包被「超时未领完关闭」后,这两项按 0 显示。

问:规则删除后,已发放的红包记录还在吗? 答:在。删除是逻辑删除,只影响规则本身;已发放红包与领取明细是历史运行数据,仍可查看。

问:生效时提示金额必须大于0? 答:红包总金额、单个红包上限、最少领取人数三项在生效时都必填且要大于 0,逐项补齐后再保存生效。