08 v1 settlement policy

V1 结算口径规则

本文档明确平台自营商品、商户普通商品、商户云仓供货、用户云仓本金与收益、租地/认养履约的 V1 结算口径。完整云仓状态机和公式见 13-cloud-warehouse-process-and-state-machines.md。

一、结算总原则

1. 按订单明细和业务批次核算

• 普通商品和商户货款按 CRMEB 订单明细核算。
• 云仓首次购买按订单明细记录商品、价格、去向和活动规则。
• 云仓二次零售按二次订单明细关联云仓批次。
• 用户本金和收益按“云仓批次 + 用户持仓 + 结算节点”核算。
• 一个云仓首次订单明细的全部数量只能选择邮寄、自提或代销中的一种。
• 整单状态与金额只用于汇总，不替代明细账。

2. 下单时记录规则快照

以下配置必须在用户首次付款时写入历史快照：

• 商品来源、商户、商品和 SKU。
• 云仓活动、活动商品和批次。
• 抢购单价、购买数量、商品实付金额。
• 支持的去向、选择截止时间和超时默认去向。
• 预计销售周期。
• 结算模式、固定进度节点。
• 用户与平台收益分成率。
• 到期回购比例。
• 首次交易和二次零售的售后观察期。
• 运费和优惠承担规则。
• 商户供货价及商户结算方式。

历史订单不跟随活动商品、商品、运费模板或分成配置的后续变化。

3. 账本只追加事实

• 已生成账本不物理删除。
• 退款、售后和错误修复通过冻结、冲正、解冻或作废记录处理。
• 实际支付或余额入账前必须有业务账本和结算单依据。
• 支付回调、结算节点和回购均需幂等。

二、商品归属与结算主体

业务	主要结算主体	账本
平台自营普通商品	平台	平台收入统计
商户普通商品	商户	商户货款账本
平台自营云仓首次购买	平台	平台首次销售统计
商户供货云仓首次购买	商户	商户供货货款账本
用户云仓二次代销	用户	本金返还、收益、回购和冲正账本
用户租地	平台履约	订单收入、履约、退款，不生成用户收益
用户认养	平台履约	订单收入、履约、退款，不生成用户收益

三、普通商户商品

商户结算基数
= 商品成交金额
- 商户承担优惠
- 商品退款扣减

商户应结算货款
= 商户结算基数
- 平台佣金
- 约定手续费
- 商户承担运费

平台券和平台补贴不减少商户结算基数；商户店铺券、商户商品优惠由商户承担并减少结算基数。

四、商户云仓供货

1. V1 默认供货价模式

商户有效首次购买数量
= 用户已付款数量
- 首次交易已退款数量
- 入库/供货验收不合格数量

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

进入待结算必须同时满足：

• 用户首次购买已经生效。
• 商品已完成云仓入库或约定供货验收。
• 首次交易售后观察期已经结束。
• 不存在退款、质量争议或财务冻结。

用户选择邮寄、自提或代销不改变供货价结算基础；二次零售是否售完不作为商户货款结算条件。

2. 成交价扣佣模式

V1 不作为默认流程。确有特殊合作时可在后续版本增加：

商户云仓结算基数
= 用户首次购买商品金额
- 商户承担优惠
- 首次退款扣减

商户云仓货款
= 商户云仓结算基数
- 平台佣金
- 约定手续费
- 商户承担运费/履约费

在正式支持该模式前，活动发布页不得出现该选项，避免只有配置没有完整账本和测试。

五、优惠承担

优惠承担解决的是“用户少付的金额由谁补足”，不是只记录一张券的名称。

优惠类型	V1 承担方	对商户货款	对用户云仓批次结算
平台通用券	平台	不减少	不减少批次确认销售收入
平台新人券	平台	不减少	不减少批次确认销售收入
平台活动补贴	平台	不减少	不减少批次确认销售收入
商户店铺券	商户	减少普通商户结算基数	云仓二次零售 V1 不使用
商户商品优惠	商户	减少普通商户结算基数	云仓二次零售 V1 不使用
运费券	发券方	只影响运费	不计入商品销售收入

二次零售确认销售收入时：

确认销售收入
= 用户有效商品实付金额
+ 平台承担优惠补贴
- 有效退款商品金额

因此用户使用平台券不会压低云仓批次对用户计算收益的销售收入。

六、运费承担

运费计算复用 CRMEB 运费模板、包邮规则和配送设置。

普通商品

方式	处理
用户承担	下单时支付运费
商户包邮	商户承担并按结算规则扣减
平台包邮	平台承担，不减少商户货款

云仓首次购买

• 抢购付款阶段只支付商品价款，不要求地址和运费。
• 用户选择邮寄后填写地址并重新计算运费。
• 需要用户承担时生成补运费支付单。
• 需要补运费时，补运费成功前邮寄仅为临时选择；支付超时且仍在选择期则返回待选择，超过选择期则自动代销。
• 活动商品包邮时不生成用户应付运费。
• 用户选择自提或代销不产生首次邮寄运费。
• 后补运费不计入用户云仓本金和代销利润。

二次零售

• 二次消费用户支付的运费不计入云仓商品确认销售收入。
• 平台日常包装、仓储和配送运营成本从平台分成承担，V1 不临时从用户收益扣减。

七、售后观察期

V1 使用“平台默认固定选项 + 商品/活动商品选择覆盖”，不允许运营输入任意天数。

选项	建议场景
T+0	无实物售后场景，V1 农产品不建议
T+3	短保生鲜
T+7	V1 默认，普通商品、云仓首次交易和二次零售
T+15	礼盒、预售或较长履约
T+30	特殊高风险合作
手动	大额争议或特殊合同，需人工审核

1. 普通商户商品

订单完成/自动确认收货
→ 售后观察期
→ 无退款、争议或冻结
→ 商户货款进入待结算

2. 云仓首次交易

商户货款进入待结算需同时满足首次购买有效、供货验收和首次售后观察期三个条件。

首次购买完成时间按去向认定：

• 邮寄：用户确认收货或系统自动确认收货。
• 自提：自提核销完成。
• 代销：用户持仓进入正式云仓批次。

待选择和代销批次冻结前可按整个订单明细申请首次退款；代销批次开始后不再转回普通首次退款。

3. 云仓二次零售

二次订单支付
→ 发货/核销
→ 订单完成
→ 二次售后观察期
→ 转为有效代销售出
→ 更新批次进度和节点结算

订单刚支付、运输中和观察期内的数量不计入有效销售进度。

八、云仓本金、收益与回购

1. 共同公式

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

批次累计已售本金
= 用户云仓抢购单价 × 累计有效代销售出数量

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

用户批次占比
= 用户有效代销数量 ÷ 批次冻结代销数量

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

所有实际结算使用累计差额，避免重复：

本次应结算
= 当前累计应结算
- 历史已结算
- 已生成未完成结算

2. 结算模式

模式	节点处理	批次结束处理
批次结束统一结算	代销期间不入账	已售本金 + 全部收益 + 未售回购款
分期收益，结束返本金	25/50/75/100% 只结新增收益	全部已售本金 + 收益尾差 + 未售回购款
分期本金和收益	25/50/75/100% 结新增本金和收益	本金/收益尾差 + 未售回购款

V1 默认“分期本金和收益”。

3. 回购

批次到期仍未有效售出的数量由平台回购：

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

回购比例支持 100%、90%、80% 和自定义，默认 100%。回购只返还约定回购款，不产生代销收益。回购完成后商品转为平台库存。

九、经营亏损处理

可能发生亏损的来源包括二次售价低于抢购成本、平台优惠、仓储推广费用、退货赔付、损耗和折扣回购。

V1 固定处理原则：

• 二次售价不得让用户承担低于抢购成本的价差，确需低价时由平台补足。
• 平台券、平台补贴不降低批次确认销售收入。
• 常规仓储、推广、包装和支付手续费从平台分成中承担。
• 仓储损坏、盘亏和非用户原因质量问题不向用户账本扣成负数。
• 用户正常可能承担的本金差额仅来自付款前明确展示的折扣回购比例。
• 二次售后先冲减未结算/冻结金额；不足时进入人工审核和平台风险金额，不直接形成用户欠款。

十、租地/认养履约口径

租地和认养属于农业体验与约定农产品交付：

用户支付套餐
→ 分配真实地块、动物个体或养殖批次份额
→ 平台代种植/代养殖
→ 形成一次或多次采收/产出
→ 按约定数量邮寄到家
→ 记录售后和未履约退款

需要记录：

• 套餐价格与权益快照。
• 约定交付数量或最低交付数量。
• 真实资产分配和生产批次。
• 实际采收/产出批次。
• 已履约、剩余和未履约退款数量。
• 邮寄运费承担。
• 减产、死亡、延期、替换、补发和退款事件。

租地/认养不生成用户收益账本，也不进入云仓代销。

十一、账本类型

商户

类型	说明
普通商品货款	CRMEB 普通商户商品销售
云仓供货货款	用户首次有效购买对应供货价
退款扣减	首次交易退款
履约扣减	规则明确由商户承担的费用
冲正/冻结	异常修正和争议

用户云仓

类型	说明
本金返还	按结算模式释放已售商品本金
代销收益	用户按批次利润分成获得的收益
回购款	到期未售商品由平台回购的金额
冻结/解冻	售后或异常期间控制可用性
冲正	对原账本追加反向事实

本金返还、收益和回购款必须分字段、分账本类型展示，不能只给用户一个无法解释的“总收益”。

十二、关键快照与字段

订单明细快照

• 商品来源、归属主体、商户、商品和 SKU。
• 活动、活动商品、云仓批次和供货记录。
• 抢购单价、数量、商品实付。
• 唯一去向、选择截止和选择方式。
• 运费支付单和运费承担。
• 结算模式、节点、周期、分成率和回购比例。
• 首次与二次售后观察期。

二次零售关联

• 二次订单和订单明细。
• 云仓批次。
• 分配数量。
• 商品实付。
• 平台补贴。
• 退款数量/金额。
• 有效时间和状态。

用户持仓

• 初始/有效代销数量。
• 单位本金和总本金。
• 分摊已售、剩余和回购数量。
• 已返本金。
• 已确认/已结算收益。
• 回购金额。
• 结算和冻结状态。

商户供货账本

• 有效首次购买数量。
• 供货价。
• 入库/供货验收时间。
• 售后观察期到期时间。
• 退款和履约扣减。
• 应结算金额和状态。

十三、结算前核对

每份结算单生成前必须核对：

• 来源订单和订单明细存在且归属正确。
• 商品、活动、批次和规则快照完整。
• 库存数量恒等式成立。
• 售后观察期已结束。
• 不存在未处理退款、争议或冻结。
• 当前累计应结算减历史金额大于 0。
• 幂等键未处理过。
• 商户与用户数据权限正确。
• 金额尾差在批次最终结算中闭合。

十四、关联文档

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