微信礼品卡
微信礼品卡是微信端售卖的储值卡、兑换卡的卡面模板:一张卡在这里定义标题、品牌、面额、有效期、积分与抵扣规则,以及微信卡包里的入口开关。卡模板建好后挂到微信礼品卡货架上售卖,顾客在小程序购买或转赠,售出订单在微信礼品卡订单查询里追溯。
一、功能概述
菜单位置:O2O业务 → 微信礼品卡 → 微信礼品卡(页面地址 /admin/o2o/wxgeneralcard/)

| 用途 | 说明 |
|---|---|
| 定义卡面 | 卡标题、卡品牌、卡颜色、条码类型、Logo 与背景图 |
| 定面额与有效期 | 面额、固定区间或领取后生效的有效期规则 |
| 定积分与抵扣 | 消费积分、积分抵现、折让比例、充值使用规则 |
| 配卡包入口 | 支持积分 / 储值、在线充值、在线商城、支付按钮等开关 |
| 追溯微信对接 | 微信卡券ID 只读展示,核对卡模板是否已推送微信 |
本页管的是「卡长什么样、按什么规则用」,不管逐张卡的发放与余额。卡券推送到微信平台、自定义卡号上传等操作本版网页端未提供,在客户端完成,见客户端微信礼品卡。
二、界面布局说明
页面是「列表 + 编辑窗体」结构:列表定位卡模板,点卡标题打开编辑窗体,字段按五个分组排列。
列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、打印 |
| 搜索框 | 按卡标题、卡品牌、微信卡券ID 模糊搜索,回车后表格刷新并回到第 1 页 |
| 列表 | 礼品卡ID、卡标题、卡品牌、面额、卡颜色、有效期类型、动态显示卡条码/二维码、微信卡券ID;礼品卡ID 与卡标题两列冻结,默认按礼品卡ID 排序 |
| 分页 | 「共 N 条」「共 N 页」+ 页码,每页可选 10 / 20 / 30 / 50 / 100 / 200 条(默认 20 条/页) |
卡标题是链接,点击打开这张卡的编辑窗体。
编辑窗体
字段分五组:基础信息、有效期、积分与抵扣、入口与开关、微信对接。顶部按钮有 返回、编辑、保存(下拉含 保存并继续编辑 / 保存并新增下一个 / 保存并返回列表)、取消、刷新、上一行、下一行。新增时礼品卡ID 由系统在保存时自动发号,保存后编号只读,不能修改。
三、业务操作步骤
步骤 1:新增卡模板
- 点工具栏 新增,打开空白编辑窗体;
- 在 基础信息 填卡标题、卡品牌,选卡条码类型与卡颜色,填面额(两位小数);
- 在 有效期 选有效期类型,按类型填固定区间或天数;
- 按需填 积分与抵扣、打开 入口与开关 里需要的开关;
- 点 保存。系统自动分配礼品卡ID,窗体提示保存成功,列表出现新行。
步骤 2:修改卡模板
- 在列表点目标卡的 卡标题;
- 点 编辑 进入编辑态,修改字段后点 保存;
- 礼品卡ID 与微信卡券ID 始终只读,改不了。
卡面规则修改后,需要重新推送到微信平台才会在顾客卡包侧生效;推送操作在客户端完成。
步骤 3:删除的限制
已上传自定义卡号的卡模板不允许删除,删除时系统提示:
号码已经上传不能删除!
这类卡改为停止投放即可,不要强行删除。
四、字段详细说明
1)基础信息
| 字段名 | 含义 |
|---|---|
| 礼品卡ID | 卡模板唯一编号,新增保存时系统自动发号,保存后只读 |
| 卡标题 | 卡面名称,必填,最长 30 字;为空保存时提示「卡标题不能为空」 |
| 卡品牌 | 品牌名称,最长 30 字 |
| 卡条码类型 | 卡包内条码形态,见枚举表 |
| 卡颜色 | 微信卡券背景色代码,见枚举表 |
| 面额 | 卡面值,金额两位小数 |
| 条码界面提示 | 条码下方提示文字,最长 50 字 |
| 服务电话 | 卡面客服电话,最长 20 字 |
| 卡描述 | 卡面描述,最长 100 字 |
| 特权说明 | 多行文本,说明持卡特权 |
2)有效期
| 字段名 | 含义 |
|---|---|
| 有效期类型 | 界面提示原文「微信 date_info.type:固定区间/领取后生效」,按微信卡券接口口径取值,具体数值对照以微信卡券文档为准 |
| 有效期开始 / 有效期结束 | 固定区间方式下的起止时间 |
| 固定有效天数 | 固定区间方式下的有效天数 |
| 领取后生效天数 | 领取后生效方式下,自领取起算的天数 |
| 使用自定义卡号 | 开关。开启后该卡使用预先上传的自定义卡号;卡号上传本版网页端未提供,在客户端维护 |
3)积分与抵扣
| 字段名 | 含义 |
|---|---|
| 每消费金额 | 积分规则的消费金额基数 |
| 获得积分 | 每消费一个基数获得的积分 |
| 使用积分 | 抵扣规则:多少积分起抵 |
| 抵扣金额 | 对应使用积分可抵的金额 |
| 订单满额可用 | 订单达到该金额才允许积分抵扣 |
| 单笔上限积分 | 单笔订单最多可使用的积分 |
| 折让比例% | 持卡消费折让比例 |
| 充值使用规则 | 充值与使用说明文字,最长 300 字 |
4)入口与开关
| 字段名 | 含义 |
|---|---|
| 卡片Logo | 卡面 Logo 图片地址,最长 300 字符,填可访问的图片 Url |
| 背景图片Url | 卡面背景图地址,最长 300 字符 |
| 支持积分 | 开关,卡是否支持积分 |
| 支持储值 | 开关,卡是否支持储值 |
| 允许在线充值 | 开关,是否允许微信端在线充值 |
| 显示微信支付按钮 | 开关,卡包内是否显示微信支付入口 |
| 显示在线商城 | 开关,卡包内是否显示在线商城入口 |
| 显示会员卡支付按钮 | 开关,卡包内是否显示会员卡支付入口 |
| 动态显示卡条码/二维码 | 开关,卡条码/二维码是否动态刷新 |
| 自动发送微信消息 | 开关,是否自动发送微信消息 |
图片文件本身在 微信图片资料管理 维护,本页只填图片地址;本版网页端不提供卡面图片上传。
5)微信对接
| 字段名 | 含义 |
|---|---|
| 微信卡券ID | 只读,最长 40 字符。推送微信平台后回写;为空说明尚未推送。本版网页端未提供推送按钮,推送在客户端完成 |
6)枚举值说明
卡条码类型:
| 取值 | 含义 |
|---|---|
| 文本 | 卡包内以文本显示卡号 |
| 一维码 | 显示一维条码 |
| 二维码 | 显示二维码 |
卡颜色(显示值即代码,共 14 项):
| 取值 |
|---|
| Color010、Color020、Color030、Color040、Color050、Color060、Color070、Color080、Color081、Color082、Color090、Color100、Color101、Color102 |
颜色代码对应微信卡券背景色,具体色值以微信卡券接口文档为准。
五、典型使用场景
场景 1:上线一张新面额的储值卡
背景:门店要售 100 元面值的微信储值卡。 操作:本页新增卡模板,填面额与有效期,打开支持储值、允许在线充值 → 到微信礼品卡货架把卡挂上货架 → 在客户端推送微信卡券并发布货架 → 顾客购买后在微信礼品卡订单查询核对订单。
场景 2:节日兑换卡
背景:中秋售月饼兑换卡,有效期固定到节日后一段时间。 操作:新增卡模板,有效期类型按固定区间口径设置起止时间,卡描述写清兑换范围 → 挂货架售卖 → 节后按订单查询导出核对售出与退款。
场景 3:合作单位员工福利卡
背景:烘焙企业给合作单位做福利卡业务,卡券由单位发放到员工手上,员工在微信端绑定后消费抵扣。 操作:本页按福利方案定义卡面额、有效期与抵扣规则(订单满额可用、单笔上限积分)→ 单位发放后,员工消费抵扣情况通过订单查询与会员相关报表核对。
场景 4:调整积分抵扣规则
背景:积分抵现比例要下调。 操作:列表搜卡标题 → 打开编辑 → 改 积分与抵扣 组的使用积分、抵扣金额、订单满额可用 → 保存 → 在客户端重新推送微信。
六、权限控制与前置条件
- 本页无独立 ERP 菜单权限映射项(Django 新增页面),有页面访问权限即可操作;菜单可见性跟随 O2O业务 分组,看不到分组时联系实施人员确认模块是否开通。
- 前置条件:O2O业务已开通(见 O2O业务总览);卡面图片先备好可访问的 Url。
- 卡模板要在顾客卡包生效,还需客户端完成微信卡券推送;货架售卖还需配置并发布微信礼品卡货架。
七、常见问题
1. 保存时提示「卡标题不能为空」
- 原因:卡标题是必填名称字段;
- 处理:在基础信息组补填卡标题再保存。
2. 删除时提示「号码已经上传不能删除!」
- 原因:这张卡已上传自定义卡号,系统禁止删除;
- 处理:不要删除,改为停止投放;确需清理时联系实施人员评估。
3. 微信卡券ID 一直是空的
- 原因:卡模板尚未推送到微信平台,本页不提供推送按钮;
- 处理:到客户端微信礼品卡窗口执行推送,回写后本页只读展示。
4. 礼品卡ID 能自己指定或修改吗
- 原因:编号由系统统一发号,保存后只读;
- 处理:新增时不必手工编号,保存后以系统分配的编号为准。
5. 改了卡面,顾客卡包里没变化
- 原因:本页只改 ERP 侧模板,微信侧卡面要重新推送才更新;
- 处理:在客户端重新执行推送,再让顾客刷新卡包查看。
附:本文档变更记录
| 日期 | 变更 |
|---|---|
| 2026-11-18 | 初稿 |
