会员拼团方案
会员拼团方案是小程序商城的成团玩法配置页：定好几个人成团、多长时间不成团就散、拼团价多少、哪些商品参加，生效后会员在小程序里开团、邀好友参团。它和会员限时抢购 共用一套单据结构，只是多了「参团人数」和「有效时间」两个拼团专属参数。
一、功能概述
菜单位置：O2O业务 → 商城活动 → 会员拼团方案（页面地址 /admin/o2o/wxvipgroupbillhead/）
| 用途 | 说明 |
|---|---|
| 定成团条件 | 参团人数（人/团）、有效时间（小时） |
| 定时间窗 | 开始/结束时间决定可以开团的时段 |
| 定拼团价 | 逐行给商品填拼团价，与原价分开 |
| 定限购 | 按活动限购、按订单限购两种口径 |
| 定履约 | 取货起止日期 + 参与分店（不选=全部分店） |
| 拿去推广 | 生成小程序/微商城的开团详情链接 |
拼团是单据：草稿、已审核（生效）两态走审核流；列表页没有删除按钮，删除和复制在单据页里做。
二、界面布局说明
列表页
| 区域 | 内容 |
|---|---|
| 右上按钮 | 新增（蓝）、审核、反审核（未勾选行时置灰）、导出、刷新 |
| 查询条 | 单据日期快捷页签：今天 / 昨天 / 本周 / 上周 / 本月（默认）/ 上月 / 自定义；高级筛选；查询、重置、导出、★ 方案 |
| 已选条件 | 「已选条件： 单据日期 等于 本月 ×」，点 × 移除 |
| 列表 | 勾选框、行号、方案编号（蓝色超链，落库是单据内部 ID，点开进单据页）、单据编号、方案编号（自己录入的短编号）、方案名称、开始日期、结束日期、参团人数、有效时间(小时)、限购（是/否）、单据状态 |
| 分页 | 「共 N 条」「共 N 页 第 N 页」，每页 20 / 50 / 100 / 200 条 |
「本月」页签只是默认高亮，进页面时列出的仍是全部方案（截图里共 365 条、19 页，第一页从 2026-10 一路排到 2025-09），按单据编号从新到旧倒序。要真按时间段看，切页签或点「查询」。
单据页
点「新增」或列表里的方案编号，进入标题为「会员拼团方案」的单据页。
| 区域 | 内容 |
|---|---|
| 工具栏 | 返回、保存（蓝）、复制、删除、推广链接（新建未保存时后三个置灰） |
| 基本信息 | 方案编号*、方案名称*、状态（只读，新建为「草稿」）、开始时间*、结束时间*、参团人数(人/团)、有效时间(小时) |
| 限购设置 | 启用限购、按活动限购、活动限购数、按订单限购、订单限购数 |
| 取货与分店 | 取货开始日期、取货结束日期、参与分店(空=所有分店)（点开弹「选择参与分店」多选窗） |
| 明细页签 | 拼团商品、多级单位物料、单据摘要 |
| 拼团商品 | 「+ 添加行」「删除选中」；列只有序号、商品类别、商品编号、商品名称、商品规格、基础单位、条码——活动价不在这个页签；空表提示「暂无商品，点击"添加行"新增」 |
| 多级单位物料 | 保存商品明细后由服务端按单位自动展开，不能手工加行，只能删行；列含商品类别、主产品商品编号/名称、商品编号/名称、条码、商品规格、原价（只读）、活动价（可编辑）、秒杀数量（只读，拼团用不上这一列） |
新建时默认值：开始时间 = 今天 00:00:00，结束时间 = 今天 +5 天 23:59:50，参团人数 = 2，有效时间 = 24 小时，启用限购 = 开、按活动限购 = 开、活动限购数 = 1。取货起止日期没有默认值，需要时自己填。
三、业务操作步骤
步骤 1：建成团条件
参团人数是成团门槛，必须大于 1（填 1 会被「参团人数必须大于1！」拦下）；有效时间是开团后多久不成团就散，必须大于 0。常见组合是 2 人 / 24 小时，或做「50 人成团」这类大团活动。
步骤 2：加拼团商品
在「拼团商品」页签点「+ 添加行」选物料，或用商品导入。导入常见回显：
- 「以下商品未上架或类别未启用配送，已跳过：…」
- 「商品编码【X】不存在或未上架（需类别启用配送且微信商品已上架）」
- 「商品编码【X】在明细中重复，请删除重复行」
- 「只有草稿状态的方案可以添加商品」
能进拼团清单的前提：商品在网店商品 里已上架，且所属类别启用了配送。多级单位商品会拆成子行，切「多级单位物料」页签查看（导入后回显「已入库并展开多级单位物料」）。
步骤 3：填拼团价
切到「多级单位物料」页签，逐行填活动价（拼团价），未填生效时报「请输入物料[商品名]的活动价」。原价是只读列，取门店标准售价，小程序上以划线价对比展示。
步骤 4：定限购与分店
| 开关 | 效果 |
|---|---|
| 启用限购 = 关 | 不限购 |
| 按活动限购 = 开 + 活动限购数 N | 整个活动期间每人最多 N 件 |
| 按订单限购 = 开 + 订单限购数 M | 每笔订单最多 M 件 |
| 参与分店 留空 | 所有分店都能参与 |
步骤 5：保存、审核、推广
- 保存：落草稿。
- 审核：列表勾选后点「审核」，未勾选行时报「请先选择要审核的单据」，确认框「确定要审核选中的 N 张单据吗？」，逐单执行后回显「审核完成：成功 X 张，失败 Y 张」（有失败时后面追加「；单据<编号>：原因」）。单据页里的「审核」按钮确认语是「确认审核该单据？」，成功回显「方案已生效」。非草稿单会被挡下：「方案当前状态为【生效】，只有草稿可以生效」。
- 反审核：退回草稿，成功回显「已取消生效，方案回到草稿状态」；单据页确认语「确认反审核该单据？」。
- 复制：确认框「确定要复制当前单据为一张新草稿吗？」。
- 推广链接：弹窗标题「推广链接」，每行商品给「微商城」「小程序」两个只读框 + 复制（点复制回显「已复制」）。拼团的小程序路径是
pages/menuOption/assemble/detail/detail.html。
四、字段详细说明
| 界面字段 | 落库字段 | 含义 |
|---|---|---|
| 方案编号（列表超链） | fBillID | 单据内部 ID，也是推广链接里的 billId |
| 单据编号 | fBillNo | 形如 Wgv261022000001：前缀 + YYMMDD + 6 位流水 |
| 方案编号（表单必填） | fHandwrtten | 门店自己手写/录入的短编号，为空时报「方案编号不能为空！」 |
| 方案名称 | fCaseName | 小程序展示名 |
| 状态 | fBillState | 0 草稿 / 1 生效；删除是置 -1 的逻辑删除 |
| 开始时间 / 结束时间 | fBegDay / fEndDay | 可开团的时间窗 |
| 参团人数(人/团) | fGroupNumber | 成团门槛，>1 |
| 有效时间(小时) | fGroupHour | 开团后多久不成团自动散团 |
| 启用限购 | fIsQuota | 总开关 |
| 按活动限购 / 活动限购数 | fIsActivityQuota / fActivityQuota | 整个活动期间每人上限 |
| 按订单限购 / 订单限购数 | fIsOrderQuota / fOrderQuota | 每笔订单上限 |
| 取货开始 / 结束日期 | fDeliverBegDay / fDeliverEndDay | 到店取货窗口，可都不填、不能只填一个 |
| 参与分店 | fFilialeIDs | 空 = 所有分店 |
| 单据摘要 | fBillRemark | 摘要文字 |
| 拼团价 / 原价 | 明细表 fGroupPrice / fSaleSprice | 明细行的两个价格 |
| 制单 / 审核 | fMakeDay fMakeManID / fPostDay fPostManID fAcctMonth | 生效时由服务端写入审核时间与账期月 |
单据头在 WX_VIPGroupBillHead，明细在 WX_VIPGroupBillSheet，多级单位物料在 WX_VIPGroupInv；三张表的 fDBID / fBillID / fLineIndex 都是 varchar(30)。明细里的商品行用 fInvID 存物料 ID，它正是推广链接里的 id 参数。拼团与秒杀同表存放，用单据子类型 fBillTypeSubID 区分：0 = 拼团，1 = 秒杀；单据类型号 fBillTypeID = 613。
五、典型使用场景
场景一：新品两人团试水。 参团人数 2、有效时间 24 小时，拼团价给到 7 折，限购按活动 1 件，先在两家门店试。
场景二：门店做「50 人成团」裂变。 参团人数填 50、活动窗口拉长到一周，把推广链接发到社群里凑团；到点不成团的自动散团退款。
场景三：每周固定档期。 用「复制」把上周的团改成新一期，只动起止时间，商品和价格沿用。
六、权限控制与前置条件
- 审核/反审核受权限项**「单据生效」、「单据反审」** 控制，无权限时提示无「单据生效」权限。
- 生成推广链接需要三处配置齐全，缺失时逐条报错：「未配置微信服务地址（TWXOption.WXServiceUrl）」「未配置 AppId（TWXOption.FixedAppId 或机构微信 AppId）」「未配置机构加密密钥（Srv_Pard.fEncryptKey）」；明细未保存就点则提示「请先保存商品明细后再生成推广链接」。
- 商品能进拼团的前提同第三节：微信商品已上架 + 类别启用配送。
生效前逐项校验（按顺序检查，命中第一条就停下并弹出原文）：
| 顺序 | 拦截条件 | 提示原文 |
|---|---|---|
| 1 | 单据不是草稿 | 方案当前状态为【生效】，只有草稿可以生效 |
| 2 | 方案编号为空 | 方案编号不能为空！ |
| 3 | 方案名称为空 | 方案名称不能为空！ |
| 4 | 开始或结束日期没填 | 请先设置开始日期和结束日期 |
| 5 | 开始日期晚于结束日期 | 开始日期不能大于结束日期！ |
| 6 | 开始时刻晚于结束时刻 | 开始时间[HH:MM:SS]不能大于结束时间[HH:MM:SS]！ |
| 7 | 取货日期只填了一边 | 取货开始日期或取货结束日期不能为空！ |
| 8 | 取货开始晚于结束 | 取货开始日期不能大于取货结束日期！ |
| 9 | 参团人数 ≤1 | 参团人数必须大于1！ |
| 10 | 有效时间 ≤0 | 有效时间必须大于0！ |
| 11 | 开了按活动限购但数量≤0 | 活动限购人数必须大于0！ |
| 12 | 开了按订单限购但数量≤0 | 每单限购人数必须大于0！ |
| 13 | 「拼团商品」页签没有行 | 生效前必须添加拼团商品 |
| 14 | 某行活动价≤0 | 请输入物料[商品名]的活动价 |
保存（不是生效）时还有一条：结束日期早于开始日期 →「结束日期不能早于开始日期」。
七、常见问题
问：参团人数为什么不能填 1？ 答：填 1 就不叫拼团了，校验直接拦「参团人数必须大于1！」。想单人直购请用普通商城价或秒杀。
问：开团后一直凑不成人怎么办？ 答：超过「有效时间(小时)」仍未满员即自动散团，参团款原路退回，不用手工处理。
问：生效前为什么提示「生效前必须添加拼团商品」？ 答：明细是空的。审核时校验要求至少一行拼团商品，先加行再生效。
问：旧地址 /admin/o2o/wx_vipgroupbill/ 打不开了？ 答：旧地址 302 跳到本页，直接用新地址即可。