积分赠送规则
积分赠送规则用来定会员线上充值时额外送多少积分:充哪一档、送多少分、每人限几次、哪些会员类别参与。它与金额赠送规则、电子券赠送规则是同一张方案表的三个入口,界面、字段、状态流转完全一致;本页日常用的是明细里的「积分」列,方案类别下拉中并没有单独的「充值赠送积分」项。
一、功能概述
菜单位置:O2O业务 → 微信公众号 → 积分赠送规则(页面地址 /admin/o2o/wxlargessscorerule/)

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