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"
>
@@ -532,6 +533,27 @@ const platformCodeOptions = ref>([])
const pagination = reactive({ currentPage: 1, pageSize: 20, total: 0 })
const tableSize = ref('small')
+/** 列头排序状态(本页列为 sortable: 'custom');未选排序时回落默认 updated_at DESC */
+const sortState = reactive<{ prop: string; order: 'ascending' | 'descending' | '' }>({ prop: '', order: '' })
+
+function buildSortParams() {
+ if (!sortState.prop || !sortState.order) {
+ return { sortField: 'updated_at', sortOrder: 'DESC' as const }
+ }
+ return {
+ sortField: sortState.prop,
+ sortOrder: sortState.order === 'ascending' ? ('ASC' as const) : ('DESC' as const)
+ }
+}
+
+/** 列头排序变更:回到第 1 页并按所选列重查(导出复用同一排序) */
+function handleSortChange({ prop, order }: { prop?: string | null; order?: string | null }) {
+ sortState.prop = String(prop || '')
+ sortState.order = order === 'ascending' || order === 'descending' ? order : ''
+ pagination.currentPage = 1
+ void loadData()
+}
+
const columns = ref(buildPendingStyleColumns(expectionColumns))
const selectionRows = ref([])
@@ -740,10 +762,7 @@ async function loadData() {
pageSize: pagination.pageSize
},
where: buildExportWhere(),
- sort: {
- sortField: 'updated_at',
- sortOrder: 'DESC' as const
- }
+ sort: buildSortParams()
}
const res: any = await orderExpectionOrder.list(params)
if (res && (res.code === 200 || res.code === 1)) {
@@ -772,10 +791,7 @@ function buildExportWhere() {
const pageExport = createOrderPageExport({
scopeKey: 'exceptionOrder',
buildWhere: buildExportWhere,
- buildSort: () => ({
- sortField: 'updated_at',
- sortOrder: 'DESC'
- }),
+ buildSort: buildSortParams,
selectionRows,
columns,
fileNamePrefix: '异常订单',
diff --git a/src/views/order/orderManagement/form/BatchQuickRecheckForm.vue b/src/views/order/orderManagement/form/BatchQuickRecheckForm.vue
index 5974457f..d39a330e 100644
--- a/src/views/order/orderManagement/form/BatchQuickRecheckForm.vue
+++ b/src/views/order/orderManagement/form/BatchQuickRecheckForm.vue
@@ -70,11 +70,20 @@
对每个订单执行前置检查(已分配储位、已分配快递、已同步且未被拦截),必要时自动完成拣货后标记发货;各订单独立事务,支持部分失败。
+
+
+ 含 SN(序列号管理)商品的订单不支持批量发货:{{ snOrderLabels.join('、') }}{{ snOrderRows.length > snOrderLabels.length ? ` 等 ${snOrderRows.length} 单` : '' }}
+ ,请改用单订单复核并提交 SN 码后再发货。
+
+
成功 {{ result.success_count }}
失败 {{ result.failed_count }}
+
+ 有 {{ snFailedCount }} 单因含 SN(序列号管理)商品失败,请改用单订单复核并提交 SN 码后再发货。
+
@@ -133,6 +142,8 @@ export type BatchQuickRecheckPreviewRow = {
delivery_order_code?: string
recheck_status?: string
pick_status?: string
+ /** 是否含 SN 商品:Y/N(响应原始列 has_sn_item,兼容归一化后的 is_sn_order) */
+ has_sn_item?: string
}
const visible = defineModel({ default: false })
@@ -154,6 +165,15 @@ const submitting = ref(false)
const result = ref(null)
const resultTab = ref<'success' | 'failed'>('success')
+/** 失败明细中命中 SN 相关文案的条数(后端对 SN 订单直接返回失败,需引导改用单订单复核) */
+const snFailedCount = computed(() => {
+ const failed = result.value?.failed
+ if (!Array.isArray(failed)) return 0
+ return failed.filter((item: any) =>
+ /SN|序列号|sn_map|sn_code|has_sn_item/i.test(`${item?.reason ?? ''} ${item?.message ?? ''}`)
+ ).length
+})
+
const form = reactive({
idsText: ''
})
@@ -166,6 +186,19 @@ const selectedRows = computed(() => props.selectedRows || [])
const parsedIds = computed(() => parseOrderIdsInput(form.idsText))
+/** 已选订单中「含 SN 商品」的行:批量快捷复核不支持,需改用单订单复核 */
+const snOrderRows = computed(() =>
+ selectedRows.value.filter((row) => String(row?.has_sn_item ?? '').trim().toUpperCase() === 'Y')
+)
+
+/** SN 订单提示文案(最多列 3 个发货单号) */
+const snOrderLabels = computed(() =>
+ snOrderRows.value
+ .slice(0, 3)
+ .map((row) => String(row.delivery_order_code ?? row.id ?? '').trim())
+ .filter(Boolean)
+)
+
/** 已选订单标签(发货单号) */
const selectedRowTagItems = computed(() =>
selectedRows.value
@@ -337,8 +370,7 @@ async function handleSubmit() {