[ { "version": "2026.08.25-stockout-create-express-fallback-zt", "date": "2026-08-25", "summary": "stockout.create 快递兜底口径调整:兜底仅使用出库单兜底快递编码(policy_config.stockout_default_express_code,默认 ZT 自提),不再回退订单默认快递(default_express_code/全局 STO);快递解析改为独立实现,不再复用订单侧 resolveExpressSnapshot 兜底链。", "methods": [ "stockout.create" ], "notes": [ "qimenMethods/stockout.js create 快递解析重写:开启 enable_external_express_code 且传 logisticsCode 时按 wms_express_setting 映射 → 系统快递列表匹配;未传/未开启/匹配不到时取 stockout_default_express_code(为空则 'ZT'),从系统快递列表解析名称,仍不存在则编码=名称=ZT", "app/model/store_warehouse.js POLICY_CONFIG_FIELDS:新增 stockout_default_express_code(名称:出库单默认快递,type list,default 'ZT'),getPolicyConfigFieldListWithOptions 同步注入快递选项,与 default_express_code 表现一致", "注意:ZT 需在系统快递列表中维护(自提),否则出库单 express_code/express_name 直接落库 ZT" ], "type": "updated", "module": "stockout" }, { "version": "2026.08.25-stockout-create-receiver-info", "date": "2026-08-25", "summary": "stockout.create 解析 receiverInfo 落库(13 个标准字段)并接入出库单兜底快递编码:快递解析在未传 logisticsCode 或匹配不到时,优先使用货主合约配置 stockout_default_express_code(出库单兜底快递),为空再回退 default_express_code/全局 STO。", "methods": [ "stockout.create" ], "notes": [ "qimenMethods/stockout.js create 新增 receiverInfo 解析:company/name/zipCode/tel/mobile/email/countryCode/province/city/area/town/detailAddress/id 共 13 字段落库 receiver_* 列(空值转 NULL)", "快递解析改为传入覆盖默认快递后的 expressPolicyConfig(default_express_code = stockout_default_express_code || default_express_code)复用 resolveExpressSnapshot 匹配链路", "app/model/store_warehouse.js POLICY_CONFIG_FIELDS 新增 stockout_default_express_code(type list,默认空,描述:出库单未传快递编码或匹配不到时使用的兜底快递编码)", "receiverInfo 中的 idType/idNumber 扩展字段暂不落库(数据库未建列)" ], "type": "updated", "module": "stockout" }, { "version": "2026.08.25-stockout-create-express-resolve", "date": "2026-08-25", "summary": "stockout.create 新增 logisticsCode 快递编码解析(简化口径):货主开启 enable_external_express_code 时按 wms_express_setting → 系统快递列表匹配,匹配不到(含未开启)一律兜底默认快递,不走订单快递策略漏斗(matchPolicy)。解析结果落库 express_code/express_name。", "methods": [ "stockout.create" ], "notes": [ "qimenMethods/stockout.js create 在事务外解析 deliveryOrder.logisticsCode:调 deliveryOrder.getStoreWarehousePolicyConfig 读策略开关 + deliveryOrder.resolveExpressSnapshot(编码映射+兜底,不含策略漏斗),取 sysLogisticsCode/sysLogisticsName 落库 express_code/express_name", "解析失败仅告警不阻断建单(express_code/express_name 保持 NULL),confirm 前仍可走 storage.stockout.updateExpress 手工补填", "注意:出库单 express_code 存系统快递编码,stockout.confirm 出站回传 logisticsCode 时直接使用该值" ], "type": "updated", "module": "stockout" }, { "version": "2026.07.01-qimen-01", "date": "2026-07-01", "summary": "补充 entryorder.create 的 request body 子结构和 response 结构", "methods": [ "entryorder.create" ], "notes": [ "补充 request.entryOrder 子结构(entryOrderCode/warehouseCode/ownerCode/orderType)", "补充 request.orderLines.orderLine 子结构(itemCode/itemId/itemName/planQty/orderLineNo/inventoryType)", "补充 response 结构(entryOrderId/entryOrderCode/createTime/status)", "参考代码:systems/entry_order.js addOrder 和 qimenMethods/entryorder.js create 返回值" ], "type": "updated", "module": "entryorder" }, { "version": "2026.04.07-qimen-01", "date": "2026-04-07", "summary": "初始化 qimen 文档变更记录 sidecar,后续接口文档变更将持续追加到本数组。", "methods": [ "*" ], "notes": [ "methods/qimen.json 仍为单一事实来源(SSOT)。", "本文件仅记录变更历史与补充说明。" ] }, { "version": "2026.06.30-stockout-create-01", "date": "2026-06-30", "summary": "stockout.create 重构:从不可用的 deliveryOrder 旧链路迁移到 wms_order_stockout 专用表;返回字段 deliveryOrderId→stockoutOrderId/stockoutOrderCode", "methods": [ "stockout.create" ], "notes": [ "params 补全 deliveryOrder 和 orderLines 内部全部子字段", "response 从空补充为 stockoutOrderId/stockoutOrderCode", "文档与代码实现(qimenMethods/stockout.js create 方法)对齐" ] }, { "version": "2026.06.30-stockout-query-01", "date": "2026-06-30", "summary": "stockout.query 从占位(接口未完善)实现为完整查询:按 deliveryOrderCode 查 wms_order_stockout 主表+明细表", "methods": [ "stockout.query" ], "notes": [ "params 补全 request.deliveryOrder.deliveryOrderCode(body)", "response 从空补充为 deliveryOrder 主单 + orderLines.orderLine 明细 + totalLines", "文档与代码实现(qimenMethods/stockout.js query 方法)对齐" ], "type": "updated" }, { "version": "2026.08.07-stockout-confirm-01", "date": "2026-08-07", "summary": "stockout.confirm 从入站改为出站:确认后由 WMS 出站调用 taobao.qimen.stockout.confirm 通知 ERP", "methods": [ "stockout.confirm" ], "notes": [ "移除 qimenMethods/stockout.js 中错误的入站 confirm 方法(stockout.confirm 是出站而非入站)", "storage.stockout.confirm 确认后通过 qimenClient.send() 出站调用 taobao.qimen.stockout.confirm", "出站 payload 包含 deliveryOrder/packages/orderLines,logisticsCode=OTHER", "qimen.json 移除 stockout.confirm 入站条目" ], "type": "changed", "module": "stockout" }, { "version": "2026.08.17-qimen-order-cancel-01", "date": "2026-08-17", "summary": "order.cancel 触发拦截的两个分支统一转发快递群发起拦截(创建售后工单+通知快递群),仅限有运单的订单处理", "methods": [ "order.cancel" ], "notes": [ "已拣货/已打印分支:保留原有 createInterceptWorkOrdersAndNotify 调用,新增前置判断——先查订单运单,无运单不再创建工单/通知快递群", "已同步订单分支(sync_status=fin):新增与分支一相同的拦截处理——有运单时创建售后工单并通知对应快递群,与正常货主发起拦截一致", "无运单订单仍按原逻辑更新拦截状态与异常群通知,不创建工单、不通知快递群", "createInterceptWorkOrdersAndNotify 内部本就按运单驱动(无运单直接返回),外层判断进一步避免无谓调用" ], "type": "changed", "module": "order" } ]