You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

206 lines
10 KiB

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;
/**
* 运去哪适配器契约测试:请求形状、响应映射、状态与取消判定。
*
* <p>全部基于录制夹具,无网络。</p>
*/
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)
.salesPlatform(common.ecommerce.shared.model.Platform.WALMART_SC)
.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\":{\"orderId\":10001}}"));
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("10001", receipt.providerOrderId());
assertEquals(null, receipt.rawStatus());
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"orderNo\":\"OB-1\""), body);
assertTrue(body.contains("\"sku\":\"DM00001\""), body);
assertTrue(body.contains("\"carrier\":\"WLC-FEDEX\""), body);
assertTrue(body.contains("\"salesPlatform\":2"), body);
assertTrue(body.contains("\"shipToContact\":\"Test\""), 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 getMapsStatusTrackingAndLines() {
RecordingTransport transport = RecordingTransport.create()
.route(YqnConstants.PATH_ORDER_FIND_ONE, req -> Responses.ok(
"{\"code\":200,\"message\":\"ok\",\"data\":{\"orderNo\":\"OB-3\","
+ "\"paidAt\":\"2026-11-08 09:00:00\",\"orderStatusEnum\":\"shipped\","
+ "\"warehouseCode\":\"RF_NY_US\",\"currency\":\"USD\","
+ "\"carrierCode\":\"WLC-FEDEX\",\"errorCode\":\"unexception\","
+ "\"shipToCountry\":\"US\",\"shipToCity\":\"New York\","
+ "\"estimatedShippingFee\":\"8.5\","
+ "\"productItems\":[{\"sku\":\"DM00001\",\"quantity\":2,\"lineNo\":\"1\"}],"
+ "\"shipmentPackages\":[{\"trackingNo\":\"TRK1\",\"carrier\":\"FEDEX\","
+ "\"erpSku\":\"DM00001\",\"shipedQuantity\":2,\"packageFlag\":0,"
+ "\"shipmentDate\":\"2026-11-08 12: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(OutboundStatus.SHIPPED, order.status());
assertEquals("TRK1", order.trackingNumber());
assertEquals("FEDEX", order.carrier());
assertEquals("WLC-FEDEX", order.carrierCode());
assertEquals(Instant.parse("2026-11-08T01:00:00Z"), order.paidAt());
assertEquals(Instant.parse("2026-11-08T04:00:00Z"), order.shippedAt());
assertEquals(1, order.lines().size());
assertEquals(2, order.lines().get(0).quantity());
assertEquals("US", order.shipTo().countryCode());
assertEquals("8.5", order.estimatedShippingFee().amount().toPlainString());
assertEquals(null, order.exceptionCode());
assertFalse(order.hasException());
}
@Test
void checkCancelBlocksShippedOrder() {
RecordingTransport transport = RecordingTransport.create()
.route(YqnConstants.PATH_ORDER_FIND_ONE, req -> Responses.ok(
"{\"code\":200,\"message\":\"ok\",\"data\":{\"orderNo\":\"OB-4\","
+ "\"orderStatusEnum\":\"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));
}
}