diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InventoryCapable.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InventoryCapable.java
index 748c1e0..9d529e9 100644
--- a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InventoryCapable.java
+++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/InventoryCapable.java
@@ -18,7 +18,13 @@ public interface InventoryCapable extends WarehouseAdapter {
/** 本仓支持的同步策略。 */
InventorySyncStrategy syncStrategy();
- /** 查库存;{@code updatedAfter} 仅在 {@link InventorySyncStrategy#TIME_WINDOW} 下生效。 */
+ /**
+ * 查库存。
+ *
+ *
{@code updatedAfter} 仅在 {@link InventorySyncStrategy#TIME_WINDOW} 下生效。
+ * {@code providerSkus} 是可选过滤:不支持的仓会忽略它并返回整仓库存,
+ * 调用方不能假定过滤一定生效。
+ */
Page query(WarehouseContext ctx, InventoryQuery query);
/** 其他出入库 / 调拨;信仓无此能力,会抛 {@code WarehouseUnsupportedCapabilityException}。 */
diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/OutboundQuery.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/OutboundQuery.java
index 3df8f5f..a7e2464 100644
--- a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/OutboundQuery.java
+++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/OutboundQuery.java
@@ -55,7 +55,12 @@ public final class OutboundQuery {
return providerOrderId;
}
- /** 按业务订单引用查。 */
+ /**
+ * 按业务订单引用(平台订单号)查。
+ *
+ * 并非所有仓都支持:只按来源单号查的仓会忽略该条件,
+ * 因此查不到时不要断定「单不存在」。
+ */
public String orderRef() {
return orderRef;
}
diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/PackageResult.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/PackageResult.java
index 9467009..26cff62 100644
--- a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/PackageResult.java
+++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/PackageResult.java
@@ -16,6 +16,8 @@ public final class PackageResult {
private final String outboundRequestNo;
private final String trackingNumber;
private final String carrier;
+ /** 承运商 code(仓方口径);只有承运商名称时为 null。 */
+ private final String carrierCode;
private final String labelRef;
private final Money weight;
private final Instant shippedAt;
@@ -31,6 +33,7 @@ public final class PackageResult {
this.outboundRequestNo = requireText(b.outboundRequestNo, "outboundRequestNo");
this.trackingNumber = b.trackingNumber;
this.carrier = b.carrier;
+ this.carrierCode = b.carrierCode;
this.labelRef = b.labelRef;
this.weight = b.weight;
this.shippedAt = b.shippedAt;
@@ -61,6 +64,11 @@ public final class PackageResult {
}
/** 面单引用(面单 ID / 下载地址);面单本体用 {@code labels()} 取。 */
+ /** 承运商 code;仓方未给时为 null。 */
+ public String carrierCode() {
+ return carrierCode;
+ }
+
public String labelRef() {
return labelRef;
}
@@ -101,6 +109,7 @@ public final class PackageResult {
private String outboundRequestNo;
private String trackingNumber;
private String carrier;
+ private String carrierCode;
private String labelRef;
private Money weight;
private Instant shippedAt;
@@ -128,6 +137,11 @@ public final class PackageResult {
return this;
}
+ public Builder carrierCode(String carrierCode) {
+ this.carrierCode = carrierCode;
+ return this;
+ }
+
public Builder labelRef(String labelRef) {
this.labelRef = labelRef;
return this;
diff --git a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java
index 2a36f0f..47473ee 100644
--- a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java
+++ b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnAdapter.java
@@ -116,13 +116,13 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
return java.util.EnumSet.of(
WarehouseCapability.PRODUCT,
WarehouseCapability.OUTBOUND,
- WarehouseCapability.SPLIT,
WarehouseCapability.FEE_SETTLEMENT,
WarehouseCapability.FEE_ESTIMATE,
WarehouseCapability.INVENTORY_QUERY,
WarehouseCapability.INBOUND,
WarehouseCapability.BOX_LABEL,
WarehouseCapability.SKU_LABEL,
+ WarehouseCapability.PLATFORM_LABEL_DELIVERY,
WarehouseCapability.LOGISTICS_PRODUCT,
WarehouseCapability.WAREHOUSE_DIRECTORY,
WarehouseCapability.TRANSFER,
@@ -153,6 +153,7 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
@Override
public OutboundReceipt create(WarehouseContext ctx, OutboundCommand cmd) {
requirePlatformLabelSupported(ctx, cmd.labelMode());
+ requireLabelContentForPlatformLabel(cmd);
YqnDtos.CreateOrderRequest body = YqnOutboundMapper.toRequest(cmd, warehouseId(ctx, cmd.warehouseId()));
String raw = execute(ctx, YqnConstants.PATH_ORDER_CREATE, body, "warehouse.outbound.create");
@@ -178,7 +179,8 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
// API 128 只按来源单号查;仓内部 id 查不了,调用方要给 outboundRequestNo
String orderNo = orderNoOf(ref);
YqnDtos.OrderDetail detail = findOne(ctx, orderNo, "warehouse.outbound.get");
- return detail == null ? null : YqnOutboundMapper.toOrder(detail, ctx.warehouseCode(), zoneOf(ctx));
+ return detail == null ? null
+ : YqnOutboundMapper.toOrder(detail, null, null, ctx.warehouseCode(), zoneOf(ctx));
}
/**
@@ -190,11 +192,14 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
*/
@Override
public Page query(WarehouseContext ctx, OutboundQuery query) {
- String orderNo = firstNonBlank(query.providerOrderId(), query.orderRef());
+ // API 128 只能按「来源单号」查:仓内部 id 与平台单号都查不了。
+ // orderRef 是平台单号,拿它当来源单号查会查不到或查错单,因此不参与查询。
+ String orderNo = firstNonBlank(query.providerOrderId(), null);
if (orderNo == null) {
throw new common.ecommerce.shared.error.ValidationException(
WarehouseException.builder()
- .message("yqn has no order list API; query requires providerOrderId or orderRef")
+ .message("yqn has no order list API; query requires providerOrderId "
+ + "(orderRef is a platform order number and is not queryable here)")
.operation("warehouse.outbound.query")
.warehouseCode(ctx.warehouseCode())
.provider(provider().name())
@@ -204,7 +209,7 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
YqnDtos.OrderDetail detail = findOne(ctx, orderNo, "warehouse.outbound.query");
return detail == null ? Page.empty()
: Page.last(java.util.Collections.singletonList(
- YqnOutboundMapper.toOrder(detail, ctx.warehouseCode(), zoneOf(ctx))));
+ YqnOutboundMapper.toOrder(detail, null, null, ctx.warehouseCode(), zoneOf(ctx))));
}
/** 调 findOne 并解析 data;订单不存在时返回 null。 */
@@ -726,6 +731,19 @@ public final class YqnAdapter implements OutboundCapable, WarehouseProductCapabl
// ------------------------------------------------------------------ internals
/** 面单模式必须与仓能力匹配;不支持时拒绝,不静默降级。 */
+ /**
+ * 平台面单必须带面单文件:只声明 {@code PLATFORM_LABEL} 却不给
+ * {@code labelContentBase64},仓没有面单可打,等于静默失败。
+ */
+ private static void requireLabelContentForPlatformLabel(OutboundCommand cmd) {
+ if (cmd.labelMode() == LabelMode.PLATFORM_LABEL
+ && (cmd.labelContentBase64() == null || cmd.labelContentBase64().trim().isEmpty())) {
+ throw new IllegalArgumentException(
+ "labelContentBase64 is required when labelMode=PLATFORM_LABEL for "
+ + cmd.outboundRequestNo());
+ }
+ }
+
private void requirePlatformLabelSupported(WarehouseContext ctx, LabelMode mode) {
if (mode == LabelMode.PLATFORM_LABEL && !supports(ctx.warehouseCode(),
WarehouseCapability.PLATFORM_LABEL_DELIVERY)) {
diff --git a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnOutboundMapper.java b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnOutboundMapper.java
index 0f2499a..8868c11 100644
--- a/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnOutboundMapper.java
+++ b/warehouse-sdk-yqn/src/main/java/common/ecommerce/yqn/adapter/YqnOutboundMapper.java
@@ -2,6 +2,7 @@ package common.ecommerce.yqn.adapter;
import common.ecommerce.shared.support.Money;
import common.ecommerce.warehouse.enums.CancelEligibility;
+import common.ecommerce.warehouse.enums.LabelMode;
import common.ecommerce.warehouse.model.OutboundCommand;
import common.ecommerce.warehouse.model.OutboundLine;
import common.ecommerce.warehouse.model.OutboundOrder;
@@ -37,6 +38,9 @@ public final class YqnOutboundMapper {
/** 运去哪时间按仓所在地解释;账户未配时回退北京时区。 */
private static final ZoneId DEFAULT_ZONE = ZoneId.of("Asia/Shanghai");
+ /** 附件类型:0 面单 / 1 装箱单 / 2 BOL / 3 其他 / 4 箱标 / 5 托盘标 / 6 商品标 / 7 发票 / 8 发货计划。 */
+ private static final int ATTACH_TYPE_SHIPPING_LABEL = 0;
+
/** 运去哪下单币种默认 USD。 */
private static final String DEFAULT_CURRENCY = "USD";
@@ -57,6 +61,10 @@ public final class YqnOutboundMapper {
req.estimatedDeliveryTime = formatTime(cmd.estimatedDeliveryTime());
req.salesPlatform = salesPlatformOf(cmd.salesPlatform());
req.remark = cmd.remark();
+ // 店铺:仓方按店铺做路由/计费;标准模型对应 shopName
+ req.channelAccount = cmd.shopName();
+ // SFP / VC 标识:1=SFP 2=VC;不传由仓按非 SFP 处理
+ req.isPrime = isPrimeOf(cmd.sfp());
ShipTo shipTo = cmd.shipTo();
req.shipToCountry = shipTo.countryCode();
@@ -73,6 +81,7 @@ public final class YqnOutboundMapper {
req.productItems = toProductItems(cmd.lines());
req.packageItems = toPackageItems(cmd.packages());
+ req.attachInfoItems = toAttachInfoItems(cmd, warehouseCode);
return req;
}
@@ -161,6 +170,78 @@ public final class YqnOutboundMapper {
return out;
}
+ /** SFP 标识 → 运去哪 isPrime:SFP=1 / VC=2;null 不传(仓按非 SFP 处理)。 */
+ static Integer isPrimeOf(Boolean sfp) {
+ return sfp == null ? null : (sfp ? 1 : 0);
+ }
+
+ /**
+ * 平台面单 → 运去哪附件 {@code attachInfoItems}。
+ *
+ * 这是 {@link LabelMode#PLATFORM_LABEL} 的实际落点:面单文件必须随单下发,
+ * 否则仓没有面单可打印。{@code packageNo} 与包裹的 {@code refNo} 一致,
+ * 只有一个包裹时把 {@code refNo} 带过去。
+ *
+ * 仓自有面单({@link LabelMode#WAREHOUSE_LABEL})或未给内容时返回 null。
+ */
+ private static List toAttachInfoItems(
+ OutboundCommand cmd, String warehouseCode) {
+ String content = cmd.labelContentBase64();
+ if (content == null || content.trim().isEmpty()) {
+ return null;
+ }
+ if (cmd.labelMode() != LabelMode.PLATFORM_LABEL) {
+ // 给了面单内容却不是平台面单模式:不静默丢弃,直接拒绝
+ throw new IllegalArgumentException(
+ "labelContentBase64 requires labelMode=PLATFORM_LABEL for "
+ + cmd.outboundRequestNo() + " (warehouse " + warehouseCode + ")");
+ }
+ YqnDtos.CreateOrderRequest.AttachInfoItem item =
+ new YqnDtos.CreateOrderRequest.AttachInfoItem();
+ // 附件名建议用 TrackingNo 且不带后缀;没有运单号时退回出库单号
+ item.name = firstNonBlank(cmd.trackingNumber(), cmd.outboundRequestNo());
+ String base64 = stripDataUri(content);
+ String format = dataUriFormat(content);
+ item.file = base64;
+ item.fileType = format == null ? "pdf" : format;
+ item.type = ATTACH_TYPE_SHIPPING_LABEL;
+ List packages = cmd.packages();
+ if (packages != null && packages.size() == 1) {
+ item.packageNo = packages.get(0).refNo();
+ }
+ List out =
+ new ArrayList(1);
+ out.add(item);
+ return out;
+ }
+
+ /** 去掉 {@code data:xxx/base64,} 头;没有头时原样返回。 */
+ static String stripDataUri(String content) {
+ if (content == null) {
+ return null;
+ }
+ int comma = content.indexOf(',');
+ if (content.startsWith("data:") && comma > 0) {
+ return content.substring(comma + 1);
+ }
+ return content;
+ }
+
+ /** 从 {@code data:application/pdf;base64,} 里取格式;取不到返回 null。 */
+ static String dataUriFormat(String content) {
+ if (content == null || !content.startsWith("data:")) {
+ return null;
+ }
+ int semi = content.indexOf(';');
+ int comma = content.indexOf(',');
+ if (semi <= 5 || comma < 0) {
+ return null;
+ }
+ String mime = content.substring(5, semi);
+ int slash = mime.indexOf('/');
+ return slash < 0 || slash == mime.length() - 1 ? null : mime.substring(slash + 1);
+ }
+
/** 运去哪时间格式 {@code yyyy-MM-dd HH:mm:ss}。 */
static String formatTime(Instant instant) {
return instant == null ? null : TIME_FORMAT.format(instant.atZone(DEFAULT_ZONE));
@@ -168,11 +249,25 @@ public final class YqnOutboundMapper {
/** 订单详情 → 统一出库单(API 128)。 */
public static OutboundOrder toOrder(YqnDtos.OrderDetail detail, String warehouseCode, ZoneId zone) {
+ return toOrder(detail, null, null, warehouseCode, zone);
+ }
+
+ /**
+ * 订单详情 → 统一出库单(API 128)。
+ *
+ * @param requestedLabelMode 下单时的面单模式;API 128 不回传,查询侧无法得知,
+ * 只能由调用方带过来(null 时按仓自有面单兜底)
+ * @param requestedAt 下单时间;API 128 不回传,同样由调用方带过来
+ */
+ public static OutboundOrder toOrder(YqnDtos.OrderDetail detail, LabelMode requestedLabelMode,
+ Instant requestedAt, String warehouseCode, ZoneId zone) {
List shippedPackages = shippedPackagesOf(detail);
- return OutboundOrder.builder()
+ OutboundOrder.Builder builder = OutboundOrder.builder()
.warehouseCode(firstNonBlank(detail.warehouseCode, warehouseCode))
.outboundRequestNo(firstNonBlank(detail.orderNo, null))
.orderRef(null) // API 128 不返回平台单号
+ .labelMode(requestedLabelMode)
+ .requestedAt(requestedAt)
.status(YqnOutboundStatus.of(detail.orderStatusEnum).toCore())
.rawStatus(detail.orderStatusEnum)
.carrier(packagesCarrierOf(shippedPackages, detail.carrierCode))
@@ -185,8 +280,8 @@ public final class YqnOutboundMapper {
.shipTo(toShipTo(detail))
.exceptionCode(exceptionOf(detail.errorCode))
.estimatedShippingFee(moneyOrNull(detail.estimatedShippingFee, detail.currency))
- .sourceProvider(WarehouseProvider.YQN)
- .build();
+ .sourceProvider(WarehouseProvider.YQN);
+ return builder.build();
}
/**
@@ -228,6 +323,7 @@ public final class YqnOutboundMapper {
.outboundRequestNo(orderNo)
.trackingNumber(tracking)
.carrier(pkg.carrier)
+ .carrierCode(pkg.carrierCode)
.carrierServiceCode(pkg.carrierServiceCode)
.erpSku(pkg.erpSku)
.shippedQuantity(pkg.shipedQuantity)
diff --git a/warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/adapter/YqnAdapterTest.java b/warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/adapter/YqnAdapterTest.java
index f966419..12be4c7 100644
--- a/warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/adapter/YqnAdapterTest.java
+++ b/warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/adapter/YqnAdapterTest.java
@@ -98,14 +98,18 @@ class YqnAdapterTest {
assertEquals("token-1", transport.recorded().get(0).headers().get(YqnConstants.TOKEN_HEADER));
}
+ /**
+ * 平台面单能力已声明(面单内容会作为附件下发,见 YqnOutboundPayloadTest);
+ * 但没给面单文件时必须拒绝,否则仓拿不到面单可打。
+ */
@Test
- void platformLabelWithoutCapabilityIsRejected() {
+ void platformLabelWithoutContentIsRejected() {
YqnAdapter adapter = new YqnAdapter(RecordingTransport.create(), new JacksonJsonCodec());
- assertFalse(adapter.capabilities().contains(WarehouseCapability.PLATFORM_LABEL_DELIVERY));
+ assertTrue(adapter.capabilities().contains(WarehouseCapability.PLATFORM_LABEL_DELIVERY));
RuntimeException ex = org.junit.jupiter.api.Assertions.assertThrows(RuntimeException.class,
() -> adapter.create(ctx(), command("OB-2", LabelMode.PLATFORM_LABEL)));
- assertTrue(ex.getMessage().contains("PLATFORM_LABEL_DELIVERY"), ex.getMessage());
+ assertTrue(ex.getMessage().contains("labelContentBase64"), ex.getMessage());
}
@Test
diff --git a/warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/adapter/YqnOutboundPayloadTest.java b/warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/adapter/YqnOutboundPayloadTest.java
new file mode 100644
index 0000000..8825b12
--- /dev/null
+++ b/warehouse-sdk-yqn/src/test/java/common/ecommerce/yqn/adapter/YqnOutboundPayloadTest.java
@@ -0,0 +1,172 @@
+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.shared.model.Platform;
+import common.ecommerce.warehouse.enums.LabelMode;
+import common.ecommerce.warehouse.enums.WarehouseCapability;
+import common.ecommerce.warehouse.enums.WarehouseProvider;
+import common.ecommerce.warehouse.model.OutboundCommand;
+import common.ecommerce.warehouse.model.OutboundLine;
+import common.ecommerce.warehouse.model.ShipTo;
+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.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * 出库链路的参数完整性契约测试(平台面单 / 店铺 / SFP / 拆单 / data URI)。
+ */
+class YqnOutboundPayloadTest {
+
+ 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-payload", CLOCK);
+ }
+
+ private static OutboundCommand.Builder baseCommand() {
+ return OutboundCommand.builder()
+ .outboundRequestNo("OB-1")
+ .orderRef("AMZ-1")
+ .carrier("FEDEX")
+ .carrierCode("WLC-FEDEX")
+ .salesPlatform(Platform.AMAZON_SC)
+ .shipTo(ShipTo.builder()
+ .name("张三").phone("+1-555-0100")
+ .countryCode("US").stateOrProvince("NY").city("New York")
+ .addressLine1("1 Main St").postalCode("10001")
+ .build())
+ .line(OutboundLine.builder()
+ .lineNo("1").omsSku("DM00001").quantity(2)
+ .declareValue(common.ecommerce.shared.support.Money.of("10.00", "USD"))
+ .build());
+ }
+
+ /** 平台面单:base64 必须随单下发给仓,否则仓没有面单可打。 */
+ @Test
+ void platformLabelContentIsSentAsAttachment() {
+ RecordingTransport transport = RecordingTransport.create()
+ .route(YqnConstants.PATH_ORDER_CREATE, req -> Responses.ok(
+ "{\"statusCode\":200,\"status\":0,\"code\":200,\"data\":{\"orderId\":123}}"));
+ YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec());
+
+ adapter.create(ctx(), baseCommand()
+ .labelMode(LabelMode.PLATFORM_LABEL)
+ .labelContentBase64("JVBERi0xLjQK")
+ .build());
+
+ String body = transport.lastDataRequest().body();
+ assertTrue(body.contains("\"attachInfoItems\""), body);
+ assertTrue(body.contains("\"file\":\"JVBERi0xLjQK\""), body);
+ assertTrue(body.contains("\"type\":0"), body); // 0 = 面单
+ assertTrue(body.contains("\"fileType\":\"pdf\""), body);
+ }
+
+ /** data URI 头要去掉,格式要从 MIME 里取。 */
+ @Test
+ void dataUriIsStrippedAndFormatDetected() {
+ RecordingTransport transport = RecordingTransport.create()
+ .route(YqnConstants.PATH_ORDER_CREATE, req -> Responses.ok(
+ "{\"statusCode\":200,\"status\":0,\"code\":200,\"data\":{\"orderId\":1}}"));
+ new YqnAdapter(transport, new JacksonJsonCodec()).create(ctx(), baseCommand()
+ .labelMode(LabelMode.PLATFORM_LABEL)
+ .labelContentBase64("data:image/png;base64,AAAA")
+ .build());
+
+ String body = transport.lastDataRequest().body();
+ assertTrue(body.contains("\"file\":\"AAAA\""), body);
+ assertTrue(body.contains("\"fileType\":\"png\""), body);
+ }
+
+ /** 给了面单内容却是仓自有面单模式:拒绝,不静默丢弃。 */
+ @Test
+ void labelContentWithoutPlatformModeIsRejected() {
+ YqnAdapter adapter = new YqnAdapter(RecordingTransport.create(), new JacksonJsonCodec());
+
+ assertThrows(IllegalArgumentException.class, () -> adapter.create(ctx(), baseCommand()
+ .labelMode(LabelMode.WAREHOUSE_LABEL)
+ .labelContentBase64("JVBERi0xLjQK")
+ .build()));
+ }
+
+ /** 仓自有面单不带附件。 */
+ @Test
+ void warehouseLabelSendsNoAttachment() {
+ RecordingTransport transport = RecordingTransport.create()
+ .route(YqnConstants.PATH_ORDER_CREATE, req -> Responses.ok(
+ "{\"statusCode\":200,\"status\":0,\"code\":200,\"data\":{\"orderId\":1}}"));
+ new YqnAdapter(transport, new JacksonJsonCodec())
+ .create(ctx(), baseCommand().labelMode(LabelMode.WAREHOUSE_LABEL).build());
+
+ assertFalse(transport.lastDataRequest().body().contains("attachInfoItems"));
+ }
+
+ @Test
+ void shopAndSfpAreSent() {
+ RecordingTransport transport = RecordingTransport.create()
+ .route(YqnConstants.PATH_ORDER_CREATE, req -> Responses.ok(
+ "{\"statusCode\":200,\"status\":0,\"code\":200,\"data\":{\"orderId\":1}}"));
+ new YqnAdapter(transport, new JacksonJsonCodec()).create(ctx(), baseCommand()
+ .shopName("NYC-STORE")
+ .sfp(true)
+ .build());
+
+ String body = transport.lastDataRequest().body();
+ assertTrue(body.contains("\"channelAccount\":\"NYC-STORE\""), body);
+ assertTrue(body.contains("\"isPrime\":1"), body);
+ }
+
+ @Test
+ void sfpFalseIsZeroNotEmpty() {
+ assertEquals(Integer.valueOf(0), YqnOutboundMapper.isPrimeOf(false));
+ assertEquals(Integer.valueOf(1), YqnOutboundMapper.isPrimeOf(true));
+ assertEquals(null, YqnOutboundMapper.isPrimeOf(null));
+ }
+
+ /**
+ * API 128 只能按来源单号查。之前把 orderRef(平台单号)当来源单号传,
+ * 会查不到或查错单——现在 orderRef 不参与查询。
+ */
+ @Test
+ void queryDoesNotTreatOrderRefAsSourceNo() {
+ YqnAdapter adapter = new YqnAdapter(RecordingTransport.create(), new JacksonJsonCodec());
+
+ RuntimeException ex = assertThrows(RuntimeException.class, () -> adapter.query(ctx(),
+ common.ecommerce.warehouse.model.OutboundQuery.builder().orderRef("AMZ-1").build()));
+ assertTrue(ex.getMessage().contains("providerOrderId"), ex.getMessage());
+ }
+
+ @Test
+ void queryByProviderOrderIdStillWorks() {
+ RecordingTransport transport = RecordingTransport.create()
+ .route(YqnConstants.PATH_ORDER_FIND_ONE, req -> Responses.ok(
+ "{\"statusCode\":200,\"status\":0,\"code\":200,\"data\":{"
+ + "\"orderNo\":\"OB-1\",\"orderStatusEnum\":\"PICKING\"}}"));
+ YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec());
+
+ assertEquals(1, adapter.query(ctx(), common.ecommerce.warehouse.model.OutboundQuery.builder()
+ .providerOrderId("OB-1").build()).size());
+ }
+
+ /** 运去哪下单接口没有拆单字段,能力位不能再声明 SPLIT。 */
+ @Test
+ void splitIsNotDeclared() {
+ YqnAdapter adapter = new YqnAdapter(RecordingTransport.create(), new JacksonJsonCodec());
+ assertFalse(adapter.capabilities().contains(WarehouseCapability.SPLIT));
+ }
+}