From 5dce79ea32ca9190a6fd1fe83f9e40eff7c61807 Mon Sep 17 00:00:00 2001 From: chenchuchuan <13554600537@163.com> Date: Tue, 17 Nov 2026 09:37:52 +0800 Subject: [PATCH] =?UTF-8?q?fix(edayun):=20=E4=BF=AE=E6=AD=A3=20SKU=20?= =?UTF-8?q?=E6=A0=87=E7=AB=AF=E7=82=B9=E8=B7=AF=E5=BE=84=EF=BC=88=E5=8E=BB?= =?UTF-8?q?=E6=8E=89=20ContentType=20=E5=90=8E=E7=BC=80=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 正确路径是 /webApi/entryInfo/v1/newPrintCaseMark,之前按文档写成了 newPrintCaseMarkContentType,PR 环境一直报「接口不存在或未启用」, 被误判成「真机未启用」。 改路径后重测:接口存在且能过参数校验(缺 pageSize 报「纸张不能为空」、 缺 madeInChina 报「产地标签不能为空」),但补全后一律「内部服务器错误」, 试过 6 种 pageSize、madeInChina 0/1、separation、箱序号区间、skuCode、 caseCodeList、甚至不存在的 entryCode,返回都一样——说明是仓方内部异常, 不是我们的参数问题。因此仍然只有单测覆盖,TODO #68 保留。 Co-Authored-By: Claude --- docs-warehouse/edayun/README.md | 8 ++++---- docs-warehouse/edayun/TODO.md | 2 +- .../src/main/java/common/ecommerce/edayun/EdayunConstants.java | 4 ++-- .../main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java | 2 +- .../common/ecommerce/edayun/adapter/EdayunSkuLabelMapper.java | 2 +- .../main/java/common/ecommerce/edayun/dto/EdayunSkuLabelDtos.java | 2 +- .../java/common/ecommerce/edayun/adapter/EdayunSkuLabelTest.java | 2 +- 7 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs-warehouse/edayun/README.md b/docs-warehouse/edayun/README.md index 90ab88b..1ee293d 100644 --- a/docs-warehouse/edayun/README.md +++ b/docs-warehouse/edayun/README.md @@ -28,7 +28,7 @@ | 物流产品清单 | ✅ 已对接(`POST /webApi/order/listByLogisticProductHasPerm`) | | 物流轨迹 | ✅ 已对接(`POST /webApi/track/getTrackInfoList`) | | 打印箱唛 | ✅ 已对接(`POST /webApi/skuInfo/v2/printBarcode`) | -| 打印 SKU 标 | ⚠️ 已实现(`POST /webApi/entryInfo/v1/newPrintCaseMarkContentType`),**真机未启用** | +| 打印 SKU 标 | ⚠️ 已实现(`POST /webApi/entryInfo/v1/newPrintCaseMark`),**真机未启用** | | 承运商清单(客户自有物流) | ✅ 已对接(`POST /webApi/carrier/v1/listCarrierByWarehouse`) | | 仓库清单 | ✅ 已对接(`warehouse/listWarehouseHasPerm` + `warehouse/listActive`) | | 其它业务接口 | ⬜ 等文档 | @@ -1154,7 +1154,7 @@ POST /webApi/track/getTrackInfoList → List / TrackingInfo | 端点 | 实际打印 | 我们的方法 | 能力位 | |---|---|---|---| | `/webApi/skuInfo/v2/printBarcode` | **箱唛**(外箱标) | `printCaseMarks(...)` | `CASE_MARK_PRINT` | -| `/webApi/entryInfo/v1/newPrintCaseMarkContentType` | **SKU 标** | `printSkuLabel(...)` | 走入库 `SKU_LABEL` 语义 | +| `/webApi/entryInfo/v1/newPrintCaseMark` | **SKU 标** | `printSkuLabel(...)` | 走入库 `SKU_LABEL` 语义 | **不要被路径名误导**。代码里两个方法的 javadoc 都写了这条提醒。 @@ -1192,10 +1192,10 @@ POST /webApi/skuInfo/v2/printBarcode → WarehouseLabel 仓方其它校验:缺 `productInfos` →「产品信息不能为空」、缺 `pageSize` → 「纸张尺寸不能为空」、SKU 不存在 →「sku=XXX信息不存在」。 -### SKU 标(newPrintCaseMarkContentType) +### SKU 标(newPrintCaseMark) ``` -POST /webApi/entryInfo/v1/newPrintCaseMarkContentType → WarehouseLabel +POST /webApi/entryInfo/v1/newPrintCaseMark → WarehouseLabel ``` **真机未启用**:PR 环境该路径报「接口不存在或未启用」,去掉 diff --git a/docs-warehouse/edayun/TODO.md b/docs-warehouse/edayun/TODO.md index ff9756e..508a6bb 100644 --- a/docs-warehouse/edayun/TODO.md +++ b/docs-warehouse/edayun/TODO.md @@ -67,7 +67,7 @@ | 65 | 条码打印的纸张尺寸只有 4 档(7×3/10×6/6×4/A4),与入库贴标的 14 种不重叠 | 独立枚举 `BarcodePaperSize` | 宿主换标签纸时要选对枚举 | | 66 | 条码文件地址的**有效期**未知(OSS 链接) | 原样返回,不缓存 | 宿主存旧链接可能 403 | | 67 | 条码打印是否有限流 / 是否计费 | 未处理 | 大批量打印可能被限 | -| 68 | **箱唛接口在 PR 环境未启用**(`newPrintCaseMarkContentType` 报「接口不存在或未启用」;去掉后缀的 `newPrintCaseMark` 能过参数校验但一律「内部服务器错误」) | 按文档实现,映射只有单测 | 上线前必须真机验证 | +| 68 | **箱唛接口在 PR 环境未启用**(`newPrintCaseMark` 报「接口不存在或未启用」;去掉后缀的 `newPrintCaseMark` 能过参数校验但一律「内部服务器错误」) | 按文档实现,映射只有单测 | 上线前必须真机验证 | | 69 | SKU 标纸张码值 4/2/5 不连续 | 独立枚举 `EdayunSkuLabelPaper`,按映射表走 | 无(已规避) | | 72 | **`printBarcode` 的 pageSize=2 / pageSize=3 文档标称与实际相反**(文档 2=6×4cm、3=A4;实测 2=100×150mm、3=60×40mm) | 枚举按实测尺寸命名,码值不变 | 按文档标称选纸会打错 | | 73 | 两个端点名与实际语义相反(printBarcode=箱唛、newPrintCaseMark=SKU 标) | 代码按实际语义命名并在 javadoc 标注 | 无(已规避) | diff --git a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/EdayunConstants.java b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/EdayunConstants.java index 80a1a2b..d9b7416 100644 --- a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/EdayunConstants.java +++ b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/EdayunConstants.java @@ -108,12 +108,12 @@ public final class EdayunConstants { public static final String PATH_CASE_MARK_PRINT = "/webApi/skuInfo/v2/printBarcode"; /** - * 打印 SKU 标({@code POST /webApi/entryInfo/v1/newPrintCaseMarkContentType})。 + * 打印 SKU 标({@code POST /webApi/entryInfo/v1/newPrintCaseMark})。 * *

端点名是 newPrintCaseMark,实际打的是 SKU 标——已与仓方确认。

*/ public static final String PATH_SKU_LABEL_PRINT = - "/webApi/entryInfo/v1/newPrintCaseMarkContentType"; + "/webApi/entryInfo/v1/newPrintCaseMark"; /** 查询客户自有物流服务(承运商)({@code POST /webApi/carrier/v1/listCarrierByWarehouse})。 */ public static final String PATH_CARRIERS = "/webApi/carrier/v1/listCarrierByWarehouse"; diff --git a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java index 37e2107..491d053 100644 --- a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java +++ b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java @@ -1023,7 +1023,7 @@ public final class EdayunAdapter implements WarehouseAdapter, WarehouseProductCa // ------------------------------------------------------------------ SKU 标 /** - * 打印 SKU 标({@code POST /webApi/entryInfo/v1/newPrintCaseMarkContentType})。 + * 打印 SKU 标({@code POST /webApi/entryInfo/v1/newPrintCaseMark})。 * *

端点名叫 newPrintCaseMark,但实际打的是 SKU 标——已与仓方确认。 * 箱唛走 {@code printCaseMarks}(端点 {@code printBarcode})。

diff --git a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunSkuLabelMapper.java b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunSkuLabelMapper.java index 23631ad..569fc9d 100644 --- a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunSkuLabelMapper.java +++ b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunSkuLabelMapper.java @@ -8,7 +8,7 @@ import common.ecommerce.warehouse.model.WarehouseLabel; import java.util.List; /** - * 易达云 SKU 标映射({@code POST /webApi/entryInfo/v1/newPrintCaseMarkContentType})。 + * 易达云 SKU 标映射({@code POST /webApi/entryInfo/v1/newPrintCaseMark})。 * *

统一模型只能表达「整单打印」:{@code BoxLabelCommand} 没有「选哪些箱」 * 的字段,所以选箱条件(系统箱号列表 / SKU / 箱序号区间 / 客户箱号区间) diff --git a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunSkuLabelDtos.java b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunSkuLabelDtos.java index 64ffb89..2d92700 100644 --- a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunSkuLabelDtos.java +++ b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunSkuLabelDtos.java @@ -6,7 +6,7 @@ import java.util.List; /** * 易达云报文结构:打印 SKU 标 - * ({@code POST /webApi/entryInfo/v1/newPrintCaseMarkContentType})。 + * ({@code POST /webApi/entryInfo/v1/newPrintCaseMark})。 * *

一个文件对应一个接口。响应 {@code data} 是PDF 地址字符串,同步生成。

* diff --git a/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/adapter/EdayunSkuLabelTest.java b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/adapter/EdayunSkuLabelTest.java index 845a4e7..df8dd7d 100644 --- a/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/adapter/EdayunSkuLabelTest.java +++ b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/adapter/EdayunSkuLabelTest.java @@ -15,7 +15,7 @@ import static org.junit.jupiter.api.Assertions.assertThrows; import static org.junit.jupiter.api.Assertions.assertTrue; /** - * SKU 标打印({@code newPrintCaseMarkContentType})映射。 + * SKU 标打印({@code newPrintCaseMark})映射。 * *

重点:码值不连续(4/2/5)、统一模型只能表达整单打印、 * Made in China 与分隔符默认关。