package common.ecommerce.edayun.adapter; import common.ecommerce.edayun.dto.EdayunRentDetailDtos; 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.Instant; import java.util.ArrayList; import java.util.Collections; import java.util.List; /** * 易达云仓租费用明细映射 * ({@code POST /webApi/order/cost/v1/selectUserRentDetailList})。 * *

与另外两个费用接口的区别:

* * *

金额口径:{@code rentPrice} 是原价减折扣后的实收;缺失时用 * {@code originalPrice - discountPrice} 兜底,两者都没有才记 0。

*/ public final class EdayunRentDetailMapper { /** 计费时间窗上限 3 个月。 */ static final int MAX_RANGE_MONTHS = 3; /** 单页上限。 */ static final int MAX_PAGE_SIZE = 200; /** * 翻页上限:{@value #MAX_PAGES} 页 × {@value #MAX_PAGE_SIZE} 条。 * *

仓租按 SKU + 天出账,3 个月窗口下条数可能上万;这里设上限防止一次拉爆, * 超出时适配器显式失败而不是截断——见 docs-warehouse/edayun/TODO.md。

*/ static final int MAX_PAGES = 20; /** 一次拉取的最大行数;超过即失败。 */ static final int MAX_ROWS = MAX_PAGES * MAX_PAGE_SIZE; private EdayunRentDetailMapper() { } /** * 统一查询条件 → 仓租明细查询请求。 * *

文档里 {@code billDateBegin} / {@code billDateEnd} 都是必填,所以没有 * 时间窗时本地直接拒绝——仓租没有按单号单独查的口径。

* * @param providerWarehouseId 仓方仓 id;非空时作为 {@code warehouseIds} 唯一元素 */ public static EdayunRentDetailDtos.SelectRentDetailRequest toRequest( FeeQuery query, String providerWarehouseId) { if (!query.hasSettledRange()) { throw new IllegalArgumentException( "edayun rent detail query requires a billing time range (billDateBegin/End);" + " refusing to pull all rents"); } requireStorageOnly(query); EdayunRentDetailDtos.SelectRentDetailRequest req = new EdayunRentDetailDtos.SelectRentDetailRequest(); req.pageNum = 1; req.pageSize = MAX_PAGE_SIZE; EdayunQueryWindows.requireWithinMonths(query.settledAfter(), query.settledBefore(), MAX_RANGE_MONTHS, "rent detail"); req.billDateBegin = query.settledAfter().toEpochMilli(); req.billDateEnd = query.settledBefore().toEpochMilli(); Long warehouseId = warehouseIdOf(providerWarehouseId); req.warehouseIds = warehouseId == null ? null : Collections.singletonList(warehouseId); String businessNum = firstNonBlank(query.externalOrderNo(), query.saleOrderNo()); req.businessNums = businessNum == null ? null : Collections.singletonList(businessNum); // 仓租是 SKU 维度;只给条码时用条码查,别把条码当 SKU 传 req.skuCodes = hasText(query.providerSku()) ? Collections.singletonList(query.providerSku().trim()) : null; return req; } /** * 本接口只出仓租。 * *

宿主若明确要求别的费用类型,说明用错了接口——显式拒绝而不是返回空集合, * 否则调用方会误以为「该期间没有作业费」。

*/ private static void requireStorageOnly(FeeQuery query) { if (query.costType() != null && query.costType() != WarehouseFeeType.STORAGE) { throw new IllegalArgumentException( "edayun rent detail query only returns STORAGE cost, got " + query.costType() + "; use settlements() or orderCosts() for other fee types"); } if (query.hasDateRange()) { throw new IllegalArgumentException( "edayun rent detail query uses settledAfter/settledBefore (billDateBegin/End)," + " not snapshot date range"); } } /** 仓方仓 id 是数字;非数字直接拒绝,避免仓侧静默查不到。 */ static Long warehouseIdOf(String providerWarehouseId) { if (!hasText(providerWarehouseId)) { return null; } try { return Long.valueOf(providerWarehouseId.trim()); } catch (NumberFormatException e) { throw new IllegalArgumentException( "edayun warehouseIds must be numeric, got: " + providerWarehouseId + " (configure the provider warehouse id as edayun's numeric warehouse id)"); } } /** * 一行仓租明细 → 一条 {@link BillingDocument}。 * *

仓租天然就是仓储费,费用类型固定 {@link WarehouseFeeType#STORAGE}, * 不按 {@code billingName} 关键字猜。

*/ public static BillingDocument toDocument(EdayunRentDetailDtos.RentDetailRow row, String warehouseCode) { String currency = hasText(row.currencyCode) ? row.currencyCode.trim() : "USD"; return BillingDocument.builder() .warehouseCode(firstNonBlank(row.warehouseName, warehouseCode)) .sourceProvider(WarehouseProvider.EDAYUN) .documentNo(firstNonBlank(row.businessNum, row.orderNo)) // billingId 是计费明细唯一标识,可作为重复拉取的去重键 .serialNumber(row.billingId == null ? null : String.valueOf(row.billingId)) .feeName(firstNonBlank(row.billingName, "仓租")) .feeType(WarehouseFeeType.STORAGE) .estimated(false) .settledAt(row.billingDate == null ? null : Instant.ofEpochMilli(row.billingDate)) .amount(moneyOf(row, currency)) .saleOrderNo(row.orderNo) .providerSku(row.skuCode) .build(); } /** 批量映射,跳过 null 行。 */ public static List toDocuments(List rows, String warehouseCode) { if (rows == null || rows.isEmpty()) { return Collections.emptyList(); } List out = new ArrayList(rows.size()); for (EdayunRentDetailDtos.RentDetailRow row : rows) { if (row != null) { out.add(toDocument(row, warehouseCode)); } } return out; } /** 实收金额:{@code rentPrice} 优先,缺失时原价减折扣。 */ static Money moneyOf(EdayunRentDetailDtos.RentDetailRow row, String currency) { BigDecimal amount = null; if (row.rentPrice != null) { amount = BigDecimal.valueOf(row.rentPrice); } else if (row.originalPrice != null) { BigDecimal discount = row.discountPrice == null ? BigDecimal.ZERO : BigDecimal.valueOf(row.discountPrice); amount = BigDecimal.valueOf(row.originalPrice).subtract(discount); } return amount == null ? Money.zero(currency) : Money.of(amount, currency); } private static String firstNonBlank(String... values) { for (String v : values) { if (hasText(v)) { return v.trim(); } } return null; } private static boolean hasText(String v) { return v != null && !v.trim().isEmpty(); } }