From 81aab7abb02b32028ed89c36d2617f807aa08491 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 26 Aug 2026 23:56:51 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#6397=20=E5=AF=B9=E9=BD=90?=
 =?UTF-8?q?=20CHANGELOG=5FTEMPLATE=20=E5=BF=85=E5=A4=87=E7=AB=A0=E8=8A=82(?=
 =?UTF-8?q?=E4=BA=8C/=E4=B8=89/=E5=9B=9B/=E5=85=AD/=E4=B8=83/=E5=85=AB/?=
 =?UTF-8?q?=E5=8D=81)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¾›åº”商注册å�ˆå�Œè�šå�ˆä¿¡æ�¯-修改接å�£-管ç�†å�Žå�°.md | 36 ++++++++++++++++---
 1 file changed, 32 insertions(+), 4 deletions(-)

diff --git a/changelogs-v2/2026-08/26_6397_供应商注册����信�-修改接�-管���.md b/changelogs-v2/2026-08/26_6397_供应商注册����信�-修改接�-管���.md
index 7b1a141d..a7a78c57 100644
--- a/changelogs-v2/2026-08/26_6397_供应商注册����信�-修改接�-管���.md
+++ b/changelogs-v2/2026-08/26_6397_供应商注册����信�-修改接�-管���.md
@@ -23,7 +23,7 @@ base: "dev-v3"
 
 展示�调整�改�接�字段：原请求字段�为 `initialAccounts`，�得改� `settlementInfo` 或其他�称。
 
-## �更接�清�
+## 二��更接�清�
 
 | # | 接� | 方法 | 路径 | �化 |
 |---:|---|---|---|---|
@@ -39,7 +39,11 @@ base: "dev-v3"
 - **请求侧��**：`contracts[].amount` 请求�按 Number 传（字符串�值也�被兼容解�），无需改表��交。
 - �端处�：详情/列表展示处把 amount 当字符串渲染��，�与�算� `Number(...)` 转�。
 
-## 公共��字段
+## 三�接�详情
+
+三个接�的��字段完全一致，统一在「公共��字段�约定；�接�的使用场景�请求/�应示例与错误�分节详述。
+
+### 公共��字段
 
 ### 请求字段 `contracts[]`
 
@@ -355,6 +359,16 @@ Authorization: Bearer <admin-token>
 | �信角色或 `supplier:view` 平����足 | `403` | 展示无��状� |
 | 供应商�存在或已删除 | `395001` | 返回列表并刷新 |
 
+## 六�边界行为
+
+- `contracts` �略�`null` 与空数组语义��：�略/传 `null` = �处���（旧客户端兼容）；`[]` = 明确清空全部��。
+- ���空时�请求最多 100 项；��与供应商主体�资质�`initialAccounts` �事务，一起�功或一起失败。
+- 创建�稿�止�带 `contractId`（�个��都是新项）；�交既有��必须原样带回字符串 `contractId`，外部/他人�� ID 触�整体回滚零写入。
+- `endDate` 早于 `startDate` 直接校验失败，零写入。
+- `amount` 边界：大于等于 0，最多 10 �整数和 2 ��数；�应按字符串输出（PR #6450 起）。
+- 历��读状� `TERMINATED` 仅�返回，创建/�交��该状�会被拒�。
+- 越�：仅�信 `FINANCE`�`SUPER_ADMIN` 且拥有对应平����写；普通 ADMIN 调用写接�返回越�错误。
+
 ## 修改��对比
 
 | 场景 | 修改� | 修改� |
@@ -365,7 +379,7 @@ Authorization: Bearer <admin-token>
 | 账户区域标题 | 页�显示“�始账户� | 页�应显示“结算信��，接�字段�为 `initialAccounts` |
 | 页�区�顺� | 资质�直接进入账户区域 | 资质�照 → ��信� → 结算信� |
 
-## 兼容性与管�端接入事项
+## 四�契约约�与正确调用方�
 
 1. 在“资质�照�区域之�新增“��信��表格，在��之�显示原账户表格。
 2. 原账户表格标题改为“结算信��；所有请求和�应继续使用 `initialAccounts`，��改字段�。
@@ -375,7 +389,15 @@ Authorization: Bearer <admin-token>
 6. 本次�新增接�路径���点或业务错误�；旧客户端�略 `contracts` 时继续�用。
 7. 管�端���在本�端工�中修改，�端状��� `pending`，直至完�页签�标题和表格接入并�供�端引用。
 
-## TEST 验���
+## 七��影�范围
+
+- �新增接�路径���点或业务错误�；旧客户端�略 `contracts` 时行为完全��。
+- `initialAccounts` 字段��类型与语义��（仅页�展示标题由「�始账户�改「结算信��，属�端文案）。
+- 请求侧 `contracts[].amount` �按 Number 传，PR #6450 �改�应输出，�改请求解�。
+- 供应商其余模�（资�信��审批记录�账户�明）的接�与字段��影�。
+- 数�库结构无�更（�用既有快照列），无 Redis/MQ 行为�化。
+
+## 八�测试环境已验�
 
 - 自动化：供应商定�测试 115 项通过；`hl-resource-service` 全� 2,111 项，0 失败�0 错误，38 项�件跳过；`hl-verify` 与差异检查通过。
 - 部署：Deploy Panel API 任务 `af3f205b` 终� `success`�退出� 0�`has_build_error=false`，未�现 Maven�编译或滚动�布错误。
@@ -392,6 +414,12 @@ Authorization: Bearer <admin-token>
 4. 已�存的��资料�留，��破�性批�清�；回退�旧客户端继续按�略 `contracts` 的路径工作。
 5. � Gateway �测创建��交�基础信��未认��越���法�� ID�失败零写入和旧客户端兼容，并确认�实例与 Nacos �康。
 
+## ��相关文档
+
+- 设计/API 说明：仓库 `docs/supplier/API-CHANGE-6397.html`
+- �日修正 PR：[#6450](https://git.1814.love:8443/wx/HL/pulls/6450)（�应 `contracts[].amount` Number→String，�日审查红线修�）
+- 供应商暂�/拉黑原因必填（�属供应商状�域）：`changelogs-v2/2026-08/26_6392_供应商暂��作与拉黑原因必填接�-新增接�-管���.md`
+
 ## 关� / �系人
 
 - **Issue**: [#6397](https://git.1814.love:8443/wx/HL/issues/6397)