From 05063853d1955a2f571f690b818ffcfa8616092c Mon Sep 17 00:00:00 2001 From: chenchuchuan <13554600537@163.com> Date: Wed, 11 Nov 2026 14:14:38 +0800 Subject: [PATCH] =?UTF-8?q?fix(yqn):=20=E7=9C=9F=E6=9C=BA=E8=81=94?= =?UTF-8?q?=E8=B0=83=E5=8F=91=E7=8E=B0=E4=B8=89=E5=A4=84=E5=8F=82=E6=95=B0?= =?UTF-8?q?=E5=90=8D/=E6=88=90=E5=8A=9F=E7=A0=81=E9=94=99=E8=AF=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用 pr 环境(RF_NY_US)跑只读探针,三处与文档不符: 1. 库存查询(get_inventory_by_page):参数名不该带 query. 前缀。 实测 400 "Required List parameter 'warehouseCodes' is not present", 说明仓方按扁平参数名取:warehouseCodes / inventoryType / rows / page。 之前照文档写的 query.warehouseCodes 被忽略。 2. 物流产品(getCarrierGroupList):同上,应为 warehouseCode 而非 query.warehouseCode,实测 400 "Required String parameter 'warehouseCode' is not present"。 3. 仓库目录(warehouse/findAll):实测 status=200 / message=success 才是 成功,不是文档示例里的 status=1。原来按 1 判定,把成功响应当失败。 另外给 YqnEnvelope 的 4xx 错误补上响应体:之前只报 http 400,看不到 仓方给的 message,排查全靠猜。 修完三个只读接口全部跑通:库存 2 条、仓库 1 个、物流产品 100 个。 Co-Authored-By: Claude --- .../src/main/java/common/ecommerce/yqn/YqnConstants.java | 8 ++++++-- .../java/common/ecommerce/yqn/adapter/YqnInventoryMapper.java | 8 ++++---- .../common/ecommerce/yqn/adapter/YqnLogisticsProductMapper.java | 2 +- .../src/main/java/common/ecommerce/yqn/http/YqnEnvelope.java | 3 ++- 4 files changed, 13 insertions(+), 8 deletions(-) diff --git a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java index cf453f1..551c77c 100644 --- a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java +++ b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java @@ -93,8 +93,12 @@ public final class YqnConstants { /** 查询仓库(API 134):组织下全部可用仓的基础档案。 */ public static final String PATH_WAREHOUSE_FIND_ALL = "/v1/warehouse/findAll"; - /** 仓库查询接口的成功 status 值;该接口文档没有 {@code code} 字段。 */ - public static final int WAREHOUSE_LIST_SUCCESS_STATUS = 1; + /** + * 仓库查询接口(API 134)的成功 status 值。 + * + *

实测该接口返回 {@code status=200, message=success},不是文档示例的 1。

+ */ + public static final int WAREHOUSE_LIST_SUCCESS_STATUS = 200; /** Spec §7.5:三家仓均未公开限流值,保守默认 2 req/s/仓。 */ public static final int PERMITS_PER_SECOND = 2; diff --git a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnInventoryMapper.java b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnInventoryMapper.java index 9d12538..7414bd4 100644 --- a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnInventoryMapper.java +++ b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnInventoryMapper.java @@ -48,15 +48,15 @@ public final class YqnInventoryMapper { } Map> params = new LinkedHashMap>(); - params.put("query.warehouseCodes", codes); + params.put("warehouseCodes", codes); if (query.inventoryType() != null) { - params.put("query.inventoryType", single(String.valueOf(query.inventoryType()))); + params.put("inventoryType", single(String.valueOf(query.inventoryType()))); } if (query.pageSize() > 0) { - params.put("query.rows", single(String.valueOf(Math.min(query.pageSize(), MAX_ROWS)))); + params.put("rows", single(String.valueOf(Math.min(query.pageSize(), MAX_ROWS)))); } if (query.cursor() != null && !query.cursor().trim().isEmpty()) { - params.put("query.page", single(query.cursor().trim())); + params.put("page", single(query.cursor().trim())); } return params; } diff --git a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnLogisticsProductMapper.java b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnLogisticsProductMapper.java index e958fe1..9bd75f0 100644 --- a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnLogisticsProductMapper.java +++ b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnLogisticsProductMapper.java @@ -26,7 +26,7 @@ public final class YqnLogisticsProductMapper { public static Map> toParams(String warehouseCode, String defaultWarehouseCode) { String code = resolveWarehouseCode(warehouseCode, defaultWarehouseCode); Map> params = new LinkedHashMap>(); - params.put("query.warehouseCode", java.util.Collections.singletonList(code)); + params.put("warehouseCode", java.util.Collections.singletonList(code)); return params; } diff --git a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/http/YqnEnvelope.java b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/http/YqnEnvelope.java index da31a1a..c288cfa 100644 --- a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/http/YqnEnvelope.java +++ b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/http/YqnEnvelope.java @@ -80,7 +80,8 @@ public final class YqnEnvelope { } if (status < 200 || status >= 300) { throw new ValidationException(ChannelException.builder() - .message("yqn request rejected: http " + status) + .message("yqn request rejected: http " + status + + ", body=" + truncate(response.body())) .operation(operation) .provider(YqnConstants.ADAPTER_ID) .requestId(requestId)