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