package common.ecommerce.edayun.adapter; import common.ecommerce.edayun.dto.EdayunInboundDtos; import common.ecommerce.warehouse.model.InboundCarton; import common.ecommerce.warehouse.model.InboundCommand; import java.time.LocalDate; import java.time.ZoneOffset; import java.util.ArrayList; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; /** * 易达云自发入库单映射 * ({@code POST /webApi/entryInfo/v1/saveEntrySpontaneousOrder})。 * *
一个接口吃下新增 / 更新 / 发布,靠 {@code saveType} 区分:
*只下发统一模型有的三组:{@code basicInfo} / {@code logisticsInfo} / * {@code cargoInfos}。头程拖车、报关、清关、海外拖车在标准模型里没有对应字段, * 不下发——这些服务范围本来就由仓方按物流产品判定,缺字段时仓方会报错。
*/ public final class EdayunInboundMapper { /** 保存类型:新增。 */ static final int SAVE_NEW = 0; /** 保存类型:更新。 */ static final int SAVE_UPDATE = 1; /** 保存类型:保存并发布。 */ static final int SAVE_PUBLISH = 2; /** 客户单号长度上限。 */ static final int MAX_CUSTOMER_ORDER_NO = 30; private static final double GRAMS_PER_KG = 1000.0; private EdayunInboundMapper() { } /** * 统一命令 → 保存入库单请求。 * * @param saveType {@link #SAVE_PUBLISH} / {@link #SAVE_UPDATE} * @param entryCode 仓侧入库单号;仅更新时必填 * @param warehouseId 仓方仓标识;数字进 {@code shelfWarehouseId},非数字进 * {@code shelfWarehouseCode} */ public static EdayunInboundDtos.SaveEntryRequest toRequest(InboundCommand cmd, int saveType, String entryCode, String warehouseId) { EdayunInboundDtos.SaveEntryRequest req = new EdayunInboundDtos.SaveEntryRequest(); req.saveType = saveType; String customerOrderNo = cmd.inboundRequestNo(); if (customerOrderNo.length() > MAX_CUSTOMER_ORDER_NO) { throw new IllegalArgumentException( "edayun customerOrderNo must not exceed " + MAX_CUSTOMER_ORDER_NO + " chars, got " + customerOrderNo.length() + ": " + customerOrderNo); } req.customerOrderNo = customerOrderNo; if (saveType == SAVE_UPDATE) { if (!hasText(entryCode)) { throw new IllegalArgumentException( "edayun updating an inbound order requires entryCode (provider entry no)"); } req.entryCode = entryCode.trim(); } req.basicInfo = toBasicInfo(cmd, warehouseId); req.logisticsInfo = toLogisticsInfo(cmd); req.cargoInfos = toCargoInfos(cmd.cartons()); return req; } /** * 基础信息:仓 id 或编码二选一。 * *易达云的 {@code shelfWarehouseId} 是数字、{@code shelfWarehouseCode} 是编码(如 * {@code USLA})。配成 {@code EDY-WH-1} 这类 OMS 编码时走 code 分支。
*/ private static EdayunInboundDtos.BasicInfo toBasicInfo(InboundCommand cmd, String warehouseId) { EdayunInboundDtos.BasicInfo info = new EdayunInboundDtos.BasicInfo(); String raw = hasText(cmd.warehouseId()) ? cmd.warehouseId().trim() : (hasText(warehouseId) ? warehouseId.trim() : null); Long id = numericOrNull(raw); if (id != null) { info.shelfWarehouseId = id; } else if (raw != null) { info.shelfWarehouseCode = raw; } info.intShippingMethod = cmd.transportType(); info.cabinetType = intOrNull(cmd.cabinetType()); // shippingProductId 是「查询入库物流产品」接口给的 id,标准模型没有对应字段 return info; } /** * 物流信息:只填标准模型有的。 * *{@code waybill}(快递单号)与 {@code shipCompany}(承运商名)标准模型没有, * 不下发——快递类发布时仓方会报缺字段,由宿主补。不要把柜号之类的 * {@code transportOrderNos} 塞进 {@code waybill},那是另一回事。
*/ private static EdayunInboundDtos.LogisticsInfo toLogisticsInfo(InboundCommand cmd) { EdayunInboundDtos.LogisticsInfo info = new EdayunInboundDtos.LogisticsInfo(); info.cabinetCode = blankToNull(cmd.containerNo()); // 预计离港 ≈ 预计发运日期;预计到港 ≈ 预计到仓日期(口径待仓方确认) info.estimatedDepartureTime = millisOf(cmd.predictionShipDate()); info.estimatedArrivalDate = millisOf(cmd.estimateArriveDate()); return info; } /** * 装箱 → 箱货信息。 * *统一模型一行是「一个 SKU 在一箱里的数量」,一箱多 SKU 时同一 {@code sid} * 会拆成多行。这里按 {@code sid}(缺失时用箱码)归并成「一箱 = 一个 cargoInfo + * 多条 boxSkuInfoList」,与文档结构对齐。
* *{@code cargoInfos} 是必填的,而箱规只有 {@code InboundCarton} 才有—— * 调用方只给了 SKU 明细时本地拒绝,不凭空编一个箱子。
*/ static List