chore(huifu): 汇付官方接口页与费率表原件迁入 docs/huifu/reference/official

yeg

2026-09-18 0bff99d363818c381775fef4ea32f69ce7c37591

chore(huifu): 汇付官方接口页与费率表原件迁入 docs/huifu/reference/official

把 9 份官方页面抓取件与官方《微信费率规则ID》Excel 从 .scratch/merchant-wechat-onboarding/
迁到 docs/huifu/reference/official/，用 git mv 保留历史：原先放在一个别的 feature 的记录目录下，
作为长期参考资料不合适。

DumpExcel.java 的默认路径原本写死搬迁前的 xlsx，已同步改为新位置。

reference/README.md 写明这批是官方原件、快照日期 2026-09-15、字段以官网当前版本为准；
并把我方自撰的 evidence-2026-09-15.md 与 official-contracts-2026-09-15.md 摘出来标注为
非官方原件（引用前必须回官方 URL 复核），避免把「我们的归纳」当成「汇付的原文」。

 .scratch/merchant-wechat-onboarding/DumpExcel.java

@@ -8,7 +8,7 @@
/** 只读导出官方「微信费率规则ID」Excel 的全部单元格，含合并区域标注。 */
public class DumpExcel {
  public static void main(String[] args) throws Exception {
    String path = args.length > 0 ? args[0] : ".scratch/merchant-wechat-onboarding/wx-fee-rule-id.xlsx";
    String path = args.length > 0 ? args[0] : "docs/huifu/reference/official/wx-fee-rule-id.xlsx";
    try (Workbook workbook = new XSSFWorkbook(new FileInputStream(path))) {
      DataFormatter formatter = new DataFormatter();
      for (int s = 0; s < workbook.getNumberOfSheets(); s++) {

 docs/huifu/reference/README.md

New file
@@ -0,0 +1,33 @@
# 官方原件（汇付页面抓取件与官方 Excel）

**这是汇付官方资料的本地快照，快照日期 2026-09-15。不是本项目的文档，字段以汇付官网当前版本为准。**

抓取方法：官方文档配置把 `/partners/api/doc/` 作为 Markdown 根路径。例如「微信商户配置查询」对应
`https://paas.huifu.com/partners/api/doc/shgl/shjj/api_shjj_wxshpzcx.md`。

| 文件 | 官方接口 |
|---|---|
| `huifu-business-open-doc.md` | 商户业务开通（1022 行） |
| `huifu-business-modify-doc.md` | 商户业务开通修改（955 行） |
| `huifu-wx-config-doc.md` | 微信商户配置 |
| `config-query-doc.md` | 微信商户配置查询 |
| `huifu-api_shjj_wxsmrz.md` | 微信实名认证 |
| `huifu-api_shjj_wxsmrzztcx.md` | 微信实名认证状态查询 |
| `huifu-fee-rate-query-doc.md` | 商户费率信息查询 |
| `huifu-multifee-query-doc.md` | 商户多费率配置查询 |
| **`wx-fee-rule-id.xlsx`** | **《微信费率规则ID》全表** —— CID 三维定位的唯一权威，Sheet1 共 139 行 |
| `sb-_sidebar.md` | 官网侧边栏全量清单（仅作索引） |

## 使用规矩

1. **引用「汇付是这么规定的」时，只能引这个目录里的原文**，或者引官方 URL。不要引我方自己的归纳。
2. 这 10 份**由 `git mv` 从 `.scratch/merchant-wechat-onboarding/` 迁来**（2026-09-18），因为那里是一个**别的** feature 的记录目录，作为长期参考资料不合适。迁走后：`DumpExcel.java` 的默认路径已同步改到这里；`.scratch/merchant-individual-onboarding/audit.md` 等**历史记录里指向旧路径的文字未改**（历史记录不重写），如果照那些路径找不到文件，就是搬到这里了。
3. `wx-fee-rule-id.xlsx` 用 `.scratch/merchant-wechat-onboarding/DumpExcel.java` 导出为文本核对（它是只读工具，加上 `--` 无参时默认读本目录的 xlsx）。

## 不在这里的两份（我方自撰，不是官方原件）

`evidence-2026-09-15.md` 与 `official-contracts-2026-09-15.md` 仍在 `.scratch/merchant-wechat-onboarding/`：

- 它们**不是官方资料**，是**我方**在真实通道上的核验日志与官方文档核查摘要（后者作者自己在头部列了 S1–S13 官方 URL，正文是二次转写）。
- 引用它们的证据效力是【实测】或【推断】，**不能当作官方依据**。引用 `official-contracts-*.md` 的结论前，必须回官方 URL 或本目录原文复核。
- 留在原地是因为它们是被那个 feature 的 issue 与被本套文档大量交叉引用的工作记录，搬走会断链。

 docs/huifu/reference/official/config-query-doc.md

 docs/huifu/reference/official/huifu-api_shjj_wxsmrz.md

 docs/huifu/reference/official/huifu-api_shjj_wxsmrzztcx.md

 docs/huifu/reference/official/huifu-business-modify-doc.md

 docs/huifu/reference/official/huifu-business-open-doc.md

 docs/huifu/reference/official/huifu-fee-rate-query-doc.md

 docs/huifu/reference/official/huifu-multifee-query-doc.md

 docs/huifu/reference/official/huifu-wx-config-doc.md

 docs/huifu/reference/official/sb-_sidebar.md

 docs/huifu/reference/official/wx-fee-rule-id.xlsx

Binary files differ