积分商城规则
积分商城规则配置会员在小程序里用积分换什么:一个方案定起止日期、参与会员类别、每人限几次,明细里逐行挂电子券与数量,顾客看到的说明文字也在这里写。它与充值赠送规则家族共用同一张方案表和同一套界面,差别是本页列表只取积分类的方案,并同样走草稿 → 生效 → 停用的状态流转与只读保护。
一、功能概述
菜单位置:O2O业务 → 微信商城 → 积分商城规则(页面地址 /admin/o2o/wxsubaward/)

| 用途 | 说明 |
|---|---|
| 定兑换方案 | 方案名称、方案类别、参与会员类别、起止日期、每人最大赠送次数 |
| 配兑换内容 | 「方案明细」页签逐行填电子券、数量、名称等 |
| 限参与分店 | 「参与分店」页签挑分店,不配即不限分店 |
| 控状态 | 草稿 → 生效 → 取消生效(回草稿)/ 停用;删除为逻辑删除 |
| 写顾客说明 | 「在线充值说明」必填,这段文字显示在线上界面上 |
本页与积分赠送规则、金额赠送规则、电子券赠送规则 读写同一张方案表 WX_VipLargessSub,但列表按方案类别过滤:本页只列类别 6、7 的方案。类别 6 是积分兑换礼券(新增时的默认值),类别 7 是按中奖率配置的抽奖类方案(明细里有一条不能删改的系统默认行),两类在界面上的文案以实际版本为准。
二、界面布局说明
列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、打印;不出现「回收站」 |
| 表格 | 方案编号、方案名称(超链)、方案类别、开始日期、结束日期、方案状态、每人最大赠送次数、在线充值说明 |
| 搜索 | 按方案编号、方案名称、在线充值说明模糊搜 |
| 排序与过滤 | 按方案ID 倒序;状态为「删除」(-1)的方案不显示,方案类别只取 6、7 |
| 分页 | 「共 N 条」「共 N 页」,每页 10 / 20 / 30 / 50 / 100 / 200 条 |
编辑页
表单字段按用途分三组:
| 分组 | 字段 |
|---|---|
| 方案信息 | 方案编号(留空保存后自动补号)、方案名称(必填)、方案类别、参与会员类别(会员类别 id 串,多值)、方案状态、优先级别 |
| 有效期与条件 | 制定日期、开始日期、结束日期、启用星期条件、附加时间条件(位掩码:星期一~日 + 单/双号)、启用日期条件、附加日期条件、每人最大赠送次数 |
| 赠送内容 | 电子券有效天数、电子券开始有效日期、金额(两位小数)、积分(两位小数)、在线充值说明(多行文本,必填) |
表单下方两个区块:
| 区块 | 内容 |
|---|---|
| 明细 | 页签「方案明细」「参与分店」,工具栏「添加行」「保存」,行尾「删除」,空表「暂无明细」,保存成功弹「保存成功」 |
| 查看有效方案 | 只读表格,提示「生效且未过期的方案,按微信会员卡类别展开」,无数据时「暂无有效方案」 |
「方案明细」页签共 8 列:行号、名称、电子券、数量、充值/等价金额、赠送金额、积分、首次充值。「查看有效方案」沿用赠送规则家族的取数口径(按微信会员卡类别展开生效且未过期的赠送类方案),积分兑换方案是否列入其中,以实际版本为准。
三、业务操作步骤
步骤 1:新建兑换方案
- 点「新增」,填方案名称(必填);方案编号可留空,保存后系统补
No+ 8 位方案ID。 - 方案类别保持积分兑换礼券(新增默认
6);要做按中奖率配置的抽奖类玩法才选7。 - 参与会员类别填会员类别 id 串(逗号分隔),
0表示不限,新增时默认就是0。 - 填开始日期、结束日期与每人最大赠送次数,需要限次就填明确数字。
- 在线充值说明必填,写清兑换口径与注意事项,这段文字顾客在线上界面看得到。
- 状态保持「草稿」,点「保存」。新增默认状态为草稿、制定日期为当天。
必填校验原文:「方案名称不能为空!」、「在线充值说明不能为空!」。
步骤 2:逐行配兑换内容
- 先保存主记录,否则切页签提示「请先保存修改内容,再修改方案明细。」。
- 在「明细」区块点「方案明细」页签 →「添加行」。
- 填电子券(券类型,档案见电子券类型)、数量与名称(这一档的说明文字),点「保存」,弹「保存成功」即写入。
两种类别的明细口径不同:
| 方案类别 | 明细怎么填 | 校验原文 |
|---|---|---|
| 6 积分兑换礼券 | 一行一种电子券 + 数量,同一方案内券类型不可重复 | 「请输入电子券!」、「电子券不允许重复!」 |
| 7 抽奖类方案 | 数量必填,中奖率填在「充值/等价金额」列,取 0~100 的整数 | 「请输入数量!」、「请输入0~100之间的整数!」、「中奖率数值错误!」 |
类别 7 另有一条系统默认行(行号 10000,即「谢谢参与」一类的兜底项):
- 删掉它提示「系统数据不允许删除!」,改它的电子券提示「系统数据不允许修改!」。
- 手工行的中奖率合计超过 100 提示「中奖率数值错误!」;保存时系统默认行的中奖率自动补为
100 - 其余行合计。 - 把方案改成「生效」时还会校验合计,不等于 100 提示「中奖率总计应为100!」。
明细整表覆盖保存,行号按当前表格顺序自动补;删行用行尾「删除」后同样要点「保存」。
步骤 3:限定参与范围(可选)
- 会员类别:在「参与会员类别」里填 id 串控制哪些卡类别参与,
0为不限。 - 分店:切到「参与分店」页签(未保存主记录时提示「请先保存修改内容,再修改参与分店。」),点「添加行」,在「分店编号」下拉里选分店——候选为未删除且尚未加入本方案的分店,显示「编号 名称」,选完点「保存」。未选分店提示「请选择参与分店」,重复添加提示「不允许重复添加同一分店」;不配即不限分店。
步骤 4:生效与核对
把「方案状态」改「生效」并保存。状态流转与只读保护:
| 当前状态 | 允许改成 | 其它字段 |
|---|---|---|
| 草稿(0) | 生效(1)、删除(-1) | 可编辑 |
| 生效(1) | 草稿(0)、停用(10) | 只读 |
| 停用(10) | 不可再变更 | 只读 |
| 删除(-1) | 仅允许改状态 | 只读 |
非草稿状态下改其它字段、或状态不变直接保存,提示「只读状态不能修改,请检查方案状态」。开了「启用星期条件」却没填附加时间条件,保存时提示「必须是星期和日期都满足已选项目时方案才有效!」。生效后核对起止日期、参与会员类别、每人次数与明细券种,确认与活动宣传一致。
步骤 5:停用或作废
活动结束把状态改「停用」(停用后不可再变更);作废方案点表单工具栏「删除」,状态置为「删除」(-1),列表不再显示,数据仍在库里。本页没有回收站入口,需要找回已作废方案时与实施人员确认。
四、字段详细说明
方案头落 WX_VipLargessSub(主键 fCaseID,系统取号),明细落 WX_VipLargessSubDetail,参与分店落 WX_VipLargessSub_shop。
| 界面字段 | 落库字段 | 含义与取值 |
|---|---|---|
| 方案编号 | fCaseNo | 长度 30;留空保存后补 No + 8 位方案ID |
| 方案名称 | fCaseName | 必填,长度 30;列表超链入口 |
| 方案类别 | fCaseType | 本页取数范围只有 6、7;新增默认 6 |
| 参与会员类别 | fVipTypeIDList | 长度 2000,会员类别 id 串(逗号分隔),0 为不限,新增默认 0 |
| 方案状态 | fCaseState | -1 删除 / 0 草稿 / 1 生效 / 10 停用 |
| 优先级别 | fLevel | 整数,方案优先级数值 |
| 制定日期 | fBillDay | 新增默认当天 |
| 开始日期 / 结束日期 | fBegDate / fEndDate | 方案有效期,列表直接显示这两列 |
| 启用星期条件 / 附加时间条件 | fIsUseEffectTimeEx / fEffectTimeEx | 开关 + 位掩码(星期一~日 + 单/双号),界面只录数值 |
| 启用日期条件 / 附加日期条件 | fIsUseEffectDateEx / fEffectDateEx | 开关 + 日期条件数值 |
| 每人最大赠送次数 | fMaxCount | 整数,每人最多享受几次 |
| 电子券有效天数 / 电子券开始有效日期 | fEffectiveDays / fEffectiveBegDate | 送出券的可用天数与起算日期 |
| 金额 / 积分 | fMoney / fScore | 方案级数值,两位小数;与明细行数值的关系以实际版本为准 |
| 在线充值说明 | fRemark | 必填,长度 500,显示在线上界面上 |
明细与参与分店列:
| 界面列 | 落库字段 | 含义与取值 |
|---|---|---|
| 行号 | WX_VipLargessSubDetail.flineIndex | 整表覆盖保存时自动补;系统默认行固定为 10000 |
| 名称 | fTitle | 长度 30,该档说明文字 |
| 电子券 | fTypeID | 券类型 id,必填;类别 6 下同一方案内不可重复 |
| 数量 | fNum | 整数,类别 7 下必填 |
| 充值/等价金额 | fAddMoney | 类别 7 用作中奖率,0~100 整数;系统默认行自动补齐 |
| 赠送金额 / 积分 / 首次充值 | fLargessMoney / fScore / fIsFirstFillMoney | 赠送规则家族共用的列,积分兑换日常按券种与数量配置 |
| 分店编号 | WX_VipLargessSub_shop.fFilialeId | 下拉选分店,编号与名称按分店档案联查显示 |
五、典型使用场景
场景一:积分换券常态化。 建一个长期方案,明细挂几种常用电子券与数量,每人最大赠送次数按预算设定,在线充值说明写清兑换口径;生效后会员在小程序积分入口按方案兑换。
场景二:节令限时兑换。 起止日期圈定活动窗口,配合「启用星期条件」只在周末开放,每人限换一次,避免积分被一次性刷空。
场景三:只给特定卡类别或特定分店。 参与会员类别填目标卡类别 id 串,参与分店页签挑出门店,总部统一配规则、门店按范围露出。
场景四:积分类抽奖玩法。 方案类别选 7,明细逐行填奖品券、数量与中奖率,保留系统默认行兜底;手工行合计不超过 100,生效前确认合计正好 100。
场景五:活动收尾与复盘。 结束把方案改「停用」,导出列表核对起止日期与每人次数;兑换与发券结果到电子券查询 等查询页核对,本页只看规则配置。
六、权限控制与前置条件
- 本页为网页端新迁移的编码窗体,权限映射里标注为客户端无对应菜单、网页端新增放行,可见性跟随 O2O业务 分组;看不到入口时联系深圳市安仕达管理软件有限公司确认账套开通范围。
- 前置条件:电子券类型档案已维护、会员积分体系可用;要限分店时分店档案需齐全。
- 小程序首页「积分兑换」入口的名称、标题与图标在商城模块管理 维护,本页只管规则内容。
- 生效前受只读保护:非草稿状态只能改状态,改明细要先回草稿。
- 星期与日期条件在网页端只录数值,没有日历点选;明细页签未暴露赠送2~5 电子券列与会员礼包列。
- 删除为状态置 -1,列表不再显示,本页没有回收站入口。
七、常见问题
问:本页建的方案,积分赠送规则里看得到吗? 答:看得到。几个入口共用同一张方案表,赠送规则入口的列表不按类别过滤;反过来本页只列类别 6、7,充值赠送类方案不会出现在这里。
问:把方案类别改成其它值会怎样? 答:保存后方案会落到对应赠送规则入口的列表里,本页因为只取类别 6、7 而不再显示它。要留在本页,类别保持 6 或 7。
问:生效后想改明细改不了? 答:生效状态只允许改状态。先改回「草稿」保存,再改明细,改完重新生效;直接改会提示「只读状态不能修改,请检查方案状态」。
问:提示「中奖率总计应为100!」怎么处理? 答:这是类别 7 生效时的校验。核对明细手工行的中奖率合计,系统默认行会按 100 - 其余行合计 自动补齐;手工行合计超过 100 会先提示「中奖率数值错误!」。
问:系统默认行能删掉或换券吗? 答:不能。删除提示「系统数据不允许删除!」,改它的电子券提示「系统数据不允许修改!」。它是兜底项,其余奖品行按中奖率配置即可。
问:「每人最大赠送次数」留空是不是不限次? 答:留空时的执行口径以实际版本为准。需要限次就填明确数字,并在活动宣传里写清同一口径。
问:在线充值说明能留空吗? 答:本页类别下必填,留空提示「在线充值说明不能为空!」。这段文字顾客在线上界面看得到,建议写清兑换条件与有效期。
问:会员兑换后券没到账? 答:本页只存规则。先核对方案是否生效、当天是否在起止日期与星期/日期条件内、参与会员类别与分店是否命中、每人次数是否用完,再到电子券查询 查发放结果;规则命中但仍未到账时联系技术支持排查兑换链路。
