```

feat(shopro_huifu): 添加汇付延时分账资金冻结状态检查功能

- 在分账服务中新增 assertDelayFundsReadyForConfirm 方法，
  检查汇付查单中的 fund_freeze_stat 字段
- 当资金处于 FREEZE 状态时抛出运行时异常，并提供详细处理建议
- 更新测试脚本中的查单摘要，添加 fund_freeze_stat、freeze_time、
  unfreeze_time 字段
- 在文档中补充常见汇付错误码说明，包括 23000003 和 23000004
  的处理方案
```

addons/shopro_huifu/docs/汇付延时分账测试指南.md

@@ -306,6 +306,15 @@ php think shopro_huifu:split-retry
 2. 分账记录若 `status=4`，点 **重试**
 3. 若无任何分账记录，检查规则是否算出大于 0 的金额
 
+### 7.3 常见汇付错误码
+
+| 错误码 | 含义 | 处理 |
+|--------|------|------|
+| **23000003** | 确认金额与可确认余额不一致 | 确认基数应使用查单 `unconfirm_amt`（内扣手续费后常小于商城 `pay_fee`）。部署最新 `HuifuSplitService` 后重试；CLI 可看 `confirm_base`。 |
+| **23000004** | 延迟交易资金冻结，不能发起交易确认 | **非金额问题**。小程序 + 延时分账时，微信侧资金常处于在途/冻结，需 **发货并同步微信**（`shopro_wechat_trade` → `upload_shipping_info`），用户 **确认收货**（`notify_confirm_receive`）或等待自动解冻后再分账。查单若 `fund_freeze_stat=FREEZE`，应把 **分账时机** 改为 `confirm` 或 `finish`，勿在 `payed` 立即 confirm。 |
+
+微信交易合规插件：见 `addons/shopro_wechat_trade/README.md`（小程序后台需签署订单中心协议、开通发货信息管理服务）。
+
 ---
 
 ## 8. 定时任务建议