微信礼品卡货架
微信礼品卡货架配置礼品卡在小程序里的售卖页面:页面标题、Banner、是否支持多选购买与自购、服务电话和商家说明在这里维护,页面下再挂主题和礼品卡商品。顾客在小程序里看到的礼品卡售卖页,对应的就是这里的一条货架记录。
一、功能概述
菜单位置:O2O业务 → 微信礼品卡 → 微信礼品卡货架(页面地址 /admin/o2o/wxgiftcardpage/)

| 用途 | 说明 |
|---|---|
| 配售卖页面 | 页面标题、Banner 图、地址、服务电话、商家说明 |
| 定购买方式 | 支持多选购买、支持自购、需要小票三个开关 |
| 挂自定义链接 | 页面下方最多两条自定义链接(标题 + 链接) |
| 记微信对接 | 微信货架页面ID、微信小程序AppId |
数据结构上货架分「页面 → 主题 → 主题商品」三层,主题商品通过礼品卡ID 挂接微信礼品卡里定义的卡模板,商品行含标题、描述、默认赠言等。本版网页端只提供页面层和自定义链接的编辑,主题、主题商品、分类没有编辑界面,这部分在客户端维护,见客户端微信礼品卡货架。
二、界面布局说明
页面是「列表 + 主从编辑窗体」结构:主表单两个分组,下方追加从表页签。
列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、打印 |
| 搜索框 | 按页面标题、微信小程序AppId 模糊搜索 |
| 列表 | 货架页面ID、页面标题、支持多选购买、支持自购、服务电话、需要小票、微信小程序AppId;货架页面ID 与页面标题两列冻结,默认按货架页面ID 排序 |
| 分页 | 「共 N 条」「共 N 页」+ 页码,每页可选 10 / 20 / 30 / 50 / 100 / 200 条(默认 20 条/页) |
页面标题是链接,点击打开编辑窗体。
编辑窗体
- 主表单两组:货架页面、微信对接;
- 主表单下方是从表页签 自定义链接,表格两列:标题、链接,页签内有独立的 保存 按钮;
- 顶部按钮有 返回、编辑、保存(下拉含 保存并继续编辑 / 保存并新增下一个 / 保存并返回列表)、取消、刷新、上一行、下一行。
新增时货架页面ID 由系统在保存时自动发号,保存后编号只读。
三、业务操作步骤
步骤 1:新增货架页面
- 点工具栏 新增;
- 在 货架页面 组填页面标题,按需打开支持多选购买、支持自购、需要小票,填 Banner图片Url、地址、服务电话、商家说明;
- 在 微信对接 组填微信货架页面ID、微信小程序AppId;
- 点 保存,系统自动分配套架页面ID,列表出现新行。
步骤 2:维护自定义链接
- 打开货架记录,先保存主表单——主表未保存就切页签,系统提示「请先保存修改内容,再修改自定义链接。」;
- 切到 自定义链接 页签,在表格里填标题与链接;
- 点页签内的 保存,从表整表覆盖保存,成功提示「保存成功」。
自定义链接最多两条,超出保存时系统提示:
自定义链接不能超过两条!
步骤 3:挂卡与发布
主题与主题商品(挂哪些礼品卡、默认赠言)在客户端货架窗口维护;货架发布到微信小程序的操作本版网页端未提供,也在客户端完成。发布后顾客才能在小程序看到售卖页,售出订单进微信礼品卡订单查询。
四、字段详细说明
1)货架页面
| 字段名 | 含义 |
|---|---|
| 货架页面ID | 货架唯一编号,新增保存时系统自动发号,保存后只读 |
| 页面标题 | 售卖页名称,必填,最长 30 字;为空保存时提示「页面标题不能为空」 |
| 支持多选购买 | 开关,顾客能否一次选多张卡购买 |
| 支持自购 | 开关,顾客能否买给自己(相对转赠而言) |
| 需要小票 | 开关,购买是否出小票 |
| Banner图片Url | 页面头图地址,最长 500 字符,填可访问的图片 Url |
| Banner图片ID | 头图图片编号 |
| Banner图片标题 | 头图标题,最长 100 字 |
| 地址 | 商家地址,最长 200 字 |
| 服务电话 | 页面客服电话,最长 30 字 |
| 商家说明 | 多行文本,最长 500 字 |
2)微信对接
| 字段名 | 含义 |
|---|---|
| 微信货架页面ID | 微信侧货架页面编号,最长 50 字符,记录与微信货架的对应关系 |
| 微信小程序AppId | 承载货架的小程序 AppId,最长 30 字符 |
3)自定义链接(从表)
| 字段名 | 含义 |
|---|---|
| 标题 | 链接显示文字 |
| 链接 | 跳转地址 |
每条货架最多两条链接;从表按整表覆盖方式保存,页签里删掉的行保存后即移除。
4)主题与主题商品(结构说明)
主题含主题标题、主题图片、标题颜色、分类索引、作为Banner 等字段;主题商品含礼品卡ID、标题、描述、图片、背景图、默认赠言等字段,通过礼品卡ID 关联卡模板。本版网页端只建模、无编辑界面,维护入口在客户端。
五、典型使用场景
场景 1:节日专题货架
背景:中秋要上一个礼品卡专题售卖页。 操作:新增货架,页面标题写专题名,配 Banner图片Url 与商家说明,打开支持多选购买 → 客户端维护主题与主题商品、挂上微信礼品卡里建好的卡 → 发布后核对小程序售卖页。
场景 2:给售卖页加活动入口
背景:货架页要挂一个活动页链接。 操作:打开货架 → 先保存主表 → 自定义链接页签加一行(标题 + 链接)→ 页签内保存,提示「保存成功」。已有两条链接时先删一条再加。
场景 3:更新客服信息
背景:客服电话换了。 操作:列表搜页面标题 → 打开编辑 → 改服务电话与商家说明 → 保存。页面层修改保存即生效于 ERP 配置,微信侧展示如需更新按客户端发布流程处理。
六、权限控制与前置条件
- 本页无独立 ERP 菜单权限映射项(Django 新增页面),有页面访问权限即可操作;菜单可见性跟随 O2O业务 分组,看不到分组时联系实施人员确认模块是否开通。
- 前置条件:先建好微信礼品卡卡模板;Banner 图片先备好可访问的 Url(图片在 微信图片资料管理 维护)。
- 货架要在小程序售卖,还需客户端完成主题挂卡与发布;本版网页端不提供 Banner / 主题图片上传和货架发布。
七、常见问题
1. 切到自定义链接页签提示「请先保存修改内容,再修改自定义链接。」
- 原因:主表单还没保存,从表需要主表编号才能挂接;
- 处理:先点主表单保存,再切页签维护链接。
2. 保存链接提示「自定义链接不能超过两条!」
- 原因:每条货架最多两条自定义链接;
- 处理:删掉不用的链接行,保留两条以内再保存。
3. 货架上看不到想卖的卡
- 原因:卡要通过主题商品挂接,本页没有主题编辑界面;
- 处理:到客户端货架窗口维护主题商品、挂上礼品卡ID,再发布。
4. 保存时提示「页面标题不能为空」
- 原因:页面标题是必填名称字段;
- 处理:补填页面标题再保存。
5. 货架页面ID 能修改吗
- 原因:编号系统发号,保存后只读;
- 处理:以系统分配的编号为准,微信侧对应关系填在微信货架页面ID 字段。
附:本文档变更记录
| 日期 | 变更 |
|---|---|
| 2026-11-18 | 初稿 |
