电子券赠送规则
电子券赠送规则用来定什么场景下自动送券、送哪张券、送几张:会员线上充值命中档位、开卡、生日、在线购物等场景触发时,按方案明细里配的券类型与张数赠券。它与金额赠送规则、积分赠送规则是同一张方案表的三个入口,界面与字段完全一致,本页日常用的是明细里的「电子券」「数量」两列。
一、功能概述
菜单位置:O2O业务 → 微信公众号 → 电子券赠送规则(页面地址 /admin/o2o/wxlargessticketrule/)

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