积分赠送与积分抵扣
这两个玩法不改商品价格，改的是积分：积分赠送在结账时按消费额多送积分，积分抵扣允许客人用积分抵掉一部分现金。它们是十三种玩法里唯二强制要求选 适用会员卡等级 的——积分只属于会员，所以这两张单天然就是会员活动。烘焙门店做「会员日双倍积分」「100 积分抵 5 元」「生日蛋糕积分换购」都出自这一篇。
一、功能概述
| 对比项 | 积分赠送 | 积分抵扣 |
|---|---|---|
| 卡片提示语 | 消费赠送积分 | 积分抵扣现金 |
| 干什么 | 命中范围内的消费，按倍率多送积分 | 命中范围内的消费，可用积分抵一部分金额 |
| 每条包含条件的规则值 | 积分比例 一个输入框 | 扣减积分 + 特价类型 + 特价/折扣 三个控件 |
| 商品范围支持全场 | 支持 | 支持 |
| 适用会员卡等级 | 必填 | 必填 |
| 典型活动 | 会员日双倍积分、新品类多倍积分 | 积分抵现、积分 + 现金换购 |
两个玩法都是会员侧的优惠，配之前先确认会员体系里的积分规则已经跑通：这两张单只负责「哪些商品按什么比例给分／抵分」，账户里积分的加减由收银端和会员模块完成。
二、界面布局说明
共同部分
| 元素 | 内容 |
|---|---|
| 具体玩法 | 下拉切 积分赠送 / 积分抵扣，切换后规则区提示语和条件行的输入框一起变 |
| 包含条件 | 点 + 添加包含条件；类型可选 全场 / 类别 / 单品——这两个玩法是支持「全场」的少数玩法之一 |
| 排除条件 | 点 + 添加排除条件；类型固定为 单品，只能剔具体商品 |
| 覆盖商品数 | 没加包含条件时显示 --（尚未设置包含条件） |
| 规则区提示 | 积分赠送：「积分赠送规则 / 每个包含条件可设置独立的积分比例。需要不同值时请添加新的分组。」 积分抵扣：「积分抵扣规则 / 每个包含条件可设置独立的抵扣积分、特价类型、特价/折扣。需要不同值时请添加新的分组。」 |
这两段提示语把这两个玩法的结构说清楚了：规则不是配在单据上的，是配在每一条包含条件上的。想给不同商品组不同倍率，就多建几条包含条件，各填各的值。
包含条件行上的积分控件
加了包含条件、选好商品之后，每一行的末尾会自动多出输入框（排除条件行没有）：
| 玩法 | 行内控件 | 提示语/占位符 | 口径 |
|---|---|---|---|
| 积分赠送 | 积分比例 | 占位符「如 1.5」 | 小数，最小 0；填 0 表示这一组不积分 |
| 积分抵扣 | 扣减积分 | 占位符「如 100」 | 最小 1，客人必须付出积分 |
| 积分抵扣 | 特价类型 | 下拉两值：折扣 / 特价 | 决定右边出现哪一栏 |
| 积分抵扣 | 特价（类型=特价时出现） | 占位符「特价金额」 | 金额，最小 0.01 |
| 积分抵扣 | 折扣(%)（类型=折扣时出现） | 占位符「如 80」 | 0–100 |
切换 特价类型 时，界面会把另一栏的值清零——「折扣」和「特价」是二选一，不会同时生效。
三、业务操作步骤
配「会员日全场双倍积分」
- 促销管理 → 促销方案 → 增加，「单品促销」组点 积分赠送 卡片的 应用。
- 填 方案名称，例如「每周三会员日双倍积分」。
- 商品范围 → 包含条件 点 + 添加包含条件，类型选 全场。
- 该行末尾的 积分比例 填
2。 - 适用范围 → 适用会员卡等级 勾参与活动的等级（这一栏不填保存不了，见第四节）。
- 时间设置 → 时间模式 选「每周」，勾周三。
- 保存 → 审核。
配「不同商品组不同倍率」
- 新增 → 积分赠送。
- 第一条包含条件：类型 类别，勾「面包」，积分比例 填
1。 - 点 + 添加包含条件 加第二条：类型 类别，勾「饮品」，积分比例 填
3。 - 想排除某几款不参与，用 排除条件 剔单品。
- 补齐会员等级、分店、日期，保存 → 审核。
不能在一条包含条件里给两个分类填不同倍率——一条只有一个比例值。这正是规则区那句「需要不同值时请添加新的分组」的意思。
配「100 积分抵 5 元」
- 新增 → 积分抵扣。
- 包含条件 类型 全场（或指定类别）。
- 行内 扣减积分 填
100。 - 特价类型 选 折扣，右侧 折扣(%) 填
5。 - 适用会员卡等级 勾等级，配分店与日期，保存 → 审核。
⚠️ 第 4 步这一栏有个界面与后端口径不一致的地方，务必看完第六节再上线：栏目标签写的是「折扣(%)」，而后端对它的校验文案是「纯抵扣/折扣模式必须设置积分抵扣金额>=0.01元」，一个按百分比解释、一个按金额解释。先在一家店下一单实测，看收银端到底按哪种口径扣钱，再全站推广。
配「积分 + 现金换购指定商品」
- 新增 → 积分抵扣。
- 包含条件 类型 单品，选要换购的商品（例如生日蛋糕小号）。
- 扣减积分 填
500，特价类型 选 特价，特价 填99。 - 含义：这一组商品用 500 积分 + 99 元成交。
- 补会员等级、分店、日期，保存 → 审核。
特价模式要求 特价金额 >= 0.01，也就是说纯积分、0 元带走在这一玩法里配不出来；要做真免费送，走买赠促销。
四、字段详细说明
| 字段 | 所属玩法 | 校验 |
|---|---|---|
| 包含条件 | 两者 | 至少一条；类型选类别/单品时必须真的选到商品或分类 |
| 包含条件 → 全场 | 两者 | 支持，不必把所有分类勾一遍 |
| 排除条件 | 两者 | 只支持单品；排除行不参与积分计算 |
积分比例 (scoreRate) | 积分赠送 | >= 0，0 表示不积分 |
扣减积分 (scoreDeduct) | 积分抵扣 | >= 1，消费者必须支付积分 |
特价类型 (specialType) | 积分抵扣 | 界面两值：折扣 / 特价 |
折扣(%) (discount) | 积分抵扣（类型=折扣） | >= 0.01 |
特价 (specialPrice) | 积分抵扣（类型=特价） | >= 0.01 |
| 适用会员卡等级 | 两者 | 保存时即校验，留空直接报错回表单页 |
完整校验提示：
| 提示 | 触发条件 |
|---|---|
| 积分赠送必须选择参与会员等级 | 积分赠送单没选 适用会员卡等级 就点保存 |
| 积分抵扣必须选择参与会员等级 | 同上，积分抵扣单 |
| 积分赠送必须设置商品范围 | 包含条件为空 |
| 积分抵扣必须设置商品范围 | 包含条件为空 |
| 商品范围包含条件必须选择商品/分类 | 类型选了类别/单品却没选内容 |
| 积分赠送率必须>=0（0表示不积分） | 积分比例填了负数 |
| 积分赠送明细数据丢失，请重新保存 | 明细未落库，重存一次 |
| 积分抵扣明细数据丢失，请重新保存 | 同上 |
| 积分抵扣金额必须是数字 | 折扣栏填了非数字 |
| 扣减积分必须>=1（消费者必须支付积分） | 扣减积分填 0 或空 |
| 纯抵扣/折扣模式必须设置积分抵扣金额>=0.01元 | 类型=折扣，折扣栏为空或 0 |
| 特价模式必须设置特价金额>=0.01元 | 类型=特价，特价栏为空或 0 |
| 特价类型无效（0=纯抵扣，1=特价，2=折扣） | 传入的类型码不在 0/1/2 内 |
五、典型使用场景
新品类拉首购：饮品三倍积分
背景：新上现磨饮品线，希望会员多试。 操作路径：积分赠送 → 包含条件一 类别=面包 比例 1 → 包含条件二 类别=饮品 比例 3 → 适用会员卡等级勾全部等级 → 起止日期给一个月 → 审核。 到期把饮品那条改回 1 或整单关闭，比改价格温和，也不会影响毛利口径。
沉睡会员唤醒：生日当月积分翻倍
背景：生日蛋糕客单高，希望把会员生日月的消费锁在店里。 操作路径：积分赠送 → 包含条件 类型 全场 → 积分比例 2 → 适用会员卡等级只勾储值卡等级 → 时间设置 给一个自然月 → 审核。 「生日当月」这个条件促销端没有对应字段，实际做法是给整月配活动，由会员模块的生日券配合。
积分消化：年底积分抵现
背景：账户里沉淀积分太多，年底做一次抵现清一波。 操作路径：积分抵扣 → 包含条件 类型 全场 → 扣减积分 100 → 特价类型 折扣、值按实测口径填 → 适用会员卡等级勾全部 → 参于分店 勾参与门店 → 日期给一周 → 审核。 先小范围一家店试，确认收银端按预期扣积分、扣金额，再放开分店。
六、权限控制与前置条件
- 需要「促销管理 → 促销方案」菜单权限与窗口编辑权限。
- 必须先有会员体系数据：会员卡类型、会员等级、积分规则。适用会员卡等级是这两个玩法的硬前置，留空保存不了。等级和卡类别是两层东西——等级决定「谁参与」，卡类型决定「积分率等执行数值」，见 会员管理。
- 商品分类必须已维护，否则包含条件只能逐个挑单品。
- 这两个玩法支持包含条件选「全场」，做全店积分活动不需要把所有分类勾一遍。
- 实际加多少分、抵多少钱、一个会员一天能抵几次，都由收银端按下发的快照计算，配置端只负责把规则发下去。上线前请在门店实测一单。
- 只有网页端创建的单据能回网页端再编辑。
七、常见问题
点保存提示「积分赠送必须选择参与会员等级」。 这两个玩法的会员等级是保存时就校验的，不是审核时才报。到 适用范围 → 适用会员卡等级 里勾上等级再保存。注意它和 会员卡类别 是两栏，报错指的是「等级」。
「积分比例」到底填 2 还是填 200？ 界面这一栏的占位符是「如 1.5」，按倍率口径读就是「消费 1 元得 1.5 积分」；同一玩法另一处输入提示写作「积分比例(%)」。校验本身只要求 >= 0，两种填法都能存。先在门店按 2 下一单看实际得分，确认口径后再批量配。这是本篇最需要实测的一个字段。
「折扣(%)」那一栏填 5，门店抵了 5% 还是 5 元？ 未知——界面标签是百分比，后端校验文案把它称作「积分抵扣金额>=0.01元」，两边口径不一致。按第五节的做法先单店实测，实测结论稳定前不要在全部门店开这个玩法。
排除条件里的商品为什么还在送积分？ 排除行只写「这个商品不参与范围」，积分字段一律按 0 落库。若排除没生效，先确认单据已审核、日期在窗口内、分店勾对了，再看收银端是否拉到了新快照（约十分钟同步一次）。
积分比例填 0 是什么意思？ 校验提示写得很明确：「0 表示不积分」。用它可以在一条全场单里挖出「某些分类不给分」的口子——全场比例给 1，再补一条包含条件给那些分类填 0。
积分赠送和积分抵扣能不能同时开？ 配置端不做跨单查重，两张都能审核生效。同一张票里既送分又抵分时谁先算、算完的基数是多少，属于收银端逻辑，上线前请在门店实测。稳妥做法：同一批商品同一时段只开其中一个。