|
|
|
|
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));
|
|
|
|
|
}
|
|
|
|
|
}
|