package common.ecommerce.yqn.adapter; import common.ecommerce.http.HttpResponse; 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.WarehouseCapability; import common.ecommerce.warehouse.WarehouseProvider; import common.ecommerce.warehouse.model.CancelEligibility; import common.ecommerce.warehouse.model.LabelMode; import common.ecommerce.warehouse.model.OutboundCommand; import common.ecommerce.warehouse.model.OutboundLine; import common.ecommerce.warehouse.model.OutboundRef; import common.ecommerce.warehouse.model.OutboundStatus; 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 java.util.function.Function; 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.assertTrue; /** * 运去哪适配器契约测试:请求形状、响应映射、状态与取消判定。 * *

全部基于录制夹具,无网络。

*/ class YqnAdapterTest { private static final Instant NOW = Instant.parse("2026-11-09T00:00:00Z"); private static final Clock CLOCK = Clock.fixed(NOW, ZoneOffset.UTC); private static final String BASE = "https://pr-hwc-open-api.yqn.com"; private static WarehouseContext ctx() { return WarehouseContext.of("YQN-RF_NY_US", WarehouseProvider.YQN, "RF_NY_US", WarehouseConnection.of(BASE, ChannelSecret.builder().appSecret("token-1").build()), "req-1", CLOCK); } private static OutboundCommand command(String requestNo, LabelMode mode) { return OutboundCommand.builder() .outboundRequestNo(requestNo) .orderRef("SO-1") .labelMode(mode) .carrier("WLC-FEDEX") .warehouseId("RF_NY_US") .shipTo(ShipTo.builder() .name("Test") // 测试数据 .phone("000") .countryCode("US") .stateOrProvince("NY") .city("New York") .addressLine1("1 Test St") .postalCode("10001") .build()) .line(OutboundLine.builder() .lineNo("1") .omsSku("DM00001") .quantity(2) .declareName("Sample") .declareNameEn("Sample") .declareValue(common.ecommerce.shared.support.Money.of("9.99", "USD")) .build()) .build(); } @Test void createMapsCommandAndReadsProviderOrderId() { RecordingTransport transport = RecordingTransport.create() .route(YqnConstants.PATH_ORDER_CREATE, req -> Responses.ok( "{\"statusCode\":200,\"status\":0,\"code\":200,\"data\":{\"orderNo\":\"YQN202611090001\",\"status\":\"ACCEPTED\"}}")); YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec()); common.ecommerce.warehouse.model.OutboundReceipt receipt = adapter.create(ctx(), command("OB-1", LabelMode.WAREHOUSE_LABEL)); assertEquals("OB-1", receipt.outboundRequestNo()); assertEquals("YQN202611090001", receipt.providerOrderId()); assertEquals("ACCEPTED", receipt.rawStatus()); String body = transport.lastDataRequest().body(); assertTrue(body.contains("\"customerOrderNo\":\"OB-1\""), body); assertTrue(body.contains("\"sku\":\"DM00001\""), body); assertTrue(body.contains("\"shippingMethod\":\"WLC-FEDEX\""), body); assertEquals("token-1", transport.recorded().get(0).headers().get(YqnConstants.TOKEN_HEADER)); } @Test void platformLabelWithoutCapabilityIsRejected() { YqnAdapter adapter = new YqnAdapter(RecordingTransport.create(), new JacksonJsonCodec()); assertFalse(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()); } @Test void getMapsStatusAndTracking() { RecordingTransport transport = RecordingTransport.create() .route(YqnConstants.PATH_ORDER_FIND, req -> Responses.ok( "{\"statusCode\":200,\"status\":0,\"code\":200,\"data\":{\"orders\":[{\"orderNo\":\"YQN1\"," + "\"customerOrderNo\":\"OB-3\",\"status\":\"SHIPPED\"," + "\"trackingNumber\":\"TRK1\",\"carrier\":\"FEDEX\"," + "\"createTime\":\"2026-11-08 10:00:00\"}]}}")); YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec()); common.ecommerce.warehouse.model.OutboundOrder order = adapter.get(ctx(), OutboundRef.ofRequestNo("OB-3")); assertEquals("OB-3", order.outboundRequestNo()); assertEquals("YQN1", order.providerOrderId()); assertEquals(OutboundStatus.SHIPPED, order.status()); assertEquals("TRK1", order.trackingNumber()); assertEquals(Instant.parse("2026-11-08T02:00:00Z"), order.requestedAt()); } @Test void checkCancelBlocksShippedOrder() { RecordingTransport transport = RecordingTransport.create() .route(YqnConstants.PATH_ORDER_FIND, req -> Responses.ok( "{\"statusCode\":200,\"status\":0,\"code\":200,\"data\":{\"orders\":[{\"orderNo\":\"YQN1\"," + "\"customerOrderNo\":\"OB-4\",\"status\":\"SHIPPED\"}]}}")); YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec()); assertEquals(CancelEligibility.BLOCKED, adapter.checkCancel(ctx(), OutboundRef.ofRequestNo("OB-4"))); } @Test void cancelChargedWithoutAcceptThrows() { RecordingTransport transport = RecordingTransport.create() .route(YqnConstants.PATH_ORDER_CANCEL, req -> Responses.ok( "{\"statusCode\":200,\"status\":0,\"code\":200,\"data\":{\"cancelType\":\"CHARGED\"," + "\"cancelFee\":\"5.00\",\"currency\":\"USD\"}}")); YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec()); common.ecommerce.warehouse.model.CancelCommand cmd = common.ecommerce.warehouse.model.CancelCommand.builder() .outboundRequestNo("OB-5").acceptCharge(false).build(); common.ecommerce.warehouse.error.OutboundCancelChargeRequiredException ex = org.junit.jupiter.api.Assertions.assertThrows( common.ecommerce.warehouse.error.OutboundCancelChargeRequiredException.class, () -> adapter.cancel(ctx(), cmd)); assertEquals("5.00", ex.cancelFee()); } @Test void businessErrorCodeBecomesException() { RecordingTransport transport = RecordingTransport.create() .route(YqnConstants.PATH_ORDER_CREATE, req -> Responses.ok("{\"statusCode\":200,\"status\":0,\"code\":1001,\"message\":\"sku not found\"}")); YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec()); RuntimeException ex = org.junit.jupiter.api.Assertions.assertThrows(RuntimeException.class, () -> adapter.create(ctx(), command("OB-6", LabelMode.WAREHOUSE_LABEL))); assertTrue(ex.getMessage().contains("1001"), ex.getMessage()); } @Test void missingOrderNoIsNotSilentSuccess() { RecordingTransport transport = RecordingTransport.create() .route(YqnConstants.PATH_ORDER_CREATE, req -> Responses.ok("{\"statusCode\":200,\"status\":0,\"code\":200,\"data\":{}}")); YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec()); org.junit.jupiter.api.Assertions.assertThrows(RuntimeException.class, () -> adapter.create(ctx(), command("OB-7", LabelMode.WAREHOUSE_LABEL))); } @Test void statusMappingCoversKnownValues() { assertEquals(OutboundStatus.CANCELLED, YqnOutboundMapper.toStatus("CANCELLED")); assertEquals(OutboundStatus.PICKING, YqnOutboundMapper.toStatus("PICKING")); assertEquals(OutboundStatus.LABEL_READY, YqnOutboundMapper.toStatus("LABEL_PRINTED")); assertEquals(OutboundStatus.EXCEPTION, YqnOutboundMapper.toStatus("EXCEPTION")); assertEquals(OutboundStatus.SUBMITTED, YqnOutboundMapper.toStatus("UNKNOWN_X")); assertNull(YqnOutboundMapper.parseTime("", null)); } }