09 cloud warehouse seckill

云仓秒杀与用户云仓

本文档说明“云仓秒杀/云仓抢购”的产品定位、活动配置和各端页面。完整状态机、库存、二次零售、结算和回购规则见 13-cloud-warehouse-process-and-state-machines.md。

一、产品定位

CRMEB 原营销
= 优惠券、普通秒杀、拼团、会员价、满减等通用促销

云仓秒杀
= CRMEB 营销体系下新增的独立秒杀模块
= 限时抢购 + 延后选择去向 + 用户云仓持仓 + 平台真实代销 + 本金/收益结算

用户端使用独立“集市云仓”页面，不与普通秒杀列表混在一起。平台端入口放在“营销”下，交互可参考普通秒杀的场次、倒计时、限购、锁库存和支付超时能力，但业务表、状态、库存池和账本必须独立。

二、完整用户闭环

平台创建云仓活动
→ 配置平台自营或商户供货商品
→ 每个活动商品 SKU 生成独立批次
→ 用户在集市云仓抢购并先完成付款
→ 订单明细进入“已付款待选择”
→ 用户可继续抢购
→ 用户立即选择，或活动结束后到订单中心集中选择
→ 每个订单明细选择邮寄、自提或平台代销中的一种

邮寄/自提：

选择邮寄 → 选择地址 → 计算并补付运费（如有）→ 出库发货 → 售后完成
选择自提 → 生成核销凭证 → 到店/基地核销 → 售后完成

平台代销：

选择代销或超时自动代销
→ 选择窗口关闭并冻结批次代销数量
→ 生成用户云仓持仓
→ 平台通过 CRMEB 产生真实二次零售订单
→ 二次订单完成并过售后观察期
→ 形成批次有效销售进度
→ 按活动 SKU 结算模式返还用户本金和收益
→ 到期未售数量由平台按快照规则回购

三、用户去向规则

• 用户付款时不强制填写地址或选择去向，保证抢购链路足够短。
• 每个订单明细的全部数量只能选择一种方式。
• 同一商品需要不同去向时，用户必须分开下单。
• V1 云仓活动必须支持平台代销，可额外支持邮寄和自提。
• 默认选择截止时间为活动结束后 3 个自然日，可按活动商品选择 1 至 7 天。
• 截止前未选择时，按用户付款前已展示并确认的规则自动转为平台代销。
• 需要补运费时，邮寄在补运费成功后才最终确认；支付超时且仍在选择期则返回待选择，超过选择期则自动代销。
• 去向最终确认后用户不能自行改选，特殊情况由客服走带审批记录的异常流程。
• 待选择或代销批次冻结前，可按整个订单明细申请首次退款；代销批次开始后不再走普通首次退款。
• 自提逾期进入异常待处理，不由系统静默改变去向。

四、平台端活动配置

1. 场次

配置项	说明
活动名称	用户端展示名称
预热时间	可提前展示但不可抢购
开始/结束时间	限时抢购范围
支付超时	未付款订单自动关闭并释放库存
活动状态	草稿、待发布、未开始、进行中、已结束、已关闭

2. 活动商品

配置项	说明
商品来源	平台自营、商户审核通过的供货商品
商品与 SKU	每个 SKU 独立形成云仓批次
抢购价	用户首次购买单价
活动库存	从来源库存预占
每人限购	按用户和活动商品校验
支持邮寄	是否允许邮寄到家
支持自提	是否允许线下自提
支持代销	V1 必须开启
选择期限	活动结束后 1 至 7 天，默认 3 天
预计销售周期	从代销批次开始时间计算
结算模式	三种模式中单选
用户收益分成率	作用于批次可分配销售利润
平台收益分成率	平台参与销售利润分配的比例
到期回购比例	100%、90%、80% 或自定义，默认 100%
首次售后观察期	影响首次退款与商户货款
二次售后观察期	影响有效代销售出与用户结算
运费规则	复用 CRMEB 运费模板

配置保存为草稿时允许不完整；发布前必须完成业务校验并展示用户端规则预览。

五、三种结算模式

每个活动 SKU 只能选择一种模式，付款时写入订单明细和用户持仓快照。

模式	代销期间	批次结束
批次结束统一结算	只展示进度，不实际返本金和收益	结算已售本金、全部收益和未售回购款
分期收益，结束返本金	25%/50%/75%/100% 节点结算新增收益	返还全部已售本金、收益尾差和未售回购款
分期本金和收益	25%/50%/75%/100% 节点按累计结果返本金和收益	结算尾差与未售回购款

V1 默认“分期本金和收益”。固定节点比运营任意填写节点更容易解释、测试和对账。

六、预计销售周期与分成

预计销售周期、用户收益分成率和平台收益分成率由运营按活动 SKU 配置。同一来源商品的不同 SKU 可以不同，参加不同活动时也使用各自快照。

示例仅用于配置说明：

预计周期	用户收益分成率	平台收益分成率
7 天	20%	80%
15 天	30%	70%
30 天	40%	60%
60 天	50%	50%

预计周期用于确定批次到期时间，不等于保证售完日期。用户与平台分成率之和必须等于 100%，并作用于实际有效二次零售形成的可分配销售利润，不直接乘销售额。

七、实际代销、进度和收益

平台实际代销售出必须来自关联云仓批次的 CRMEB 二次零售订单：

二次订单明细完成并超过售后观察期
→ 计入批次有效销售数量和确认销售收入
→ 计算批次累计进度
→ 检查是否达到结算节点

批次销售进度
= 累计有效代销售出数量 ÷ 批次冻结代销数量

批次累计确认销售收入
= 二次零售有效商品实付
+ 平台优惠补贴
- 有效退款商品金额

批次累计可分配销售利润
= max(0, 批次累计确认销售收入 - 已售商品对应用户本金)

用户累计收益
= 批次累计可分配销售利润
× 用户批次持仓占比
× 用户收益分成率快照

用户每次实际结算使用“当前累计应结算减去历史已结算和正在结算金额”，防止重复付款。

八、两类未售处理

活动没有抢购完

活动结束并释放全部未支付订单后，没有被用户有效付款购买的数量直接退回平台或商户来源库存。

代销周期没有卖完

批次到期后停止分配新二次零售，剩余用户持仓由平台回购：

用户回购款
= 用户最终未售数量
× 用户云仓抢购单价
× 到期回购比例快照

回购完成后剩余商品转为平台库存，不再给原用户产生后续收益。V1 默认按 100% 回购，运营可在活动发布前选择 90%、80% 或自定义比例并向用户清晰展示。

九、商户供货与货款

商户商品进入云仓活动前完成供货申请、平台审核、实际库存预占和平台仓入库/等价供货验收。V1 不允许使用尚未验收的预期库存发布活动。

V1 默认按供货价结算：

商户应结算货款
= 商户供货价 × 用户有效首次购买数量
- 首次退款扣减
- 已确认由商户承担的履约扣减

用户首次购买完成、供货验收完成、首次售后观察期结束且无争议后进入商户待结算。首次购买完成按去向认定：邮寄为确认/自动收货，自提为核销，代销为持仓进入正式批次。不同去向会影响可结算时间，但二次零售何时售完不改变商户首次供货货款基础。

十、用户端页面

1. 集市云仓

区域	展示内容
场次	状态、开始/结束倒计时
商品	商品、SKU、抢购价、剩余库存、限购
方式标签	支持邮寄、自提、平台代销
规则摘要	预计周期、结算模式、分成率、回购比例
抢购按钮	未开始、抢购中、已售罄、已结束等稳定状态

2. 云仓商品详情

必须展示：

• 商品和溯源信息。
• 抢购价、活动库存、限购和时间。
• 付款后再选择去向的说明。
• 可选邮寄、自提和代销方式。
• 选择截止时间与超时自动代销。
• 预计销售周期。
• 结算模式及节点。
• 用户/平台收益分成率。
• 到期回购比例和计算示例。
• 实际销售的认定方式。
• 售后对进度和结算的影响。

3. 支付成功页

• 明确商品已抢购成功。
• 提供“立即选择去向”和“继续抢购”两个主操作。
• 展示最晚选择时间。
• 不以弹窗阻塞用户继续参加活动。

4. 订单中心待选择

• 独立筛选“云仓待选择”。
• 支持多笔订单逐笔处理，但每笔仍单独确认。
• 显示截止倒计时和超时默认结果。
• 邮寄选择地址并补运费；自提展示网点；代销展示完整规则快照。

5. 我的云仓

字段	说明
来源订单	首次抢购订单明细
云仓批次	活动、商品和 SKU 批次
初始代销数量	本明细全部代销数量
用户本金	抢购单价 × 代销数量
批次有效销售进度	统一批次进度
分摊已售数量	按持仓占比分摊
剩余数量	尚未有效售出或回购的数量
结算模式	活动商品快照
已返本金	累计已入账本金
待结算收益	已确认未入账收益
已结算收益	累计已入账收益
回购数量/金额	到期后展示
状态	待入批次、代销中、结算中、已完成、冻结

6. 云仓账本

按本金返还、收益、回购款、冲正和冻结分类展示。每笔明细可展开查看活动、批次、进度节点、计算基数、分成率和状态。

十一、平台端页面

页面	核心能力
云仓活动列表	场次、状态、成交、待选择、代销和结算概览
活动编辑	时间、支付超时和活动商品
活动商品配置	SKU 批次、库存、价格、方式、周期、分成、结算和回购
发布预检	阻止缺少库存、规则或供货审核的活动发布
去向处理	待选择、用户选择、系统自动代销和异常改选
批次列表	状态、总量、各库存池、进度、到期和节点
二次零售分配	订单明细、批次分配、有效状态和退款
到期回购	未售数量、比例、金额、审核和库存转入
用户持仓	用户、订单、批次、数量、本金、收益和状态
用户账本	本金、收益、回购、冻结、冲正和结算单
商户供货货款	首次有效数量、验收、观察期和货款状态
异常事件	库存、质量、售后、暂停和恢复

十二、商户端页面

页面	核心能力
云仓供货申请	从自有商品/SKU 选择，填写供货价、数量和履约说明
供货审核记录	查看平台审核与驳回原因
入库/验收状态	查看预占、已送达、合格、不合格和差异
首次购买汇总	查看有效首次购买数量，不展示为用户投资订单
云仓供货货款	查看供货价、有效数量、退款扣减、待结算和已结算
云仓履约/售后	处理约定由商户负责的发货、质量和首次售后

商户不参与用户持仓分配和用户收益计算，只能查看与自身商品、供货、履约和货款相关的数据。

十三、用户展示与风险边界

• 预计销售周期与预计金额使用“预计”表述，不替代实际进度。
• 用户可查看活动规则快照，历史订单不跟随新配置变化。
• 平台不得把二次售价低于用户抢购成本的差额转给用户。
• 平台券、平台补贴和日常运营成本由平台分成承担。
• 用户本金可能发生差额的正常场景仅为下单前明确展示的折扣回购。
• 用户账本不得出现负余额；异常售后使用冻结和冲正流程。

十四、关联文档

• 07-settlement-and-ledger.md
• 08-v1-settlement-policy.md
• 12-v1-business-decisions-and-glossary.md
• 13-cloud-warehouse-process-and-state-machines.md
• 15-v1-data-model-draft.md