- 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 补变更记录
154 lines
11 KiB
JSON
154 lines
11 KiB
JSON
[
|
||
{
|
||
"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"
|
||
}
|
||
]
|