时段、周期与适用范围

价格配好之后，还要回答三个问题：哪家店、哪些人、什么时候。网页端把这三层收在同一个页面的 适用范围 和 时间设置 两个区域里，十三种玩法共用。这一篇讲清楚这六层圈定的规则、留空意味着什么、以及为什么「勾了却还是不生效」——绝大多数促销排查最后都落在这两个区域。

一、功能概述

圈定层	字段	留空含义
门店	参于分店	不限制分店，所有门店都参与
收款	参与的收款方式	不限制收款方式
会员	会员卡类别	不限类别，非会员也享受。类别就是 会员卡类型
会员	允许支付会员卡类别	不限制用哪类卡余额支付
会员	适用会员卡等级	不限等级（积分赠送/抵扣除外，那两种玩法必填）。等级见 会员等级
时间	开始日期 / 结束日期	见第四节，留空的活动不会下发到门店
时间	促销时段 / 时间模式 / 特定日期暂停促销	三项都是可选的加严条件，全不填即整个日期窗口内全天生效

五层范围是与的关系：勾了分店、又勾了会员等级，则必须「是这些分店里的这些等级会员」才享受。

二、界面布局说明

适用范围

五个字段都是同一个样式的多选弹窗：一个只读输入框 + 右侧下拉箭头，点开是列表，勾选确认后回填。各自的占位符写得很直白——「请选择适用分店」「请选择适用收款方式」「请选择适用会员卡类型」「请选择适用支付会员卡类型」「请选择适用会员等级」。

字段	选的是什么	什么时候用
参于分店	门店档案里的分店	门店自主活动必勾；总部统一活动可以留空
参与的收款方式	收款方式档案（现金、微信、支付宝、储值等）	只想让某种付款方式的单子享受时勾，例如「储值卡支付才打折」
会员卡类别	会员卡类型	按卡种区分活动，例如只有储值卡参与
允许支付会员卡类别	会员卡类型	和上一栏是两件事：这栏管「允许用哪些卡的余额付款」，那栏管「哪些卡的人享受优惠」
适用会员卡等级	会员等级	按等级做分层活动，例如金卡双倍积分

时间设置

四个区块，除起止日期外默认折叠，点区块右上角的 展开 打开。

开始日期 / 结束日期：两个日期框，格式 yyyy/mm/dd。结束日期的时间部分保存时固定写成 23:59:59，也就是活动跑到结束日当天打烊为止。

促销时段【仅支持平板收银】：标题上就写着只支持平板收银，传统收银机不吃这个条件。展开后有两个页签：

页签	内容
按小时	一个 反选 复选框、右上角的时间区间汇总（默认 0:00-23:59）、0–23 共 24 个整点格，点格选中
按分钟	添加时间 按钮，每加一行是「时间 至 时间 删除」，可以加多段

按小时模式下，右上角的区间汇总取选中格的最小整点到最大整点（勾 8、9、14 显示 08:00-14:59），它只是一个提示，实际下发的是你勾选的那些整点。

时间模式：三个页签 每天 / 每周 / 每月。

页签	展开内容
每天	无附加条件，日期窗口内每天都参与
每周	区块标题 促销周期，反选 + 周一到周日七个格
每月	区块标题 每月促销日期，反选 + 1 到 31 号网格

反选 是一次性动作：点一下把当前所有格整体翻转，复选框本身不会保持勾选状态。所以「先点反选、再手动补两格」是常用配法。

特定日期暂停促销：添加日期 按钮弹出日期选择，确认后以标签形式排在下方，每个标签带一个 × 号可单独删除。同一天重复添加不会生成第二个标签。

三、业务操作步骤

只做两家门店的活动

1. 新增促销方案，配好玩法。
2. 适用范围 → 参于分店 点开，勾那两家店，确认。输入框回填「已选择 2 项」。
3. 保存 → 审核。
4. 验证：另开一家门店的收银端，等快照下发后那两家改价、这家不变。

只做周三下午茶时段

1. 玩法配好后，时间设置 → 时间模式 点 每周，展开 促销周期 勾 周三。
2. 促销时段 点 展开，保持 按小时，点 14、15、16、17 四个格。
3. 起止日期给一个季度。
4. 保存 → 审核。
5. 验证：非周三、或周三 13 点下单，都不应享受。

注意：促销时段只被平板收银识别。如果门店用的是传统收银机，这一层等于没配，活动会在周三全天生效。这种情况改用「每周 + 起止日期」粗配，或者把该时段的活动单独建一张当天有效的单。

每月 1 号、15 号的会员日

1. 时间模式 点 每月，展开 每月促销日期。
2. 点 1 号、15 号两个格。
3. 起止日期给一年。
4. 保存 → 审核。

春节暂停

1. 活动本身按「每天」配，日期给一整年。
2. 特定日期暂停促销 → 添加日期，选除夕，确认；重复操作把初一到初三都加上。
3. 下方出现四个日期标签，保存 → 审核。
4. 验证：标签里的日期当天不享受，前后照旧。

精确到分钟的早市

1. 促销时段 展开，点 按分钟 页签。
2. 点 添加时间，第一行填 06:30 至 09:30。
3. 再加一行 11:30 至 13:30（午市），一行一段。
4. 保存 → 审核。

从「每周」改回「每天」

1. 打开单据 编辑，时间模式 直接点回 每天。
2. 保存 → 审核。

模式决定周期条件是否生效，切回「每天」就把周期条件关掉了。只是把周一到周日全取消勾选，并不会清掉数据库里的旧周期值，反审核再进来时旧值还在。

四、字段详细说明

界面区块	落库位置	说明
参于分店	fFilialeList	分店 ID 串，前后带逗号存储
参与的收款方式	fPayModeIDs	收款方式 ID 串
会员卡类别	fVipTypeList	会员卡类型 ID 串
允许支付会员卡类别	fPayVipTypeIDs	会员卡类型 ID 串
适用会员卡等级	fVipLevelList	会员等级 ID 串
开始日期 / 结束日期	fBegDay / fEndDay	结束日期时间部分固定 23:59:59
促销时段	fEffectTimeSlotEx	JSON，含整点数组、时间段数组、当前页签
每周促销日	fEffectTimeEx	星期位掩码（周一 = 第 1 位）
每月促销日	fEffectDateEx	日期位掩码（1 号 = 第 1 位）
时间模式=每周	fIsUseEffectTimeEx	由页签自动置位，界面上没有独立复选框
时间模式=每月	fIsUseEffectDateEx	同上
特定日期暂停促销	fExcludeDates	JSON 日期数组，格式 YYYYMMDD

几条硬口径：

• 起止日期是活动能否下发的第一道闸。快照只取「开始日期 ≤ 当前时间 ≤ 结束日期」的已审核单据，日期空的单不会被取到。
• 五个范围字段留空 = 不限制，不是「谁都不给」。这是最容易理解反的一层。
• 促销时段、每周、每月、暂停日期都是加严条件，它们只会把活动范围缩小，不会扩大。
• 反审核再编辑保存时，日期、周期、时段、暂停日期这几项留空会保留数据库原值，不会静默清空。要真的改掉，就在界面上改成一个新值再保存。

五、典型使用场景

总部活动 + 门店豁免

背景：全场折扣总部统一做，但机场店、医院店价格体系不同，不参与。 操作路径：参于分店 点开，全选后取消那两家例外门店 → 保存 → 审核。 多选弹窗支持反选，比一家家勾快。

现烤时段只给平板收银

背景：下午 3–5 点现烤出炉，只在有平板收银的旗舰店做。 操作路径：参于分店 勾旗舰店 → 促销时段 按小时勾 15、16、17 → 时间模式 保持每天 → 起止日期给一个季度 → 特定日期暂停促销 加店休与节假日 → 审核。

储值会员专属折扣

背景：只希望用储值卡结算的客人享受折扣，同时限制只能用储值卡付款。 操作路径：会员卡类别 勾「储值卡」（决定谁能享受）+ 允许支付会员卡类别 勾「储值卡」（决定允许怎么付）+ 参与的收款方式 勾「储值卡」→ 保存 → 审核。 三栏名字像，管的是三件事，配之前先想清楚要卡哪一层。

六、权限控制与前置条件

• 分店资料、收款方式、会员卡类别与等级必须先维护好，五个选择器才有内容可选。
• 需要「促销管理 → 促销方案」菜单权限与窗口编辑权限。
• 促销时段仅平板收银识别；传统收银机请以日期 + 周期为准。
• 列表页按单据日期查询时最多查 31 天、且只能查一年内的数据，做历史活动复盘要用日期分段查。

七、常见问题

分店没勾，活动却在所有店生效了。 这是设计如此：留空 = 不限制分店。门店专属活动必须显式勾选门店。

勾了分店，那家店还是不生效。 按顺序查：单据是否「已生效」→ 当前时间是否在起止日期内 → 该商品是否真的落在商品范围里 → 会员卡类别/等级是否把客人挡在外面 → 收银端是否已拉到新快照（约十分钟一次）。

促销时段设了 14–17 点，门店全天都在打折。 先看门店用的是不是传统收银机——这一栏标题写着【仅支持平板收银】。其次确认 时间模式 与 特定日期暂停促销 没有互相矛盾的配置。

取消勾选所有星期后保存，周期条件还在。 周期是否生效由 时间模式 决定，不由格子的勾选状态决定。要变成每天，点回 每天 页签再保存。

「反选」点完复选框自己弹回去了。 正常。反选是一次性翻转动作，不是持久状态。

暂停日期加了却没效果。 检查日期标签是否真的是活动窗口内的日子（暂停一个不在窗口内的日期不会有任何变化），以及单据在加完日期后有没有重新保存、审核。

同一个时间段能不能配两段？ 可以，但要用 按分钟 页签，一段一行。按小时 页签是整点格，跨小时的连续段用格子多选即可。