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