营销活动业务逻辑梳理

更新日期：2026-05-22。

本文基于后端 WinTradeCloudService 的营销相关代码梳理，主要覆盖 wt-market、wt-business、wt-user、wt-client、wt-admin 和 wt-quartz 中的营销逻辑。它偏业务阅读，帮助先理解平台、商户和用户分别能做什么，以及优惠在订单里如何真正生效。

一句话结论

当前后端营销中心支持的主线是：平台活动、商户活动、平台券、商户券、平台活动价、商户活动价、活动范围、预算池、成本分摊、补贴确认和活动归档。

代码里没有看到独立的秒杀、拼团、团购、满赠、包邮券等专门活动模型。现有“活动”更像一个营销方案容器，里面可以挂优惠券或活动价，再通过店铺、SKU、预算和使用策略控制生效。

后端支持哪些营销活动

核心业务对象

营销中心不是单表逻辑，而是一组对象组合。

平台可以做什么

平台管理员通过 /api/v1/marketing/admin 维护平台侧营销。

1. 通过平台活动配置向导创建平台活动，填写活动名称、编码、开始时间、结束时间、说明和 1:1、16:9、2:1 三张主宣传图。
2. 按需手工补录活动范围，可以绑定参与店铺和参与 SKU；标准流程也可以等商户报名审核通过后自动生成范围。
3. 配置展示资源，Banner 和广告位可以关联平台营销活动。
4. 配置平台优惠券，包括券组、券定义、用券策略、策略目标和券池。
5. 配置平台活动价，指定商户、店铺、SPU 或 SKU，设置活动价或折扣。
6. 配置预算池，支持充值、人工调账、冻结、解冻、剩余预算退回和结算后调整。
7. 查看发券记录、用券记录、分摊记录、活动价分摊、成本日报和补贴记录。
8. 批量邀请商户报名，审核商户提交的参与记录，审核通过后自动补齐平台活动参与店铺和 SKU。
9. 推进活动状态，包括启动、暂停、恢复、结束、关闭未使用钱包券、结算归档和取消。

平台活动适合做全站活动、跨店活动、指定店铺活动、指定 SKU 活动和平台补贴类活动。

商铺店家可以做什么

商户通过 /api/v1/merchant/marketing 维护自己的店铺营销。Controller 会按当前商户账号补齐或校验 merchantAccountId，避免操作其他商户数据。

1. 创建商户活动，绑定自己的商户账号和店铺。
2. 配置商户活动范围，可以绑定本店店铺范围和 SKU 范围。
3. 创建商户优惠券组、优惠券、用券策略、策略目标和券池。
4. 向用户发放商户券，也可以让用户主动领取商户券。
5. 创建商户活动价，让本店商品直接命中活动价。
6. 配置商户预算池，商户预存预算可以从商户钱包充值。
7. 查看本商户的发券、用券、分摊、预算流水、成本日报和补贴推进记录。
8. 对平台活动价中由商户承担的成本进行确认。

商户活动适合做店铺满减券、店铺立减券、店铺折扣券、指定商品券、指定 SKU 活动价和店铺自补贴活动。

商户如何参与平台活动

后端存在 PlatformMarketingActivityParticipation 参与关系，状态包括 INVITED、APPLIED、APPROVED、REJECTED、WITHDRAWN、REMOVED。当前 Controller 已经暴露平台邀请、商户报名、平台审核通过和拒绝的主要动作。

平台活动如果要让某个商户活动承接成本或范围，建议按下面流程操作：

1. 平台通过 营销中心 / 平台营销活动配置向导 创建平台活动，并通过 /platform/activity-participation/invite/batch 批量邀请目标商户店铺。
2. 邀请记录里的报名页面地址使用 /merchant-marketing/platform-activity-apply-workflow。
3. 商户通过 商户营销 / 平台活动报名向导 选择 INVITED 平台活动。
4. 商户在向导中创建新的商户活动，或选择已有商户活动；创建商户活动时会关联 platformActivityId。
5. 商户选择本店参与平台活动的 SKU 后，通过 /platform/activity-participation/apply 提交报名，报名必须包含 SKU。
6. 平台通过 /platform/activity-participation/{participationId}/approve 审核通过，系统会自动把商户店铺和报名 SKU 写入平台活动范围。
7. 平台活动范围和商户活动范围会共同校验，店铺和 SKU 必须同时匹配。
8. 如果平台活动价成本由商户承担，还需要商户创建平台活动价成本确认记录。

需要注意：WITHDRAWN 和 REMOVED 状态已在枚举中存在，但当前显式接口主要覆盖邀请、报名、通过和拒绝，退出和移除仍需要结合后续运营需求确认是否补接口。

活动状态规则

平台活动和商户活动共用一套状态。

不同业务动作对活动状态的要求不同。

活动范围规则

活动范围有两层。

1. 活动级范围：平台活动或商户活动可以配置参与店铺和参与 SKU。
2. 优惠券使用范围：优惠券策略可以配置 ALL、SHOP、SPU、SKU 或预留的 CATEGORY。

后端的实际判断是交集逻辑。

配置侧需要注意：

• 平台活动不再要求先手工配置店铺范围和 SKU 范围才能邀请商户。
• 商户报名审核通过后，会把报名店铺和 SKU 自动写入平台活动范围。
• 发布前至少需要存在审核通过报名生成的 SKU 范围，或平台已经手工补录有效 SKU 范围。
• 商户报名不能用空 SKU 表示整店参加。

优惠券规则

当前支持三类券。

优惠券还有这些关键规则：

活动价规则

活动价会在商品当前价格计算时生效，发生在优惠券之前。

匹配活动价时，后端会校验这些条件：

1. 策略已审核通过。
2. 策略、活动维度和人工开关都启用。
3. 币种必须是 CNY。
4. 商品命中指定 SPU 或 SKU。
5. 数量满足最小和最大购买数量。
6. 当前时间在策略生效时间内。
7. 活动本身处于活动价可用状态。
8. 商品命中活动范围。
9. 如果平台活动价由商户承担成本，商户必须有已通过的平台活动参与关系和成本确认记录。

活动价优先级目前是：先找商户活动价，再找平台活动价；同一层内选择用户单价最低的策略。命中活动价后，订单项会保存 promotionId 和 promotionData，用于后续分摊、预算和补贴。

优惠叠加规则

订单里优惠的叠加顺序大致是：

1. 当前价格先算商品原价、活动价和运费。
2. 用户选择商户券后，先按店铺维度扣商户券。
3. 用户选择平台券后，再基于剩余商品金额扣平台券。
4. 最终重新汇总订单金额。

关键限制如下：

用户端如何参与

用户端有两类参与方式：主动领券和自动命中活动价。

领券流程

1. 用户查询可领取平台券：GET /api/v1/user/personal/coupon-wallet/claimable/platform/page。
2. 用户查询可领取商户券：GET /api/v1/user/personal/coupon-wallet/claimable/merchant/page。
3. 后端返回是否可领取、不可领取原因、活动名、券名、有效期、限领数量和已领数量。
4. 用户领取平台券：POST /api/v1/user/personal/coupon-wallet/claim/platform/{couponPoolId}。
5. 用户领取商户券：POST /api/v1/user/personal/coupon-wallet/claim/merchant/{couponPoolId}。
6. 领取成功后生成个人卡券钱包项和卡券流水。

下单用券流程

1. 用户先做订单预览，不传优惠券，拿基础金额和店铺拆单。
2. 用户查询该订单可用券：
   • 购物车：POST /api/v1/personal/order/cart/available-coupon。
   • SKU 直购：POST /api/v1/personal/order/available-coupon。
3. 后端从用户可用钱包券中筛选可用于当前订单的券，并估算优惠金额。
4. 用户选择平台券和商户券后，再调用订单预览接口，传入 platformCouponWalletItemId 和 merchantCouponWalletItems。
5. 后端重新计算优惠后的金额。
6. 用户确认下单，创建订单时后端锁定所选优惠券。
7. 用户支付时，后端再次校验锁定券、活动状态、预算和活动价锁价。
8. 支付成功后，卡券变为已使用，生成用券记录、分摊记录、预算流水和待确认补贴。

活动价参与流程

用户不需要主动选择活动价。商品当前价格接口或订单试算会自动调用活动价匹配逻辑，命中后直接影响商品单价、优惠金额、订单项快照和商户结算基数。

订单取消、超时和退款

预算和成本规则

预算池分平台和商户两套，但账务组件统一处理。

预算流水支持充值、预占、释放预占、核销预占、直接核销、退款返还、退回预占、退回剩余预算、结算后调整、冻结、解冻和日终对账。

活动成本主要来自三类：

1. 平台券抵扣。
2. 商户券抵扣。
3. 平台或商户活动价优惠。

这些成本都会尽量分摊到订单项，再进入预算流水、成本日报和补贴确认。

配置示例

平台满减券活动

1. 平台创建平台活动。
2. 配置活动店铺和 SKU 范围，或不配表示全范围。
3. 创建平台优惠券，类型选 FULL_REDUCTION，设置门槛和抵扣金额。
4. 创建用券策略，范围选 ALL 或指定目标。
5. 创建券池，设置发放时间、总量、每人限领和预算池。
6. 如预算有限，给预算池充值并设置扣减模式。
7. 启动活动。
8. 用户领取平台券，下单时选择平台券。

商户店铺券活动

1. 商户创建商户活动，并选择本店。
2. 配置参与 SKU。
3. 创建商户优惠券和用券策略。
4. 创建商户券池，绑定商户预算池。
5. 商户预算池充值。
6. 启动活动。
7. 用户领取商户券，在该店铺下单时使用。

商品活动价

1. 平台或商户创建活动。
2. 配置活动范围。
3. 创建活动价策略，指定 SPU 或 SKU。
4. 选择固定活动价、折扣活动价或阶梯活动价。
5. 平台活动价如果由商户承担成本，需要商户确认。
6. 启动活动。
7. 商品当前价格自动命中活动价，用户无需领券。

目前需要关注的缺口

阅读代码时的入口