package common.ecommerce.hengjian.adapter; import common.ecommerce.hengjian.HengjianConstants; import common.ecommerce.hengjian.dto.HengjianOperationFeeDtos; import common.ecommerce.hengjian.dto.HengjianStorageFeeDtos; import common.ecommerce.hengjian.dto.HengjianTailDeliveryFeeDtos; import common.ecommerce.shared.support.Money; import common.ecommerce.warehouse.enums.WarehouseFeeType; import common.ecommerce.warehouse.enums.WarehouseProvider; import common.ecommerce.warehouse.model.BillingDocument; import common.ecommerce.warehouse.model.FeeQuery; import java.math.BigDecimal; import java.time.LocalDate; import java.time.ZoneOffset; import java.util.ArrayList; import java.util.List; /** * 恒健计费明细映射(仓储费 / 尾程费 / 作业费)。 * *
三个接口的请求结构一致、行字段完全不同,所以请求构造共用一份, * 行映射各写一个方法。
* *必须有过滤条件:全空等于拉全量账单,这里直接拒绝, * 不发这种请求。
* *字段对应关系:
*| {@link FeeQuery} | 恒健 | 说明 |
|---|---|---|
| {@code billingTransNo} | {@code relOrderNos} | *计费单号(账单侧的业务单号) |
| {@code saleOrderNo} / {@code externalOrderNo} | {@code sourceNos} | *来源单号(我们下发的出库单号);两个字段都当来源单号,去重后下发 |
| {@code settledAfter/Before} 或 {@code snapshotDateRange} | *{@code btChargeAt} | {@code yyyy-MM-dd ~ yyyy-MM-dd} |
上一版是静默截断到 200——调用方传 9999 实际只发 200 却毫不知情, * 再按自己的 pageSize 判「本页是否满」就会误判末页,漏账。现在超限直接拒绝。
*/ static int pageSizeOf(int requested) { if (requested <= 0) { return HengjianConstants.FEE_PAGE_SIZE_DEFAULT; } if (requested > HengjianConstants.FEE_PAGE_SIZE_MAX) { throw new IllegalArgumentException( "hengjian billing page size must not exceed " + HengjianConstants.FEE_PAGE_SIZE_MAX + " (仓方上限待真机确认), got " + requested); } return requested; } /** * 恒健的「未结算」哨兵日期。 * *真机确认(2026-11-17):未结算的账单行会把 * {@code settlementAt} / {@code bookAt} 填成 {@code 1997-01-01 00:00:00}, * 不是 null。直接落库会让对账以为「1997 年结过一笔」。
*/ static final java.time.LocalDate NO_SETTLEMENT_DATE = java.time.LocalDate.of(1997, 1, 1); /** * 结算时间:哨兵日期转 null。 * * @param raw 仓方原始时间字符串 * @return 真实结算时间;未结算 / 空 / 无法解析时返回 null */ static java.time.Instant settledAt(String raw) { java.time.Instant parsed = HengjianOrderMapper.parseTime(raw); if (parsed == null) { return null; } if (NO_SETTLEMENT_DATE.equals( parsed.atZone(java.time.ZoneOffset.UTC).toLocalDate())) { return null; } return parsed; } // ================================================================ 仓储费 /** 仓储费行 → 统一费用单据。 */ public static BillingDocument toDocument(HengjianStorageFeeDtos.StorageFeeRow row, String warehouseCode) { Money amount = moneyOf(row.cost, row.currency); if (amount == null) { // 金额缺失的行无法入账:返回 null,由 mapAll 跳过,不用 0 兜底 return null; } return BillingDocument.builder() .warehouseCode(firstNonBlank(row.orgWarehouseCode, warehouseCode)) .sourceProvider(WarehouseProvider.HENGJIAN) .documentNo(trimToNull(row.billNo)) .serialNumber(trimToNull(row.transactionNo)) .feeName(trimToNull(row.settlementName)) .feeType(WarehouseFeeType.STORAGE) // 账单明细是已发生账目,不是预估 .estimated(false) .settledAt(settledAt(row.settlementAt)) .amount(amount) .providerSku(trimToNull(row.sku)) .saleOrderNo(trimToNull(row.sourceNo)) .build(); } // ================================================================ 尾程费 /** 尾程费行 → 统一费用单据。 */ public static BillingDocument toDocument(HengjianTailDeliveryFeeDtos.TailDeliveryFeeRow row, String warehouseCode) { Money amount = moneyOf(row.cost, row.currency); if (amount == null) { return null; } return BillingDocument.builder() .warehouseCode(firstNonBlank(row.orgWarehouseCode, warehouseCode)) .sourceProvider(WarehouseProvider.HENGJIAN) .documentNo(trimToNull(row.billNo)) .serialNumber(trimToNull(row.transactionNo)) .feeName(trimToNull(row.settlementName)) .feeType(WarehouseFeeType.LAST_MILE) .estimated(false) // 未结算行回 1997-01-01 哨兵;哨兵转 null,不回落到 chargeAt .settledAt(settledAt(row.settlementAt)) .amount(amount) .providerSku(trimToNull(row.erpSku)) // 订单号口径:站内单号优先,其次是来源单号,最后平台单号 .saleOrderNo(firstNonBlank(row.deliveryOrderNo, firstNonBlank(row.sourceOrderNo, firstNonBlank(row.orderNo, row.platformOrderNo)))) .build(); } // ================================================================ 作业费 /** 作业费行 → 统一费用单据。 */ public static BillingDocument toDocument(HengjianOperationFeeDtos.OperationFeeRow row, String warehouseCode) { Money amount = moneyOf(row.cost, row.currency); if (amount == null) { return null; } return BillingDocument.builder() .warehouseCode(firstNonBlank(row.orgWarehouseCode, warehouseCode)) .sourceProvider(WarehouseProvider.HENGJIAN) .documentNo(trimToNull(row.billNo)) .serialNumber(trimToNull(row.transactionNo)) .feeName(trimToNull(row.settlementName)) .feeType(WarehouseFeeType.OPERATION) .estimated(false) // 未结算行回 1997-01-01 哨兵;哨兵转 null,不回落到 chargeAt .settledAt(settledAt(row.settlementAt)) .amount(amount) .providerSku(trimToNull(row.relSku)) .saleOrderNo(firstNonBlank(row.relOrderNo, row.sourceNo)) .build(); } // ================================================================ 列表 static恒健三项计费接口的 {@code cost} 都是该行总费用;缺失时返回 * {@code null}(调用方会跳过该行),不用 0 兜底——0 会让对账金额偏小, * 而且看不出是哪一行缺了。
*/ static Money moneyOf(Double cost, String currency) { if (cost == null) { return null; } String code = trimToNull(currency); return Money.of(BigDecimal.valueOf(cost), code == null ? DEFAULT_CURRENCY : code); } static String firstNonBlank(String a, String b) { String x = trimToNull(a); return x != null ? x : trimToNull(b); } static String trimToNull(String v) { if (v == null) { return null; } String t = v.trim(); return t.isEmpty() ? null : t; } }