feat: correct first

docs/business_api_reference.md

@@ -177,6 +177,7 @@
 - `bank_account`：可选，引用 `basic_info.BankAccount`，用于记录具体的付款账户。
 - `markup`：可选字符串，用于记录票据附言；与 `remarks`（内部备注）区分。
 - `discount_amount`：可选，默认 0，允许大于 `amount`（表示折扣大于实付）；必须 ≥ 0。
+- 列表/详情响应额外包含 `is_external_source` 与 `external_source_id`，用于标识是否来自外部系统同步以及对应外部记录 ID。
 - `settlement_amount = amount + discount_amount`，所有余额、对账及汇总均基于结算金额。
 - `amount` 必须大于 0。返回 201 + 创建的记录，响应中会包含 `discount_amount` 与 `settlement_amount`。
 
@@ -214,6 +215,7 @@
 - `bank_account`：可选，引用到账银行账户。
 - `discount_amount`：可选，默认 0，可大于 `amount`，但必须 ≥ 0。
 - `markup`：可选，记录回单附言，默认留空。
+- 列表/详情响应额外包含 `is_external_source` 与 `external_source_id`，用于外部收款/退款同步关联与审计。
 - `settlement_amount` 为响应只读字段（`amount + discount_amount`），对账及余额只会计算结算金额。
 
 ### 5.2 审批
@@ -290,7 +292,8 @@
 
 - 固定按 `occurred_at -> recorded_at -> source_id` 倒序输出，不提供排序参数。
 - `positive_amount` / `negative_amount` 统一表示余额增减；`cumulative_amount`、`current_balance`、`arrears_amount` 均冗余在每条记录中，前端可直接使用。
-- 余额快照来自 `BalanceService`，每次请求只查询一次，保证与审批事务一致。
+- 客户对账单在存在外部 statement-only 业务依据时，可能出现 `external_sales_order` / `external_sales_return_order` 两种新的 `source_type`。
+- 客户对账单在存在外部 statement-only 业务依据时，`current_balance` / `arrears_amount` 会基于“本地余额 + 外部业务来源净额”做临时展示口径修正；余额接口本身仍返回持久化 `CustomerBalance.balance`。
 - 单条查询接口需提供 `counterparty_type`、`counterparty_id`、`order_type`、`order_id` 四个 Query 参数，返回 schema 与列表一致，仅 `records` 中包含匹配记录。
 
 ---