diff --git a/src/api/order.index/orderindex.ts b/src/api/order.index/orderindex.ts index 8ef23bad..fcf11d34 100644 --- a/src/api/order.index/orderindex.ts +++ b/src/api/order.index/orderindex.ts @@ -24,7 +24,9 @@ export type OrderListParams = { * {"create_channel":{"operator":"in","value":["QM","API"]}} 标准结构多选;{"create_channel":{"operator":"ne","value":"MANUAL"}} 排除指定渠道。 * 注意:列表响应中的 create_channel 已格式化为中文标签,查询条件须传英文枚举值。 * - is_sn_order 是否含 SN(序列号) 商品筛选(后端订单分表 has_sn_item enum Y/N 归一化后输出): * {"is_sn_order":"Y"} 仅含 SN 商品订单;{"is_sn_order":"N"} 仅无 SN 商品订单。 - * 响应行同时返回 has_sn_item(原始列)与 is_sn_order(归一化),前端筛选/展示统一用 is_sn_order。 */ + * 响应行同时返回 has_sn_item(原始列)与 is_sn_order(归一化),前端筛选/展示统一用 is_sn_order。 + * - sn_code / snCode / sn_codes / snCodes 按 SN 码反查订单(先查 wms_order_item_sn 拿 order_id 再回填,订单表结构不变): + * 值支持单个字符串、逗号/空格/分号分隔多个码、字符串数组或 { value } 结构,按完整 SN 码精确匹配。 */ where?: Record sort?: { sortField?: string @@ -186,12 +188,12 @@ export type OrderExportParams = { * 导出表头字段白名单(中文表头字符串数组,如 ["系统订单号","外部订单号"]);不传或空数组时输出全部列。 * 支持 export_columns 与 exportColumns 两种写法。 * - * 文档枚举共 55 个(校验不区分导出模式,选中当前模式不存在的表头时该列自动忽略;传入非法表头会报错并列出非法值): - * 系统订单号、外部订单号、平台单号、订单ID、订单号、外部单号、订单状态、抓取波次号、波次号、波次序号、 + * 文档枚举共 57 个(校验不区分导出模式,选中当前模式不存在的表头时该列自动忽略;传入非法表头会报错并列出非法值): + * 系统订单号、外部订单号、平台单号、订单ID、订单号、外部单号、订单状态、拦截状态、抓取波次号、波次号、波次序号、 * 货主、平台、来源、店铺昵称、收件人、收件人电话、省、市、区、镇、详细地址、商品明细、仓库商品名称、 * 商品条码、商品图片、数量、物流公司、运单号、业务类型、运单接口、包材ID、包材编码、包材名称、分配时间、 * 订单商品总类数、订单商品总数、SN码数量、SN码、SN码汇总、商品重量、称重重量(g)、订单金额、实收金额、创建时间、支付时间、发货时间、 - * 出库状态、复核状态、复核完成状态、配货状态、打包状态、备注、买家留言、卖家留言、归档时间。 + * 出库状态、复核状态、复核完成状态、复核时间、配货状态、打包状态、备注、买家留言、卖家留言、归档时间。 * 其中仅 waybill 输出:系统订单号、外部订单号、平台单号、抓取波次号、商品明细、SN码汇总; * 仅 item 输出:订单ID、订单号、外部单号、波次号、仓库商品名称、商品条码、商品图片、数量、SN码。 * 「SN码数量」(sn_quantity)= 启用序列号管理商品(stock_warehouse.is_sn_mgmt='Y')的 plan_qty 合计; @@ -199,7 +201,7 @@ export type OrderExportParams = { * 「SN码」(sn_codes, item):该商品行复核时登记的 SN 码列表(状态限定 BOUND/VERIFIED/REISSUED,排除退回/作废); * 「SN码汇总」(sn_codes_summary, waybill):整单全部已登记 SN 码汇总,仅主单号行输出。 * ⚠️ 白名单不含「领料状态」「确认打印状态」(列表页有该状态列,但导出不支持,传入会报错)。 - * ⚠️ 「复核时间」(recheck_time) 已由后端支持(2026-10-08 确认),文档枚举暂未收录,保留在可选列中。 + * ⚠️ **一旦传入白名单,服务端只输出白名单内的列**:新增列必须同步加入前端可选清单,否则不会出现在导出表头中。 * 前端字段清单见 views/order/orderManagement/config/order-common-config.ts 的 ORDER_EXPORT_ALL_COLUMNS。 */ export_columns?: string[] diff --git a/src/api/order.pendingorder/orderpendingOrder.ts b/src/api/order.pendingorder/orderpendingOrder.ts index 355c2ba7..4f4fe516 100644 --- a/src/api/order.pendingorder/orderpendingOrder.ts +++ b/src/api/order.pendingorder/orderpendingOrder.ts @@ -52,6 +52,7 @@ export type PendingOrderListParams = { * claim_status 领料状态筛选(按订单表列过滤;枚举:none=未领料、padding=领料中、fin=已领料、error=异常): * 例 {"claim_status":{"operator":"ne","value":"fin"}} 查未完成领料的订单。 * is_sn_order 是否含 SN(序列号)商品筛选(按 has_sn_item 归一化):{"is_sn_order":"Y"} 仅 SN 订单、"N" 仅非 SN 订单。 + * sn_code / snCode / sn_codes / snCodes 按 SN 码反查订单(先查 wms_order_item_sn 回填,支持单值/分隔字符串/数组,完整码精确匹配)。 */ where?: OrderWhere; sort?: OrderSort; diff --git a/src/api/order.revieworder/orderreviewOrder.ts b/src/api/order.revieworder/orderreviewOrder.ts index 9d0159fa..05067cba 100644 --- a/src/api/order.revieworder/orderreviewOrder.ts +++ b/src/api/order.revieworder/orderreviewOrder.ts @@ -25,6 +25,7 @@ export type ReviewOrderListParams = { * {"create_channel":{"operator":"in","value":["QM","API"]}} 标准结构多选;{"create_channel":{"operator":"ne","value":"MANUAL"}} 排除指定渠道。 * 注意:列表响应中的 create_channel 已格式化为中文标签,查询条件须传英文枚举值。 * is_sn_order 是否含 SN(序列号)商品筛选(按 has_sn_item 归一化):{"is_sn_order":"Y"} 仅 SN 订单、"N" 仅非 SN 订单。 + * sn_code / snCode / sn_codes / snCodes 按 SN 码反查订单(先查 wms_order_item_sn 回填,支持单值/分隔字符串/数组,完整码精确匹配)。 */ where?: OrderWhere sort?: OrderSort diff --git a/src/api/order.wave/orderwave.ts b/src/api/order.wave/orderwave.ts index 11468083..84609e62 100644 --- a/src/api/order.wave/orderwave.ts +++ b/src/api/order.wave/orderwave.ts @@ -216,6 +216,7 @@ export type WaveGroupOrderFetchListParams = { same_order_quantity?: number shop_name?: string include_sku?: string + /** 是否在响应里返回组内订单 ID(order_ids);「抓取团购单」弹窗勾选「返回订单 ID 列表」时下发 true */ return_order_ids?: boolean } @@ -1107,7 +1108,7 @@ export type WaveSingleFetchByIdsResponse = { excluded_locked_order_ids?: Array skipped_order_ids?: Array not_found_order_ids?: Array - /** 因 SN(序列号管理)被排除、未加入波次的订单 ID 列表 */ + /** 因 SN(序列号管理)被排除、未加入波次的订单 ID 列表;SN 订单现已允许按订单抓取,该字段恒为空数组(保留兼容) */ excluded_sn_order_ids?: Array } diff --git a/src/api/storewarehouse.store/storeWarehouse.ts b/src/api/storewarehouse.store/storeWarehouse.ts index 58d4388f..9aa3c4ca 100644 --- a/src/api/storewarehouse.store/storeWarehouse.ts +++ b/src/api/storewarehouse.store/storeWarehouse.ts @@ -363,25 +363,35 @@ export function listApiConfig(data: { } as any) } -/** 保存接口配置(新增或更新) - * - app_name:必传,不再自动生成 - * - QM_WMS 类型:须填写 qimen_app_key(ERP)/ qimen_warehouse_code - * - OPEN_API 类型:系统自动生成 self_app_key(WMS+32位HEX)和 self_app_secret(64位HEX),无需传入奇门字段 +/** + * 保存接口配置(新增或更新) + * + * 对齐 2026-11-14 最新接口设计: + * - id:签约关系ID(兼容 contract_id) + * - interface_type_id:必须是 wms_interface_type 已存在的类型; + * ⚠️ 签约关系级配置统一按「货主开放接口」落库——传 3(OPEN_API_WAREHOUSE 仓库开放接口)时 + * 服务端自动映射为 2(OPEN_API 货主开放接口),货主主体也可维护 + * - app_name:必传(不再自动生成) + * - QM_WMS 类型:须填写 qimen_app_key(ERP)/ qimen_customer_id / qimen_warehouse_code + * - OPEN_API 类型:系统自动生成 self_app_key(WMS+32位HEX)与 self_app_secret(64位HEX),无需奇门字段 + * - callback_url:**已不是有效入参**,传入不生效;回调地址统一取 config.openapi.defaultCallbackUrl + * - 响应无业务字段(成功判定看 flag/code) */ export function saveApiConfig(data: { id: number interface_type_id: number - /** 应用名称(必传,不再自动生成) */ + /** 应用名称(必传) */ app_name: string - /** ERP AppKey(来自 index.getQimenAppList 下拉选择) */ + /** ERP AppKey(来自 index.getQimenAppList 下拉选择,QM_WMS 必填) */ qimen_app_key?: string + /** 奇门客户ID(QM_WMS 必填) */ qimen_customer_id?: string + /** 奇门仓库编码(QM_WMS 必填) */ qimen_warehouse_code?: string - api_version?: string - contact_person?: string - contact_phone?: string - email?: string - is_enabled?: number + /** + * @deprecated 后端已忽略(含别名 callbackUrl):回调地址不再由入参维护, + * 保存时统一取 config.openapi.defaultCallbackUrl;前端不发送 + */ callback_url?: string }) { return request({ diff --git a/src/views/order/orderManagement/config/order-common-config.ts b/src/views/order/orderManagement/config/order-common-config.ts index c5cbbfbd..dcf668ea 100644 --- a/src/views/order/orderManagement/config/order-common-config.ts +++ b/src/views/order/orderManagement/config/order-common-config.ts @@ -366,14 +366,13 @@ export type OrderExportColumnOption = { } /** - * order.export 全部可导出字段(共 57 个 = 接口文档枚举 55 个 + 「复核时间」+「拦截状态」): + * order.export 全部可导出字段(共 57 个,与接口文档枚举一致,2026-11-14): * 仅 waybill 模式输出:系统订单号、外部订单号、平台单号、抓取波次号、商品明细、SN码汇总; * 仅 item 模式输出:订单ID、订单号、外部单号、波次号、仓库商品名称、商品条码、商品图片、数量、SN码; * 其余为两种模式通用(选了当前模式不存在的表头时后端会自动忽略该列)。 * ⚠️ 接口白名单**不含**「领料状态」「确认打印状态」(列表页仍有这两列,但导出不支持,传入非法表头会直接报错)。 - * ⚠️ 「复核时间」(recheck_time) 刚由后端支持(2026-10-08),文档枚举暂未收录,勿以为多余而删除。 - * ⚠️ 「拦截状态」(intercept_status) 由前端于 2026-11-02 按需求先加入(配送订单等列表页均有该列); - * 接口文档 55 项枚举尚未收录,需后端同步支持该表头,否则传入会按「非法表头」报错。 + * ⚠️ **一旦传入 export_columns,服务端只输出白名单内的列**:新增列(如拦截状态、SN码数量、SN码、SN码汇总) + * 必须同步加入本清单,否则不会出现在导出表头中;不传该参数才会输出当前模式全部列。 * 「SN码数量」(字段 sn_quantity):订单明细中启用序列号管理(is_sn_mgmt='Y')商品的 plan_qty 合计; * waybill 模式仅主单号行输出合计(子单号行为 0),item 模式按商品明细行输出(非 SN 商品行为 0)。 * 「SN码」(sn_codes, 仅 item):该商品行复核时登记的 SN 码列表(状态限定 BOUND/VERIFIED/REISSUED); @@ -1341,6 +1340,7 @@ export const isSnOrderFilterOptions = [ { label: '否', value: 'N' }, ] +/** 有无留言(buyer_message_has,虚拟字段):界面值 has/none,下发时由 buildOrderWhereConditions 转为布尔 true/false(文档要求) */ export const buyerMessageHasFilterOptions = [ { label: '有留言', value: 'has' }, { label: '无留言', value: 'none' }, @@ -1571,6 +1571,19 @@ export const recheckTimeRangeScanField = scanBasicField({ label: '复核时间', export const isUrgencyScanField = scanBasicField({ label: '是否紧急', value: 'is_urgency', type: 'select', options: isUrgencyFilterOptions }) /** ScanBox:含SN商品 → where.is_sn_order = Y/N(后端按订单分表 has_sn_item 归一化过滤;勿传 has_sn_item) */ export const snOrderScanField = scanBasicField({ label: '含SN商品', value: 'is_sn_order', type: 'select', options: isSnOrderFilterOptions }) +/** + * ScanBox:按 SN 码反查订单(where.sn_code 虚拟字段) + * 后端先查 wms_order_item_sn 拿 order_id 再回填到订单条件;值支持单个码、 + * 逗号/空格/分号分隔多个码、数组或 { value } 结构,按完整 SN 码精确匹配。 + */ +export const snCodeScanField = scanBasicField({ + label: 'SN码', + value: 'sn_code', + type: 'text', + placeholder: '完整 SN 码,多个用逗号/空格分隔', + operators: ORDER_BULK_SEARCH_OPERATORS, + defaultOperator: 'eq' +}) export const buyerMessageHasScanField = scanBasicField({ label: '有无留言', value: 'buyer_message_has', type: 'select', options: buyerMessageHasFilterOptions }) export const buyerMessageScanField = scanBasicField({ label: '留言', value: 'buyer_message', type: 'text', defaultOperator: 'like' }) /** 「包含商品」筛选项定义已迁至 @/utils/scanFields(此处仅转发) */ @@ -1704,6 +1717,7 @@ export const deliveryAvailableFields = [ { ...storeScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...isUrgencyScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...snOrderScanField, group: SCAN_QUICK_FILTER_GROUP }, + { ...snCodeScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...waveAssignmentScanField, group: SCAN_QUICK_FILTER_GROUP }, // 订单信息 { ...pendingOrderQuickSearchScanField, group: SCAN_ORDER_INFO_GROUP }, @@ -1929,6 +1943,7 @@ export const reviewAvailableFields = [ { ...storeScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...isUrgencyScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...snOrderScanField, group: SCAN_QUICK_FILTER_GROUP }, + { ...snCodeScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...waveAssignmentScanField, group: SCAN_QUICK_FILTER_GROUP }, // 订单信息 { ...orderQuickSearchScanField, label: '发货单号', group: SCAN_ORDER_INFO_GROUP }, @@ -2101,6 +2116,7 @@ export const pendingAvailableFields = [ { ...storeScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...isUrgencyScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...snOrderScanField, group: SCAN_QUICK_FILTER_GROUP }, + { ...snCodeScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...waveAssignmentScanField, group: SCAN_QUICK_FILTER_GROUP }, // 订单信息 { ...pendingOrderQuickSearchScanField, group: SCAN_ORDER_INFO_GROUP }, @@ -2504,6 +2520,7 @@ export const expectionOrderAvailableFields = [ { ...storeScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...isUrgencyScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...snOrderScanField, group: SCAN_QUICK_FILTER_GROUP }, + { ...snCodeScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...waveAssignmentScanField, group: SCAN_QUICK_FILTER_GROUP }, // 订单信息 { ...pendingOrderQuickSearchScanField, group: SCAN_ORDER_INFO_GROUP }, @@ -2637,6 +2654,7 @@ export const archiveAvailableFields = [ { ...storeScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...isUrgencyScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...snOrderScanField, group: SCAN_QUICK_FILTER_GROUP }, + { ...snCodeScanField, group: SCAN_QUICK_FILTER_GROUP }, { ...waveAssignmentScanField, group: SCAN_QUICK_FILTER_GROUP }, // 订单信息 { ...orderQuickSearchScanField, group: SCAN_ORDER_INFO_GROUP }, diff --git a/src/views/order/orderManagement/exceptionOrder.vue b/src/views/order/orderManagement/exceptionOrder.vue index 93b9d43b..1880ec74 100644 --- a/src/views/order/orderManagement/exceptionOrder.vue +++ b/src/views/order/orderManagement/exceptionOrder.vue @@ -53,6 +53,7 @@ @page-change="handlePageChange" @page-size-change="handlePageSizeChange" @refresh="loadData" + @sort-change="handleSortChange" @selection-change="onSelectionChange" >