finance-settlementlisted
Install: claude install-skill 1398281322-a11y/java-backend-guardrails
# 商家结算 / 账期
## When to Invoke
门店/商家要打款、T+1/T+7 账期、结算单、平台抽佣后应付。文旅核销后才可结算。面试:「怎么给商家结账」。
## When NOT
微信分账 API → `pay-split-account`(渠道把钱划走)。那是支付通道;本文件是 **平台账本上的应付与账单**。统计 GMV → `finance-stats`。
## 风险(面试考点)
支付成功立刻给商家可提现:退款时平台垫资。默认 **履约完成(发货确认/核销)后进入待结算,账期满可结算**。
结算单与交易单多对多:一笔订单可能跨账期退款,要从下期扣或追缴。不能结算后物理删除明细。
佣金:`应付商家 = 实付 - 平台佣金 - 渠道手续费(看合同)`。尾差规则固定。
和渠道分账同时存在时:渠道已分账则平台结算单只做对账,避免再打一笔。
## 方案选型(轻量优先)
```text
支付成功 → 记账「平台预收」(未对商家负债或冻结)
核销/收货 → 生成结算明细 status=PENDING,账期日=履约日+N
账期到 → 聚合成结算单 SETTLED,可提现/打款
退款 → 未结算明细冲红;已结算则下期扣或应收回
```
```sql
t_settle_item uk(order_no, sku_line) -- 一笔履约一行
t_settle_bill merchant_id + period -- 账期账单
```
打款:结算单 SUCCESS 才调代付;代付单号稳定,超时查单,见 `pay-refund-channel` 同类「同号重试」。
## 默认方案
日批:把昨日已核销未入明细的订单入 `settle_item`。账期批:PENDING 且 `available_at<=today` 汇总成账单。人工审核或自动打款。
明细保留订单号、核销号、金额分、佣金分,财务可钻取。
## 反例
错误:支付成功就给商家余额++。
正确:履约后才待结算。
错误:结算后 UPDATE 把历史金额改掉。
正确:冲红新行,不动已出账单金额(账单作废走红字单)。
错误:当渠道分账已打给门店,平台再打款一次。
正确:模式互斥或对账扣减。
## 验证
- 核销后未满账期,商家余额不增加。
- 账期内退款,账单金额减少或红字,不出现已打款又全额再打。
- 两门店拆单,各出各的结算明细。
## 评审清单
- [ ] 结算时点是履约不是支付
- [ ] 有账期与账单
- [ ] 退款冲减路径
- [ ] 未与渠道分账双打
---