- toOrder:create_channel=STOCKOUT、库存锁转移、收货必填校验、同快递/兜底平台、转单后置 TRANSFERRED(禁止一键出库) - stockout.create:解析 receiverInfo 13 字段落库,快递兜底改用出库单默认快递(stockout_default_express_code,默认 ZT 自提) - 新增 storage.stockout.updateInfo:收货/地址/快递/平台修改,仅 CREATED/PENDING,收货缺失禁止提交 - 迁移:wms_order_stockout 新增 receiver_* 13 列、order_status 增 TRANSFERRED、source_platform 两列 - 附带:storeWarehouse.createUser、奇门取消订单配送表幂等、express_platform Uint64 打包、方法与变更文档同步
136 lines
9.1 KiB
JSON
136 lines
9.1 KiB
JSON
[
|
||
{
|
||
"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"
|
||
}
|
||
]
|