07 settlement and ledger

收益结算与账本规则

收益结算是本项目的核心之一。商户愿不愿意长期参与，取决于收益是否清晰、可解释、可追踪。

基本原则

• 每一笔商户收益都必须有来源。
• 每一笔收益都必须能追溯到订单明细。
• 历史收益不能因为后续商品价格、成本价、规则修改而变化。
• 退款、售后、取消订单必须影响收益。
• 账本不建议物理删除，只能冲正、冻结或作废。
• V1 优先做“可核算、可审核、可导出”，不强求全自动分账。

收益来源

来源类型	说明
land_harvest_shop	租地收成上架商户店铺销售
land_harvest_consign	租地收成委托平台代售
adoption_output_shop	认养产出上架商户店铺销售
adoption_output_consign	认养产出委托平台代售
market_normal	平台集市普通铺货商品
market_activity	平台集市活动抢购商品
store_normal	商户普通店铺商品

核心金额字段

字段	说明
销售金额	用户实际支付的商品金额，不含或含运费需统一口径
运费金额	用户支付运费
优惠金额	平台券、商户券、活动优惠
退款金额	售后退款金额
商品成本	集市成本、供应链成本、平台约定成本
服务成本	代种植、代养殖、包装、履约等成本
平台佣金	平台按比例或固定金额收取
手续费	支付通道、提现、服务手续费
商户收益	最终应结算给商户的金额

通用公式

基础公式：

商户收益 = 可结算销售金额 - 商品成本 - 服务成本 - 平台佣金 - 手续费 - 退款扣减

其中：

可结算销售金额 = 商品实付金额 - 已退款商品金额

V1 可以按订单明细维度计算，不建议只按整单计算，因为一个订单可能包含多个商户、多个来源商品。

不同来源结算建议

租地收成上架店铺

商户收益 = 商品实付金额 - 平台销售服务费 - 退款扣减

说明：

• 土地租赁费和代种植费通常在商户租地时已经支付。
• 收成归商户所有，因此售出后不再扣商品成本。
• 平台可以按销售额收取服务费或佣金。

租地收成委托平台代售

商户收益 = 商品实付金额 - 平台代售服务费 - 包装履约成本 - 退款扣减

说明：

• 平台负责统一销售、包装、发货、售后。
• 代售服务费可以高于商户自售服务费。

认养产出上架店铺

商户收益 = 商品实付金额 - 平台销售服务费 - 退款扣减

说明：

• 认养费用已在前置订单支付。
• 产出归属商户后，再销售获得收益。

平台集市普通铺货

商户收益 = 商品实付金额 - 商品成本价 - 平台佣金 - 退款扣减

说明：

• 普通铺货收益较低。
• 商品成本价由平台配置。
• V1 默认售出后扣成本；如果商品配置为商户已预付成本，则售出后不再重复扣商品成本。

平台集市活动抢购

商户收益 = 商品实付金额 - 活动服务费 - 平台佣金 - 退款扣减

说明：

• 商户等级越高，成本价越低。
• 活动商品需要记录抢购价快照。
• V1 口径中，活动抢购商品必须由商户先支付成本，因此订单售出后不再重复扣商品成本。

账本状态

状态	说明
待入账	订单刚支付，暂不结算
待结算	订单完成且过售后期
结算中	已进入结算单
已结算	财务已确认结算
已冻结	存在售后、风控或争议
已冲正	原账本被反向记录抵消
已作废	订单取消或无效

结算时点

建议 V1 使用以下时点：

用户支付成功
→ 记录订单来源快照
→ 订单完成
→ 等待售后期结束
→ 生成待结算账本
→ 财务审核
→ 生成结算单
→ 打款/余额入账
→ 已结算

账本关键字段

字段	说明
账本编号	唯一编号
商户 ID	收益归属商户
用户订单 ID	用户购买订单
订单明细 ID	具体商品明细
商品 ID	当前商品
来源类型	租地、认养、集市、普通店铺
来源对象 ID	收成记录、产出记录、集市商品等
销售金额	快照
成本金额	快照
服务费	快照
佣金	快照
手续费	快照
退款扣减	快照
商户收益	计算结果
状态	待结算、已结算等
结算单 ID	已结算时关联
创建时间	生成时间
结算时间	完成结算时间

结算单

结算单是财务批量处理账本的凭证。

字段	说明
结算单号	唯一编号
商户 ID	被结算商户
账本数量	包含多少笔明细
销售总额	汇总销售金额
成本总额	汇总成本
扣费总额	佣金、手续费等
结算金额	应付商户金额
状态	待审核、待打款、已完成、已驳回
审核人	财务或管理员
备注	结算说明

V1 结算口径

V1 具体结算口径已在 08-v1-settlement-policy.md 中明确，包括：

• 普通集市商品是否先付成本。
• 活动抢购商品必须先付款。
• 运费承担方如何配置。
• 售后期和结算周期如何选择。
• 平台券、商户券、运费券分别由谁承担。
• 租地/认养产出如何按商户选择处理。
• 商户自售和委托平台代售的差异。
• 后端需要预留的订单快照字段。

后续如果业务规则变化，应优先更新 08 文档，再同步调整本账本模型。