促销总览与新增方案
网页端促销不是「一张折扣单」，而是一个配置器 + 一层下发机制：配置器把十三种玩法收进同一个「新增促销方案」页面，用「具体玩法」下拉切换各自的规则区；下发机制把审核通过、日期在窗口内、且勾选了目标分店的单据打包成促销快照给收银端。所以配促销的第一步不是填数字，而是选对玩法、圈对范围、审核生效这三件事都齐了才算配完。本篇把入口、单据结构、状态流转和同步机制讲清楚，各玩法的字段细节在后面的分篇里。
一、功能概述
后台里跟促销相关的入口有四个，写的是不同表、面向不同终端：
| 入口 | 菜单位置 | 页面地址 | 面向 |
|---|---|---|---|
| 促销方案 | 促销管理 → 促销方案 | /admin/Promotion/posspeciallyspricehead/ | 门店收银端，十三种玩法都在这里 |
| 场景营销 | 促销管理 → 场景营销 | /admin/Promotion/scenepromotion/ | 累计消费满量后赠会员礼包，独立列表 |
| 固定组合 | 促销管理 → 固定组合 | /admin/Promotion/salesetcasepage/ | 把一组商品绑成一个组合价，内容写死不让客人挑，独立列表 |
| 在线促销 | 商城活动 → 在线促销 | /admin/o2o/wxonlinepromotion/ | 微商城下单时的促销，只选已发布未下架商品 |
十三种玩法按「优惠落在谁身上」分三组，这个分组就是新增时的第一层选择：
| 分组 | 玩法 | 界面提示语 |
|---|---|---|
| 单品促销 | 特价 | 为商品指定特价金额 |
| 单品促销 | 折扣 | 为商品指定折扣率 |
| 单品促销 | 量贩特价 | 多档位批量特价 |
| 单品促销 | 积分赠送 | 消费赠送积分 |
| 单品促销 | 积分抵扣 | 积分抵扣现金 |
| 范围促销 | 全场折扣 | 为某些商品指定折扣或优惠金额 |
| 范围促销 | 满额立减 | 单笔订单满足金额立减 |
| 范围促销 | 买赠促销 | 为畅销品搭赠滞销品或赠新品 |
| 范围促销 | 换购促销 | 消费满足要求享低价换购 |
| 范围促销 | 第二件打折 | 指定商品第二件半价或享受折扣 |
| 范围促销 | 阶梯促销 | 单笔订单按梯度金额或数量享受优惠 |
| 套餐促销 | 套餐促销 | 组合对应商品享受套餐活动价 |
| 独立入口 | 场景营销 | 在「场景营销」列表里新增，也可在促销方案的玩法下拉中查看 |
促销方案列表只列促销方案的单据，场景营销（子类型 10）和在线促销被排除在外，各自有自己的列表页；不要在促销方案列表里找场景营销的单。
二、界面布局说明
促销方案列表
| 区域 | 内容 |
|---|---|
| 查询条 | 关键字框（提示「搜索单据号,方案名称,单据…」）、单据状态 下拉、单据日期 起止、蓝色 搜索 |
| 工具栏 | 蓝色 增加、红色 删除，右侧显示「选中了 N 个中的 M 个」 |
| 列表 | 序号 / 单据号 / 单据日期 / 方案名称 / 开始日期 / 结束日期 / 中止标志 / 单据状态 / 制单人 |
| 分页 | 「共 N 条」+ 页码 + 前往页 |
列表里 中止标志 只有「是/否」，它是明细行上的历史标志位，网页端没有提供中止按钮，要停一张促销用「反审核」或直接把结束日期改到昨天。
新增促销：先选玩法
点 增加 先弹这张「新增促销」窗。标题下那行红字星号说明就是整个模块的下发口径：
促销类型 * （应用成功后，十分钟内自动同步到门店）
每张卡片右侧一个 应用 按钮。点 应用 后进入「新增促销方案」页，具体玩法 已经填好刚选的那一种，不用再选一遍。想换玩法，直接改这个下拉，下面的规则区会整块重画——但已填的商品范围会保留，切玩法前先想清楚。
新增促销方案：四大区域
| 区域 | 内容 | 说明 |
|---|---|---|
| 基本信息 | 方案名称 | 单行文本。名称会出现在收银端小票和促销快照里，写清楚「什么活动、什么力度」 |
| 促销规则 | 具体玩法 下拉 + 玩法专属区 | 十三种玩法各自的字段，见后面的分篇 |
| 适用范围 | 参于分店 / 参与的收款方式 / 会员卡类别 / 允许支付会员卡类别 / 适用会员卡等级 | 五个都是多选弹窗，留空即不限制 |
| 时间设置 | 开始日期 / 结束日期 / 促销时段 / 时间模式 / 特定日期暂停促销 | 后三项默认折叠，点右侧 展开 |
工具栏按状态变：新增时 是 返回 / 保存 / 复制 / 删除；已生效单据进编辑态 后多出 审核 / 反审核。详细规则见 40单据窗口通用操作。
三、业务操作步骤
配一张促销的完整链路
- 促销管理 → 促销方案，点 增加。
- 在弹窗里选玩法点 应用。页面标题变成「新增促销方案」，具体玩法 已填好。
- 填 方案名称。
- 在 促销规则 区加商品或设条件。单品类玩法用 搜索商品 / 导入Excel 往明细表里加行，再逐行填优惠值；范围类玩法点 + 添加包含条件，选「类别」或「单品」后在弹窗里多选，覆盖商品数 会跟着变成实际件数。
- 在 适用范围 里圈分店。不选分店等于不限制分店——总部统一活动可以留空，门店自主活动务必只勾那几家，否则会把别的店一起改了价。
- 在 时间设置 里填 开始日期 和 结束日期。结束日期保存时会被强制补到当天
23:59:59，也就是说活动跑到结束日当天打烊为止。 - 点 保存。列表出现这张单，单据状态 是「草稿」。
- 回列表打开这张单，点 编辑 → 审核。校验通过后状态翻成「已生效」。
- 等十分钟。收银端按下发周期拉促销快照，新单进入快照后门店开始按活动价结账。
提前结束一张促销
反审核 是唯一的收口动作：单据回到「草稿」，从下一份促销快照里消失。改结束日期也行，但要等门店拉到新快照，急停用反审核。
复制一张历史活动
在已生效单据上点 编辑 → 复制，得到一张同规则的新草稿单，改日期和分店后重新审核。这是做「每月一次会员日」最省事的路径，比从头配一遍快得多。
批量删除
列表勾选多张单点 删除，只有草稿状态的单据会被删掉，其余跳过并提示跳过了几条。已生效的单要先反审核才能删。
四、字段详细说明
单据状态
| 状态 | 含义 | 能做什么 |
|---|---|---|
| 草稿 | 已保存未审核 | 编辑、审核、删除 |
| 已生效 | 审核通过，进入下发范围 | 编辑（需先点编辑）、反审核 |
| 已关闭 | 单据关闭 | 只读 |
| 待确认 | 走审批流的中间态 | 只读 |
「进入下发范围」还要同时满足：当前日期在开始与结束日期之间、中止标志未置位、不是在线促销单。状态是「已生效」但日期还没到，门店同样不会生效——这是「明明审核了却没活动」的常见原因之一。
优先级
单据上有一个 优先级 字段（fPriorityLevel）。促销快照在打包时按「优先级降序、审核日期降序」排序，也就是说优先级高的单据排在快照前面。收银端如何按这个顺序取舍优惠属于收银端逻辑，配置端能控制的只是这个排序输入。
审核时的硬校验
审核不是走个形式，会逐玩法检查规则区是否填全。通用两条：
| 提示 | 触发条件 |
|---|---|
| 审核失败：开始日期和结束日期不能为空 | 两个日期任一个没填 |
| 审核失败：开始日期(X)不能晚于结束日期(Y) | 日期填反了 |
玩法专属的校验（例如「特价促销必须添加至少一个商品」「积分抵扣必须选择参与会员等级」）在各玩法分篇的「常见问题」里逐条列出。
五、典型使用场景
总部配一个全网活动，只排除两家新店
背景：新店还在磨合期，不参与价格战。 操作路径：促销方案 → 新增 → 全场折扣 → 商品范围选「类别=面包」→ 适用范围的分店选择器里勾全部门店再取消两家新店 → 填日期 → 保存 → 审核。
给一家门店配一个只跑周末早上的活动
背景：社区店周末早上客流集中，想限时让利拉新。 操作路径：新增 → 特价 → 搜索商品加三款引流品 → 适用范围只勾这家分店 → 时间设置里 促销时段 按小时勾 7–11 点、时间模式 选「每周」勾周六周日 → 保存 → 审核。注意 促销时段 标题上写着「仅支持平板收银」，传统收银机不认这个条件。
去年的活动原样再跑一次
背景：中秋月饼礼盒每年配置一样，只换日期。 操作路径：促销方案列表找到去年的单 → 编辑 → 复制 → 改方案名称的年份和起止日期 → 保存 → 审核。
六、权限控制与前置条件
- 菜单权限：需要「促销管理 → 促销方案」的菜单权限；打开后能点哪些按钮由窗口权限控制，删除、导出数据单独勾。查看别人建的单需要「允许查看他人单据」。配法见 20角色管理。
- 前置数据：分店资料、收款方式、会员卡类别与等级、商品与商品分类必须先维护好，适用范围和商品范围的选择器才有内容可选。
- 商品单位：单品选择器只列 基础单位 的商品，多单位商品要先在商品资料里定好基础单位。
- 只有网页端建的单能在网页端再编辑。打开一张客户端 ERP 建的单，会提示「单据 XXX 不是由 WEB 平台创建，无法在 WEB 端编辑。请使用原 ERP 系统打开。」并退回上一页。
七、常见问题
打开单据被弹回列表，提示不是由 WEB 平台创建。 原因：这张单是客户端 ERP 保存的，网页端只允许编辑自己建的那批。 处理：在网页端点 增加 重配一张；或回客户端 ERP 改原单。需要留在网页端维护，就用复制功能生成一张网页端新单。
审核了，门店说没有活动。 按这个顺序查：单据状态是不是「已生效」→ 当前日期在不在起止日期内 → 适用范围的分店有没有勾到这家店 → 商品范围有没有真的覆盖到那个商品（覆盖商品数 显示 -- 就是还没设包含条件）→ 收银端有没有拉到新快照（等十分钟再试）。
保存成功但审核报「必须添加至少一个商品」。 原因：单品类玩法的商品明细表是空的，光选了玩法没加行。 处理：用 搜索商品 逐个加，或 导入Excel 批量加，看到表格里有行再审核。
结束日期填了当天，活动当天中午就没了。 原因：不存在。结束日期在保存时会被补到 23:59:59，当天全天有效。如果确实提前没了，查 特定日期暂停促销 里是不是把当天加进去了，或 时间模式 选了「每周」却没勾当天的星期。
列表里找不到刚建的场景营销单。 原因：促销方案列表把场景营销子类型排除了。 处理：去 促销管理 → 场景营销 看，见 94场景营销。
想停掉一张促销但找不到中止按钮。 原因：网页端没有中止操作，中止标志 只是明细上的一个只读标志位。 处理：用 反审核 让单据回到草稿，或把结束日期改到昨天后重新审核。