package common.ecommerce.hengjian.adapter; import common.ecommerce.hengjian.dto.HengjianAddressClassificationDtos; import common.ecommerce.hengjian.dto.HengjianFeeEstimateDtos; import common.ecommerce.shared.support.Money; import common.ecommerce.warehouse.enums.AddressType; import common.ecommerce.warehouse.enums.WarehouseProvider; import common.ecommerce.warehouse.model.FeeEstimateQuery; import common.ecommerce.warehouse.model.FeeEstimateResult; import java.math.BigDecimal; import java.util.ArrayList; import java.util.List; import java.util.Locale; /** * 恒健运费测算与地址属性映射。 * *
统一模型是 cm / g;恒健的 {@code parcelLength} 等字段是 INTEGER, * 所以厘米值要取整(四舍五入)——截断会让包裹尺寸偏小,报价偏低。
* *价格口径:{@code original*} 是承运商牌价、{@code conversion*} 是折算价 * (客户实付)。统一模型的 {@code totalRate} 取折算价——那才是客户要付的钱。 * 牌价没有对应字段,只进费用明细的名称里(如果仓方给了的话)。
* *恒健回四个英文词,映射到 {@link AddressType};认不出归 UNKNOWN,不猜—— * 猜错会多收或少收住宅附加费。
*/ public final class HengjianEstimateMapper { /** 长度单位:统一模型是 cm,恒健也接受 cm,直接下发不换算。 */ static final String UNIT_LENGTH_CM = "cm"; /** 重量单位:统一模型是 g,恒健也接受 g,直接下发不换算。 */ static final String UNIT_WEIGHT_G = "g"; /** 币种缺失时的默认值。 */ private static final String DEFAULT_CURRENCY = "USD"; private HengjianEstimateMapper() { } /** * 统一试算条件 → 恒健请求。 * *文档把 {@code shipper*} 系列标为必填,但真机校验信息里没有它们, * 所以不传。若真机后续要求,补上即可(模型里没有发货方信息,需调用方提供)。
*/ public static HengjianFeeEstimateDtos.CalculateRequest toRequest(FeeEstimateQuery query) { return toRequest(query, null); } /** * 统一试算条件 → 恒健请求。 * * @param fallbackWarehouseCode 调用方没给发运仓时的兜底(账户仓);恒健要求 * 「发运仓库」与「发运邮编」至少给一个 */ public static HengjianFeeEstimateDtos.CalculateRequest toRequest(FeeEstimateQuery query, String fallbackWarehouseCode) { HengjianFeeEstimateDtos.CalculateRequest req = new HengjianFeeEstimateDtos.CalculateRequest(); req.warehouseCode = firstNonBlank(query.shipFromWarehouseCode(), fallbackWarehouseCode); // 恒健这几个字段是 INTEGER:四舍五入而不是截断,截断会让包裹偏小、报价偏低 req.parcelLength = roundedCm(query.lengthCm()); req.parcelWidth = roundedCm(query.widthCm()); req.parcelHeight = roundedCm(query.heightCm()); req.parcelWeight = query.weightGrams().doubleValue(); req.parcelLengthUnit = UNIT_LENGTH_CM; req.parcelWeightUnit = UNIT_WEIGHT_G; req.receiverCountryCode = query.receiveCountry(); req.receiverState = query.receiveState(); req.receiverCity = query.receiveCity(); req.receiverZipcode = query.receivePostal(); req.receiverAddressLine1 = query.receiveAddress(); // 承运商 / 服务码是选填:给了就下发,由仓按指定渠道报价 req.carrier = trimToNull(query.logisticsProductCode()); req.serviceCode = trimToNull(query.logisticsServiceCode()); return req; } /** 厘米取整(四舍五入);恒健字段是 INTEGER。 */ static Integer roundedCm(BigDecimal cm) { return cm == null ? null : Integer.valueOf(cm.setScale(0, java.math.RoundingMode.HALF_UP).intValue()); } /** * 报价数组 → 统一结果。 * *恒健不按仓维度返回(请求也没带仓),所以统一结果只有一个实例, * {@code shipOrgWarehouseCode} 用账户仓填充——这是「这些报价适用于这个仓」的意思, * 不是从响应里读出来的。
*/ public static FeeEstimateResult toResult(List