在线促销

在线促销是只作用于线上渠道的特价与折扣：同一个商品，门店收银价照旧，小程序商城里按这一页配的方案卖特价或打折。方案生效后在起止日期内自动对线上生效，过了结束日期自动不再命中。

一、功能概述

菜单位置：O2O业务 → 商城活动 → 在线促销（页面地址 /admin/o2o/wxonlinepromotion/）

用途	说明
给线上商品定特价	逐商品指定特价金额，低于原价卖出
给线上商品定折扣	逐商品按折扣率打折
圈适用分店	方案只对勾选的分店生效，不勾即全部分店
圈收款方式	只对指定收款方式生效（线上相关的收款方式）
定时投放	开始/结束日期精确到时分，还有附加时间条件与排除日期

在线促销与促销管理里的门店促销同库不同类：它借用促销单据表，但强制打上「线上单据」标记与独立的子类型，所以门店收银不会误命中线上方案，反之亦然。

二、界面布局说明

区域	内容
工具栏	搜索、增加、删除，上方状态条显示「选中了 N 个中的 M 个」
列表	行号、单据号、单据日期、方案名称、开始日期、结束日期、中止标志、单据状态、制单人、参于分店
侧栏筛选	单据状态、单据日期两组
搜索框	支持按单据号、手写编号、方案名称、参于分店模糊搜

单据号形如 Psp261023000003：前缀 + 六位日期（YYMMDD）+ 六位流水，前缀由租户的单号规则配置决定，可按实际配置调整。

列表有两条硬限制：一次最多查 31 天的跨度，且只能查最近 365 天内的方案。

点「增加」先选玩法

「增加」不是直接进单，而是弹出「新增在线促销」窗口，分组标题「单品促销」，两张卡片各带一个「应用」按钮：

卡片	说明	进去以后
特价	为商品指定特价金额	促销价列标题是「特价(元)」
折扣	为商品指定折扣率	促销价列标题是「折扣率(%)」

窗口支持右上角 × 、Esc、点遮罩关闭。在线促销只有这两种玩法，门店促销里的量贩、买赠、换购等在这里不出现。

三、业务操作步骤

步骤 1：建单

点「增加」→ 选「特价」或「折扣」→ 进入单据编辑页。填基本信息：

字段	说明
单据编号	系统自动取号，只读
手写编号/方案号	手工编的活动代号，可空
方案名称	建议写「10月现烤8折」这种能被认出来的名字
单据日期	默认当天

步骤 2：圈范围

字段	怎么填
适用分店	点选择器多选分店；一个都不选就是全部分店（列表「参于分店」列显示 -999999999）
适用收款方式	多选收款方式，限定只有哪些支付方式能享受

⚠ 在线促销没有「参与会员等级」「会员类型」这类会员条件——那是门店促销的能力。线上方案对所有进店的人一视同仁。

步骤 3：定时间

字段	说明
开始日期 / 结束日期	精确到时分，必填
中止标志	临时叫停活动的标记
附加时间条件	例如只在每周几、每天的某个时段生效
排除日期	从区间里剔掉的具体日期（如节日不参与活动）

步骤 4：填促销商品

页面下方「促销规则」→「具体玩法」固定是所选的特价或折扣。在「促销商品明细」里加商品：

• 「搜索商品」：弹窗按商品编码/名称/拼音码挑，一次可多选。
• 「导入Excel」：按模板批量灌商品与促销价。

明细表列：复选框、商品编码、商品名称、单位、原价、特价(元) 或 折扣率(%)、操作。底部有「删除选中」和一行汇总：「已选 N 个商品，原价总额¥X，促销后总额¥Y，让利¥Z」——让利金额是实时算给使用者看的，填价时就能看出这个活动让掉多少。

可选的商品有前置条件：微信商城里已上架、且所属分类启用了上传网店，所以做线上促销前先把网店商品 的上架状态配好。

步骤 5：保存与审核

保存走单据表单提交。生效后要过一串校验，任一不满足就报对应文案：

报错	原因
审核失败：开始日期和结束日期不能为空	时间没填
审核失败：开始日期(2026-10-28)不能晚于结束日期(2026-10-20)	时间倒挂
特价促销必须添加至少一个商品 / 折扣促销必须添加至少一个商品	明细是空的
商品特价必须>0	特价填了 0 或负数
折扣率必须在0.01-100之间	折扣率越界
特价明细数据丢失，请重新保存 / 折扣明细数据丢失，请重新保存	页面与后端明细不同步，重新保存一次
商品ID无效 / 商品数据校验失败	商品已下架或被删除

审核成功后单据状态从「草稿」变「已生效」；反审核可退回草稿再改。

四、字段详细说明

界面字段	落库字段	含义
单据号	fbillno	促销单头表主单号
单据日期	fbillday	列表按 %Y-%m-%d 显示，无值显示 -
方案名称	fcasename	活动名
开始日期 / 结束日期	fbegday / fendday	生效区间
中止标志	fstopsign	列表显示 是/否
单据状态	fbillstate	草稿 / 已审核 / 删除
制单人	fmakemanid	列表显示的是用户名
参于分店	ffilialelist	分店 ID 串；-999999999 代表全部分店
适用收款方式	fpaymodeids	收款方式 ID 串
附加时间条件	feffecttimeex	更细的时间限制
排除日期	fexcludedates	区间内不生效的日期
手写编号	fhandwrtten	自定活动代号
备注	fautoremark / fbillremark / ffollowbillno	自动摘要、手工备注、关联单号

数据落在促销主表 Pos_SpeciallySpriceHead 与明细表 Pos_SpeciallySpriceSheet，在线方案靠两个标记与门店方案区分：线上单据标记与独立的促销子类型；这两个值由系统每次保存时强制写入，不需要也不要手工配。明细里单品行的行类型为 0。

五、典型使用场景

场景一：线上专享价，不动门店价。 门店收银 68 元，小程序卖 58 元。建一条特价方案，商品填进去，促销价 58，适用分店全选，起止日期设活动期。门店 POS 不受影响。

场景二：只在工作日午间打折。 折扣方案 + 「附加时间条件」限定周一到周五 11:00–14:00，「排除日期」剔掉节假日。

场景三：活动临时叫停。 已生效的方案不必反审核，勾「中止标志」审核后线上立即不再命中，历史数据仍在，恢复只需把标志去掉。

场景四：算让利。 明细底部汇总行直接给出「让利¥X」，做活动预算审批时截图即可用。

六、权限控制与前置条件

• 在线促销走促销单据权限：单据页的「审核」「反审核」分别要求单据生效、单据反审权限，没有权限时按钮置灰并提示「无「单据生效」权限」。
• 前置条件：
  1. 商品已在网店商品 上架，且其分类启用了上传网店；
  2. 分店已标记为微商城门店；
  3. 需要限定支付方式时，先在基础设置里把线上收款方式配好。
• 促销方案对小程序端的生效不是本页直接推送的：新增弹窗上写的是「应用成功后，十分钟内自动同步到门店」，同步由后台作业完成，本页没有手动推送按钮。

七、常见问题

问：为什么在线促销里没有买赠、换购、第二件半价？ 答：线上只支持特价与折扣两种玩法，其余玩法属于门店促销。

问：为什么有的商品搜不到？ 答：商品搜索器只列「微信商品已上架 + 分类启用上传网店」的商品，先到网店商品 把这两处打开。

问：改了方案为什么小程序上价格没变？ 答：先看方案是否已审核生效、当前时间是否落在起止区间内、有没有被「排除日期/附加时间条件」挡掉；再看是否已到同步时间。

问：提示「特价明细数据丢失，请重新保存」怎么办？ 答：这是页面明细与后端不同步导致，重新点「搜索商品」把商品加回来再保存即可；反复出现说明商品中途被下架，按提示的「商品ID无效」处理。

问：能不能只让某几家店参加线上促销？ 答：可以，「适用分店」里只勾这几家；不勾任何分店等于全部分店。