WMS_MAIN/methods/changes/qimen.json
liufumingren b07d7bca33 feat(stockout): 出库单转订单全链路(receiverInfo 落库、出库单默认快递、updateInfo、TRANSFERRED)
- 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 打包、方法与变更文档同步
2026-08-25 23:40:42 +08:00

136 lines
9.1 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[
{
"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"
}
]