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