金额赠送规则
金额赠送规则用来定会员线上充值时额外送多少储值金额:充哪一档、送多少、每人限几次、哪些会员类别与分店参与、活动从哪天到哪天。它与积分赠送规则、电子券赠送规则是同一张方案表的三个入口,界面与字段完全一致,区别只在菜单名与明细里填哪一组列——本页日常用的是「赠送金额」列。
一、功能概述
菜单位置:O2O业务 → 微信公众号 → 金额赠送规则(页面地址 /admin/o2o/wxlargessmoneyrule/)

同一页面在 O2O业务 → 微信会员 → 金额赠送规则 还有一个入口。三个赠送规则入口与微信会员侧的对应入口都读写 WX_VipLargessSub,在任一入口建的方案,其它入口的列表里同样看得到,列表不按入口过滤。
| 用途 | 说明 |
|---|---|
| 定赠送方案 | 方案名称、方案类别、参与会员类别、起止日期、每人最大赠送次数 |
| 定档位赠送 | 「方案明细」页签逐行维护「充值/等价金额 → 赠送金额」,可标记首次充值 |
| 定参与范围 | 「参与分店」页签挑分店;不配即不限分店 |
| 控状态 | 草稿 → 生效 → 取消生效(回草稿)/ 停用;删除为逻辑删除 |
| 查有效方案 | 「查看有效方案」只读表格,按微信会员卡类别展开当前生效且未过期的方案 |
档位金额来自线上充值金额设置。两边没有外键关联,靠数值对齐,明细里的「充值/等价金额」要与面额完全一致才命中。
二、界面布局说明
列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、打印(选中行后另出现导出选中);删除走方案状态,不出现「回收站」 |
| 搜索框 | 提示文字「搜索...」,按方案编号、方案名称、在线充值说明模糊搜 |
| 表格 | 列依次为方案编号、方案名称(超链,点开编辑)、方案类别、开始日期、结束日期、方案状态、每人最大赠送次数、在线充值说明 |
| 排序 | 按方案ID 倒序,新建的方案排在最前 |
| 过滤 | 状态为「删除」(-1)的方案不在列表里 |
| 分页 | 底部「共 N 条」「共 N 页」,每页 10 / 20 / 30 / 50 / 100 / 200 条 |
编辑窗口
表单字段集中在一个区块里,日常要填的三组内容如下(界面不按这些名字分区,此处按用途归类):
| 分组 | 字段 |
|---|---|
| 方案信息 | 方案编号(提示「留空保存后按方案ID自动补号」)、方案名称(必填)、方案类别、参与会员类别(提示「会员类别 id 串(多值),界面原为选择器弹窗」)、方案状态、优先级别 |
| 有效期与条件 | 制定日期、开始日期、结束日期、启用星期条件(开关)、附加时间条件(提示「位掩码:星期一~日 + 单/双号」)、启用日期条件(开关)、附加日期条件、每人最大赠送次数 |
| 赠送内容 | 电子券有效天数、电子券开始有效日期、金额(两位小数)、积分(两位小数)、在线充值说明(多行文本,必填,提示「此信息显示在线充值界面上」) |
模型里其余列(是否生效、会员类别、开始时间、结束时间、提交日期、按月赠送月数、周期赠送方式、周期次数、首期金额、每期金额、周期赠送内容、周期天数)按字段中文名自动补入表单,为普通输入框;方案ID 只读。这些列在客户端由专门的页签或弹窗维护,网页版未给出取值口径,日常配置可留空。
表单下方另有三个区块:
| 区块 | 内容 |
|---|---|
| 明细 | 两个页签按钮「方案明细」「参与分店」,工具栏「添加行」「保存」,行尾「删除」;空表显示「暂无明细」,保存成功弹「保存成功」 |
| 查看有效方案 | 只读表格,提示「生效且未过期的方案,按微信会员卡类别展开」,无数据时显示「暂无有效方案」 |
表单工具栏左侧为返回、编辑、保存(下拉含「保存并继续编辑」「保存并新增下一个」「保存并返回列表」)、取消、刷新、上一行、下一行;右侧为历史版本、附件、删除。
三、业务操作步骤
步骤 1:新建方案(草稿)
- 点「新增」,填「方案名称」(必填);「方案编号」可留空,保存后自动补成
No+ 8 位方案ID; - 「方案类别」选「充值赠送金额」(只送储值)或「充值赠送礼券&金额」(券与金额一起送);
- 「参与会员类别」填会员类别 id 串,多个用英文逗号分隔;填
0表示不限类别; - 填开始日期、结束日期、每人最大赠送次数;
- 「在线充值说明」必填,这段文字会显示在在线充值界面上给顾客看;
- 「方案状态」保持「草稿」,点「保存」。
新增时状态默认草稿、制定日期默认当天。必填项缺失时按原文提示处理:方案名称不能为空!、在线充值说明不能为空!(方案类别为「生日管家礼券」「小程序礼券」时说明可空)。
步骤 2:维护方案明细
- 先保存主记录。未保存时切到明细页签会提示
请先保存修改内容,再修改方案明细。; - 在「明细」区块点「方案明细」页签,点「添加行」;
- 逐行填:「充值/等价金额」填线上充值金额设置里的面额数值,「赠送金额」填该档额外送的储值金额,「名称」写档位说明,只送首充的行把「首次充值」置为是;
- 点页签工具栏的「保存」,弹「保存成功」即写入。
明细为整表覆盖保存:每次保存按当前表格内容重写该方案的全部明细行,行号自动补。删行用行尾「删除」,删完同样要点「保存」才落库。
网页版明细页签列出 8 列(行号、名称、电子券、数量、充值/等价金额、赠送金额、积分、首次充值)。表里另有「赠送2~赠送5」的电子券与张数列、会员礼包列,网页版未暴露,一次只能维护第一组券;客户端新增方案时会按面额档位自动生成明细行,网页版需手工添加。
步骤 3:限定参与分店(可选)
- 切到「参与分店」页签(未保存主记录时提示
请先保存修改内容,再修改参与分店。); - 点「添加行」,在「分店编号」下拉里选分店,候选为未删除且尚未加入本方案的分店,显示为「编号 名称」;「编号」「名称」两列选中后只读带出;
- 点「保存」。
校验原文:未选分店提示 请选择参与分店,同一分店重复添加提示 不允许重复添加同一分店。不配任何分店即不限分店(客户端口径:该页签主要供第三方小程序场景使用)。
步骤 4:生效方案
把「方案状态」改为「生效」并保存。生效后方案进入只读保护:
| 当前状态 | 允许改成 | 其它字段 |
|---|---|---|
| 草稿(0) | 生效(1)、删除(-1) | 可自由编辑 |
| 生效(1) | 草稿(0,即取消生效)、停用(10) | 只读,改其它字段会被拦下 |
| 停用(10) | 不可再变更 | 只读 |
| 删除(-1) | 仅允许改状态 | 只读 |
在生效状态下直接改明细或表头字段再保存,会提示 只读状态不能修改,请检查方案状态;状态不变直接点保存同样会被拦下。要改内容,先把状态改回「草稿」保存,再编辑,改完重新生效。
步骤 5:核对有效方案
在编辑窗口下方的「查看有效方案」表格里核对当前真正生效的方案。该表格与当前打开的方案无关,列的是全账套范围内生效且未过期的方案,按微信会员卡类别展开,列为:会员卡类别、方案编号、方案名称、开始日期、结束日期、方案状态。
取数口径:会员卡类别需为微信会员卡且卡类别与卡系列均未打删除标志;方案类别在 1、2、3、4、5、8、9、10 之内;方案状态为生效;结束日期不早于今天;参与会员类别命中该卡类别或为 0(不限)。
步骤 6:停用或删除
- 活动结束不再赠送:状态改「停用」。停用后不可再变更,需要重新启用时另建方案。
- 作废方案:点表单工具栏「删除」,方案状态被置为「删除」(-1),列表不再显示,属逻辑删除,数据仍在库里。
四、字段详细说明
1)方案主表字段
| 界面字段 | 落库字段 | 含义与取值 |
|---|---|---|
| 方案ID | WX_VipLargessSub.fCaseID | 主键,系统取号,只读 |
| 方案编号 | fCaseNo | 最长 30 字符;留空保存后自动补 No + 8 位方案ID |
| 方案名称 | fCaseName | 必填,最长 30 字符 |
| 方案类别 | fCaseType | 见下方枚举 |
| 参与会员类别 | fVipTypeIDList | 会员类别 id 串,多值逗号分隔,最长 2000 字符;0 表示不限 |
| 方案状态 | fCaseState | 见下方枚举 |
| 优先级别 | fLevel | 多方案命中时的优先级数值;比较方向以实际版本为准,配置前与实施人员确认 |
| 制定日期 | fBillDay | 新增默认当天 |
| 开始日期 / 结束日期 | fBegDate / fEndDate | 活动起止日期 |
| 启用星期条件 | fIsUseEffectTimeEx | 开关;开启后必须填附加时间条件 |
| 附加时间条件 | fEffectTimeEx | 位掩码:星期一~日 + 单号/双号日期;网页版只录数值,无日历点选 |
| 启用日期条件 | fIsUseEffectDateEx | 开关;客户端对应 1~31 号方格选择 |
| 附加日期条件 | fEffectDateEx | 日期条件数值,网页版只录数值 |
| 每人最大赠送次数 | fMaxCount | 每人最多享受几次 |
| 电子券有效天数 | fEffectiveDays | 送出的券可用多少天 |
| 电子券开始有效日期 | fEffectiveBegDate | 送出的券从哪天起可用 |
| 金额 | fMoney | 方案级金额数值,两位小数 |
| 积分 | fScore | 方案级积分数值,两位小数 |
| 在线充值说明 | fRemark | 必填(类别 10、11 可空),最长 500 字符,显示在在线充值界面上 |
2)方案类别枚举
| 取值 | 界面文案 |
|---|---|
| 1 | 充值赠送金额 |
| 2 | 充值赠送礼券&金额 |
| 3 | 开卡赠送礼券&金额 |
| 4 | 在线购物赠送礼券 |
| 5 | 生日赠送礼券&金额 |
| 10 | 生日管家礼券 |
| 11 | 小程序礼券 |
| 100 | 会员礼包 |
| 101 | 会员画像 |
日常充值送储值用类别 1,券与金额一起送用类别 2。类别 10、11 的显示文案以实际版本为准;客户端下拉里另有「6.每月赠送礼券」等文案,网页版未列出;类别 8、9 不在下拉里,但仍在「查看有效方案」的取数范围内,且类别 9 保留了一条校验(见下)。
3)方案状态枚举
| 取值 | 界面文案 | 说明 |
|---|---|---|
| -1 | 删除 | 逻辑删除,列表不显示 |
| 0 | 草稿 | 可编辑,新增默认值 |
| 1 | 生效 | 只读保护,仅可改状态 |
| 10 | 停用 | 不可再变更 |
4)方案明细列(WX_VipLargessSubDetail)
| 界面列 | 落库列 | 含义 |
|---|---|---|
| 行号 | flineIndex | 保存时自动补 |
| 名称 | fTitle | 档位说明,最长 30 字符 |
| 电子券 | fTypeID | 券类型 id(模型中文名「赠送1|电子券」) |
| 数量 | fNum | 该券送几张(模型中文名「赠送1|张数」) |
| 充值/等价金额 | fAddMoney | 命中门槛金额,需与充值面额一致(模型中文名「消费金额」) |
| 赠送金额 | fLargessMoney | 该档额外送的储值金额 |
| 积分 | fScore | 该档额外送的积分 |
| 首次充值 | fIsFirstFillMoney | 标记只送首充(模型中文名「是否首充」);客户端口径为勾上后充过对应金额的会员不再享受该档 |
表里另有赠送2~赠送5 的电子券与张数(fTypeID1~fTypeID4 / fNum1~fNum4)、会员礼包(fGiftPackCaseId)、参与会员类别(fVipTypeIDList)、会员类别(fVipTypeID)列,网页版明细页签未列出这些列。
5)参与分店列(WX_VipLargessSub_shop)
| 界面列 | 落库列 | 含义 |
|---|---|---|
| 分店编号 | fFilialeId | 下拉选择,候选来自分店档案中未删除且未加入本方案的分店 |
| 编号 / 名称 | Pos_Filiale.fFilialeNo / fFilialeName | 只读带出,不落本表 |
6)校验提示原文
| 报错原文 | 触发条件 |
|---|---|
| 方案名称不能为空! | 方案名称留空 |
| 在线充值说明不能为空! | 说明留空且方案类别不是 10、11 |
| 只读状态不能修改,请检查方案状态 | 非草稿状态下改了状态以外的字段,或状态流转不合法 |
| 当方案类别为会员画像送礼券时,参与会员类别也只能为会员画像! | 方案类别为 9 且参与类别里含非「会员画像」的卡类别 |
| 必须是星期和日期都满足已选项目时方案才有效! | 开了「启用星期条件」但附加时间条件为空 |
| 请选择参与分店 / 不允许重复添加同一分店 | 参与分店页签未选分店或重复添加 |
五、典型使用场景
场景一:店庆充值送储值。 先在线上充值金额设置确认档位,再新建方案:类别选「充值赠送金额」,参与会员类别填 0 不限,起止日期给店庆当天,每人最大赠送次数填 1,在线充值说明写「店庆当天充值加送储值」。明细逐档填「充值/等价金额」与「赠送金额」,保存后把状态改「生效」。
场景二:只送首次充值。 明细里把目标档位的「首次充值」置为是,老会员充过该档就不再享受;配合「每人最大赠送次数」控制总次数。
场景三:限定几家门店参与。 在「参与分店」页签逐行添加参与门店并保存;不添加即不限分店。活动结束把状态改「停用」,注意停用后不可再变更。
场景四:排查顾客没收到赠送。 依次核对:充值金额是否与明细「充值/等价金额」完全一致、当天是否在起止日期内、是否开了星期/日期条件而当天不满足、每人最大赠送次数是否用完、该档是否只送首充、参与会员类别与参与分店是否命中。也可以在「查看有效方案」里确认方案当前确实生效且未过期。
六、权限控制与前置条件
- 本页为网页端新迁移的编码窗体,权限映射里标注为「客户端无对应菜单 / Django 新增,始终放行」,可见性跟随 O2O业务 分组;看不到入口时联系深圳市安仕达管理软件有限公司确认账套开通范围。
- 前置条件:线上充值面额档位已维护、微信会员线上充值渠道已开通。
- 参与会员类别要能命中,对应卡系列需勾上微信卡券相关开关;「查看有效方案」只展开微信会员卡类别。
- 网页版未提供星期/日期条件的日历点选,两个附加条件列只录数值;需要按星期或按日期精细限制时,与实施人员确认位掩码取值后再填。
- 方案生效后对顾客立即可见(在线充值说明会展示在充值界面),发布前核对金额与文案。
七、常见问题
问:在金额赠送规则里建的方案,积分赠送规则里也能看到? 答:能。三个入口是同一张表的三个代理入口,界面与数据完全一致,列表不按入口区分。靠「方案类别」与明细里填哪组列来区分送什么。
问:生效后改不了明细? 答:生效状态只允许改状态。先把方案状态改回「草稿」保存,再改明细,改完重新生效;直接改会提示「只读状态不能修改,请检查方案状态」。
问:停用后还能重新生效吗? 答:不能。停用(10)后不可再变更状态。需要继续活动请另建方案。
问:明细里想一次送五种券? 答:网页版明细页签只暴露第一组「电子券 / 数量」,赠送2~5 列未提供。需要多组券时按客户端口径处理或拆成多个方案。
问:「充值/等价金额」要不要手工填? 答:要。客户端新增方案时按面额档位自动生成明细行,网页版没有该动作,需点「添加行」逐档录入,金额与线上充值金额设置的面额保持一致。
问:方案编号留空了,保存后变成 No00000123 是什么? 答:这是自动补号规则——No + 8 位方案ID。需要自定义编号时在保存前填写。
问:「查看有效方案」里为什么没有我刚建的方案? 答:该表格只列生效且结束日期不早于今天、方案类别在取数范围内、参与会员类别命中的方案。草稿、停用、已过期或类别不在范围内的方案都不会出现。
问:删除方案后数据还在吗? 答:在。删除是把方案状态置为「删除」(-1)的逻辑删除,列表不再显示,明细与参与分店数据仍留在库里。
