WMS_MAIN/methods/changes/qimen.json
liufumingren b5e5d4d588 feat(storeWarehouse,report,notice,order): 签约导出与代开户备注兜底、报表meta下线、入库完成通知与编码规范化
- storeWarehouse: 货主签约列表异步导出 export/exportTaskProgress(26列中文表头Excel+进度回写);openAccount 代开户未传 store_remask(或传空)时默认取公司全称前50字符填充,保证货主名称在列表/导出中始终有值

- report: 下线 report.meta(破坏性),窗口参数改由 definition.typeList、勾选字段经 definition.list 提供;报表投递目标货主状态放宽为 1/2(正常/审核中);reportDelivery 实体展示名称兼容下划线/驼峰并优雅回退 ID

- notice/order: 入库单完成通知货主(entry_order_completed,固定订阅回退链:收货组→售后组→仓库异常群);入库明细 itemId 规范化(非法值降级按 item_code 精确/归一化条码匹配,剥离中文后缀,多命中报错防错配);库存预警定时任务与 webhook 模型调整

- storage: 快捷直入/入库单基本信息等相关小改(inbound_direct_log、storage/entry、storage/inventory)

- docs: methods/system 0.3.62→0.3.63、openapi/qimen 同步,AI_METHOD_ROUTING 与 report-config-guide 同步,methods/changes/*.json 补变更记录
2026-08-31 17:17:48 +08:00

154 lines
11 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.30-entryorder-create-item-match-fix",
"date": "2026-08-30",
"summary": "entryorder.create 商品匹配修复文档同步:明细行商品匹配三级策略(itemId 主键直查 > itemCode 精确匹配 > itemCode 归一化条码匹配)、编码支持中文后缀、item_id 统一写入 StockStore 数字主键、失败信息回显真实 SKU/商品/编码并附订单行号",
"methods": [
"entryorder.create"
],
"notes": [
"商品匹配三级策略:itemId 主键直查(纯数字且不超 BIGINT 范围、货主一致)> itemCode 精确匹配 > itemCode 归一化条码匹配(取编码开头连续数字)",
"带中文后缀编码(如 6934864201409-新品、6902226688892-赠品装)精确匹配不到时按归一化条码对齐;归一化命中多商品时报错不静默",
"item_id 统一写入实际匹配到的 StockStore 数字主键 id,修复 Data truncated for column 'item_id'",
"失败信息回显真实 SKU/商品/编码并附订单行号(未同步推送到仓库 / wms无对应关系 / 归一化匹配到多个商品)",
"测试:新增 qimen.entryorder.match.regression.test.js、entry_order.match.unit.test.js,修正 qimen.entryorder.create.status.test.js,10 passing / 0 failing(2026-08-30)",
"代码依据:app/service/systems/entry_order.js addOrder,qimenMethods/entryorder.js 与 openapiMethods/entryorder.js 共用同一逻辑"
],
"type": "updated",
"module": "entryorder"
},
{
"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"
}
]