docs(changelog): #6397 接口详情子节编号化 + 补六.6/六.7 章节

这个提交包含在:
API Changelog Bot
2026-08-26 23:58:34 +08:00
父节点 81aab7abb0
当前提交 e362441e9c
@@ -76,7 +76,7 @@ base: "dev-v3"
历史数据可能返回只读状态 `TERMINATED`;创建和提交请求不得发送该状态。
## 1. 创建供应商注册草稿
### 1. 创建供应商注册草稿 `POST /admin/supplier/items/add`
`POST /admin/supplier/items/add`
@@ -166,7 +166,7 @@ Content-Type: application/json
失败时不会留下供应商主体或部分合同。
## 2. 提交供应商注册
### 2. 提交供应商注册 `POST /admin/supplier/items/{supplierId}/submit`
`POST /admin/supplier/items/{supplierId}/submit`
@@ -263,7 +263,7 @@ Content-Type: application/json
该失败会回滚本次提交表单中的主体、资质、合同和审计变化,供应商仍保持原状态和原版本。
## 3. 查询供应商基本信息
### 3. 查询供应商基本信息 `GET /admin/supplier/items/{supplierId}/basic-info/view`
`GET /admin/supplier/items/{supplierId}/basic-info/view`
@@ -369,7 +369,7 @@ Authorization: Bearer <admin-token>
- 历史只读状态 `TERMINATED` 仅可返回,创建/提交发送该状态会被拒绝。
- 越权:仅可信 `FINANCE`、`SUPER_ADMIN` 且拥有对应平台权限可写;普通 ADMIN 调用写接口返回越权错误。
## 修改前后对比
## 六.6、修改前后对比
| 场景 | 修改前 | 修改后 |
|---|---|---|
@@ -379,6 +379,13 @@ Authorization: Bearer <admin-token>
| 账户区域标题 | 页面显示“初始账户” | 页面应显示“结算信息”,接口字段仍为 `initialAccounts` |
| 页面区块顺序 | 资质后直接进入账户区域 | 资质证照 → 合同信息 → 结算信息 |
## 六.7、影响评估
- **管理端(admin)**:供应商注册/编辑页需新增「合同信息」表格并调整区块顺序;既有合同必须缓存并原样回传字符串 `contractId`,否则提交会整单回滚。
- **同日修正(PR #6450)**:响应 `contracts[].amount` 由 Number 改为 String,前端 f2a4200d 按 Number 集成的解析处需改为字符串处理(展示直接渲染、运算前 `Number(...)`),影响面限于合同金额展示/计算处,请求提交不受影响。
- **C 端(mp)**:不涉及,无影响。
- **QA 排查面**:问题定位优先看「契约约束与正确调用方式」第 3、4 条(快照回传与空数组语义)与「关键变化」(amount 字符串化)。
## 四、契约约束与正确调用方式
1. 在“资质证照”区域之后新增“合同信息”表格,在合同之后显示原账户表格。