线上充值金额设置
线上充值金额设置决定顾客在小程序「在线充值」页面上能一键选哪几档金额,同时挂着充值页面图与分享页面图两张广告图。它是线上充值促销的前置配置:金额赠送规则、积分赠送规则、电子券赠送规则里明细的「充值/等价金额」必须与这里的面额对得上,顾客才充得到、送得出。
一、功能概述
菜单位置:O2O业务 → 微信公众号 → 线上充值金额设置(页面地址 /admin/o2o/viponlinefillmoneytype/)

同一页面在 O2O业务 → 微信会员 → 线上充值金额设置 还有一个入口,两者共用同一张表 Vip_OnlineFillMoneyType,档位与图片都是同一份数据。
| 用途 | 说明 |
|---|---|
| 定充值档位 | 类型编号、类型名称、面额;面额必须是大于零的整数且各档不重复 |
| 控档位启用 | 「是否使用」开关决定该档是否参与线上充值展示 |
| 配广告图 | 「充值页面图」「分享页面图」两个图片面板,单张上限 500KB |
| 区分系统档与自建档 | 类型ID 小于 100 为系统预置记录,全字段只读、不可删除 |
档位与赠送方案之间没有数据库外键,靠金额数值对齐。改了面额,要回头核对赠送规则明细里的「充值/等价金额」,否则会出现「方案配了充 300 送 30,档位表里却没有 300 元档」的情况。
二、界面布局说明
列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、回收站、打印(选中行后另出现导出选中) |
| 搜索框 | 提示文字「搜索...」,按类型编号、类型名称模糊搜 |
| 表格 | 列依次为类型编号、类型名称(超链,点开编辑)、面额、是否使用、使用标志 |
| 排序 | 按类型编号升序 |
| 分页 | 底部「共 N 条」「共 N 页」,每页 10 / 20 / 30 / 50 / 100 / 200 条 |
「是否使用」是业务开关,「使用标志」是系统标志列(只读),两列不要混用。打了删除标志的记录不在列表里,到「回收站」查看与还原。
编辑窗口
| 字段 | 控件与提示 |
|---|---|
| 类型编号 | 文本,界面带必填标记,最长 10 字符,全表唯一 |
| 类型名称 | 文本,界面带必填标记,最长 30 字符 |
| 面额 | 金额(两位小数显示),界面带必填标记;提示「必须为正整数,且不能与其它面额重复」 |
| 是否使用 | 开关 |
| 规格 | 文本,最长 30 字符;提示「小程序端使用,界面原未暴露」 |
| 助记码 | 文本,最长 30 字符 |
建立人、建立日期、修改人、修改日期、版本号、各标志列与类型ID 为只读,排在表单后部;删除人、删除日期、有附件三列不在界面显示。
表单下方是标题为「图片」的区块,里面两个面板:
| 面板 | 说明 |
|---|---|
| 充值页面图 | 小程序充值页广告图,客户端界面建议尺寸 1200x1700 |
| 分享页面图 | 会员分享充值活动时展示的广告图,客户端界面建议尺寸 500x400 |
两个面板都是模块级固定图片:不管打开哪一条面额记录,看到的都是同一组图,换一条记录不会换图。每个面板有预览区、「上传图片」「删除图片」两个按钮,单张上限 500KB,超限弹「图片大小超过500KB限制」;无图时显示「暂无图片」,主记录未保存时显示「请先保存主记录」且按钮不可用。上传成功弹「图片已上传」,删除成功弹「图片已删除」。
网页版这两个面板不提供图片说明文字录入(客户端有「保存文字」),也没有客户端【操作】菜单里的「设置 3 种 / 6 种 / 9 种充值面额」初始化动作,档位需逐条维护。
三、业务操作步骤
步骤 1:核对系统预置档位
打开列表,类型ID 小于 100 的记录是系统预置档位。点开这类记录时全部字段只读,改完点保存会提示 系统生成的记录不允许修改!,点删除会提示 系统默认生成的记录不允许删除!。不想让某档出现在小程序上,用自建档位替代或联系技术支持处理预置档位的启用状态。
步骤 2:新增自定义档位
- 点「新增」,填「类型编号」(不重复)与「类型名称」;
- 「面额」填一个大于零的整数,例如某个活动档位金额;
- 「是否使用」打开,「规格」「助记码」按需填;
- 点「保存」。列表刷新后出现新档位,类型ID 由系统从 100 起取号。
保存时逐项校验,报错原文如下:
| 报错原文 | 原因 |
|---|---|
| 类型编号不能为空 | 编号留空 |
| 编号[填写的编号]已存在 | 编号与其它档位重复 |
| 面额不能为空 | 面额留空 |
| 面额必须为整数! | 填了小数 |
| 面额不能小于零! | 填了负数 |
| 面额必须大于零 | 填了 0 |
| 面额[填写的面额]已存在 | 面额与其它档位重复 |
校验不通过时表单顶部显示「表单验证失败,请修正以下错误后重新提交:」,下面逐条列出「字段名: 错误内容」。
步骤 3:上传两张广告图
- 先保存主记录(新增未保存时图片面板显示「请先保存主记录」);
- 在「充值页面图」面板点「上传图片」,选一张 500KB 以内、按 1200x1700 比例出的图;
- 在「分享页面图」面板同样上传一张 500KB 以内、按 500x400 比例出的图;
- 两个面板都弹「图片已上传」并显示预览即成功。
这两张图存在固定的业务绑定位置上,所有面额记录共用,上传一次即可,不必逐条记录重复传。
步骤 4:与赠送方案对齐
- 到金额赠送规则(或积分、电子券赠送规则)新建方案;
- 在「明细」区块的「方案明细」页签点「添加行」,逐档录入:「充值/等价金额」填本页的面额数值,再填对应的赠送金额 / 积分 / 电子券与张数;
- 方案生效后到小程序在线充值页核对:档位按钮显示的金额与本页一致,充值后按方案赠送。
客户端新增方案时会按面额档位自动生成明细行,网页版没有这个自动生成动作,明细行要手工添加;档位有增减时,已建方案的明细也不会跟着变,需要手工补行或另建方案。
步骤 5:停用与删除档位
- 临时不想展示某档:把「是否使用」关掉并保存。
- 删除自建档位:点开记录点「删除」,或列表选中后批量删除,提示「已逻辑删除」,记录从列表消失但仍在库里。
- 误删恢复:点工具栏「回收站」,找到该记录点「还原」,确认框「确定要还原这条记录吗?」,确定后提示「记录已还原」,记录回到列表。
- 批量删除时若选中了系统预置档位,会提示
系统默认生成的记录不允许删除!,其余自建档位照常删除。
四、字段详细说明
| 界面字段 | 落库字段 | 含义与取值 |
|---|---|---|
| 类型ID | Vip_OnlineFillMoneyType.fTypeId | 主键;小于 100 为系统预置(只读、禁删),新增自建档位从 100 起取号 |
| 类型编号 | fTypeNo | 档位代码,最长 10 字符,全表唯一 |
| 类型名称 | fTypeName | 档位名称,最长 30 字符 |
| 面额 | fPrice | 顾客可一键选择的充值金额;必须为大于零的整数且各档不重复 |
| 是否使用 | fIsUse | 布尔开关,控制该档是否参与线上充值展示 |
| 规格 | fSpec | 最长 30 字符,小程序端使用,客户端界面原未暴露该列 |
| 助记码 | ZJM | 最长 30 字符,检索辅助 |
| 使用标志 | SignUsed | 系统标志列,只读 |
| 删除标志 | SignDelete | 系统标志列;删除时置 1,列表据此过滤,回收站据此列出 |
| 建立人 / 建立日期 / 修改人 / 修改日期 | DefineMan / DefineDate / ChangeMan / ChangeDate | 审计列,只读 |
| 版本号 | RecVer | 只读 |
图片面板参数
| 项 | 充值页面图 | 分享页面图 |
|---|---|---|
| 存储方式 | 模块级固定绑定(所有面额记录共用) | 模块级固定绑定(所有面额记录共用) |
| 归属 | 小程序 / 充值方案 | 小程序 / 充值方案 |
| 单张大小上限 | 500KB | 500KB |
| 客户端建议尺寸 | 1200x1700 | 500x400 |
| 说明文字 | 网页版不提供 | 网页版不提供 |
五、典型使用场景
场景一:店庆冲储值。 先在本页把活动要用的面额档位补齐并打开「是否使用」,传好充值页面图与分享页面图;再到金额赠送规则建一个「充值赠送金额」方案,明细逐档填赠送金额,生效后顾客在小程序充值即按档赠送。
场景二:档位对不上导致送不出。 顾客反映充了某金额没赠送。先回本页确认该面额档位存在且「是否使用」为开,再到赠送规则明细核对「充值/等价金额」是否与面额完全一致——两边靠数值对齐,差一元也命中不了。
场景三:换活动广告图。 活动改版时在同一条面额记录上重新上传两张图即可,因为图片是模块级固定的,所有档位记录看到的都是新图,不必逐条改。
六、权限控制与前置条件
- 本页为网页端新迁移的编码窗体,权限映射里标注为「客户端无对应菜单 / Django 新增,始终放行」,可见性跟随 O2O业务 分组;两个分组入口各自跟随所在分组,看不到时联系深圳市安仕达管理软件有限公司确认开通范围。
- 微信会员线上充值渠道须已开通,小程序端才能展示档位。
- 系统预置档位(类型ID 小于 100)只读、禁删;自建档位才可改可删。
- 赠送方案要能选到参与会员类别,对应卡系列需勾上微信卡券相关开关,详见会员卡类型与客户端帮助。
- 若账套启用了「使用会员管理【全局充值金额分段赠送】代替 o2o【金额赠送规则】定线上充值方案」这项特点,线上充值赠送改按会员管理侧的分段赠送匹配,本页档位仍供充值页展示,但赠送不再走本组规则(该口径来自客户端帮助,网页版未见对应开关)。
七、常见问题
问:系统预置的档位能改面额吗? 答:不能。类型ID 小于 100 的记录全字段只读,保存提示「系统生成的记录不允许修改!」,删除提示「系统默认生成的记录不允许删除!」。需要不同金额时新增自建档位。
问:面额填 100.5 保存不了? 答:面额必须是大于零的整数,小数会被「面额必须为整数!」拦下;0 与负数分别提示「面额必须大于零」「面额不能小于零!」。
问:为什么每条面额记录看到的图片都一样? 答:这两个面板是模块级固定图片,绑定在固定业务位置上,与具体面额记录无关,客户端也是同一口径。上传一次全组共用。
问:图片传不上去,提示超过 500KB? 答:两个面板单张上限都是 500KB,先压缩再传;尺寸按客户端建议的 1200x1700(充值页面图)与 500x400(分享页面图)出图,避免小程序里拉伸变形。
问:客户端有「设置 6 种充值面额」,网页版在哪里? 答:网页版未提供该初始化动作,档位需逐条新增维护。客户端的初始化会重建整张档位表,覆盖自定义行,两边混用时先留底。
问:删掉的档位还能找回来吗? 答:能。删除是逻辑删除,点工具栏「回收站」找到记录点「还原」,确认后提示「记录已还原」,档位回到列表。
问:改了面额,赠送方案要跟着改吗? 答:要。两边没有外键关联,靠金额数值对齐;已建方案的明细行不会随档位增减自动变化,需手工补改明细或另建方案。
