diff --git a/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/sdk/EdayunSdkSmokeTest.java b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/sdk/EdayunSdkSmokeTest.java
new file mode 100644
index 0000000..0f09551
--- /dev/null
+++ b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/sdk/EdayunSdkSmokeTest.java
@@ -0,0 +1,436 @@
+package common.ecommerce.edayun.sdk;
+
+import common.ecommerce.edayun.EdayunConstants;
+import common.ecommerce.edayun.adapter.EdayunAdapter;
+import common.ecommerce.edayun.adapter.EdayunAdapterFactory;
+import common.ecommerce.shared.model.Platform;
+import common.ecommerce.shared.spi.ChannelSecret;
+import common.ecommerce.shared.support.Money;
+import common.ecommerce.shared.testkit.InMemoryIdempotencyStore;
+import common.ecommerce.shared.testkit.InMemoryLockProvider;
+import common.ecommerce.http.JacksonJsonCodec;
+import common.ecommerce.shared.testkit.InMemoryTokenStore;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
+import common.ecommerce.warehouse.enums.CaseMarkPaperSize;
+import common.ecommerce.warehouse.enums.CancelEligibility;
+import common.ecommerce.warehouse.enums.ReturnDealMethod;
+import common.ecommerce.warehouse.enums.WarehouseCapability;
+import common.ecommerce.warehouse.enums.WarehouseProvider;
+import common.ecommerce.warehouse.model.CaseMarkPrintCommand;
+import common.ecommerce.warehouse.model.BolDocument;
+import common.ecommerce.warehouse.model.CancelCommand;
+import common.ecommerce.warehouse.model.CancelResult;
+import common.ecommerce.warehouse.model.FeeEstimateQuery;
+import common.ecommerce.warehouse.model.FeeEstimateResult;
+import common.ecommerce.warehouse.model.InventoryQuery;
+import common.ecommerce.warehouse.model.InventorySnapshot;
+import common.ecommerce.warehouse.model.LogisticsProduct;
+import common.ecommerce.warehouse.model.OutboundCommand;
+import common.ecommerce.warehouse.model.OutboundLine;
+import common.ecommerce.warehouse.model.OutboundOrder;
+import common.ecommerce.warehouse.model.OutboundReceipt;
+import common.ecommerce.warehouse.model.OutboundRef;
+import common.ecommerce.warehouse.model.ReturnCommand;
+import common.ecommerce.warehouse.model.ReturnQuery;
+import common.ecommerce.warehouse.model.ShipTo;
+import common.ecommerce.warehouse.model.TrackEvent;
+import common.ecommerce.warehouse.model.TrackingInfo;
+import common.ecommerce.warehouse.model.WarehouseCarrier;
+import common.ecommerce.warehouse.model.WarehouseFacility;
+import common.ecommerce.warehouse.model.WarehouseLabel;
+import common.ecommerce.warehouse.model.WarehouseReturn;
+import common.ecommerce.warehouse.sdk.WarehouseConnection;
+import common.ecommerce.warehouse.sdk.WarehouseSdk;
+import common.ecommerce.warehouse.spi.WarehouseAccount;
+import common.ecommerce.warehouse.testkit.InMemoryWarehouses;
+import org.junit.jupiter.api.Test;
+
+import java.math.BigDecimal;
+import java.time.Clock;
+import java.time.Instant;
+import java.time.ZoneOffset;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * 易达云 SDK 装配链路冒烟。
+ *
+ *
不联网:走 {@link WarehouseSdk} 门面 → 工厂 → 适配器 → 假传输层,
+ * 用真实报文样本验一遍「能不能装起来、能力位对不对、字段有没有搬对」。
+ *
+ * 覆盖的业务场景:
+ *
+ * - 主数据:仓库 / 承运商 / 物流产品
+ * - 发货:试算 → 建单 → 查单 → 面单 → 取消
+ * - 库存:查询
+ * - 退货:建单 → 查详情 → 列表 → 取消
+ * - 单据 / 轨迹 / 打印
+ *
+ */
+class EdayunSdkSmokeTest {
+
+ private static final Clock CLOCK = Clock.fixed(Instant.parse("2026-11-16T00:00:00Z"), ZoneOffset.UTC);
+ private static final String WH = "EDY-USLA";
+ private static final String BASE = "https://test.omniselling.com.cn/saas-service/openapi/microService";
+
+ private static WarehouseSdk sdk(RecordingTransport transport) {
+ InMemoryWarehouses repo = new InMemoryWarehouses().put(WarehouseAccount.builder()
+ .warehouseCode(WH)
+ .provider(WarehouseProvider.EDAYUN.name())
+ .providerWarehouseId("2")
+ .credentialRef("kms://test/edayun")
+ .timeZone("America/Los_Angeles")
+ .build());
+ // 直接注册适配器实例:把传输层换成假的,其余装配(token 缓存 / 锁 / 时钟)与
+ // 生产走同一套构造参数。工厂路径由 factoryAssemblesAdapter 单独验证。
+ EdayunAdapter adapter = new EdayunAdapter(transport, new JacksonJsonCodec(),
+ new InMemoryTokenStore(), new InMemoryLockProvider(), CLOCK);
+ return WarehouseSdk.builder()
+ .warehouseRepository(repo)
+ .idempotencyStore(new InMemoryIdempotencyStore())
+ .clock(CLOCK)
+ .register(adapter)
+ .build();
+ }
+
+ private static WarehouseConnection conn() {
+ return WarehouseConnection.of(BASE, ChannelSecret.builder()
+ .appKey("ak").appSecret("sk")
+ .clientId("cid").clientSecret("cs")
+ .build());
+ }
+
+ /** 所有业务接口共用的假传输层:token + 按路径路由。 */
+ private static RecordingTransport transport() {
+ return RecordingTransport.create()
+ .route(EdayunConstants.PATH_TOKEN, req -> Responses.ok(
+ "{\"access_token\":\"T1\",\"token_type\":\"bearer\"}"))
+ .route(EdayunConstants.PATH_WAREHOUSE_PERMITTED, req -> Responses.ok(
+ "{\"code\":200,\"data\":[{\"warehouseId\":\"2\",\"warehouseName\":\"美西1仓\","
+ + "\"warehouseCode\":\"USLA\",\"countryCode\":\"US\"}]}"))
+ .route(EdayunConstants.PATH_CARRIERS, req -> Responses.ok(
+ "{\"code\":200,\"data\":[{\"carrierId\":\"1\",\"carrierNameEn\":\"FedEx\","
+ + "\"carrierNameCn\":\"FedEx\",\"ownLogisticList\":["
+ + "{\"logisticId\":\"250\",\"logisticName\":\"FedEx-express\"}]}]}"))
+ .route(EdayunConstants.PATH_LOGISTICS_PRODUCTS, req -> Responses.ok(
+ "{\"code\":200,\"data\":[{\"productId\":\"133\",\"productName\":\"USPS\"},"
+ + "{\"productId\":\"-998\",\"productName\":\"使用分物流规则\"}]}"))
+ .route(EdayunConstants.PATH_FEE_ESTIMATE, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"操作成功\",\"data\":{\"successItems\":[{"
+ + "\"logisticProductId\":\"80\",\"logisticProductName\":\"美国经济派送\","
+ + "\"currencyCode\":\"USD\",\"estimatedPrice\":5.315,"
+ + "\"detailList\":[{\"billingItemName\":\"尾程配送费\","
+ + "\"estimatedPrice\":3.315,\"currencyCode\":\"USD\"}]}],"
+ + "\"failItems\":[]}}"))
+ .route(EdayunConstants.PATH_ORDER_CREATE, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"操作成功\",\"data\":{\"orderNo\":\"ORD1001\","
+ + "\"poNumber\":\"SO-1\"}}"))
+ .route(EdayunConstants.PATH_ORDER_GET, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"操作成功\",\"data\":{\"orderNo\":\"ORD1001\","
+ + "\"poNumber\":\"SO-1\",\"orderStatus\":\"Shipped\","
+ + "\"trackingNo\":\"1Z111\"}}"))
+ .route(EdayunConstants.PATH_ORDER_LABEL, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"操作成功\",\"data\":{\"orderNo\":\"ORD1001\","
+ + "\"trackingNo\":\"1Z111\",\"labels\":\"https://oss/l1.pdf\"}}"))
+ .route(EdayunConstants.PATH_ORDER_CHECK_CANCEL, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"操作成功\",\"data\":\"Published\"}"))
+ .route(EdayunConstants.PATH_ORDER_CANCEL, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"操作成功\",\"data\":true}"))
+ .route(EdayunConstants.PATH_INVENTORY, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"success\",\"total\":1,\"rows\":[{"
+ + "\"skuCode\":\"ybtest\",\"stock\":\"4\",\"totalStock\":\"10\","
+ + "\"inTransitStock\":\"20\",\"frozenStock\":\"1\","
+ + "\"toDeliverStock\":\"2\",\"safeStock\":null,"
+ + "\"warehouseCode\":\"USLA\"}]}"))
+ .route(EdayunConstants.PATH_RETURN_CREATE, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"操作成功\",\"data\":\"RMA1001\"}"))
+ .route(EdayunConstants.PATH_RETURN_DETAIL, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"操作成功\",\"data\":{\"basicInfo\":{"
+ + "\"rmaCode\":\"RMA1001\",\"status\":5,\"statusName\":\"已处理\","
+ + "\"relationNo\":\"SO-1\",\"warehouseName\":\"美西1仓\"},"
+ + "\"checkList\":[{\"skuCode\":\"ybtest\",\"skuNum\":1,"
+ + "\"commandName\":\"上架\"}]}}"))
+ .route(EdayunConstants.PATH_RETURN_LIST, req -> Responses.ok(
+ "{\"total\":1,\"code\":200,\"rows\":[{\"rmaCode\":\"RMA1001\","
+ + "\"status\":5,\"statusName\":\"已处理\",\"warehouseName\":\"美西1仓\","
+ + "\"createTime\":1790568000000}]}"))
+ .route(EdayunConstants.PATH_RETURN_CANCEL, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"操作成功\",\"data\":true}"))
+ .route(EdayunConstants.PATH_BOL_LIST, req -> Responses.ok(
+ "{\"code\":200,\"data\":{\"bolList\":[{\"bolCode\":\"cp005\","
+ + "\"status\":11,\"statusName\":\"已妥投\",\"bolFileUrl\":\"https://oss/b.pdf\"}]}}"))
+ .route(EdayunConstants.PATH_TRACK, req -> Responses.ok(
+ "{\"code\":200,\"data\":[{\"trackingNo\":\"1Z111\",\"status\":1,"
+ + "\"carrierName\":\"fedex\",\"onlineTime\":\"2025-08-19 08:17:00\","
+ + "\"deliveredTime\":\"2025-08-20 10:00:00\",\"timeZone\":\"GMT-04:00\","
+ + "\"trackDetaillVoList\":[{\"recentDescribe\":\"上网\","
+ + "\"recentDescribeTime\":1741145821000}]}]}"))
+ .route(EdayunConstants.PATH_CASE_MARK_PRINT, req -> Responses.ok(
+ "{\"code\":200,\"msg\":\"操作成功\",\"data\":\"https://oss/case.pdf\"}"))
+ .route(EdayunConstants.PATH_INBOUND_SKU_DETAIL, req -> Responses.ok(
+ "{\"total\":1,\"code\":200,\"rows\":[{\"entryCode\":\"REV1\","
+ + "\"skuCode\":\"ybtest\",\"forecastQuantity\":10,"
+ + "\"actualCheckedQuantity\":10,\"shelvesQuantity\":10,"
+ + "\"status\":4,\"statusName\":\"已上架\"}]}"));
+ }
+
+ // ================================================================ 装配
+
+ /**
+ * 工厂装配:不联网,只验证 {@code build()} 能把适配器建出来、
+ * 能力位与 provider 对得上。
+ */
+ @Test
+ void factoryAssemblesAdapter() {
+ InMemoryWarehouses repo = new InMemoryWarehouses().put(WarehouseAccount.builder()
+ .warehouseCode(WH)
+ .provider(WarehouseProvider.EDAYUN.name())
+ .providerWarehouseId("2")
+ .credentialRef("kms://test/edayun")
+ .timeZone("America/Los_Angeles")
+ .build());
+ WarehouseSdk built = WarehouseSdk.builder()
+ .warehouseRepository(repo)
+ .clock(CLOCK)
+ .register(new EdayunAdapterFactory(
+ new InMemoryTokenStore(), new InMemoryLockProvider(), CLOCK))
+ .build();
+
+ assertTrue(built.capabilities(WH).supported().contains(WarehouseCapability.OUTBOUND));
+ // 能按仓解析到适配器:仓库清单会真的打一次仓方,用假传输层接
+ assertNotNull(built.warehouses(WH, conn()));
+ }
+
+ // ================================================================ 能力位
+
+ @Test
+ void declaresAllImplementedCapabilities() {
+ WarehouseSdk sdk = sdk(transport());
+ java.util.EnumSet caps = sdk.capabilities(WH).supported();
+
+ // 已实现
+ assertTrue(caps.contains(WarehouseCapability.PRODUCT), "商品");
+ assertTrue(caps.contains(WarehouseCapability.OUTBOUND), "出库");
+ assertTrue(caps.contains(WarehouseCapability.INVENTORY_QUERY), "库存");
+ assertTrue(caps.contains(WarehouseCapability.INBOUND), "入库");
+ assertTrue(caps.contains(WarehouseCapability.RETURN), "退货");
+ assertTrue(caps.contains(WarehouseCapability.FEE_SETTLEMENT), "费用");
+ assertTrue(caps.contains(WarehouseCapability.FEE_ESTIMATE), "试算");
+ assertTrue(caps.contains(WarehouseCapability.BOL), "BOL");
+ assertTrue(caps.contains(WarehouseCapability.TRACKING), "轨迹");
+ assertTrue(caps.contains(WarehouseCapability.LOGISTICS_PRODUCT), "物流产品");
+ assertTrue(caps.contains(WarehouseCapability.CASE_MARK_PRINT), "箱唛");
+ assertTrue(caps.contains(WarehouseCapability.DIRECTORY), "基础资料");
+
+ // 未实现——调了必须抛,不能返回空
+ assertTrue(!caps.contains(WarehouseCapability.TRANSFER), "易达云没有调拨");
+ assertTrue(!caps.contains(WarehouseCapability.WEBHOOK), "回调文档还没给");
+ assertTrue(!caps.contains(WarehouseCapability.RETURN_DISPOSITION), "缺行 id");
+ }
+
+ // ================================================================ 场景 1:主数据
+
+ @Test
+ void scenario1_masterData() {
+ WarehouseSdk sdk = sdk(transport());
+
+ List warehouses = sdk.warehouses(WH, conn()).warehouses();
+ assertEquals(1, warehouses.size());
+ assertEquals("USLA", warehouses.get(0).warehouseCode());
+ assertEquals("2", warehouses.get(0).providerWarehouseId());
+
+ List carriers = sdk.warehouses(WH, conn()).carrierDirectory();
+ assertEquals(1, carriers.size());
+ assertEquals("FedEx", carriers.get(0).nameEn());
+ assertEquals(1, carriers.get(0).logists().size());
+
+ List products = sdk.warehouses(WH, conn()).logisticsProducts(null);
+ // -998 已跳过
+ assertEquals(1, products.size());
+ assertEquals("133", products.get(0).logisticsProductCode());
+ }
+
+ // ================================================================ 场景 2:发货
+
+ @Test
+ void scenario2_shipping() {
+ RecordingTransport transport = transport();
+ WarehouseSdk sdk = sdk(transport);
+
+ // 2.1 发货前试算
+ List quotes = sdk.warehouses(WH, conn()).fees().estimate(
+ FeeEstimateQuery.builder()
+ .lengthCm(new BigDecimal("22")).widthCm(new BigDecimal("22"))
+ .heightCm(new BigDecimal("22")).weightGrams(new BigDecimal("1000"))
+ .receiveCountry("US").receivePostal("91761")
+ .logisticsServiceCode("80")
+ .build());
+ assertEquals(1, quotes.size());
+ assertEquals(1, quotes.get(0).carriers().size());
+ assertEquals(new BigDecimal("5.315"), quotes.get(0).carriers().get(0).totalRate().amount());
+
+ // 2.2 建单
+ OutboundReceipt receipt = sdk.warehouses(WH, conn()).outbound().create(outbound());
+ assertEquals("ORD1001", receipt.providerOrderId());
+
+ // 2.3 查单
+ OutboundOrder order = sdk.warehouses(WH, conn()).outbound()
+ .get(OutboundRef.ofRequestNo("SO-1"));
+ assertNotNull(order);
+ assertEquals("ORD1001", order.providerOrderId());
+
+ // 2.4 面单
+ assertEquals(1, sdk.warehouses(WH, conn()).outbound()
+ .packages(OutboundRef.ofRequestNo("SO-1")).size());
+
+ // 2.5 取消前校验 → 免费
+ assertEquals(CancelEligibility.FREE, sdk.warehouses(WH, conn()).outbound()
+ .checkCancel(OutboundRef.ofRequestNo("SO-1")));
+
+ // 2.6 取消
+ CancelResult cancelled = sdk.warehouses(WH, conn()).outbound().cancel(
+ CancelCommand.builder().outboundRequestNo("SO-1").providerOrderId("ORD1001").build());
+ assertTrue(cancelled.cancelled());
+ }
+
+ /** 建单幂等:同一个 outboundRequestNo 调两次只发一次请求。 */
+ @Test
+ void scenario2_createIsIdempotent() {
+ RecordingTransport transport = transport();
+ WarehouseSdk sdk = sdk(transport);
+
+ sdk.warehouses(WH, conn()).outbound().create(outbound());
+ sdk.warehouses(WH, conn()).outbound().create(outbound());
+
+ long creates = transport.dataRequests().stream()
+ .filter(r -> r.url().endsWith(EdayunConstants.PATH_ORDER_CREATE))
+ .count();
+ assertEquals(1, creates, "第二次应命中幂等,不再调仓");
+ }
+
+ private static OutboundCommand outbound() {
+ return OutboundCommand.builder()
+ .outboundRequestNo("OB-1")
+ .orderRef("SO-1")
+ .warehouseId("2")
+ .currency("USD")
+ .salesPlatform(Platform.AMAZON_SC)
+ .shipTo(ShipTo.builder()
+ .name("Buyer").phone("+1-555-0100")
+ .countryCode("US").stateOrProvince("California")
+ .city("Escondido").addressLine1("1308 E Washington Ave")
+ .postalCode("92027")
+ .build())
+ .line(OutboundLine.builder()
+ .lineNo("1").omsSku("ybtest").quantity(1)
+ .declareValue(Money.of("19.99", "USD"))
+ .build())
+ .build();
+ }
+
+ // ================================================================ 场景 3:库存
+
+ @Test
+ void scenario3_inventory() {
+ WarehouseSdk sdk = sdk(transport());
+
+ List rows = sdk.warehouses(WH, conn()).inventory()
+ .query(InventoryQuery.builder().sku("ybtest").build()).items();
+
+ assertEquals(1, rows.size());
+ InventorySnapshot s = rows.get(0);
+ assertEquals("ybtest", s.providerSku());
+ assertEquals(4, s.available());
+ assertEquals(10, s.onHand());
+ assertEquals(20, s.inTransit());
+ // safeStock 为 null → -1(统一模型约定)
+ assertEquals(-1, s.alertQuantity());
+ }
+
+ // ================================================================ 场景 4:退货
+
+ @Test
+ void scenario4_returns() {
+ WarehouseSdk sdk = sdk(transport());
+
+ // 4.1 建退货单(自行退回)
+ WarehouseReturn created = sdk.warehouses(WH, conn()).returns().create(
+ ReturnCommand.builder()
+ .returnRequestNo("RT-1")
+ .saleOrderNo("SO-1")
+ .returnTrackingNo("1Z999")
+ .carrierCode("FedEx")
+ .warehouseId("2")
+ .line("ybtest", 1, ReturnDealMethod.WAREHOUSE_CONFIRM)
+ .build());
+ assertEquals("RMA1001", created.providerReturnId());
+
+ // 4.2 查详情
+ WarehouseReturn detail = sdk.warehouses(WH, conn()).returns().get("RMA1001");
+ assertNotNull(detail);
+ assertEquals("RMA1001", detail.providerReturnId());
+ assertEquals(1, detail.lines().size());
+
+ // 4.3 列表
+ assertEquals(1, sdk.warehouses(WH, conn()).returns()
+ .query(ReturnQuery.builder().pageSize(100).build()).size());
+
+ // 4.4 取消
+ assertTrue(sdk.warehouses(WH, conn()).returns().cancel("RMA1001"));
+ }
+
+ // ================================================================ 场景 5:单据 / 轨迹 / 打印
+
+ @Test
+ void scenario5_documentsTrackingAndPrinting() {
+ WarehouseSdk sdk = sdk(transport());
+
+ // BOL
+ List bols = sdk.warehouses(WH, conn()).orderBols("FBA1");
+ assertEquals(1, bols.size());
+ assertEquals("cp005", bols.get(0).bolCode());
+
+ // 轨迹:节点
+ List events = sdk.warehouses(WH, conn()).track("1Z111");
+ assertEquals(1, events.size());
+ // 轨迹:运单级,带上网 / 妥投时间
+ TrackingInfo info = sdk.warehouses(WH, conn()).trackShipment("1Z111");
+ assertNotNull(info.firstOnlineAt());
+ assertNotNull(info.deliveredAt());
+
+ // 箱唛(同步 PDF)
+ WarehouseLabel label = sdk.warehouses(WH, conn()).printCaseMarks(
+ CaseMarkPrintCommand.builder()
+ .paperSize(CaseMarkPaperSize.SIZE_70_30)
+ .item("ybtest", 1)
+ .build());
+ assertEquals("https://oss/case.pdf", label.url());
+
+ // 入库单
+ assertNotNull(sdk.warehouses(WH, conn()).inbound().get("REV1"));
+ }
+
+ // ================================================================ 未实现能力
+
+ @Test
+ void unimplementedCapabilitiesThrow() {
+ WarehouseSdk sdk = sdk(transport());
+
+ // 调拨
+ assertThrows(RuntimeException.class,
+ () -> sdk.warehouses(WH, conn()).getTransfer("T-1"));
+ // 退货检验后处理(缺行 id)
+ assertThrows(RuntimeException.class,
+ () -> sdk.warehouses(WH, conn()).returns().process(
+ common.ecommerce.warehouse.model.ReturnProcessCommand.builder()
+ .providerReturnNo("RMA1").lineId(1)
+ .disposition(common.ecommerce.warehouse.enums
+ .ReturnProcessDisposition.RESTOCK)
+ .build()));
+ }
+}