Browse Source

fix(edayun): 修正 SKU 标端点路径(去掉 ContentType 后缀)

正确路径是 /webApi/entryInfo/v1/newPrintCaseMark,之前按文档写成了
newPrintCaseMarkContentType,PR 环境一直报「接口不存在或未启用」,
被误判成「真机未启用」。

改路径后重测:接口存在且能过参数校验(缺 pageSize 报「纸张不能为空」、
缺 madeInChina 报「产地标签不能为空」),但补全后一律「内部服务器错误」,
试过 6 种 pageSize、madeInChina 0/1、separation、箱序号区间、skuCode、
caseCodeList、甚至不存在的 entryCode,返回都一样——说明是仓方内部异常,
不是我们的参数问题。因此仍然只有单测覆盖,TODO #68 保留。

Co-Authored-By: Claude <noreply@anthropic.com>
feature/Walmart
chenchuchuan 3 days ago
parent
commit
5dce79ea32
  1. 8
      docs-warehouse/edayun/README.md
  2. 2
      docs-warehouse/edayun/TODO.md
  3. 4
      warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/EdayunConstants.java
  4. 2
      warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java
  5. 2
      warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunSkuLabelMapper.java
  6. 2
      warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunSkuLabelDtos.java
  7. 2
      warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/adapter/EdayunSkuLabelTest.java

8
docs-warehouse/edayun/README.md

@ -28,7 +28,7 @@ @@ -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<TrackEvent> / TrackingInfo @@ -1154,7 +1154,7 @@ POST /webApi/track/getTrackInfoList → List<TrackEvent> / 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 @@ -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 环境该路径报「接口不存在或未启用」,去掉

2
docs-warehouse/edayun/TODO.md

@ -67,7 +67,7 @@ @@ -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 标注 | 无(已规避) |

4
warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/EdayunConstants.java

@ -108,12 +108,12 @@ public final class EdayunConstants { @@ -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})。
*
* <p>端点名是 newPrintCaseMark,实际打的是 SKU 标——已与仓方确认。</p>
*/
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";

2
warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java

@ -1023,7 +1023,7 @@ public final class EdayunAdapter implements WarehouseAdapter, WarehouseProductCa @@ -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})。
*
* <p><b>端点名叫 newPrintCaseMark,但实际打的是 SKU 标</b>——已与仓方确认。
* 箱唛走 {@code printCaseMarks}(端点 {@code printBarcode})。</p>

2
warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunSkuLabelMapper.java

@ -8,7 +8,7 @@ import common.ecommerce.warehouse.model.WarehouseLabel; @@ -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})。
*
* <p><b>统一模型只能表达「整单打印」</b>:{@code BoxLabelCommand} 没有「选哪些箱」
* 的字段,所以选箱条件(系统箱号列表 / SKU / 箱序号区间 / 客户箱号区间)

2
warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunSkuLabelDtos.java

@ -6,7 +6,7 @@ import java.util.List; @@ -6,7 +6,7 @@ import java.util.List;
/**
* 易达云报文结构:打印 SKU 标
* ({@code POST /webApi/entryInfo/v1/newPrintCaseMarkContentType})。
* ({@code POST /webApi/entryInfo/v1/newPrintCaseMark})。
*
* <p>一个文件对应一个接口。响应 {@code data} 是<b>PDF 地址字符串</b>,同步生成。</p>
*

2
warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/adapter/EdayunSkuLabelTest.java

@ -15,7 +15,7 @@ import static org.junit.jupiter.api.Assertions.assertThrows; @@ -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})映射。
*
* <p>重点:码值不连续(4/2/5)、统一模型只能表达整单打印、
* Made in China 与分隔符默认关。</p>

Loading…
Cancel
Save