package common.ecommerce.yqn.adapter; import common.ecommerce.shared.support.Money; import common.ecommerce.warehouse.model.BillingDocument; import common.ecommerce.warehouse.model.FeeQuery; import common.ecommerce.warehouse.enums.WarehouseFeeType; import common.ecommerce.warehouse.sdk.WarehouseContext; import common.ecommerce.yqn.dto.YqnDtos; import java.time.Instant; import java.time.LocalDate; import java.time.ZoneId; import java.time.format.DateTimeFormatter; import java.time.format.DateTimeParseException; import java.util.ArrayList; import java.util.List; /** * 运去哪费用报文映射(API 133)。 */ public final class YqnFeeMapper { /** 运去哪所有金额都是 USD。 */ private static final String CURRENCY = "USD"; /** 仓储费按日期查的上限。 */ static final int MAX_SNAPSHOT_DAYS = 30; private static final DateTimeFormatter DATE = DateTimeFormatter.ofPattern("yyyy-MM-dd"); private static final DateTimeFormatter TIME = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); private static final ZoneId DEFAULT_ZONE = ZoneId.of("Asia/Shanghai"); private YqnFeeMapper() { } /** * 统一查询条件 → 运去哪请求。 * *

运去哪的约束:

* */ public static YqnDtos.CostDetailRequest toRequest(FeeQuery query) { if (query.isEmpty()) { throw new IllegalArgumentException( "yqn fee query requires at least one condition; refusing to pull all costs"); } YqnDtos.CostDetailRequest req = new YqnDtos.CostDetailRequest(); req.saleOrderNo = saleOrderNoOf(query.saleOrderNo()); req.billingTransNo = query.billingTransNo(); req.costType = costTypeOf(query.costType()); req.sku = query.providerSku(); req.externalOrderNo = query.externalOrderNo(); if (query.hasDateRange()) { requireStorageOnly(query); req.snapshotStartDate = DATE.format(query.snapshotStartDate()); req.snapshotEndDate = DATE.format(query.snapshotEndDate()); } return req; } /** 运去哪的要求:按时间查只能查仓储费。 */ private static void requireStorageOnly(FeeQuery query) { if (query.costType() != WarehouseFeeType.STORAGE) { throw new IllegalArgumentException( "yqn supports snapshot date range only for STORAGE cost; " + "operation / last-mile costs must be queried by saleOrderNo, " + "value-added by billingTransNo"); } long days = java.time.temporal.ChronoUnit.DAYS.between( query.snapshotStartDate(), query.snapshotEndDate()); if (days < 0 || days > MAX_SNAPSHOT_DAYS) { throw new IllegalArgumentException( "yqn snapshot date range must be within " + MAX_SNAPSHOT_DAYS + " days, got " + days); } } private static Long saleOrderNoOf(String raw) { if (raw == null || raw.trim().isEmpty()) { return null; } try { return Long.valueOf(raw.trim()); } catch (NumberFormatException e) { throw new IllegalArgumentException( "yqn saleOrderNo must be numeric, got: " + raw + " (use the warehouse order id, not your own order number)"); } } /** 业务类型 → 运去哪 costType;null 不限制。 */ static Integer costTypeOf(WarehouseFeeType type) { if (type == null) { return null; } switch (type) { case OPERATION: return 1; case STORAGE: return 2; case VALUE_ADDED: return 3; case LAST_MILE: return 4; default: return null; } } /** 一条运去哪费用 → 统一账单。 */ public static BillingDocument toDocument(YqnDtos.CostDetail detail, String warehouseCode, ZoneId zone) { return BillingDocument.builder() .warehouseCode(firstNonBlank(detail.warehouseCode, warehouseCode)) .feeName(detail.costName) .feeType(feeTypeOf(detail.costName)) .settledAt(parseTime(detail.settlementTime, zone)) // 1 实际结算 → estimated=false;2 预估结算 → true .estimated(detail.settlementType != null && detail.settlementType == 2) .amount(detail.costAmount == null ? Money.zero(CURRENCY) : Money.of(java.math.BigDecimal.valueOf(detail.costAmount), CURRENCY)) .saleOrderNo(detail.saleOrderNo == null ? null : String.valueOf(detail.saleOrderNo)) .sourceProvider(common.ecommerce.warehouse.enums.WarehouseProvider.YQN) .build(); } /** * 按费用名称归类。 * *

运去哪只给中文名,没有类型码(查询用的 {@code costType} 不回报)。 * 认不出来就留 null,不猜——对账时按名字分类比猜错安全。

*/ static WarehouseFeeType feeTypeOf(String costName) { if (costName == null) { return null; } String name = costName.trim(); if (name.contains("仓储") || name.contains("仓租")) { return WarehouseFeeType.STORAGE; } if (name.contains("尾程") || name.contains("运费") || name.contains("快递")) { return WarehouseFeeType.LAST_MILE; } if (name.contains("增值")) { return WarehouseFeeType.VALUE_ADDED; } if (name.contains("操作") || name.contains("作业")) { return WarehouseFeeType.OPERATION; } return null; } static Instant parseTime(String value, ZoneId zone) { if (value == null || value.trim().isEmpty()) { return null; } String v = value.trim(); try { return java.time.LocalDateTime.parse(v, TIME) .atZone(zone == null ? DEFAULT_ZONE : zone).toInstant(); } catch (DateTimeParseException e) { try { return Instant.parse(v); } catch (DateTimeParseException ignored) { return null; } } } private static String firstNonBlank(String a, String b) { if (a != null && !a.trim().isEmpty()) { return a.trim(); } return b == null ? null : b.trim(); } }