package common.ecommerce.xincang.adapter; import common.ecommerce.shared.spi.ChannelSecret; import common.ecommerce.shared.testkit.InMemoryLockProvider; import common.ecommerce.shared.testkit.InMemoryTokenStore; import common.ecommerce.shared.testkit.MutableClock; import common.ecommerce.shared.testkit.RecordingTransport; import common.ecommerce.shared.testkit.Responses; import common.ecommerce.shared.model.Platform; import common.ecommerce.warehouse.WarehouseCapability; import common.ecommerce.warehouse.WarehouseProvider; import common.ecommerce.warehouse.model.LabelMode; import common.ecommerce.warehouse.model.OutboundCommand; import common.ecommerce.warehouse.model.OutboundLine; import common.ecommerce.warehouse.model.OutboundReceipt; import common.ecommerce.warehouse.model.ShipTo; import common.ecommerce.warehouse.sdk.WarehouseConnection; import common.ecommerce.warehouse.sdk.WarehouseContext; import common.ecommerce.xincang.XincangConstants; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; import java.time.Clock; import java.time.Duration; import static org.junit.jupiter.api.Assertions.*; /** * 信仓出库下单(一单多件)契约测试。 */ class XincangOrderTest { private static final String BASE = XincangConstants.TEST_BASE_URL; private static final String APP_KEY = "ak-1"; private static final String TOKEN = "{T-1}"; private RecordingTransport transport; private MutableClock clock; private XincangAdapter adapter; @BeforeEach void setUp() { transport = RecordingTransport.create(); clock = MutableClock.atUtc("2026-11-10T00:00:00Z"); transport.route(XincangConstants.PATH_LOGIN, req -> Responses.ok( "{\"rst\":{\"id\":\"c-1\",\"token\":\"" + TOKEN + "\",\"token_expire_time\":\"" + java.time.LocalDateTime.ofInstant(clock.instant().plus(Duration.ofHours(2)), XincangConstants.SYSTEM_ZONE) .format(java.time.format.DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")) + "\"},\"errno\":0,\"err\":\"\",\"trace_id\":\"t-login\"}")); adapter = new XincangAdapter(transport, new common.ecommerce.http.JacksonJsonCodec(), new InMemoryTokenStore(), new InMemoryLockProvider(), clock); } private static WarehouseContext ctx() { return WarehouseContext.of("XC-CA-3790", WarehouseProvider.XINCANG, "CA-3790", WarehouseConnection.of(BASE, ChannelSecret.builder() .appKey(APP_KEY).appSecret("sk").build()), "req-1", Clock.systemUTC()); } private static OutboundCommand command(Boolean split) { OutboundCommand.Builder b = OutboundCommand.builder() .outboundRequestNo("OB-20261110-001") .orderRef("SO-1") .labelMode(LabelMode.WAREHOUSE_LABEL) .salesPlatform(Platform.AMAZON_SC) .carrierCode("FEDEX-G") .warehouseId("CA-3790") .shipTo(ShipTo.builder() .name("Receiver") .phone("5550000") .countryCode("US") .stateOrProvince("CA") .city("Fontana") .addressLine1("3790 DE FOREST CIRCLE, UNIT B, EXTRA LONG SUFFIX") .postalCode("92337") .build()) .line(OutboundLine.builder().lineNo("1").omsSku("SKU-A").quantity(2).build()) .line(OutboundLine.builder().lineNo("2").omsSku("SKU-B").providerSku("SKU-B-XC") .quantity(1).build()); if (split != null) { b.splitOrder(split); } return b.build(); } @Test void createsMultiLineOrderAsMultipart() { transport.route(XincangConstants.PATH_ORDER_ADD_MULTIPLE, req -> Responses.ok( "{\"rst\":{\"order_no\":\"DS-B001-26101300025\",\"order_id\":\"125553878740636306\"}," + "\"errno\":0,\"err\":\"\",\"trace_id\":\"t-order\"}")); OutboundReceipt receipt = adapter.create(ctx(), command(true)); assertEquals("OB-20261110-001", receipt.outboundRequestNo()); assertEquals("DS-B001-26101300025", receipt.providerOrderId()); common.ecommerce.http.HttpRequest req = transport.lastDataRequest(); assertEquals("POST", req.method()); assertTrue(req.url().contains("/api.add_order_multiple?token="), req.url()); assertTrue(req.contentType().startsWith("multipart/form-data; boundary="), req.contentType()); String body = req.body(); assertTrue(body.contains("name=\"ckh\"\r\n\r\nOB-20261110-001"), body); assertTrue(body.contains("name=\"warehouse_code\"\r\n\r\nCA-3790"), body); assertTrue(body.contains("name=\"logistics_type\"\r\n\r\nFEDEX-G"), body); assertTrue(body.contains("name=\"order_type\"\r\n\r\ncommon"), body); assertTrue(body.contains("name=\"is_split\"\r\n\r\n1"), body); // 商品明细是一段 JSON 字符串 assertTrue(body.contains("\"product_sku\":\"SKU-A\""), body); assertTrue(body.contains("\"sku_count\":\"2\""), body); // 仓侧 SKU 优先 assertTrue(body.contains("\"product_sku\":\"SKU-B-XC\""), body); // 地址超过 32 位走 address2(前 32 字符 = "3790 DE FOREST CIRCLE, UNIT B, E") assertTrue(body.contains("name=\"address\"\r\n\r\n3790 DE FOREST CIRCLE, UNIT B, E\r\n"), body); assertTrue(body.contains("name=\"address2\"\r\n\r\nXTRA LONG SUFFIX"), body); } @Test void splitFlagIsOmittedWhenCallerDidNotSetIt() { transport.route(XincangConstants.PATH_ORDER_ADD_MULTIPLE, req -> Responses.ok( "{\"rst\":{\"order_no\":\"DS-1\",\"order_id\":\"1\"},\"errno\":0,\"err\":\"\"}")); adapter.create(ctx(), command(null)); assertFalse(transport.lastDataRequest().body().contains("name=\"is_split\""), "未显式指定时交给信仓默认(拆单)"); } @Test void missingShipToFieldFailsBeforeSending() { transport.route(XincangConstants.PATH_ORDER_ADD_MULTIPLE, req -> Responses.ok("{}")); OutboundCommand cmd = OutboundCommand.builder() .outboundRequestNo("OB-2") .salesPlatform(Platform.AMAZON_SC) .carrierCode("FEDEX-G") .warehouseId("CA-3790") .shipTo(ShipTo.builder().name("R").countryCode("US").stateOrProvince("CA") .city("Fontana").addressLine1("1 A St").postalCode("92337").build()) .line(OutboundLine.builder().lineNo("1").omsSku("SKU-A").quantity(1).build()) .build(); common.ecommerce.shared.error.ValidationException e = assertThrows(common.ecommerce.shared.error.ValidationException.class, () -> adapter.create(ctx(), cmd)); assertTrue(e.getMessage().contains("shipTo.phone"), e.getMessage()); // 登录后即失败,不应发出下单请求 assertFalse(transport.recorded().stream().anyMatch( r -> r.url().contains(XincangConstants.PATH_ORDER_ADD_MULTIPLE))); } @Test void missingProviderOrderNoIsNotSilentSuccess() { transport.route(XincangConstants.PATH_ORDER_ADD_MULTIPLE, req -> Responses.ok( "{\"rst\":null,\"errno\":0,\"err\":\"\",\"trace_id\":\"t-x\"}")); common.ecommerce.warehouse.error.WarehouseException e = assertThrows(common.ecommerce.warehouse.error.WarehouseException.class, () -> adapter.create(ctx(), command(true))); assertTrue(e.getMessage().contains("rst.order_no"), e.getMessage()); } @Test void queryAndCancelAreExplicitlyUnsupported() { assertThrows(common.ecommerce.shared.error.ValidationException.class, () -> adapter.get(ctx(), null)); assertThrows(common.ecommerce.shared.error.ValidationException.class, () -> adapter.query(ctx(), null)); assertFalse(adapter.capabilities().contains(WarehouseCapability.INVENTORY_QUERY)); } @Test void outboundCapabilityIsDeclared() { assertTrue(adapter.capabilities().contains(WarehouseCapability.OUTBOUND)); assertTrue(adapter.supports("XC-CA-3790", WarehouseCapability.SPLIT)); } }