From e1e1760ab929ce008d46077e69b48a8373c115f8 Mon Sep 17 00:00:00 2001 From: caojia <1301869380@qq.com> Date: Thu, 24 Sep 2026 17:10:06 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=8E=A5=E5=8F=A3=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...询接口说明.md => TMS订单额度欠费状态和客户状态查询接口说明.md} | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) rename bms-back/doc/{TMS订单账单状态查询接口说明.md => TMS订单额度欠费状态和客户状态查询接口说明.md} (96%) diff --git a/bms-back/doc/TMS订单账单状态查询接口说明.md b/bms-back/doc/TMS订单额度欠费状态和客户状态查询接口说明.md similarity index 96% rename from bms-back/doc/TMS订单账单状态查询接口说明.md rename to bms-back/doc/TMS订单额度欠费状态和客户状态查询接口说明.md index 9dd2cc3c..90a30b57 100644 --- a/bms-back/doc/TMS订单账单状态查询接口说明.md +++ b/bms-back/doc/TMS订单额度欠费状态和客户状态查询接口说明.md @@ -1,4 +1,4 @@ -# TMS 订单账单状态查询接口 +# TMS 订单额度欠费状态和客户状态查询接口 ## 1. 接口用途 @@ -17,7 +17,7 @@ TMS 根据订单号、运单号或转单号查询 BMS 中的订单计费记录 | 字符编码 | UTF-8 | | 响应格式 | JSON | -> `X-Api-Code` 的实际值由 BMS 管理方通过安全渠道提供,不在业务代码、接口文档或工单中明文传播。 +> `X-Api-Code` = BMS.TMS.ZYaOvlQzpcfau8TUaCFfO3Hp8ieHIqGw。 ## 3. 请求参数 @@ -47,6 +47,8 @@ OR transfer_no = identifier ## 4. 请求示例 +按订单号查询: + ```bash curl --location \ 'http://{BMS_HOST}:{PORT}/api/tms/order-bill/status?identifier=TMS20260918005496762601' \ @@ -258,4 +260,3 @@ curl --location \ 5. `customerActiveStatus` 只返回 `ACTIVE`、`MISSING`、`DISABLED` 三种约定状态;只有 `ACTIVE` 表示客户当前启用,其他状态由 TMS 根据自身规则处理。 6. `creditArrearsStatus` 是订单计费记录中的状态快照,不代表客户当前实时额度状态。 7. 建议设置连接超时和读取超时,并对网络异常进行有限次数重试;查询接口本身是只读接口,可安全重试。 -8. `X-Api-Code` 属于接口凭证,应通过配置中心或密钥管理方式保存,不要硬编码到 TMS 代码仓库或日志中。