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.

508 lines
22 KiB

package common.ecommerce.hengjian.adapter;
import common.ecommerce.hengjian.HengjianConstants;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.shared.model.Platform;
import common.ecommerce.shared.spi.ChannelSecret;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.testkit.RecordingTransport;
import common.ecommerce.shared.testkit.Responses;
import common.ecommerce.warehouse.enums.LabelMode;
import common.ecommerce.warehouse.enums.WarehouseCapability;
import common.ecommerce.warehouse.enums.WarehouseProvider;
import common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException;
import common.ecommerce.warehouse.model.OutboundCommand;
import common.ecommerce.warehouse.model.OutboundLine;
import common.ecommerce.warehouse.model.OutboundReceipt;
import common.ecommerce.warehouse.model.OutboundRef;
import common.ecommerce.warehouse.model.ShipTo;
import common.ecommerce.warehouse.sdk.WarehouseConnection;
import common.ecommerce.warehouse.sdk.WarehouseContext;
import common.ecommerce.warehouse.sdk.WarehouseSdk;
import common.ecommerce.warehouse.spi.WarehouseAccount;
import common.ecommerce.warehouse.testkit.InMemoryWarehouses;
import org.junit.jupiter.api.Test;
import java.time.Clock;
import java.time.Instant;
import java.time.ZoneId;
import java.time.ZoneOffset;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertTrue;
/**
* 创建销售发货单({@code POST /v1/saleOrder/create})契约测试。
*/
class HengjianCreateOrderTest {
private static final Instant NOW = Instant.parse("2026-11-12T03:04:05Z");
private static final Clock CLOCK = Clock.fixed(NOW, ZoneOffset.UTC);
private static final String CREATE_BODY =
"{\"statusCode\":200,\"status\":0,\"code\":200,\"message\":\"创建订单成功\","
+ "\"data\":{\"orderId\":193252852}}";
private static WarehouseContext ctx() {
return ctx(ZoneOffset.UTC);
}
private static WarehouseContext ctx(ZoneId zone) {
return WarehouseContext.of("HJ-EFCA", WarehouseProvider.HENGJIAN, "EFCA",
WarehouseConnection.of(HengjianConstants.TEST_BASE_URL,
ChannelSecret.builder().appSecret("token-1").build(), zone),
"req-1", CLOCK);
}
private static HengjianAdapter adapter(RecordingTransport transport) {
return new HengjianAdapter(transport, new JacksonJsonCodec());
}
private static RecordingTransport creating() {
return RecordingTransport.create()
.route(HengjianConstants.PATH_ORDER_CREATE, req -> Responses.ok(CREATE_BODY));
}
private static ShipTo shipTo() {
return ShipTo.builder()
.name("Test Receiver")
.phone("555-0100")
.email("buyer@example.com")
.countryCode("US")
.stateOrProvince("CA")
.city("Los Angeles")
.addressLine1("1 Test St")
.addressLine2("Suite 2")
.postalCode("90001")
.build();
}
private static OutboundCommand.Builder order() {
return OutboundCommand.builder()
.outboundRequestNo("OB-2026-0001")
.orderRef("SO-1")
.salesPlatform(Platform.AMAZON_SC)
.carrier("UPS")
.carrierCode("UPSG_HL")
.shopName("EFCA-STORE")
.shipTo(shipTo())
.line(OutboundLine.builder()
.lineNo("1")
.omsSku("DM00001")
.quantity(2)
.declareValue(Money.of("9.99", "USD"))
.build());
}
// ---------------------------------------------------------------- 请求形状
@Test
void sendsPostToSaleOrderCreate() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order().build());
assertEquals("POST", transport.lastDataRequest().method());
assertEquals(HengjianConstants.TEST_BASE_URL + "/v1/saleOrder/create",
transport.lastDataRequest().url());
}
/** 文档必填的字段必须全部出现。 */
@Test
void sendsAllMandatoryFields() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order().build());
String body = transport.lastDataRequest().body();
String[] mandatory = {"orderNo", "shipToCountry", "shipToState", "shipToCity",
"shipToPostal", "shipToAddress1", "shipToContact", "shipToTelephone",
"createdAt", "productItems", "attachInfoItems"};
for (String field : mandatory) {
assertTrue(body.contains("\"" + field + "\""), "缺少必填字段 " + field + ",body=" + body);
}
}
/** 产品行里的四个必填子字段都要有。 */
@Test
void productItemCarriesMandatoryFlags() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order().build());
String body = transport.lastDataRequest().body();
String[] mandatory = {"sku", "quantity", "isInsure", "isSignature"};
for (String field : mandatory) {
assertTrue(body.contains("\"" + field + "\""), "产品行缺少 " + field + ",body=" + body);
}
assertTrue(body.contains("\"sku\":\"DM00001\""), body);
assertTrue(body.contains("\"quantity\":2"), body);
}
/**
* 恒健把 {@code attachInfoItems} 标为必填:没有附件时发空数组,
* 不能省略字段。
*/
@Test
void sendsEmptyAttachmentArrayWhenNoLabel() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order().build());
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"attachInfoItems\":[]"),
"没有附件时应发空数组而不是省略,body=" + body);
}
/** 平台面单:base64 内容进 file,类型 0,名称优先用跟踪号。 */
@Test
void sendsPlatformLabelAsAttachment() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order()
.labelMode(LabelMode.PLATFORM_LABEL)
.trackingNumber("1ZXH1234567890")
.labelContentBase64("data:application/pdf;base64,JVBERi0xLjQK")
.build());
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"name\":\"1ZXH1234567890\""), body);
// data URI 头必须剥掉,否则仓方会把前缀当文件内容
assertTrue(body.contains("\"file\":\"JVBERi0xLjQK\""), body);
assertFalse(body.contains("data:application/pdf"), body);
assertTrue(body.contains("\"type\":\"0\""), body);
}
/** 声明平台面单却不给文件,本地就拒绝——仓没有面单可打等于静默失败。 */
@Test
void rejectsPlatformLabelWithoutContent() {
RecordingTransport transport = creating();
IllegalArgumentException ex = assertThrows(IllegalArgumentException.class,
() -> adapter(transport).create(ctx(),
order().labelMode(LabelMode.PLATFORM_LABEL).build()));
assertTrue(ex.getMessage().contains("labelContentBase64"), ex.getMessage());
assertTrue(transport.dataRequests().isEmpty(), "本地校验失败不应发出请求");
}
/** 给了面单内容却不是平台面单模式,拒绝而不是静默丢弃。 */
@Test
void rejectsLabelContentWithoutPlatformMode() {
RecordingTransport transport = creating();
IllegalArgumentException ex = assertThrows(IllegalArgumentException.class,
() -> adapter(transport).create(ctx(),
order().labelContentBase64("JVBERi0xLjQK").build()));
assertTrue(ex.getMessage().contains("PLATFORM_LABEL"), ex.getMessage());
assertTrue(transport.dataRequests().isEmpty());
}
/** 时间按 UTC 输出,不受调用方传的时区影响。 */
@Test
void formatsTimesInUtc() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(ZoneId.of("America/Los_Angeles")),
order().latestShipDate(Instant.parse("2026-11-15T23:30:00Z")).build());
String body = transport.lastDataRequest().body();
// createdAt 用注入的固定时钟
assertTrue(body.contains("\"createdAt\":\"2026-11-12 03:04:05\""), body);
assertTrue(body.contains("\"expectedShipDate\":\"2026-11-15 23:30:00\""),
"恒健要求 UTC,不能按仓所在时区输出,body=" + body);
}
/** 行金额是「当前 SKU 总金额」,申报单价要乘数量。 */
@Test
void skuAmountIsLineTotalNotUnitPrice() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order().build());
String body = transport.lastDataRequest().body();
// 9.99 × 2 = 19.98
assertTrue(body.contains("\"skuAmount\":19.98"), "skuAmount 必须是行总额,body=" + body);
}
@Test
void usesExplicitTotalAmountWhenGiven() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), OutboundCommand.builder()
.outboundRequestNo("OB-2")
.salesPlatform(Platform.AMAZON_SC)
.shipTo(shipTo())
.line(OutboundLine.builder()
.lineNo("1")
.omsSku("DM00001")
.quantity(3)
.declareValue(Money.of("10.00", "USD"))
.totalAmount(Money.of("28.00", "USD"))
.build())
.build());
assertTrue(transport.lastDataRequest().body().contains("\"skuAmount\":28.0"));
}
/** 保价由「是否有保价金额」推导;有金额就要带 insureAmount。 */
@Test
void insuredLineSendsFlagAndAmount() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), OutboundCommand.builder()
.outboundRequestNo("OB-3")
.salesPlatform(Platform.AMAZON_SC)
.shipTo(shipTo())
.line(OutboundLine.builder()
.lineNo("1")
.omsSku("DM00001")
.quantity(1)
.insuredAmount(Money.of("100.00", "USD"))
.build())
.build());
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"isInsure\":1"), body);
assertTrue(body.contains("\"insureAmount\":100.0"), body);
}
@Test
void uninsuredLineSendsZero() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order().build());
assertTrue(transport.lastDataRequest().body().contains("\"isInsure\":0"));
}
/** 签收:布尔值映射成 1 / 0;null 视为不签收(恒健必填,不能省略)。 */
@Test
void signatureFlagIsMandatoryAndMapped() {
RecordingTransport required = creating();
adapter(required).create(ctx(), order().signatureRequired(true).build());
assertTrue(required.lastDataRequest().body().contains("\"isSignature\":1"));
RecordingTransport notRequired = creating();
adapter(notRequired).create(ctx(), order().build());
assertTrue(notRequired.lastDataRequest().body().contains("\"isSignature\":0"));
}
@Test
void mapsShopCurrencyAndCarrier() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order()
.currency("CAD")
.sfp(true)
.remark("买家备注")
.build());
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"channelAccount\":\"EFCA-STORE\""), body);
assertTrue(body.contains("\"currency\":\"CAD\""), body);
assertTrue(body.contains("\"carrier\":\"UPS\""), body);
assertTrue(body.contains("\"carrierCode\":\"UPSG_HL\""), body);
assertTrue(body.contains("\"isPrime\":1"), body);
assertTrue(body.contains("\"customerRemark\":\"买家备注\""), body);
}
/** 恒健没有平台维度:salesPlatform 不发,也不按平台推断 isDFOrder。 */
@Test
void doesNotSendSalesPlatformOrInferDfOrder() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order().build());
String body = transport.lastDataRequest().body();
assertFalse(body.contains("salesPlatform"), body);
// 未显式指定时不发;不按 AMAZON_VC 之类去猜
assertFalse(body.contains("isDFOrder"), body);
}
/** 原先缺失的 5 个文档字段现在都能传。 */
@Test
void sendsPreviouslyMissingDocumentedFields() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order()
.paidAt(Instant.parse("2026-11-10T08:00:00Z"))
.pickupTime(java.time.LocalDate.parse("2026-11-12"))
.directFulfillment(true)
.thirdPartyAccount("THIRD-ACC-1")
.warehouseRemark("请加固外箱")
.remark("买家备注")
.build());
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"paidAt\":\"2026-11-10 08:00:00\""), body);
assertTrue(body.contains("\"pickupTime\":\"2026-11-12\""), body);
assertTrue(body.contains("\"isDFOrder\":1"), body);
assertTrue(body.contains("\"thirdPartyAccount\":\"THIRD-ACC-1\""), body);
assertTrue(body.contains("\"warehouseRemark\":\"请加固外箱\""), body);
// 客户备注与仓库备注是两个字段,各发各的
assertTrue(body.contains("\"customerRemark\":\"买家备注\""), body);
}
/** 未指定的新字段不出现(不编造默认值)。 */
@Test
void omitsNewFieldsWhenUnset() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order().build());
String body = transport.lastDataRequest().body();
for (String field : new String[]{"paidAt", "pickupTime", "isDFOrder",
"thirdPartyAccount", "warehouseRemark"}) {
assertFalse(body.contains("\"" + field + "\""), "未指定时不应发送 " + field + ",body=" + body);
}
}
/** 通用附件列表:URL 与 base64 两种形态、type 用仓方原值。 */
@Test
void sendsGenericAttachments() {
RecordingTransport transport = creating();
adapter(transport).create(ctx(), order()
.attachment(common.ecommerce.warehouse.model.WarehouseAttachment.builder()
.name("packing-list").type("1")
.url("https://cdn/packing.pdf").build())
.attachment(common.ecommerce.warehouse.model.WarehouseAttachment.builder()
.name("bol").type("2")
.contentBase64("data:application/pdf;base64,JVBERi0xLjQK").build())
.build());
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"name\":\"packing-list\""), body);
assertTrue(body.contains("\"type\":\"1\""), body);
assertTrue(body.contains("\"url\":\"https://cdn/packing.pdf\""), body);
assertTrue(body.contains("\"file\":\"JVBERi0xLjQK\""), body);
}
/** 附件缺 name / type / url+base64 时本地拒绝,不发出去被仓方挡回来。 */
@Test
void rejectsIncompleteAttachment() {
RecordingTransport transport = creating();
assertThrows(IllegalArgumentException.class,
() -> adapter(transport).create(ctx(), order()
.attachment(common.ecommerce.warehouse.model.WarehouseAttachment.builder()
.type("1").url("https://cdn/x.pdf").build())
.build()));
assertTrue(transport.dataRequests().isEmpty());
}
/** 仓代码:命令显式指定优先,否则用账户配置。 */
@Test
void warehouseCodeResolvesFromCommandThenAccount() {
RecordingTransport fromCommand = creating();
adapter(fromCommand).create(ctx(), order().warehouseId("EFNJ").build());
assertTrue(fromCommand.lastDataRequest().body().contains("\"warehouseCode\":\"EFNJ\""));
RecordingTransport fromAccount = creating();
adapter(fromAccount).create(ctx(), order().build());
assertTrue(fromAccount.lastDataRequest().body().contains("\"warehouseCode\":\"EFCA\""));
}
// ---------------------------------------------------------------- 本地必填校验
@Test
void rejectsMissingShipToFields() {
String[] fields = {"countryCode", "stateOrProvince", "postalCode", "addressLine1",
"name", "phone", "city"};
for (String field : fields) {
ShipTo.Builder b = ShipTo.builder()
.name("N").phone("P").countryCode("US").stateOrProvince("CA")
.city("C").addressLine1("A").postalCode("Z");
if ("countryCode".equals(field)) {
b.countryCode(null);
} else if ("stateOrProvince".equals(field)) {
b.stateOrProvince(null);
} else if ("postalCode".equals(field)) {
b.postalCode(null);
} else if ("addressLine1".equals(field)) {
b.addressLine1(null);
} else if ("name".equals(field)) {
b.name(null);
} else if ("phone".equals(field)) {
b.phone(null);
} else {
b.city(null);
}
OutboundCommand cmd = OutboundCommand.builder()
.outboundRequestNo("OB-X")
.salesPlatform(Platform.AMAZON_SC)
.shipTo(b.build())
.line(OutboundLine.builder().lineNo("1").omsSku("S").quantity(1).build())
.build();
assertThrows(IllegalArgumentException.class,
() -> adapter(creating()).create(ctx(), cmd), field);
}
}
// ---------------------------------------------------------------- 响应
@Test
void readsProviderOrderIdFromData() {
RecordingTransport transport = creating();
OutboundReceipt receipt = adapter(transport).create(ctx(), order().build());
assertEquals("OB-2026-0001", receipt.outboundRequestNo());
assertEquals("193252852", receipt.providerOrderId(), "仓内部数字 id 必须落库,取消时要用");
assertEquals("创建订单成功", receipt.rawStatus());
}
/** 没有 orderId 不能当成功:后续取消需要它。 */
@Test
void rejectsResponseWithoutOrderId() {
RecordingTransport transport = RecordingTransport.create()
.route(HengjianConstants.PATH_ORDER_CREATE, req -> Responses.ok(
"{\"statusCode\":200,\"status\":0,\"code\":200,\"message\":\"ok\"}"));
RuntimeException ex = assertThrows(RuntimeException.class,
() -> adapter(transport).create(ctx(), order().build()));
assertTrue(ex.getMessage().contains("data.orderId"), ex.getMessage());
}
@Test
void businessErrorIsPropagated() {
RecordingTransport transport = RecordingTransport.create()
.route(HengjianConstants.PATH_ORDER_CREATE, req -> Responses.ok(
"{\"code\":500,\"message\":\"仓库不存在\"}"));
RuntimeException ex = assertThrows(RuntimeException.class,
() -> adapter(transport).create(ctx(), order().build()));
assertTrue(ex.getMessage().contains("仓库不存在"), ex.getMessage());
}
// ---------------------------------------------------------------- 能力位与未接入接口
@Test
void declaresOutboundAndLabelCapabilities() {
HengjianAdapter adapter = adapter(RecordingTransport.create());
assertTrue(adapter.capabilities().contains(WarehouseCapability.OUTBOUND));
assertTrue(adapter.capabilities().contains(WarehouseCapability.PLATFORM_LABEL_DELIVERY));
}
/** 查询 / 取消还没接:显式拒绝,不返回 null 或空集合。 */
@Test
void unimplementedOutboundMethodsThrow() {
HengjianAdapter adapter = adapter(RecordingTransport.create());
assertThrows(RuntimeException.class,
() -> adapter.get(ctx(), OutboundRef.ofRequestNo("OB-1")));
assertThrows(RuntimeException.class,
() -> adapter.packages(ctx(), OutboundRef.ofRequestNo("OB-1")));
assertThrows(RuntimeException.class,
() -> adapter.checkCancel(ctx(), OutboundRef.ofRequestNo("OB-1")));
assertThrows(RuntimeException.class,
() -> adapter.cancel(ctx(), common.ecommerce.warehouse.model.CancelCommand.builder()
.outboundRequestNo("OB-1").build()));
}
/** 未声明的能力位仍然被门面挡住(TRACKING 还没接)。 */
@Test
void undeclaredCapabilityIsRejectedByFacade() {
WarehouseSdk sdk = WarehouseSdk.builder()
.warehouseRepository(new InMemoryWarehouses().put(WarehouseAccount.builder()
.warehouseCode("HJ-EFCA")
.provider(WarehouseProvider.HENGJIAN.name())
.providerWarehouseId("EFCA")
.accountId("acc-test")
.build()))
.clock(CLOCK)
.register(new HengjianAdapterFactory())
.build();
assertThrows(WarehouseUnsupportedCapabilityException.class,
() -> sdk.warehouses("HJ-EFCA", WarehouseConnection.of(
HengjianConstants.TEST_BASE_URL,
ChannelSecret.builder().appSecret("t").build(),
ZoneOffset.UTC))
.track("1Z999"));
}
}