oms/frontend/src/views/Order/StatusPanel.vue
liufumingren 69b26bf7cc feat(platform): 统一系统预设平台编码,外部平台标识按预设转换
- 新增 app/lib/platformCode.js:17 个预设平台(1688/DW/DYCS/DYGX/DYXD/JD/KS/MAOCHAO/
  MTYYJK/OFFLINE/OTHER/PDD/SPH/TB/TGC/TM/XHS)+ 别名表(中英文、大小写)+ 未知落 OTHER
- 店管家硬编码 PlatformType → 预设映射(Pinduoduo→PDD、TouTiao→DYXD、WxVideo→SPH、
  Alibaba→1688、Taobao→TB、KuaiShou→KS、Tmall→TM、JingDong→JD…)
- 拉单落库统一:orders.platform_type、order_status_*.source_platform_code/name
  写预设编码与本系统中文名(推 WMS 的 sourcePlatformCode/Name 同源)
- 店铺商品 platform_type 同样落预设编码
- 新增 scripts/migrate-platform-codes.js(npm run platforms:migrate):
  按同一口径迁移历史数据,默认 dry-run;已执行迁移 14 类(订单 27 / 店铺商品 44 / 状态表 15+13)
- 前端新增 constants/platform.ts(code→中文名):店铺商品「平台类型」列显示中文名,
  订单详情新增「来源平台」行
- 新增 platformCode 单测(5 项,含未知平台落 OTHER)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 17:31:44 +08:00

966 lines
39 KiB
Vue
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.

<script setup lang="ts">
import { computed, onMounted, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import DataTable from '@/components/DataTable.vue'
import ExportButton from '@/components/ExportButton.vue'
import ListPager from '@/components/ListPager.vue'
import RecordPickerDialog from '@/components/RecordPickerDialog.vue'
import OrderFormDialog from './OrderFormDialog.vue'
import { DEFAULT_PAGE_SIZE, useListPage } from '@/composables/useListPage'
import { formatDateTime } from '@/utils/datetime'
import { platformNameOf } from '@/constants/platform'
import {
ORDER_STAGE_META,
archiveOrders,
auditOrders,
cancelOrders,
changeOrdersWarehouse,
getOrderStatusDetail,
getOrderStatusFilters,
getOrderStatusList,
pushOrderToWms,
pushOrders,
pushOrdersToWms,
rejectOrders,
removeOrderStatus,
restoreOrders,
returnOrdersToPending,
voidOrders,
type OrderItemLine,
type OrderStage,
type OrderStatusFilters,
type OrderStatusItem,
} from '@/api/orderStatus'
/**
* 订单面板(按状态分视图)
*
* 八个视图(待审核 / 待推送 / 异常 / 委外中 / 配送 / 已作废 / 已取消 / 历史)共用本面板,数据源为对应状态表;
* 批量与行内动作按场景分布:
* - 待审核:审核(锁定库存 → 待推送)/ 切换仓库 / 取消 / 作废 / 编辑
* - 待推送:推送仓库(WMS deliveryorder.create)/ 驳回(换号+释放库存)/ 取消 / 作废 / 切换仓库 / 手工标记推送结果
* - 异常:转回待审核 / 直接审核 / 取消 / 作废 / 编辑
* - 委外中(已推送成功):只读流转(取消)——**不再提供推送仓库操作**
* - 配送 / 历史:只读(配送可归档)
* - 已作废 / 已取消:可恢复(曾推送过的自动换号)
*
* 删除仅在「已取消」视图提供:待审核 / 待推送 / 异常等视图的订单需先取消再删除,
* 避免绕过状态机把在途单据直接抹掉。
*/
const props = defineProps<{ status: OrderStage }>()
const isHistory = computed(() => props.status === 'history')
/** 异常视图:状态恒为「异常」,列表不再重复展示状态列,并把异常原因提到前面标红 */
const isException = computed(() => props.status === 'exception')
const stageMeta = computed(() => ORDER_STAGE_META[props.status])
/* -------------------- 筛选条件(默认一行简单条件,可展开为完整条件) -------------------- */
const expanded = ref(false)
const query = reactive({
page: 1,
pageSize: DEFAULT_PAGE_SIZE,
order_no: '',
parent_order_no: '',
shop_id: '' as number | '',
receiver: '',
address: '',
remark: '',
createdRange: [] as string[],
archivedRange: [] as string[],
})
/** 「含未绑定商品订单」开关(默认关闭:不显示含未绑定商品的订单) */
const showUnboundOrders = ref(false)
function onUnboundSwitchChange() {
query.page = 1
search()
}
const { loading, list, total, elapsed, fetchList, search, handlePageChange, handleSizeChange } =
useListPage<OrderStatusItem, typeof query>({
query,
fetcher: () => {
const params: Record<string, unknown> = {
status: props.status,
page: query.page,
pageSize: query.pageSize,
}
if (query.order_no) params.order_no = query.order_no.trim()
if (query.parent_order_no) params.parent_order_no = query.parent_order_no.trim()
if (query.shop_id !== '') params.shop_id = query.shop_id
if (query.receiver) params.receiver = query.receiver.trim()
if (query.address) params.address = query.address.trim()
if (query.remark) params.remark = query.remark.trim()
if (query.createdRange.length === 2) {
params.created_from = query.createdRange[0]
params.created_to = query.createdRange[1]
}
if (query.archivedRange.length === 2) {
params.archived_from = query.archivedRange[0]
params.archived_to = query.archivedRange[1]
}
// 待审核默认只看「商品都已绑定」的订单,开关打开才包含未绑定商品的订单
if (props.status === 'pending' && !showUnboundOrders.value) params.exclude_unbound = 1
return getOrderStatusList(params as never)
},
})
/** 无条件重置(含展开区的完整条件) */
function reset() {
query.order_no = ''
query.parent_order_no = ''
query.shop_id = ''
query.receiver = ''
query.address = ''
query.remark = ''
query.createdRange = []
query.archivedRange = []
search()
}
/** 导出筛选条件(当前视图状态 + 当前筛选条件) */
const exportFilters = computed(() => ({
order_stage: props.status,
order_no: query.order_no.trim(),
parent_order_no: query.parent_order_no.trim(),
receiver: query.receiver.trim(),
address: query.address.trim(),
remark: query.remark.trim(),
shop_id: query.shop_id,
created_from: query.createdRange[0],
created_to: query.createdRange[1],
archived_from: query.archivedRange[0],
archived_to: query.archivedRange[1],
exclude_unbound: props.status === 'pending' && !showUnboundOrders.value ? 1 : '',
}))
/* -------------------- 筛选项数据源(状态枚举 / 店铺 / 归档阈值) -------------------- */
const filters = ref<OrderStatusFilters>({
statuses: [],
status_labels: {} as OrderStatusFilters['status_labels'],
active_statuses: [],
archive_months: 3,
shops: [],
warehouses: [],
})
async function fetchFilters() {
try {
filters.value = await getOrderStatusFilters()
} catch {
// 拦截器已提示,保留默认值
}
}
/* -------------------- 勾选与批量操作 -------------------- */
const selectedIds = ref<number[]>([])
function onSelectionChange(rows: OrderStatusItem[]) {
selectedIds.value = rows.map(row => row.id)
}
type BatchKey =
| 'audit'
| 'return'
| 'push_wms'
| 'push_success'
| 'push_failed'
| 'reject'
| 'cancel'
| 'void'
| 'restore'
| 'change_warehouse'
/** 批量操作按场景分布在各视图(店铺在创建时确定,不再提供批量设置店铺) */
const BATCH_ACTIONS: Record<OrderStage, { key: BatchKey; label: string; type: string }[]> = {
pending: [
{ key: 'audit', label: '批量审核(→ 待推送)', type: 'primary' },
{ key: 'change_warehouse', label: '切换仓库', type: 'default' },
{ key: 'cancel', label: '取消', type: 'warning' },
{ key: 'void', label: '作废', type: 'danger' },
],
queued: [
{ key: 'push_wms', label: '推送仓库', type: 'success' },
{ key: 'reject', label: '驳回(换号)', type: 'warning' },
{ key: 'change_warehouse', label: '切换仓库', type: 'default' },
{ key: 'cancel', label: '取消', type: 'warning' },
{ key: 'void', label: '作废', type: 'danger' },
{ key: 'push_success', label: '手工标记推送成功', type: 'default' },
{ key: 'push_failed', label: '手工标记推送失败', type: 'default' },
],
exception: [
{ key: 'return', label: '批量转回待审核', type: 'warning' },
{ key: 'audit', label: '批量审核(直接 → 待推送)', type: 'primary' },
{ key: 'change_warehouse', label: '切换仓库', type: 'default' },
{ key: 'cancel', label: '取消', type: 'warning' },
{ key: 'void', label: '作废', type: 'danger' },
],
outsourcing: [
{ key: 'cancel', label: '取消(同步取消仓库单)', type: 'warning' },
],
delivery: [],
void: [{ key: 'restore', label: '恢复(→ 待审核)', type: 'primary' }],
canceled: [{ key: 'restore', label: '恢复(→ 待审核)', type: 'primary' }],
history: [],
}
const batchActions = computed(() => BATCH_ACTIONS[props.status] || [])
/** 批量操作确认文案 */
function confirmText(key: BatchKey, count: number): string {
const map: Record<BatchKey, string> = {
audit: `确认对选中的 ${count} 条订单执行「审核」?审核即锁定库存并进入「${ORDER_STAGE_META.queued.label}」。`,
return: `确认将选中的 ${count} 条订单「转回待审核」?转回后需重新审核。`,
push_wms: `确认将选中的 ${count} 条订单「推送仓库」?推送成功进入「${ORDER_STAGE_META.outsourcing.label}」,等仓库回传确认后进入「${ORDER_STAGE_META.delivery.label}」。`,
push_success: `确认将选中的 ${count} 条订单手工标记为「推送成功」?将进入「${ORDER_STAGE_META.outsourcing.label}」视图。`,
push_failed: `确认将选中的 ${count} 条订单手工标记为「推送失败」?将转入「${ORDER_STAGE_META.exception.label}」并释放锁定库存。`,
reject: `确认驳回选中的 ${count} 条订单?驳回会自动换号(避免重推被仓库判重)并释放锁定库存,回到「${ORDER_STAGE_META.pending.label}」。`,
cancel: `确认取消选中的 ${count} 条订单?已推送成功的会先取消仓库单据,成功后释放锁定库存。`,
void: `确认作废选中的 ${count} 条订单?作废记录人与原因、释放锁定库存,不可恢复也禁止删除。`,
restore: '确认将选中的订单恢复到「待审核」?曾推送过的单据会自动换号。',
change_warehouse: '确认切换选中订单的发货仓库?',
}
return map[key]
}
/** 切换仓库使用的目标选择弹窗(列表选择,而非手输名称) */
const picker = reactive({
visible: false,
title: '',
})
const pickerOptions = computed<Array<Record<string, unknown>>>(() =>
(filters.value.warehouses || []).map(item => ({ ...item })),
)
const pickerColumns = [
{ prop: 'code', label: '仓库编码', width: 180 },
{ prop: 'name', label: '仓库名称', minWidth: 200 },
]
/** 弹窗确认后的回调(由打开方注入) */
let pickerResolve: ((row: Record<string, unknown> | null) => void) | null = null
/**
* 打开仓库选择弹窗并等待结果
* @return 选中的仓库行,取消返回 null
*/
function openPicker() {
if (!(filters.value.warehouses || []).length) {
ElMessage.warning('当前主体下没有仓库,请先到「仓库管理」创建')
return Promise.resolve(null)
}
picker.title = '切换仓库'
picker.visible = true
return new Promise<Record<string, unknown> | null>((resolve) => {
pickerResolve = resolve
})
}
function onPickerConfirm(row: Record<string, unknown>) {
if (pickerResolve) pickerResolve(row)
pickerResolve = null
}
function onPickerClose(visible: boolean) {
picker.visible = visible
if (!visible && pickerResolve) {
pickerResolve(null)
pickerResolve = null
}
}
async function pickWarehouse(): Promise<number | null> {
const row = await openPicker()
return row ? Number(row.id) : null
}
/** 批量操作入口 */
async function handleBatch(key: BatchKey) {
const ids = [ ...selectedIds.value ]
if (!ids.length) {
ElMessage.warning('请先勾选要操作的订单')
return
}
try {
// 需额外入参的动作先收集参数,再统一确认
if (key === 'change_warehouse') {
const warehouseId = await pickWarehouse()
if (!warehouseId) return
const result = await changeOrdersWarehouse(ids, warehouseId)
ElMessage.success(`已切换仓库:${result.target.name}`)
selectedIds.value = []
await fetchList()
return
}
let tip = ''
if (key === 'push_failed') {
const { value } = await ElMessageBox.prompt(confirmText(key, ids.length), '手工标记推送失败', {
confirmButtonText: '确定',
cancelButtonText: '取消',
inputPlaceholder: '请填写推送失败原因(写入订单备注)',
inputValidator: (text: string) => (text && text.trim() ? true : '请填写推送失败原因'),
})
tip = String(value).trim()
} else if (key === 'void') {
const { value } = await ElMessageBox.prompt(confirmText(key, ids.length), '作废订单', {
confirmButtonText: '确定',
cancelButtonText: '取消',
inputPlaceholder: '请填写作废原因(可不填)',
})
tip = String(value || '').trim()
} else if (key === 'cancel') {
const { value } = await ElMessageBox.prompt(confirmText(key, ids.length), '取消订单', {
confirmButtonText: '确定',
cancelButtonText: '取消',
inputPlaceholder: '请填写取消原因(可不填)',
})
tip = String(value || '').trim()
} else {
await ElMessageBox.confirm(confirmText(key, ids.length), '批量操作', {
type: 'warning',
confirmButtonText: '确定',
cancelButtonText: '取消',
})
}
if (key === 'audit') {
const result = await auditOrders(ids)
if (result.failures?.length) {
ElMessage.warning(`已审核 ${result.count} 条,${result.failed} 条失败(如:${result.failures[0].message})`)
} else {
ElMessage.success(`已审核 ${result.count} 条,当前状态「${result.status_label}」`)
}
} else if (key === 'return') {
const result = await returnOrdersToPending(ids)
ElMessage.success(`已处理 ${result.count} 条,当前状态「${result.status_label}」`)
} else if (key === 'push_wms') {
const result = await pushOrdersToWms(ids)
ElMessage.success(
`推送完成:成功 ${result.pushed},失败 ${result.failed},待重试 ${result.retry},跳过 ${result.skipped}` +
(result.pendingRest ? `(剩余 ${result.pendingRest} 条由定时任务继续推送)` : ''),
)
} else if (key === 'push_success') {
const result = await pushOrders(ids, 'success')
ElMessage.success(`已处理 ${result.count} 条,当前状态「${result.status_label}」`)
} else if (key === 'push_failed') {
const result = await pushOrders(ids, 'failed', tip || '推送外部失败')
ElMessage.success(`已处理 ${result.count} 条,当前状态「${result.status_label}」`)
} else if (key === 'reject') {
const result = await rejectOrders(ids)
const renamed = result.items.filter(item => item.bill_no_changed).length
ElMessage.success(`已驳回 ${result.count} 条${renamed ? `,其中 ${renamed} 条已换号` : ''}`)
} else if (key === 'cancel') {
const result = await cancelOrders(ids, tip || undefined)
ElMessage.success(`已取消 ${result.count} 条,当前状态「${result.status_label}」`)
} else if (key === 'void') {
const result = await voidOrders(ids, tip || undefined)
ElMessage.success(`已作废 ${result.count} 条,当前状态「${result.status_label}」`)
} else if (key === 'restore') {
const result = await restoreOrders(ids)
const renamed = result.items.filter(item => item.bill_no_changed).length
ElMessage.success(`已恢复 ${result.count} 条${renamed ? `,其中 ${renamed} 条已换号` : ''}`)
}
selectedIds.value = []
await fetchList()
} catch {
// 用户取消 或 拦截器已提示
}
}
/** 手工归档创建时间超期的订单(默认 3 个月,定时任务亦会自动执行) */
async function handleArchiveExpired() {
const months = filters.value.archive_months || 3
try {
await ElMessageBox.confirm(
`确认归档创建时间超过 ${months} 个月的订单?归档后迁入历史表(只读),并记录归档时间与转入时间。`,
'归档超期订单',
{ type: 'warning', confirmButtonText: '确定', cancelButtonText: '取消' },
)
} catch {
return
}
try {
const result = await archiveOrders({ months })
ElMessage.success(`已归档 ${result.count} 条`)
await fetchList()
} catch {
// 拦截器已提示
}
}
/* -------------------- 详情(单据头 + 明细,实时取详情接口) -------------------- */
const detailVisible = ref(false)
const detailLoading = ref(false)
const detailRow = ref<OrderStatusItem | null>(null)
const detailProducts = ref<OrderItemLine[]>([])
async function openDetail(row: OrderStatusItem) {
detailRow.value = row
detailProducts.value = []
detailVisible.value = true
detailLoading.value = true
try {
const { order, items } = await getOrderStatusDetail(row.id)
detailRow.value = order
detailProducts.value = items
} catch {
// 拦截器已提示,退化为列表行展示
} finally {
detailLoading.value = false
}
}
/* -------------------- 新建 / 编辑(发货单口径表单) -------------------- */
const formVisible = ref(false)
const formOrderId = ref<number | null>(null)
function openCreate() {
formOrderId.value = null
formVisible.value = true
}
function openEdit(row: OrderStatusItem) {
formOrderId.value = row.id
formVisible.value = true
}
async function handleFormSaved() {
if (formOrderId.value) {
selectedIds.value = []
await fetchList()
} else if (props.status === 'pending') {
await fetchList()
}
}
/* -------------------- 行内动作 -------------------- */
type RowActionKey =
| 'detail'
| 'edit'
| 'audit'
| 'push_wms'
| 'reject'
| 'cancel'
| 'void'
| 'restore'
| 'remove'
| 'archive'
const AUTO_ACTIONS: Record<OrderStage, RowActionKey[]> = {
pending: [ 'edit', 'audit', 'cancel', 'void' ],
queued: [ 'push_wms', 'reject', 'cancel', 'void' ],
exception: [ 'edit', 'audit', 'cancel', 'void' ],
outsourcing: [ 'cancel' ],
delivery: [ 'archive' ],
void: [ 'restore' ],
canceled: [ 'restore', 'remove' ],
history: [],
}
const rowActions = computed(() => AUTO_ACTIONS[props.status] || [])
/** 行内动作文案 */
const ROW_ACTION_LABEL: Record<RowActionKey, string> = {
detail: '查看',
edit: '编辑',
audit: '审核',
push_wms: '推送仓库',
reject: '驳回',
cancel: '取消',
void: '作废',
restore: '恢复',
remove: '删除',
archive: '归档',
}
/** 单条动作:确认后调用对应接口 */
async function handleRowAction(row: OrderStatusItem, key: RowActionKey) {
const ids = [ row.id ]
try {
if (key === 'edit') {
openEdit(row)
return
}
if (key === 'audit') {
await ElMessageBox.confirm(`确认审核订单 ${row.order_no}?审核即锁定库存并进入「待推送」。`, '审核', { type: 'warning' })
const result = await auditOrders(ids)
ElMessage.success(`已审核 ${row.order_no},锁定 ${result.stock_locked ?? 0} 行库存,已进入「${result.status_label}」`)
} else if (key === 'push_wms') {
await ElMessageBox.confirm(`确认把订单 ${row.order_no} 推送到仓库?`, '推送仓库', { type: 'warning' })
const result = await pushOrderToWms(row.id)
ElMessage.success(`已推送 ${row.order_no}(第 ${result.attempts} 次尝试),已进入「委外中」`)
} else if (key === 'reject') {
await ElMessageBox.confirm(
`确认驳回订单 ${row.order_no}?驳回会换号(避免重推被仓库判重)并释放锁定库存。`,
'驳回',
{ type: 'warning' },
)
const result = await rejectOrders(ids)
const item = result.items[0]
ElMessage.success(item.bill_no_changed ? `已驳回并换号:${item.order_no}` : '已驳回')
} else if (key === 'cancel') {
const { value } = await ElMessageBox.prompt(`确认取消订单 ${row.order_no}?`, '取消订单', {
confirmButtonText: '确定',
cancelButtonText: '取消',
inputPlaceholder: '请填写取消原因(可不填)',
})
await cancelOrders(ids, String(value || '').trim() || undefined)
ElMessage.success(`已取消 ${row.order_no}`)
} else if (key === 'void') {
const { value } = await ElMessageBox.prompt(
`确认作废订单 ${row.order_no}?作废后不可恢复也禁止删除。`,
'作废订单',
{
confirmButtonText: '确定',
cancelButtonText: '取消',
inputPlaceholder: '请填写作废原因(可不填)',
},
)
await voidOrders(ids, String(value || '').trim() || undefined)
ElMessage.success(`已作废 ${row.order_no}`)
} else if (key === 'restore') {
await ElMessageBox.confirm(`确认把订单 ${row.order_no} 恢复到「待审核」?曾推送过的会自动换号。`, '恢复', {
type: 'warning',
})
const result = await restoreOrders(ids)
const item = result.items[0]
ElMessage.success(item.bill_no_changed ? `已恢复并换号:${item.order_no}` : `已恢复 ${row.order_no}`)
} else if (key === 'remove') {
await ElMessageBox.confirm(`确认删除订单 ${row.order_no}?删除后不可恢复(已审核及之后禁止删除)。`, '删除订单', {
type: 'warning',
})
await removeOrderStatus(row.id)
ElMessage.success(`已删除 ${row.order_no}`)
} else if (key === 'archive') {
await ElMessageBox.confirm(`确认把订单 ${row.order_no} 归档到历史?归档后只读。`, '归档', { type: 'warning' })
await archiveOrders({ ids })
ElMessage.success(`已归档 ${row.order_no}`)
}
selectedIds.value = []
await fetchList()
} catch {
// 用户取消 或 拦截器已提示
}
}
/** 数量/单价展示:数字去掉多余小数 */
function fmtNum(value: unknown): string {
if (value === null || value === undefined || value === '') return '-'
const num = Number(value)
return Number.isFinite(num) ? String(Number(num.toFixed(2))) : String(value)
}
/** 外部打单平台订单的平台单号(店管家「订单编号」,来源订单号用的是其「系统编号」) */
function platformOrderNoOf(row: Record<string, any> | null): string {
const props = row && (row.extend_props as Record<string, unknown> | null)
const value = props && props.platform_order_no
return typeof value === 'string' ? value : ''
}
/** 行金额 = 数量 × 单价 */
function lineAmount(line: OrderItemLine): string {
const qty = Number(line.plan_qty || 0)
const price = Number(line.actual_price || 0)
if (!Number.isFinite(qty) || !Number.isFinite(price)) return '-'
return (qty * price).toFixed(2)
}
/** 收件人展示:姓名 + 电话/手机 */
function receiverText(row: OrderStatusItem): string {
const phone = row.mobile || row.tel || ''
return phone ? `${row.receiver || '-'}(${phone})` : row.receiver || '-'
}
/**
* 运单号(多包裹时逐个展示):优先 express_codes(回调写入的多运单号集合),回退单值 express_code
* @param row 订单行
* @return 运单号数组(无则空数组)
*/
function expressCodesOf(row: OrderStatusItem): string[] {
const codes = (row.express_codes || []).filter(code => code && String(code).trim())
if (codes.length) return codes.map(code => String(code))
return row.express_code ? [ String(row.express_code) ] : []
}
onMounted(async () => {
await fetchFilters()
await fetchList()
})
</script>
<template>
<div class="panel">
<!-- 批量操作区(按场景分布在各视图) + 新建/归档入口 -->
<div class="toolbar">
<div class="toolbar-left">
<el-tag :type="stageMeta.tag" size="small" effect="plain">{{ stageMeta.label }}</el-tag>
<el-button
v-for="action in batchActions"
:key="action.key"
:type="action.type as never"
size="small"
:disabled="!selectedIds.length"
@click="handleBatch(action.key)"
>
{{ action.label }}
</el-button>
<span v-if="!batchActions.length" class="toolbar-hint">该视图只读(可查看详情)</span>
<span v-else-if="selectedIds.length" class="toolbar-hint">已选 {{ selectedIds.length }} 条</span>
</div>
<div class="toolbar-right">
<el-switch
v-if="props.status === 'pending'"
v-model="showUnboundOrders"
size="small"
inline-prompt
active-text="含未绑定"
inactive-text="仅已绑定"
class="unbound-switch"
@change="onUnboundSwitchChange"
/>
<ExportButton type="order" :filters="exportFilters" size="small" plain />
<el-button v-if="props.status === 'pending'" type="primary" size="small" @click="openCreate">
新建订单(发货单)
</el-button>
<el-button v-if="isHistory" size="small" @click="handleArchiveExpired">
归档超期订单(&gt;{{ filters.archive_months }} 个月)
</el-button>
</div>
</div>
<!-- 筛选:默认一行简单条件 -->
<el-form :inline="true" size="small" class="filter-bar" @submit.prevent>
<el-form-item label="订单号">
<el-input v-model="query.order_no" placeholder="支持模糊匹配" clearable style="width: 160px" @keyup.enter="search" />
</el-form-item>
<el-form-item label="创建时间">
<el-date-picker
v-model="query.createdRange"
type="daterange"
value-format="YYYY-MM-DD"
range-separator="至"
start-placeholder="开始日期"
end-placeholder="结束日期"
style="width: 230px"
/>
</el-form-item>
<el-form-item>
<el-button type="primary" @click="search">查询</el-button>
<el-button @click="reset">重置</el-button>
<el-link type="primary" :underline="false" class="expand-link" @click="expanded = !expanded">
{{ expanded ? '收起' : '展开' }}
</el-link>
</el-form-item>
</el-form>
<!-- 展开后的完整条件 -->
<el-form v-if="expanded" :inline="true" size="small" class="filter-bar filter-extra" @submit.prevent>
<el-form-item label="来源订单号">
<el-input v-model="query.parent_order_no" placeholder="上游 / 平台订单号" clearable style="width: 160px" @keyup.enter="search" />
</el-form-item>
<el-form-item label="店铺">
<el-select v-model="query.shop_id" placeholder="全部" clearable style="width: 160px">
<el-option v-for="shop in filters.shops" :key="shop.id" :label="shop.name" :value="shop.id" />
</el-select>
</el-form-item>
<el-form-item label="收货人">
<el-input v-model="query.receiver" placeholder="收货人" clearable style="width: 130px" @keyup.enter="search" />
</el-form-item>
<el-form-item label="收货地址">
<el-input v-model="query.address" placeholder="地址关键词" clearable style="width: 180px" @keyup.enter="search" />
</el-form-item>
<el-form-item label="备注/异常原因">
<el-input v-model="query.remark" placeholder="备注或异常原因" clearable style="width: 160px" @keyup.enter="search" />
</el-form-item>
<el-form-item v-if="isHistory" label="归档时间">
<el-date-picker
v-model="query.archivedRange"
type="daterange"
value-format="YYYY-MM-DD"
range-separator="至"
start-placeholder="开始日期"
end-placeholder="结束日期"
style="width: 230px"
/>
</el-form-item>
<el-form-item>
<el-button type="primary" @click="search">查询</el-button>
</el-form-item>
</el-form>
<!-- 列表:高度铺满,表头与操作列固定,只有表体滚动 -->
<div class="table-wrap">
<DataTable
:loading="loading"
:data="list"
row-key="id"
height="100%"
@selection-change="onSelectionChange"
>
<el-table-column type="selection" width="42" :reserve-selection="false" />
<el-table-column prop="order_no" label="订单号" width="150" show-overflow-tooltip />
<el-table-column v-if="isException" label="异常原因" min-width="260" show-overflow-tooltip>
<template #default="{ row }">
<el-tag v-if="row.remark" type="danger" effect="plain" size="small" class="fail-tag">
{{ row.remark }}
</el-tag>
<span v-else class="muted">-</span>
</template>
</el-table-column>
<el-table-column prop="parent_order_no" label="来源订单号" width="140" show-overflow-tooltip />
<el-table-column label="店铺" width="120" show-overflow-tooltip>
<template #default="{ row }">{{ row.shop_name || '-' }}</template>
</el-table-column>
<el-table-column label="商品明细" min-width="180" show-overflow-tooltip>
<template #default="{ row }">{{ row.product_summary || '-' }}</template>
</el-table-column>
<el-table-column label="仓库" width="130" show-overflow-tooltip>
<template #default="{ row }">{{ row.warehouse_name || row.warehouse_code || '-' }}</template>
</el-table-column>
<el-table-column label="收货人" width="140" show-overflow-tooltip>
<template #default="{ row }">{{ receiverText(row) }}</template>
</el-table-column>
<el-table-column prop="address" label="收货地址" min-width="180" show-overflow-tooltip />
<el-table-column v-if="!isException" label="状态" width="90">
<template #default="{ row }">
<el-tag size="small" :type="stageMeta.tag">{{ row.status_label || stageMeta.label }}</el-tag>
</template>
</el-table-column>
<el-table-column label="物流公司" width="130" show-overflow-tooltip>
<template #default="{ row }">{{ row.logistics_name || row.logistics_code || '-' }}</template>
</el-table-column>
<el-table-column label="运单号" width="170" show-overflow-tooltip>
<template #default="{ row }">
<template v-if="expressCodesOf(row).length">
<div v-for="code in expressCodesOf(row)" :key="code">{{ code }}</div>
</template>
<template v-else>-</template>
</template>
</el-table-column>
<el-table-column label="库存/仓库单" width="140" show-overflow-tooltip>
<template #default="{ row }">
<el-tag v-if="Number(row.stock_locked) === 1" size="small" type="warning" effect="plain">已锁库存</el-tag>
<span v-else-if="row.wms_order_no">WMS {{ row.wms_order_no }}</span>
<span v-else>-</span>
</template>
</el-table-column>
<el-table-column v-if="!isException" prop="remark" label="备注 / 异常原因" min-width="140" show-overflow-tooltip />
<el-table-column label="创建时间" width="150">
<template #default="{ row }">{{ formatDateTime(row.created_at) }}</template>
</el-table-column>
<el-table-column v-if="isHistory" label="归档时间" width="150">
<template #default="{ row }">{{ formatDateTime(row.archived_at) }}</template>
</el-table-column>
<el-table-column v-if="isHistory" label="转入时间" width="150">
<template #default="{ row }">{{ formatDateTime(row.transferred_at) }}</template>
</el-table-column>
<el-table-column label="操作" :width="rowActions.length > 3 ? 220 : 150" fixed="right">
<template #default="{ row }">
<el-button link type="primary" size="small" @click="openDetail(row)">查看</el-button>
<el-button
v-for="action in rowActions"
:key="action"
link
size="small"
:type="action === 'remove' || action === 'void' ? 'danger' : 'primary'"
@click="handleRowAction(row, action)"
>
{{ ROW_ACTION_LABEL[action] }}
</el-button>
</template>
</el-table-column>
</DataTable>
</div>
<ListPager
:total="total"
:elapsed="elapsed"
:page="query.page"
:page-size="query.pageSize"
@page-change="handlePageChange"
@size-change="handleSizeChange"
/>
<!-- 详情(单据头 + 明细,实时取自详情接口) -->
<el-drawer v-model="detailVisible" :title="`订单 ${detailRow?.order_no || ''}`" size="720px">
<template v-if="detailRow">
<el-descriptions v-loading="detailLoading" :column="2" border size="small">
<el-descriptions-item label="订单号">{{ detailRow.order_no }}</el-descriptions-item>
<el-descriptions-item label="来源订单号">{{ detailRow.parent_order_no || '-' }}</el-descriptions-item>
<el-descriptions-item v-if="platformOrderNoOf(detailRow)" label="平台订单号">
{{ platformOrderNoOf(detailRow) }}
</el-descriptions-item>
<el-descriptions-item v-if="detailRow.is_external" label="来源平台">
{{ platformNameOf(detailRow.source_platform_code) }}
</el-descriptions-item>
<el-descriptions-item label="状态">
<el-tag size="small" :type="ORDER_STAGE_META[detailRow.status]?.tag">
{{ detailRow.status_label || ORDER_STAGE_META[detailRow.status]?.label }}
</el-tag>
</el-descriptions-item>
<el-descriptions-item label="所在表">{{ detailRow.current_table || detailRow.status }}</el-descriptions-item>
<el-descriptions-item label="仓库">
{{ detailRow.warehouse_name || detailRow.warehouse_code || '-' }}
</el-descriptions-item>
<el-descriptions-item label="店铺">{{ detailRow.shop_name || detailRow.shop_nick || '-' }}</el-descriptions-item>
<el-descriptions-item label="订单类型">{{ detailRow.order_type || '-' }}</el-descriptions-item>
<el-descriptions-item label="订单ID(索引表)">{{ detailRow.id }}</el-descriptions-item>
<el-descriptions-item label="收件人">{{ detailRow.receiver || '-' }}</el-descriptions-item>
<el-descriptions-item label="电话 / 手机">
{{ detailRow.mobile || detailRow.tel || '-' }}
</el-descriptions-item>
<el-descriptions-item label="收货地址" :span="2">
{{ [ detailRow.province, detailRow.city, detailRow.area, detailRow.town, detailRow.detail_address ].filter(Boolean).join('') || detailRow.address || '-' }}
</el-descriptions-item>
<el-descriptions-item label="商品总数量">{{ fmtNum(detailRow.item_total) }}</el-descriptions-item>
<el-descriptions-item label="商品种类">{{ detailRow.item_kind ?? 0 }} 种</el-descriptions-item>
<el-descriptions-item label="订单总金额">{{ fmtNum(detailRow.total_amount) }}</el-descriptions-item>
<el-descriptions-item label="商品金额">{{ fmtNum(detailRow.item_amount) }}</el-descriptions-item>
<el-descriptions-item label="快递费">{{ fmtNum(detailRow.freight) }}</el-descriptions-item>
<el-descriptions-item label="已收金额">{{ fmtNum(detailRow.got_amount) }}</el-descriptions-item>
<el-descriptions-item label="物流公司">
{{ detailRow.logistics_name || detailRow.logistics_code || '-' }}
</el-descriptions-item>
<el-descriptions-item label="运单号">
<template v-if="expressCodesOf(detailRow).length">
<div v-for="code in expressCodesOf(detailRow)" :key="code">{{ code }}</div>
</template>
<template v-else>-</template>
</el-descriptions-item>
<el-descriptions-item label="库存锁定">
<el-tag size="small" :type="Number(detailRow.stock_locked) === 1 ? 'warning' : 'info'" effect="plain">
{{ Number(detailRow.stock_locked) === 1 ? '已锁定' : '未锁定' }}
</el-tag>
</el-descriptions-item>
<el-descriptions-item label="仓库单号">{{ detailRow.wms_order_no || '-' }}</el-descriptions-item>
<el-descriptions-item label="审核人 / 时间">
{{ detailRow.operator_name || detailRow.audit_by || '-' }} / {{ formatDateTime(detailRow.audit_time) }}
</el-descriptions-item>
<el-descriptions-item label="推送时间">{{ formatDateTime(detailRow.pushed_at) }}</el-descriptions-item>
<template v-if="detailRow.void_at">
<el-descriptions-item label="作废时间">{{ formatDateTime(detailRow.void_at) }}</el-descriptions-item>
<el-descriptions-item label="作废原因">{{ detailRow.void_reason || '-' }}</el-descriptions-item>
</template>
<el-descriptions-item label="卖家留言" :span="2">{{ detailRow.seller_message || '-' }}</el-descriptions-item>
<el-descriptions-item label="备注 / 异常原因" :span="2">{{ detailRow.remark || '-' }}</el-descriptions-item>
<el-descriptions-item label="创建时间">{{ formatDateTime(detailRow.created_at) }}</el-descriptions-item>
<el-descriptions-item label="更新时间">{{ formatDateTime(detailRow.updated_at) }}</el-descriptions-item>
<template v-if="isHistory">
<el-descriptions-item label="归档时间">{{ formatDateTime(detailRow.archived_at) }}</el-descriptions-item>
<el-descriptions-item label="转入时间">{{ formatDateTime(detailRow.transferred_at) }}</el-descriptions-item>
</template>
</el-descriptions>
<el-divider content-position="left">商品明细({{ detailProducts.length }} 行)</el-divider>
<DataTable :data="detailProducts" :stripe="true">
<el-table-column prop="order_line_no" label="行号" width="70" />
<el-table-column prop="item_code" label="商品编码" width="150" show-overflow-tooltip />
<el-table-column prop="item_name" label="商品名称" min-width="150" show-overflow-tooltip />
<el-table-column label="数量" width="80" align="right">
<template #default="{ row }">{{ fmtNum(row.plan_qty) }}</template>
</el-table-column>
<el-table-column label="单价" width="80" align="right">
<template #default="{ row }">{{ fmtNum(row.actual_price) }}</template>
</el-table-column>
<el-table-column label="金额" width="90" align="right">
<template #default="{ row }">{{ lineAmount(row) }}</template>
</el-table-column>
<el-table-column label="库存类型" width="90">
<template #default="{ row }">{{ row.inventory_type === 'CC' ? '残次' : '正品' }}</template>
</el-table-column>
</DataTable>
</template>
</el-drawer>
<!-- 新建 / 编辑(发货单口径:仓库 / 店铺 / 收件人 12 项 / 金额 / 留言 / 明细) -->
<OrderFormDialog
v-model="formVisible"
:order-id="formOrderId"
:filters="filters"
@saved="handleFormSaved"
/>
<!-- 切换仓库:列表选择(店铺在创建订单时确定,不再提供设置店铺) -->
<RecordPickerDialog
:model-value="picker.visible"
:title="picker.title"
:options="pickerOptions"
:columns="pickerColumns"
:search-props="['name', 'code']"
confirm-text="切换仓库"
empty-text="当前主体下没有仓库"
@update:model-value="onPickerClose"
@confirm="onPickerConfirm"
/>
</div>
</template>
<style scoped>
.panel {
display: flex;
flex-direction: column;
height: 100%;
min-height: 0;
}
.toolbar {
flex: 0 0 auto;
display: flex;
align-items: center;
justify-content: space-between;
gap: 8px;
margin-bottom: 8px;
}
.toolbar-left {
display: flex;
align-items: center;
gap: 8px;
flex-wrap: wrap;
}
.unbound-switch {
margin-right: 4px;
}
.toolbar-right {
display: flex;
align-items: center;
gap: 8px;
}
.toolbar-hint {
font-size: 12px;
color: var(--el-text-color-secondary);
}
.filter-bar {
flex: 0 0 auto;
margin-bottom: 0;
}
.filter-extra {
padding-top: 2px;
}
.expand-link {
margin-left: 8px;
font-size: 12px;
}
.table-wrap {
flex: 1;
min-height: 0;
overflow: hidden;
}
/* 异常原因:标红 tag,超长省略(悬浮 tooltip 看全文) */
.fail-tag {
max-width: 100%;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
vertical-align: middle;
}
.muted {
color: var(--el-text-color-secondary);
}
.add-line {
margin-top: 8px;
}
.compact-form :deep(.el-form-item) {
margin-bottom: 6px;
}
.compact-form :deep(.el-divider) {
margin: 6px 0 8px;
}
</style>