package common.ecommerce.hengjian.adapter; import common.ecommerce.hengjian.HengjianConstants; 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.enums.AddressType; import common.ecommerce.warehouse.enums.WarehouseCapability; import common.ecommerce.warehouse.enums.WarehouseProvider; import common.ecommerce.warehouse.model.FeeEstimateQuery; import common.ecommerce.warehouse.model.FeeEstimateResult; import common.ecommerce.warehouse.sdk.WarehouseConnection; import common.ecommerce.warehouse.sdk.WarehouseContext; import org.junit.jupiter.api.Test; import java.math.BigDecimal; import java.util.List; 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 /v2/api/shipping/calculate})与地址属性 * ({@code /v2/api/shipping/addressClassification})契约测试。 */ class HengjianEstimateTest { private static final WarehouseContext CTX = WarehouseContext.of( "HJ-EFCA", WarehouseProvider.HENGJIAN, "EFCA", WarehouseConnection.of(HengjianConstants.TEST_BASE_URL, ChannelSecret.builder().appSecret("token-1").build()), "req-1", java.time.Clock.fixed(java.time.Instant.parse("2026-11-16T00:00:00Z"), java.time.ZoneOffset.UTC)); private static HengjianAdapter adapter(RecordingTransport transport) { return new HengjianAdapter(transport, new JacksonJsonCodec()); } private static FeeEstimateQuery.Builder query() { return FeeEstimateQuery.builder() .lengthCm(new BigDecimal("10.4")) .widthCm(new BigDecimal("10.6")) .heightCm(new BigDecimal("9.4")) .weightGrams(new BigDecimal("500")) .receiveCountry("US") .receiveState("CA") .receiveCity("Los Angeles") .receivePostal("90001") .receiveAddress("1 Main St"); } // ================================================================ 测算请求 private static final String ESTIMATE_BODY = "{\"statusCode\":200,\"status\":0,\"code\":200,\"message\":\"success\",\"data\":[" + "{\"carrier\":\"FedEx\",\"logisticServiceCode\":\"FEDHD_HL\"," + "\"serviceCode\":\"FEDHD\",\"conversionTotalRate\":18.38," + "\"originalTotalRate\":36.76,\"currency\":\"USD\",\"isResidential\":1," + "\"costItems\":[{\"costName\":\"Basic Rate\",\"estimatedCost\":9.38," + "\"currency\":\"USD\",\"errorMsg\":null}," + "{\"costName\":\"Fuel Surcharge\",\"estimatedCost\":3.06," + "\"currency\":\"USD\",\"errorMsg\":\"\"}]}]}"; private static RecordingTransport estimating() { return RecordingTransport.create() .route(HengjianConstants.PATH_FEE_ESTIMATE, req -> Responses.ok(ESTIMATE_BODY)); } @Test void estimatePostsToCalculate() { RecordingTransport transport = estimating(); adapter(transport).estimate(CTX, query().build()); assertEquals("POST", transport.lastDataRequest().method()); assertEquals(HengjianConstants.TEST_BASE_URL + "/v2/api/shipping/calculate", transport.lastDataRequest().url()); } /** 真机确认的必填项都要出现;shipper* 不必传。 */ @Test void estimateSendsMandatoryFields() { RecordingTransport transport = estimating(); adapter(transport).estimate(CTX, query().build()); String body = transport.lastDataRequest().body(); String[] mandatory = {"parcelLength", "parcelWidth", "parcelHeight", "parcelWeight", "parcelLengthUnit", "parcelWeightUnit", "receiverCountryCode", "receiverState", "receiverCity", "receiverZipcode", "receiverAddressLine1"}; for (String field : mandatory) { assertTrue(body.contains("\"" + field + "\""), "缺少必填字段 " + field + ",body=" + body); } // 真机校验信息里没有 shipper*,不发 assertFalse(body.contains("shipper"), body); } /** 单位直接用 cm / g,不做换算。 */ @Test void estimateUsesCmAndGramsWithoutConversion() { RecordingTransport transport = estimating(); adapter(transport).estimate(CTX, query().build()); String body = transport.lastDataRequest().body(); assertTrue(body.contains("\"parcelLengthUnit\":\"cm\""), body); assertTrue(body.contains("\"parcelWeightUnit\":\"g\""), body); assertTrue(body.contains("\"parcelWeight\":500.0"), body); } /** 恒健的包裹尺寸是 INTEGER:四舍五入,不截断(截断会让报价偏低)。 */ @Test void estimateRoundsDimensionsHalfUp() { RecordingTransport transport = estimating(); adapter(transport).estimate(CTX, query().build()); String body = transport.lastDataRequest().body(); // 10.4 -> 10, 10.6 -> 11, 9.4 -> 9 assertTrue(body.contains("\"parcelLength\":10"), body); assertTrue(body.contains("\"parcelWidth\":11"), body); assertTrue(body.contains("\"parcelHeight\":9"), body); } /** 物流服务码是选填:不给也能调(由仓报全部渠道)。 */ @Test void estimateWorksWithoutServiceCode() { RecordingTransport transport = estimating(); adapter(transport).estimate(CTX, query().build()); String body = transport.lastDataRequest().body(); assertFalse(body.contains("serviceCode\""), body); assertFalse(body.contains("\"carrier\""), body); } @Test void estimateSendsServiceCodeWhenGiven() { RecordingTransport transport = estimating(); adapter(transport).estimate(CTX, query() .logisticsServiceCode("FEDHD").logisticsProductCode("FedEx").build()); String body = transport.lastDataRequest().body(); assertTrue(body.contains("\"serviceCode\":\"FEDHD\""), body); assertTrue(body.contains("\"carrier\":\"FedEx\""), body); } // ================================================================ 测算结果 @Test void estimateMapsQuote() { List results = adapter(estimating()).estimate(CTX, query().build()); assertEquals(1, results.size(), "恒健不按仓维度返回,只有一个结果"); FeeEstimateResult result = results.get(0); assertEquals(WarehouseProvider.HENGJIAN, result.sourceProvider()); assertEquals("EFCA", result.shipOrgWarehouseCode()); assertEquals(1, result.carriers().size()); FeeEstimateResult.CarrierQuote quote = result.carriers().get(0); assertEquals("FedEx", quote.carrier()); // 优先用 logisticServiceCode(响应示例里那才是下单用的服务码) assertEquals("FEDHD_HL", quote.logisticsServiceCode()); // 折算价(客户实付),不是官方牌价 36.76 assertEquals(18.38, quote.totalRate().amount().doubleValue(), 0.0001); assertEquals("USD", quote.totalRate().currency().getCurrencyCode()); assertEquals(2, quote.costItems().size()); assertEquals("Fuel Surcharge", quote.costItems().get(1).costName()); assertEquals(3.06, quote.costItems().get(1).estimatedCost().amount().doubleValue(), 0.0001); } /** 没有报价时不抛,返回一个渠道为空的仓级结果。 */ @Test void estimateEmptyQuotesIsNotAnError() { RecordingTransport transport = RecordingTransport.create() .route(HengjianConstants.PATH_FEE_ESTIMATE, req -> Responses.ok( "{\"code\":200,\"message\":\"success\",\"data\":[]}")); List results = adapter(transport).estimate(CTX, query().build()); assertEquals(1, results.size()); assertTrue(results.get(0).carriers().isEmpty()); } // ================================================================ 地址属性 private static RecordingTransport classifying(String data) { return RecordingTransport.create() .route(HengjianConstants.PATH_ADDRESS_CLASSIFICATION, req -> Responses.ok( "{\"statusCode\":200,\"status\":0,\"code\":200,\"message\":\"success\"," + "\"data\":\"" + data + "\"}")); } @Test void classifyPostsToAddressClassification() { RecordingTransport transport = classifying("BUSINESS"); adapter(transport).classifyAddress(CTX, "1 Main St", null, "LA", "CA", "90001", "US"); assertEquals("POST", transport.lastDataRequest().method()); assertEquals(HengjianConstants.TEST_BASE_URL + "/v2/api/shipping/addressClassification", transport.lastDataRequest().url()); String body = transport.lastDataRequest().body(); assertTrue(body.contains("\"street1\":\"1 Main St\""), body); assertTrue(body.contains("\"zip\":\"90001\""), body); assertTrue(body.contains("\"country\":\"US\""), body); // street2 没给就不发 assertFalse(body.contains("street2"), body); } /** 文档里的四个值都要映射对;认不出归 UNKNOWN。 */ @Test void classifiesAllDocumentedValues() { assertEquals(AddressType.BUSINESS, classifyAs("BUSINESS")); assertEquals(AddressType.RESIDENTIAL, classifyAs("RESIDENTIAL")); assertEquals(AddressType.MIXED, classifyAs("MIXED")); assertEquals(AddressType.UNKNOWN, classifyAs("UNKNOWN")); } /** 仓方将来加新值:不猜,归 UNKNOWN。 */ @Test void unknownValueIsNotGuessed() { assertEquals(AddressType.UNKNOWN, classifyAs("SOMETHING_NEW")); // 大小写不敏感,但只认文档里那四个 assertEquals(AddressType.BUSINESS, classifyAs("business")); } /** 住宅附加费按 RESIDENTIAL 与 MIXED 计。 */ @Test void mixedCountsAsResidential() { assertTrue(AddressType.RESIDENTIAL.residential()); assertTrue(AddressType.MIXED.residential()); assertFalse(AddressType.BUSINESS.residential()); assertFalse(AddressType.UNKNOWN.residential()); } /** 真机确认五项必填:缺哪个报哪个,不发出去被仓方挡回来。 */ @Test void classifyRejectsMissingRequiredParts() { RecordingTransport transport = classifying("BUSINESS"); HengjianAdapter adapter = adapter(transport); assertThrows(IllegalArgumentException.class, () -> adapter.classifyAddress(CTX, null, null, "LA", "CA", "90001", "US")); assertThrows(IllegalArgumentException.class, () -> adapter.classifyAddress(CTX, "1 St", null, null, "CA", "90001", "US")); assertThrows(IllegalArgumentException.class, () -> adapter.classifyAddress(CTX, "1 St", null, "LA", null, "90001", "US")); assertThrows(IllegalArgumentException.class, () -> adapter.classifyAddress(CTX, "1 St", null, "LA", "CA", null, "US")); assertThrows(IllegalArgumentException.class, () -> adapter.classifyAddress(CTX, "1 St", null, "LA", "CA", "90001", null)); assertTrue(transport.dataRequests().isEmpty(), "本地校验失败不应发请求"); } private static AddressType classifyAs(String raw) { return adapter(classifying(raw)).classifyAddress(CTX, "1 St", null, "LA", "CA", "90001", "US"); } // ================================================================ 能力位 @Test void declaresEstimateAndAddressCapabilities() { HengjianAdapter adapter = adapter(RecordingTransport.create()); assertTrue(adapter.capabilities().contains(WarehouseCapability.FEE_ESTIMATE)); assertTrue(adapter.capabilities().contains(WarehouseCapability.ADDRESS_CLASSIFICATION)); } }