Browse Source

feat(yqn): 按 API 100 对接打印入库计划单 SKU 标

补齐上一提交预留的 SKU_LABEL 能力位。

- SkuLabelCommand:仓侧单号 + 来源单号 + 导出方式 + 尺寸 + 原产地 + 四个显示开关
- SkuLabelSizeType:14 种小尺寸(40×30 … 100×100),映射为运去哪
  labelSizeType 1..14。**不复用箱标的 LabelSizeType**:箱标只有 3 种尺寸
  (100×100 / 100×150 / 104×98),SKU 标是 14 种,两者取值集合几乎不重叠,
  合一个枚举会让「每页数量联动」那套约束套用到 SKU 标上
- YqnSkuLabelMapper 复用 YqnBoxLabelMapper 的 downloadMode 语义(1 压缩包 / 2 PDF)
- InboundCapable.printSkuLabel 默认抛不支持;门面 inbound().printSkuLabel(cmd)

沿用文档给出的默认值:中文默认不显示,二维码与 ERP_SKU 默认显示。
原产地上送前统一大写,空白按「不打印」处理并省略该字段。

同样是异步任务:只返回 taskNo,label() 恒为 null。

Co-Authored-By: Claude <noreply@anthropic.com>
feature/supplier-lingxing
chenchuchuan 2 weeks ago
parent
commit
c3716f6160
  1. 4
      README.md
  2. 15
      warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InboundCapable.java
  3. 67
      warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/SkuLabelSizeType.java
  4. 173
      warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/SkuLabelCommand.java
  5. 18
      warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/sdk/WarehouseOperations.java
  6. 2
      warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java
  7. 17
      warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java
  8. 100
      warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnSkuLabelMapper.java
  9. 26
      warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/dto/YqnDtos.java
  10. 150
      warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/adapter/YqnSkuLabelTest.java

4
README.md

@ -300,7 +300,7 @@ common.ecommerce
│ │ InboundStatus / TransferStatus / TransferType / LabelMode / │ │ InboundStatus / TransferStatus / TransferType / LabelMode /
│ │ CancelEligibility / InventorySyncStrategy / WarehouseFeeType / │ │ CancelEligibility / InventorySyncStrategy / WarehouseFeeType /
│ │ ReturnDealMethod / ReturnProcessDisposition / AttachmentType / │ │ ReturnDealMethod / ReturnProcessDisposition / AttachmentType /
│ │ LabelDownloadMode / LabelSizeType / LabelsPerPage │ │ LabelDownloadMode / LabelSizeType / LabelsPerPage / SkuLabelSizeType
│ ├── model ShipTo / OutboundOrder / OutboundCommand / OutboundLine / │ ├── model ShipTo / OutboundOrder / OutboundCommand / OutboundLine /
│ │ OutboundQuery / OutboundRef / OutboundReceipt / OutboundPackageSpec / │ │ OutboundQuery / OutboundRef / OutboundReceipt / OutboundPackageSpec /
│ │ PackageResult / WarehouseLabel / CancelCommand / CancelResult / │ │ PackageResult / WarehouseLabel / CancelCommand / CancelResult /
@ -310,7 +310,7 @@ common.ecommerce
│ │ WarehouseReturn / TransferCommand / TransferOrder / │ │ WarehouseReturn / TransferCommand / TransferOrder /
│ │ BillingDocument / FeeQuery / FeeEstimateQuery / FeeEstimateResult / │ │ BillingDocument / FeeQuery / FeeEstimateQuery / FeeEstimateResult /
│ │ TrackEvent / TrackingInfo / DestructionCommand / DestructionOrder / │ │ TrackEvent / TrackingInfo / DestructionCommand / DestructionOrder /
│ │ BoxLabelCommand / LabelPrintTask / WarehouseLabel │ │ BoxLabelCommand / SkuLabelCommand / LabelPrintTask / WarehouseLabel
│ ├── capability OutboundCapable / InventoryCapable / InboundCapable / │ ├── capability OutboundCapable / InventoryCapable / InboundCapable /
│ │ WarehouseReturnCapable / WarehouseFeeCapable / │ │ WarehouseReturnCapable / WarehouseFeeCapable /
│ │ WarehouseFeeEstimateCapable / TransferCapable / │ │ WarehouseFeeEstimateCapable / TransferCapable /

15
warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InboundCapable.java

@ -6,6 +6,7 @@ import common.ecommerce.warehouse.model.InboundCommand;
import common.ecommerce.warehouse.model.InboundOrder; import common.ecommerce.warehouse.model.InboundOrder;
import common.ecommerce.warehouse.model.InboundReceipt; import common.ecommerce.warehouse.model.InboundReceipt;
import common.ecommerce.warehouse.model.LabelPrintTask; import common.ecommerce.warehouse.model.LabelPrintTask;
import common.ecommerce.warehouse.model.SkuLabelCommand;
import common.ecommerce.warehouse.sdk.WarehouseAdapter; import common.ecommerce.warehouse.sdk.WarehouseAdapter;
import common.ecommerce.warehouse.sdk.WarehouseContext; import common.ecommerce.warehouse.sdk.WarehouseContext;
@ -46,4 +47,18 @@ public interface InboundCapable extends WarehouseAdapter {
throw new common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException( throw new common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException(
common.ecommerce.warehouse.enums.WarehouseCapability.BOX_LABEL); common.ecommerce.warehouse.enums.WarehouseCapability.BOX_LABEL);
} }
/**
* 打印入库计划单 SKU 标(商品贴标)。
*
* <p>与 {@link #printBoxLabel} 是两套东西:箱标贴外箱、按箱排版;SKU 标贴单个商品,
* 尺寸集合与排版参数都不同。同样是异步生成,只返回任务编号。</p>
*
* @throws common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException
* 该仓不声明 {@code SKU_LABEL}
*/
default LabelPrintTask printSkuLabel(WarehouseContext ctx, SkuLabelCommand cmd) {
throw new common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException(
common.ecommerce.warehouse.enums.WarehouseCapability.SKU_LABEL);
}
} }

67
warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/SkuLabelSizeType.java

@ -0,0 +1,67 @@
package common.ecommerce.warehouse.enums;
/**
* SKU 标纸尺寸(入库计划单商品贴标)。
*
* <p>与箱标用的 {@link LabelSizeType} 不是一套:箱标只有 3 种(100×100 / 100×150 /
* 104×98 美国信纸),SKU 标是 14 种小尺寸。两者的取值集合不重叠,合并会误导调用方。</p>
*/
public enum SkuLabelSizeType {
/** 40mm × 30mm。 */
SIZE_40_30(10, "40×30"),
/** 50mm × 30mm。 */
SIZE_50_30(20, "50×30"),
/** 50mm × 40mm。 */
SIZE_50_40(30, "50×40"),
/** 60mm × 30mm。 */
SIZE_60_30(40, "60×30"),
/** 60mm × 40mm。 */
SIZE_60_40(50, "60×40"),
/** 70mm × 20mm。 */
SIZE_70_20(60, "70×20"),
/** 70mm × 30mm。 */
SIZE_70_30(70, "70×30"),
/** 70mm × 40mm。 */
SIZE_70_40(80, "70×40"),
/** 70mm × 50mm。 */
SIZE_70_50(90, "70×50"),
/** 80mm × 50mm。 */
SIZE_80_50(100, "80×50"),
/** 80mm × 60mm。 */
SIZE_80_60(110, "80×60"),
/** 100mm × 30mm。 */
SIZE_100_30(120, "100×30"),
/** 100mm × 60mm。 */
SIZE_100_60(130, "100×60"),
/** 100mm × 100mm。 */
SIZE_100_100(140, "100×100");
private final int code;
private final String label;
SkuLabelSizeType(int code, String label) {
this.code = code;
this.label = label;
}
/** 落库用的稳定码;由 SDK 分配,永不复用、永不重排。 */
public int code() {
return code;
}
/** 中文显示名(即纸尺寸)。 */
public String label() {
return label;
}
/** 按落库码反查。 */
public static SkuLabelSizeType ofCode(int code) {
for (SkuLabelSizeType v : values()) {
if (v.code == code) {
return v;
}
}
return null;
}
}

173
warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/SkuLabelCommand.java

@ -0,0 +1,173 @@
package common.ecommerce.warehouse.model;
import common.ecommerce.warehouse.enums.LabelDownloadMode;
import common.ecommerce.warehouse.enums.SkuLabelSizeType;
/**
* 打印 SKU 标命令(入库计划单的商品贴标)。
*
* <p>与 {@link BoxLabelCommand}(外箱标)不是一回事:箱标贴外箱、按箱排版;
* SKU 标贴单个商品,尺寸集合完全不同。</p>
*
* <p>仓方同样是<b>异步</b>生成文件:返回的 {@link LabelPrintTask} 只有任务编号,
* 下载地址要另外查任务中心。</p>
*/
public final class SkuLabelCommand {
/** 入库计划单号(仓方口径),必填。 */
private final String providerInboundNo;
/** 来源单号(OMS 入库单号),必填。 */
private final String inboundRequestNo;
private final LabelDownloadMode downloadMode;
private final SkuLabelSizeType sizeType;
/** 原产地国家,ISO 3166-1 alpha-2;null 表示不打印原产地。 */
private final String originCountry;
/** 是否显示英文名称。 */
private final boolean showEn;
/** 是否显示中文名称。 */
private final boolean showCn;
/** 是否显示二维码。 */
private final boolean showQrCode;
/** 是否显示 ERP SKU。 */
private final boolean showErpSku;
private SkuLabelCommand(Builder b) {
this.providerInboundNo = require(b.providerInboundNo, "providerInboundNo");
this.inboundRequestNo = require(b.inboundRequestNo, "inboundRequestNo");
if (b.downloadMode == null) {
throw new IllegalArgumentException("downloadMode is required");
}
this.downloadMode = b.downloadMode;
if (b.sizeType == null) {
throw new IllegalArgumentException("sizeType is required");
}
this.sizeType = b.sizeType;
this.originCountry = normalizeCountry(b.originCountry);
this.showEn = b.showEn;
this.showCn = b.showCn;
this.showQrCode = b.showQrCode;
this.showErpSku = b.showErpSku;
}
public static Builder builder() {
return new Builder();
}
/** 入库计划单号(仓方口径)。 */
public String providerInboundNo() {
return providerInboundNo;
}
/** 来源单号(OMS 入库单号)。 */
public String inboundRequestNo() {
return inboundRequestNo;
}
public LabelDownloadMode downloadMode() {
return downloadMode;
}
public SkuLabelSizeType sizeType() {
return sizeType;
}
/** 原产地国家;null 表示不打印。 */
public String originCountry() {
return originCountry;
}
public boolean showEn() {
return showEn;
}
public boolean showCn() {
return showCn;
}
public boolean showQrCode() {
return showQrCode;
}
public boolean showErpSku() {
return showErpSku;
}
/** 国家码统一大写;空白视为未指定。 */
private static String normalizeCountry(String v) {
if (v == null || v.trim().isEmpty()) {
return null;
}
return v.trim().toUpperCase();
}
private static String require(String v, String name) {
if (v == null || v.trim().isEmpty()) {
throw new IllegalArgumentException(name + " must not be blank");
}
return v.trim();
}
public static final class Builder {
private String providerInboundNo;
private String inboundRequestNo;
private LabelDownloadMode downloadMode = LabelDownloadMode.PDF;
private SkuLabelSizeType sizeType;
private String originCountry;
private boolean showEn;
/** 文档默认否。 */
private boolean showCn;
/** 文档默认是。 */
private boolean showQrCode = true;
/** 文档默认是。 */
private boolean showErpSku = true;
public Builder providerInboundNo(String v) {
this.providerInboundNo = v;
return this;
}
public Builder inboundRequestNo(String v) {
this.inboundRequestNo = v;
return this;
}
public Builder downloadMode(LabelDownloadMode v) {
this.downloadMode = v;
return this;
}
public Builder sizeType(SkuLabelSizeType v) {
this.sizeType = v;
return this;
}
public Builder originCountry(String v) {
this.originCountry = v;
return this;
}
public Builder showEn(boolean v) {
this.showEn = v;
return this;
}
public Builder showCn(boolean v) {
this.showCn = v;
return this;
}
public Builder showQrCode(boolean v) {
this.showQrCode = v;
return this;
}
public Builder showErpSku(boolean v) {
this.showErpSku = v;
return this;
}
public SkuLabelCommand build() {
return new SkuLabelCommand(this);
}
}
}

18
warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/sdk/WarehouseOperations.java

@ -33,6 +33,7 @@ import common.ecommerce.warehouse.model.InboundCommand;
import common.ecommerce.warehouse.model.InboundOrder; import common.ecommerce.warehouse.model.InboundOrder;
import common.ecommerce.warehouse.model.InboundReceipt; import common.ecommerce.warehouse.model.InboundReceipt;
import common.ecommerce.warehouse.model.LabelPrintTask; import common.ecommerce.warehouse.model.LabelPrintTask;
import common.ecommerce.warehouse.model.SkuLabelCommand;
import common.ecommerce.warehouse.model.InventoryQuery; import common.ecommerce.warehouse.model.InventoryQuery;
import common.ecommerce.warehouse.model.InventorySnapshot; import common.ecommerce.warehouse.model.InventorySnapshot;
import common.ecommerce.warehouse.enums.InventorySyncStrategy; import common.ecommerce.warehouse.enums.InventorySyncStrategy;
@ -326,6 +327,23 @@ public final class WarehouseOperations {
r -> CallSupport.NO_COUNT, r -> CallSupport.NO_COUNT,
() -> ((InboundCapable) adapter).printBoxLabel(ctx, cmd)); () -> ((InboundCapable) adapter).printBoxLabel(ctx, cmd));
} }
/**
* 打印入库计划单 SKU 标(商品贴标)。
*
* <p>同样是异步任务:只拿到任务编号,文件要另外去任务中心取。不走幂等守卫——
* 重复调用只是再生成一份。</p>
*/
public LabelPrintTask printSkuLabel(SkuLabelCommand cmd) {
require(WarehouseCapability.SKU_LABEL, InboundCapable.class);
return CallSupport.observe(observer, ctx, "warehouse.inbound.skuLabel",
CallSupport.params("providerInboundNo", cmd.providerInboundNo(),
"inboundRequestNo", cmd.inboundRequestNo(),
"downloadMode", cmd.downloadMode(),
"sizeType", cmd.sizeType()),
r -> CallSupport.NO_COUNT,
() -> ((InboundCapable) adapter).printSkuLabel(ctx, cmd));
}
} }
/** 退货视图。 */ /** 退货视图。 */

2
warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/YqnConstants.java

@ -40,6 +40,8 @@ public final class YqnConstants {
public static final String PATH_INBOUND_CREATE = "/v1/inbound/createInboundPlan"; public static final String PATH_INBOUND_CREATE = "/v1/inbound/createInboundPlan";
/** 打印入库计划单箱标(API 99):异步生成,只回任务编号。 */ /** 打印入库计划单箱标(API 99):异步生成,只回任务编号。 */
public static final String PATH_INBOUND_BOX_LABEL = "/v1/inbound/generateBoxLabel"; public static final String PATH_INBOUND_BOX_LABEL = "/v1/inbound/generateBoxLabel";
/** 打印入库计划单 SKU 标(API 100):异步生成,只回任务编号。 */
public static final String PATH_INBOUND_SKU_LABEL = "/v1/inbound/generateItemLabel";
/** 查询入库计划(API 101)。 */ /** 查询入库计划(API 101)。 */
public static final String PATH_INBOUND_GET = "/v1/inbound/getInboundPlanInfo"; public static final String PATH_INBOUND_GET = "/v1/inbound/getInboundPlanInfo";
/** 创建销售退货(API 81)。 */ /** 创建销售退货(API 81)。 */

17
warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java

@ -34,6 +34,7 @@ import common.ecommerce.warehouse.model.BoxLabelCommand;
import common.ecommerce.warehouse.model.DestructionCommand; import common.ecommerce.warehouse.model.DestructionCommand;
import common.ecommerce.warehouse.model.DestructionOrder; import common.ecommerce.warehouse.model.DestructionOrder;
import common.ecommerce.warehouse.model.LabelPrintTask; import common.ecommerce.warehouse.model.LabelPrintTask;
import common.ecommerce.warehouse.model.SkuLabelCommand;
import common.ecommerce.warehouse.model.TrackEvent; import common.ecommerce.warehouse.model.TrackEvent;
import common.ecommerce.warehouse.model.TrackingInfo; import common.ecommerce.warehouse.model.TrackingInfo;
import common.ecommerce.warehouse.capability.WarehouseFeeEstimateCapable; import common.ecommerce.warehouse.capability.WarehouseFeeEstimateCapable;
@ -116,6 +117,7 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
WarehouseCapability.INVENTORY_QUERY, WarehouseCapability.INVENTORY_QUERY,
WarehouseCapability.INBOUND, WarehouseCapability.INBOUND,
WarehouseCapability.BOX_LABEL, WarehouseCapability.BOX_LABEL,
WarehouseCapability.SKU_LABEL,
WarehouseCapability.TRANSFER, WarehouseCapability.TRANSFER,
WarehouseCapability.RETURN, WarehouseCapability.RETURN,
WarehouseCapability.RETURN_DISPOSITION, WarehouseCapability.RETURN_DISPOSITION,
@ -514,6 +516,21 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
return YqnBoxLabelMapper.toTask(resp, cmd); return YqnBoxLabelMapper.toTask(resp, cmd);
} }
/**
* 打印入库计划单 SKU 标(API 100)。
*
* <p>同样是异步任务:响应只有 {@code taskNo},文件要另外查任务中心。</p>
*/
@Override
public LabelPrintTask printSkuLabel(WarehouseContext ctx, SkuLabelCommand cmd) {
YqnDtos.SkuLabelRequest body = YqnSkuLabelMapper.toRequest(cmd);
String raw = execute(ctx, YqnConstants.PATH_INBOUND_SKU_LABEL, body,
"warehouse.inbound.skuLabel");
YqnDtos.BoxLabelResponse resp =
json.fromJson(String.valueOf(json.nodeAt(raw, "data")), YqnDtos.BoxLabelResponse.class);
return YqnSkuLabelMapper.toTask(resp, cmd);
}
// ------------------------------------------------------------------ 销毁 // ------------------------------------------------------------------ 销毁
/** /**

100
warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnSkuLabelMapper.java

@ -0,0 +1,100 @@
package common.ecommerce.yqn.adapter;
import common.ecommerce.warehouse.enums.LabelDownloadMode;
import common.ecommerce.warehouse.enums.SkuLabelSizeType;
import common.ecommerce.warehouse.enums.WarehouseProvider;
import common.ecommerce.warehouse.model.LabelPrintTask;
import common.ecommerce.warehouse.model.SkuLabelCommand;
import common.ecommerce.yqn.dto.YqnDtos;
/**
* 运去哪入库 SKU 标报文映射(API 100)。
*/
public final class YqnSkuLabelMapper {
private YqnSkuLabelMapper() {
}
/** 统一命令 → 运去哪请求。 */
public static YqnDtos.SkuLabelRequest toRequest(SkuLabelCommand cmd) {
YqnDtos.SkuLabelRequest req = new YqnDtos.SkuLabelRequest();
req.orderNo = cmd.providerInboundNo();
req.sourceNo = cmd.inboundRequestNo();
req.downloadMode = downloadModeCode(cmd.downloadMode());
req.labelSizeType = sizeTypeCode(cmd.sizeType());
req.originCountry = cmd.originCountry();
req.isShowEn = cmd.showEn();
req.isShowCn = cmd.showCn();
req.isShowQrCode = cmd.showQrCode();
req.isShowErpSku = cmd.showErpSku();
return req;
}
/** 响应 → 任务。异步接口只回任务编号,不带文件。 */
public static LabelPrintTask toTask(YqnDtos.BoxLabelResponse resp, SkuLabelCommand cmd) {
return LabelPrintTask.builder()
.sourceProvider(WarehouseProvider.YQN)
.taskNo(resp.taskNo)
.providerInboundNo(hasText(resp.orderNo) ? resp.orderNo : cmd.providerInboundNo())
.inboundRequestNo(hasText(resp.sourceNo) ? resp.sourceNo : cmd.inboundRequestNo())
.build();
}
/** 导出方式 → 运去哪 downloadMode:1 压缩包 / 2 单个 PDF。 */
static Integer downloadModeCode(LabelDownloadMode mode) {
if (mode == null) {
return null;
}
switch (mode) {
case ARCHIVE:
return 1;
case PDF:
return 2;
default:
throw new IllegalArgumentException("yqn does not support downloadMode: " + mode);
}
}
/** 尺寸 → 运去哪 labelSizeType:1..14,按文档顺序。 */
static Integer sizeTypeCode(SkuLabelSizeType size) {
if (size == null) {
return null;
}
switch (size) {
case SIZE_40_30:
return 1;
case SIZE_50_30:
return 2;
case SIZE_50_40:
return 3;
case SIZE_60_30:
return 4;
case SIZE_60_40:
return 5;
case SIZE_70_20:
return 6;
case SIZE_70_30:
return 7;
case SIZE_70_40:
return 8;
case SIZE_70_50:
return 9;
case SIZE_80_50:
return 10;
case SIZE_80_60:
return 11;
case SIZE_100_30:
return 12;
case SIZE_100_60:
return 13;
case SIZE_100_100:
return 14;
default:
throw new IllegalArgumentException("yqn does not support sku labelSizeType: " + size);
}
}
private static boolean hasText(String v) {
return v != null && !v.trim().isEmpty();
}
}

26
warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/dto/YqnDtos.java

@ -1096,4 +1096,30 @@ public final class YqnDtos {
public String orderNo; public String orderNo;
public String sourceNo; public String sourceNo;
} }
// ------------------------------------------------------------------ 入库 SKU 标(API 100)
/** 打印入库计划单 SKU 标请求(API 100 {@code /v1/inbound/generateItemLabel})。 */
@JsonInclude(JsonInclude.Include.NON_NULL)
public static final class SkuLabelRequest {
/** 入库计划单号(仓侧 ip 单号)。 */
public String orderNo;
/** 来源单号。 */
public String sourceNo;
/** 1 合成压缩包 / 2 合成一个 pdf。 */
public Integer downloadMode;
/** 纸张大小,1..14(40*30 … 100*100)。 */
public Integer labelSizeType;
/** 原产地国家二字码;不打印时传 null。 */
public String originCountry;
/** 是否显示英文名称。 */
public Boolean isShowEn;
/** 是否展示中文名称;默认否。 */
public Boolean isShowCn;
/** 是否展示二维码;默认是。 */
public Boolean isShowQrCode;
/** 是否展示 ERP_SKU;默认是。 */
public Boolean isShowErpSku;
}
} }

150
warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/adapter/YqnSkuLabelTest.java

@ -0,0 +1,150 @@
package common.ecommerce.yqn.adapter;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.shared.spi.ChannelSecret;
import common.ecommerce.shared.testkit.RecordingTransport;
import common.ecommerce.shared.testkit.Responses;
import common.ecommerce.warehouse.enums.LabelDownloadMode;
import common.ecommerce.warehouse.enums.SkuLabelSizeType;
import common.ecommerce.warehouse.enums.WarehouseCapability;
import common.ecommerce.warehouse.enums.WarehouseProvider;
import common.ecommerce.warehouse.model.LabelPrintTask;
import common.ecommerce.warehouse.model.SkuLabelCommand;
import common.ecommerce.warehouse.sdk.WarehouseConnection;
import common.ecommerce.warehouse.sdk.WarehouseContext;
import common.ecommerce.yqn.YqnConstants;
import org.junit.jupiter.api.Test;
import java.time.Clock;
import java.time.Instant;
import java.time.ZoneOffset;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertNull;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertTrue;
/**
* 打印入库计划单 SKU 标(API 100)契约测试。
*/
class YqnSkuLabelTest {
private static final Clock CLOCK = Clock.fixed(Instant.parse("2026-11-10T00:00:00Z"), ZoneOffset.UTC);
private static WarehouseContext ctx() {
return WarehouseContext.of("YQN-RF_NY_US", WarehouseProvider.YQN, "RF_NY_US",
WarehouseConnection.of(YqnConstants.PR_BASE_URL,
ChannelSecret.builder().appSecret("key-1").build()),
"req-sku-label", CLOCK);
}
private static SkuLabelCommand command() {
return SkuLabelCommand.builder()
.providerInboundNo("IP20261110001")
.inboundRequestNo("OMS-IN-001")
.downloadMode(LabelDownloadMode.PDF)
.sizeType(SkuLabelSizeType.SIZE_70_30)
.originCountry("us")
.showEn(true)
.showCn(true)
.build();
}
private static String okBody() {
return "{\"statusCode\":200,\"status\":0,\"code\":200,\"message\":\"ok\","
+ "\"data\":{\"taskNo\":\"TK25082700004\",\"orderNo\":\"IP20261110001\","
+ "\"sourceNo\":\"OMS-IN-001\"}}";
}
@Test
void sendsDocumentedShape() {
RecordingTransport transport = RecordingTransport.create()
.route(YqnConstants.PATH_INBOUND_SKU_LABEL, req -> Responses.ok(okBody()));
YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec());
LabelPrintTask task = adapter.printSkuLabel(ctx(), command());
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"orderNo\":\"IP20261110001\""), body);
assertTrue(body.contains("\"sourceNo\":\"OMS-IN-001\""), body);
assertTrue(body.contains("\"downloadMode\":2"), body);
// 70*30 是文档里的第 7 个
assertTrue(body.contains("\"labelSizeType\":7"), body);
assertTrue(body.contains("\"originCountry\":\"US\""), body);
assertTrue(body.contains("\"isShowEn\":true"), body);
assertTrue(body.contains("\"isShowCn\":true"), body);
assertEquals("TK25082700004", task.taskNo());
assertEquals(WarehouseProvider.YQN, task.sourceProvider());
assertNull(task.label());
}
/** 文档默认:二维码与 ERP SKU 都显示,中文不显示。 */
@Test
void appliesDocumentedDefaults() {
SkuLabelCommand defaults = SkuLabelCommand.builder()
.providerInboundNo("IP1").inboundRequestNo("OMS-1")
.sizeType(SkuLabelSizeType.SIZE_40_30)
.build();
RecordingTransport transport = RecordingTransport.create()
.route(YqnConstants.PATH_INBOUND_SKU_LABEL, req -> Responses.ok(okBody()));
new YqnAdapter(transport, new JacksonJsonCodec()).printSkuLabel(ctx(), defaults);
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"isShowQrCode\":true"), body);
assertTrue(body.contains("\"isShowErpSku\":true"), body);
assertTrue(body.contains("\"isShowCn\":false"), body);
// 未指定原产地就不发这个字段
assertFalse(body.contains("originCountry"), body);
}
@Test
void originCountryIsUpperCasedAndBlankIsDropped() {
SkuLabelCommand blank = SkuLabelCommand.builder()
.providerInboundNo("IP1").inboundRequestNo("OMS-1")
.sizeType(SkuLabelSizeType.SIZE_40_30)
.originCountry(" ")
.build();
assertNull(blank.originCountry());
}
@Test
void allFourteenSizesMapInDocumentOrder() {
assertEquals(Integer.valueOf(1), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_40_30));
assertEquals(Integer.valueOf(2), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_50_30));
assertEquals(Integer.valueOf(3), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_50_40));
assertEquals(Integer.valueOf(4), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_60_30));
assertEquals(Integer.valueOf(5), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_60_40));
assertEquals(Integer.valueOf(6), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_70_20));
assertEquals(Integer.valueOf(7), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_70_30));
assertEquals(Integer.valueOf(8), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_70_40));
assertEquals(Integer.valueOf(9), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_70_50));
assertEquals(Integer.valueOf(10), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_80_50));
assertEquals(Integer.valueOf(11), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_80_60));
assertEquals(Integer.valueOf(12), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_100_30));
assertEquals(Integer.valueOf(13), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_100_60));
assertEquals(Integer.valueOf(14), YqnSkuLabelMapper.sizeTypeCode(SkuLabelSizeType.SIZE_100_100));
assertEquals(14, SkuLabelSizeType.values().length);
}
@Test
void archiveModeMapsToOne() {
assertEquals(Integer.valueOf(1), YqnSkuLabelMapper.downloadModeCode(LabelDownloadMode.ARCHIVE));
assertEquals(Integer.valueOf(2), YqnSkuLabelMapper.downloadModeCode(LabelDownloadMode.PDF));
}
@Test
void declaresSkuLabelCapability() {
YqnAdapter adapter = new YqnAdapter(RecordingTransport.create(), new JacksonJsonCodec());
assertTrue(adapter.capabilities().contains(WarehouseCapability.SKU_LABEL));
// 箱标与 SKU 标是两个独立能力位
assertTrue(adapter.capabilities().contains(WarehouseCapability.BOX_LABEL));
}
@Test
void sizeTypeIsRequired() {
assertThrows(IllegalArgumentException.class, () -> SkuLabelCommand.builder()
.providerInboundNo("IP1").inboundRequestNo("OMS-1").build());
}
}
Loading…
Cancel
Save