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.

226 lines
11 KiB

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.enums.WarehouseCapability;
import common.ecommerce.warehouse.enums.WarehouseProvider;
import common.ecommerce.warehouse.enums.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 wayfairRequiresTrackingNumberAndFaceBase64() {
OutboundCommand wayfair = OutboundCommand.builder()
.outboundRequestNo("OB-WF-1")
.salesPlatform(Platform.WAYFAIR)
.labelMode(LabelMode.PLATFORM_LABEL)
.carrierCode("FEDEX-G")
.warehouseId("CA-3790")
.shipTo(ShipTo.builder().name("R").phone("1").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(), wayfair));
assertTrue(e.getMessage().contains("gzh"), e.getMessage());
}
@Test
void wayfairSendsGzhAndFaceBase64WhenProvided() {
transport.route(XincangConstants.PATH_ORDER_ADD_MULTIPLE, req -> Responses.ok(
"{\"rst\":{\"order_no\":\"DS-WF\",\"order_id\":\"1\"},\"errno\":0,\"err\":\"\"}"));
OutboundCommand wayfair = OutboundCommand.builder()
.outboundRequestNo("OB-WF-2")
.salesPlatform(Platform.WAYFAIR)
.labelMode(LabelMode.PLATFORM_LABEL)
.carrierCode("FEDEX-G")
.warehouseId("CA-3790")
.trackingNumber("1Z999")
.labelContentBase64("data:application/pdf;base64,AAAA")
.shopName("MY-SHOP")
.sfp(true)
.shipTo(ShipTo.builder().name("R").phone("1").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();
adapter.create(ctx(), wayfair);
String body = transport.lastDataRequest().body();
assertTrue(body.contains("name=\"order_type\"\r\n\r\nwayfair"), body);
assertTrue(body.contains("name=\"gzh\"\r\n\r\n1Z999"), body);
assertTrue(body.contains("name=\"face_base64\"\r\n\r\ndata:application/pdf;base64,AAAA"), body);
assertTrue(body.contains("name=\"shop_name\"\r\n\r\nMY-SHOP"), body);
assertTrue(body.contains("name=\"sfp\"\r\n\r\n是"), body);
// 该接口 schema 没有 remark,不应发送
assertFalse(body.contains("name=\"remark\""), 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() {
// get / query 均已接入(见 XincangOrderDetailTest、XincangInventoryTest),
// 这里只断言能力位齐全
assertTrue(adapter.capabilities().contains(WarehouseCapability.INVENTORY_QUERY));
}
@Test
void outboundCapabilityIsDeclared() {
assertTrue(adapter.capabilities().contains(WarehouseCapability.OUTBOUND));
assertTrue(adapter.supports("XC-CA-3790", WarehouseCapability.SPLIT));
}
}