This commit is contained in:
yin 2026-05-04 18:21:28 +08:00
parent b30cb15793
commit 487a7a64f7
90 changed files with 3273 additions and 1013 deletions

View File

@ -33,6 +33,27 @@ export type QueryOrderLogsParams = {
pageSize?: number
}
/** order.queryOrderLogList 请求(id / order_id / orderId 择一即可) */
export type QueryOrderLogListParams = {
id?: string | number
order_id?: string | number
orderId?: string | number
}
/** order.queryOrderLogList 单条日志 */
export type OrderLogListItem = {
id: number
operation_code: string
operation_name?: string | null
operator_name?: string | null
created_at: string
external_log_type?: string | null
external_log_id?: number | string | null
platform_code?: string | null
platform_name?: string | null
message?: string | null
}
export function orderList(data: OrderListParams = {}): Promise<any> {
return request({
url: '/system',
@ -89,6 +110,21 @@ export function orderQueryOrderLogs(data: QueryOrderLogsParams): Promise<any> {
} as any)
}
/** 订单操作日志(order.queryOrderLogList),响应多为顶层 list / total / code / flag */
export function orderQueryOrderLogList(data: QueryOrderLogListParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.queryOrderLogList',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 订单明细行(历史接口 order.detail,未纳入远端 module 清单) */
export function orderDetail(data: Record<string, any> = {}): Promise<any> {
return request({
@ -109,5 +145,6 @@ export const order = {
manualOutboundOrder: orderManualOutboundOrder,
badgeCount: orderBadgeCount,
queryOrderLogs: orderQueryOrderLogs,
queryOrderLogList: orderQueryOrderLogList,
detail: orderDetail
}

View File

@ -110,23 +110,26 @@ export type PendingOrderAllocateStorageParams = {
id?: number | string;
};
/** allocateStorage 异步受理响应(与文档一致) */
export type PendingOrderAllocateStorageResponse = {
request_id: string;
warehouse_id: number;
message: string;
};
export type PendingOrderAllocateStorageProgressParams = {
request_id?: string;
requestId?: string;
};
export type PendingOrderAllocateStorageProgressResponse = {
request_id?: string;
status?: string;
progress_percent?: number;
total_count?: number;
success_count?: number;
failed_count?: number;
updated_count?: number;
request_id: string;
status: "submitted" | "running" | "success" | "failed" | "not_found";
result?: Record<string, unknown>;
error?: string;
message?: string;
warehouse_id?: number;
update_time?: string;
result?: Record<string, any>;
message?: string;
};
export type PendingOrderSyncOrderIdsParams = {
@ -230,7 +233,7 @@ export function orderPendingOrderAllocateExpressCode(
export function orderPendingOrderAllocateStorage(
data: PendingOrderAllocateStorageParams,
): Promise<any> {
): Promise<PendingOrderAllocateStorageResponse & { code?: number; message?: string; flag?: string; data?: unknown }> {
return request({
url: "/system",
method: "post",
@ -262,7 +265,7 @@ export function orderPendingOrderCancelAllocateStorage(
export function orderPendingOrderAllocateStorageProgress(
data: PendingOrderAllocateStorageProgressParams,
): Promise<PendingOrderAllocateStorageProgressResponse & { code?: number; message?: string; flag?: string; data?: any }> {
): Promise<PendingOrderAllocateStorageProgressResponse & { code?: number; message?: string; flag?: string; data?: unknown }> {
return request({
url: "/system",
method: "post",

28
src/api/pick/pick.ts Normal file
View File

@ -0,0 +1,28 @@
import request from '@/utils/request'
const v = '1.0'
/** pick.query 请求参数(与 module pick 一致) */
export type PickQueryParams = {
waybill_code: string
full_display?: boolean
}
/** 按运单号查询波次拣货信息(pick.query) */
export function pickQuery(data: PickQueryParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'pick.query',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export const pick = {
query: pickQuery
}

View File

@ -0,0 +1,57 @@
import request from '@/utils/request'
const v = '1.0'
export type SettingWarehouseSaveSettingsParams = {
subject_config: Record<string, unknown>
cache_warehouse_id?: number
cacheWarehouseId?: number
}
export function settingWarehouseGetSettings(data: Record<string, unknown> = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'setting.warehouse.getSettings',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function settingWarehouseGetFieldMeta(): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'setting.warehouse.getFieldMeta',
v,
timestamp: new Date().getTime()
},
data: {},
isSystemApi: true
} as any)
}
export function settingWarehouseSaveSettings(data: SettingWarehouseSaveSettingsParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'setting.warehouse.saveSettings',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export const settingWarehouse = {
getSettings: settingWarehouseGetSettings,
getFieldMeta: settingWarehouseGetFieldMeta,
saveSettings: settingWarehouseSaveSettings
}

View File

@ -1,6 +1,14 @@
import request from '@/utils/request'
const v = "1.0"
export type QueryReceivingLogsParams = {
id?: number | string
receiving_id?: number | string
page?: number
pageSize?: number
pagination?: { page?: number; pageSize?: number }
}
export function getReceivingList(data: any): Promise<any> {
return request({
url: '/system',
@ -28,7 +36,7 @@ export function getReceivingDetail(data: any): Promise<any> {
})
}
export function queryReceivingLogs(data: any): Promise<any> {
export function queryReceivingLogs(data: QueryReceivingLogsParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',

View File

@ -1,6 +1,24 @@
import request from '@/utils/request'
const v = "1.0";
export function createStore(data:any) {
const v = "1.0"
/** 与文档 subject_config 子字段对齐(可整体传 subject_config 对象) */
export type StoreSubjectConfigInput = {
max_notice_webhook_count?: number
default_express_code?: string
default_platform_code?: string
group_wave_prefix?: string
min_group_order_fetch_quantity?: number
}
export type StoreCreateStoreParams = {
subject_config?: StoreSubjectConfigInput
}
export type StoreCreateWarehouseParams = {
subject_config?: StoreSubjectConfigInput
}
export function createStore(data: StoreCreateStoreParams & Record<string, unknown> = {}) {
return request({
url: '/system',
method: 'post',
@ -14,7 +32,7 @@ export function createStore(data:any) {
} as any)
}
export function createWarehouse(data:any) {
export function createWarehouse(data: StoreCreateWarehouseParams & Record<string, unknown> = {}) {
return request({
url: '/system',
method: 'post',

View File

@ -16,20 +16,6 @@ export function getWarehouseZones(data:any) {
} as any)
}
export function getSettings(data:any = {}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'setting.warehouse.getSettings',
v: '1.0',
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function getWarehouseTree(warehouseId:any) {
return request({
url: '/system',

View File

@ -709,6 +709,23 @@ function handleCustomChange() {
}
}
/** select 选项可带 operator、conditionValue(用于波次分配等同一字段不同操作符) */
function buildMappedSelectCondition(field: any, condition: any): { value: any; operator: string; type: string } | null {
if (field.type !== 'select' || !Array.isArray(field.options)) return null
const raw = condition.value
if (raw === undefined || raw === null || raw === '') return null
const selected = field.options.find((o: any) => o.value === raw)
if (!selected || typeof selected.operator !== 'string' || !selected.operator) return null
const apiValue = Object.prototype.hasOwnProperty.call(selected, 'conditionValue')
? selected.conditionValue
: selected.value
return {
value: apiValue,
operator: selected.operator,
type: field.conditionType || 'text'
}
}
function buildAndEmitCustomCondition() {
const conditions: any = {}
let hasCondition = false
@ -745,6 +762,17 @@ function buildAndEmitCustomCondition() {
return
}
const mappedSelectEmit = buildMappedSelectCondition(field, condition)
if (mappedSelectEmit) {
conditions[field.value] = {
...mappedSelectEmit,
field: field.value,
isMultiple: false
}
hasCondition = true
return
}
let conditionValue = condition.value
// 处理多值操作符:contains / in / notin 逗号分隔 -> 数组
@ -906,6 +934,12 @@ function buildConditionsObject() {
return
}
const mappedSelectObj = buildMappedSelectCondition(field, condition)
if (mappedSelectObj) {
conditions[field.value] = mappedSelectObj
return
}
let conditionValue = condition.value
if (['contains', 'in', 'notin'].includes(op) && typeof conditionValue === 'string' && conditionValue) {

View File

@ -3,12 +3,12 @@ export const componentMap: Record<string, any> = {
'login/index': () => import('@/views/login/index.vue'),
'system/setting/permission/index': () => import('@/views/system/setting/permission/index.vue'),
'system/setting/index': () => import('@/views/system/setting/index.vue'),
'system/setting/index': () => import('@/views/system/setting/index.vue'),
// 'system/setting/index': () => import('@/views/system/setting/index.vue'),
'order/index': () => import('@/views/order/orderManagement/index.vue'),
/** 与后端菜单 component 字段兼容:部分环境为 order/setting */
'order/setting': () => import('@/views/order/orderManagement/index.vue'),
/** 与后端菜单 component 字段兼容:部分环境为 order/setting */
'order/setting': () => import('@/views/order/orderManagement/index.vue'),
// 'order/setting': () => import('@/views/order/orderManagement/index.vue'),
'auth/approve': () => import('@/views/auth/approve.vue'),
'account/index': () => import('@/views/system/setting/account/index.vue'),
// 'permission/index': () => import('@/views/system/setting/permission/index.vue'),
@ -21,11 +21,13 @@ export const componentMap: Record<string, any> = {
'storage/inventory': () => import('@/views/storage/inventory/index.vue'),
'storage/stockout': () => import('@/views/storage/stockout/index.vue'),
'store/index': () => import('@/views/store/index.vue'),
'wave/index': () => import('@/views/wave/index.vue'),
'role/index': () => import('@/views/system/setting/role/index.vue'),
'system/setting/role/index': () => import('@/views/system/setting/role/index.vue'),
'wave/index': () => import('@/views/order/waveOrder/index.vue'),
/** 与后端菜单 component 字段兼容 */
'order/waveOrder': () => import('@/views/order/waveOrder/index.vue'),
'role/index': () => import('@/views/system/setting/role/index.vue'),
'system/setting/role/index': () => import('@/views/system/setting/role/index.vue'),
// 'role/index': () => import('@/views/system/setting/role/index.vue'),
// 'system/setting/role/index': () => import('@/views/system/setting/role/index.vue'),
'system/setting/printTemplate/index': () => import('@/views/system/setting/printTemplate/index.vue'),
// 'system/setting/printStation/index': () => import('@/views/system/setting/printStation/index.vue'),
'system/print/station': () => import('@/views/system/setting/printStation/index.vue'),

View File

@ -8,30 +8,55 @@
title="刷新"
:loading="loading"
class="toolbar-btn"
:disabled="!orderId || !hasLogRequest"
@click="fetchLogs"
:disabled="!orderId"
@click="handleRefresh"
>
刷新
</el-button>
</el-button-group>
<el-table
:data="tableData"
:data="displayRows"
border
stripe
style="width: 100%; height: 100%"
height="100%"
v-loading="loading"
>
<el-table-column prop="created_at" label="时间" width="250" />
<el-table-column prop="operator_name" label="操作人" width="120" />
<el-table-column prop="operation_name" label="操作名称" />
<el-table-column prop="platform_name" label="操作平台" />
<el-table-column prop="created_at" label="时间" width="175" />
<el-table-column label="操作人" width="110">
<template #default="{ row }">
{{ row.operator_name ?? '—' }}
</template>
</el-table-column>
<el-table-column label="操作类型" min-width="160" show-overflow-tooltip>
<template #default="{ row }">
{{ formatOperationLabel(row) }}
</template>
</el-table-column>
<el-table-column label="平台" width="100" show-overflow-tooltip>
<template #default="{ row }">
{{ row.platform_name || row.platform_code || '—' }}
</template>
</el-table-column>
<el-table-column label="外部日志" width="108" align="center">
<template #default="{ row }">
<el-tag v-if="row.external_log_type && row.external_log_type !== 'NONE'" size="small" type="info">
{{ row.external_log_type }}
</el-tag>
<span v-else class="cell-muted">—</span>
</template>
</el-table-column>
<el-table-column label="说明" min-width="220" show-overflow-tooltip>
<template #default="{ row }">
{{ row.message ?? '—' }}
</template>
</el-table-column>
<el-table-column label="操作" width="120">
<el-table-column label="操作" width="108" align="center" fixed="right">
<template #default="scope">
<el-button
v-if="scope.row.external_log_id"
v-if="hasExternalPayload(scope.row)"
type="primary"
link
size="small"
@ -39,6 +64,7 @@
>
查看报文
</el-button>
<span v-else class="cell-muted">—</span>
</template>
</el-table-column>
</el-table>
@ -64,11 +90,7 @@
size="800px"
class="el-drawers"
>
<RequestData
v-if="showRequestData"
:id="requestId"
:type="requestType"
/>
<RequestData v-if="showRequestData" :id="requestId" :type="requestType" />
</el-drawer>
</div>
</template>
@ -78,16 +100,24 @@ import { computed, reactive, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import { Refresh } from '@element-plus/icons-vue'
import RequestData from '@/components/RequestData/index.vue'
import { orderQueryOrderLogList } from '@/api/order.index/orderindex'
const props = defineProps<{
/** 当前选中订单行(与其它订单页一致) */
/** 当前选中订单行(与其它订单页一致,使用 id 作为 order_id) */
data?: Record<string, any> | null
/** 日志查询接口;未提供时视为当前页面暂无日志接口 */
/**
* 自定义日志查询(兼容旧 order.queryOrderLogs 分页形态)。
* 不传时默认调用 order.queryOrderLogList,并在前端对 list 分页展示。
*/
request?: ((params: { id: string; page?: number; pageSize?: number }) => Promise<any>) | null
}>()
const loading = ref(false)
const tableData = ref<any[]>([])
/** 默认接口:全量列表,前端分页 */
const allRows = ref<any[]>([])
/** 自定义 request:服务端当前页 */
const serverRows = ref<any[]>([])
const showRequestData = ref(false)
const requestId = ref(0)
const requestType = ref('')
@ -98,22 +128,61 @@ const pagination = reactive({
total: 0
})
const useServerPagination = computed(() => typeof props.request === 'function')
const orderId = computed(() => {
const id = props.data?.id
if (id === undefined || id === null || id === '') return ''
return String(id)
})
const hasLogRequest = computed(() => typeof props.request === 'function')
const displayRows = computed(() => {
if (useServerPagination.value) return serverRows.value
const start = (pagination.page - 1) * pagination.pageSize
return allRows.value.slice(start, start + pagination.pageSize)
})
function extractLogListPayload(res: any): { list: any[]; total: number } {
if (!res) return { list: [], total: 0 }
const inner = res.data && typeof res.data === 'object' && !Array.isArray(res.data) ? res.data : res
const list = Array.isArray(inner.list)
? inner.list
: Array.isArray(res.list)
? res.list
: []
const totalRaw = inner.pagination?.total ?? inner.total ?? res.total
const total =
typeof totalRaw === 'number' && !Number.isNaN(totalRaw)
? totalRaw
: list.length
return { list, total }
}
function formatOperationLabel(row: any): string {
const name = row?.operation_name
const code = row?.operation_code
if (name && String(name).trim() && name !== code) return String(name)
if (name && String(name).trim()) return String(name)
if (code) return String(code)
return '—'
}
function hasExternalPayload(row: any): boolean {
const id = row?.external_log_id
if (id === undefined || id === null || id === '') return false
const n = typeof id === 'number' ? id : Number(id)
return Number.isFinite(n) && n > 0
}
watch(
() => [orderId.value, hasLogRequest.value],
([newOrderId, canQuery]) => {
if (newOrderId && canQuery) {
() => orderId.value,
(newOrderId) => {
if (newOrderId) {
pagination.page = 1
fetchLogs()
loadLogsFromServer()
} else {
tableData.value = []
allRows.value = []
serverRows.value = []
pagination.total = 0
}
},
@ -122,34 +191,50 @@ watch(
async function handlePageChange(page: number) {
pagination.page = page
await fetchLogs()
if (useServerPagination.value) await loadLogsFromServer()
}
async function handlePageSizeChange(pageSize: number) {
pagination.pageSize = pageSize
pagination.page = 1
await fetchLogs()
if (useServerPagination.value) await loadLogsFromServer()
}
async function fetchLogs() {
if (!orderId.value || !hasLogRequest.value || !props.request) return
async function handleRefresh() {
pagination.page = 1
await loadLogsFromServer()
}
async function loadLogsFromServer() {
if (!orderId.value) return
loading.value = true
try {
const response: any = await props.request({
id: orderId.value,
page: pagination.page,
pageSize: pagination.pageSize
})
if (!response || ![1, 200].includes(response.code)) {
throw new Error(response?.message || '请求失败')
if (useServerPagination.value && props.request) {
const response: any = await props.request({
id: orderId.value,
page: pagination.page,
pageSize: pagination.pageSize
})
if (!response || ![1, 200].includes(response.code)) {
throw new Error(response?.message || '请求失败')
}
const { list, total } = extractLogListPayload(response)
serverRows.value = list
pagination.total = total
} else {
// 成功态已在 request 拦截器中校验(code ∈ SUCCESS_CODES)
const response: any = await orderQueryOrderLogList({ id: orderId.value })
const { list, total } = extractLogListPayload(response)
allRows.value = list
pagination.total = total
}
const d = response.data || {}
tableData.value = d.list || []
pagination.total = d.pagination?.total ?? d.total ?? 0
} catch (error: any) {
console.error('order logs query failed:', error)
ElMessage.error(error?.message || '获取订单操作日志失败')
allRows.value = []
serverRows.value = []
pagination.total = 0
} finally {
loading.value = false
}
@ -178,6 +263,11 @@ function viewData(row: any) {
margin-bottom: 5px;
}
.cell-muted {
color: var(--el-text-color-placeholder);
font-size: 12px;
}
.el-table {
flex: 1;
}

View File

@ -398,10 +398,23 @@ export const simpleListToolbarButtons = pickToolbarButtons(simpleListToolbarButt
/** ScanBox:波次分配 → where.wave_id 为 { operator: 'eq'|'ne', value: 0 } */
export const waveAssignmentScanField = {
label: '波次分配',
value: 'wave_id',
type: 'select',
conditionType: 'number',
options: [
{ label: '未分配波次', value: '__wave_assign_eq_0__', operator: 'eq', conditionValue: 0 },
{ label: '已分配波次', value: '__wave_assign_ne_0__', operator: 'ne', conditionValue: 0 }
]
}
// deliveryOrder相关配置
export const deliveryAvailableFields = [
{ label: '货主', value: 'store_id', type: 'select', multiple: true, options: [] },
{ label: '订单号', value: 'delivery_order_code', type: 'text' },
waveAssignmentScanField,
{ label: '波次号', value: 'wave_no', type: 'text' },
{ label: '店铺名称', value: 'shop_nick', type: 'text' },
{ label: '来源平台', value: 'sys_platform_name', type: 'select', options: [] },
@ -501,6 +514,7 @@ export const deliveryOrderToolbarButtons = simpleListToolbarButtons
// revieworder相关配置
export const reviewAvailableFields = [
{ label: '发货单号', value: 'delivery_order_code', type: 'text' },
waveAssignmentScanField,
{ label: '波次号', value: 'wave_no', type: 'text' },
{ label: '店铺名称', value: 'shop_nick', type: 'text' },
{ label: '平台编码', value: 'sys_platform_code', type: 'select', options: [] },
@ -634,17 +648,45 @@ export const outboundToolbarButtons = pickToolbarButtons(outboundToolbarButtonKe
export const pendingAvailableFields = [
{ label: '货主', value: 'store_id', type: 'select', multiple: true, options: [] },
{ label: '订单号', value: 'order_code', type: 'text' },
waveAssignmentScanField,
{ label: '波次号', value: 'wave_no', type: 'text' },
{ label: '店铺名称', value: 'shop_nick', type: 'text' },
{ label: '来源平台', value: 'sys_platform_name', type: 'select', options: [] },
{ label: '物流公司', value: 'logistics_name', type: 'select', options: [] },
{ label: '快递单号', value: 'waybill_codes', type: 'text' },
{ label: '订单状态', value: 'status', type: 'select', options: [
{ label: '待审核', value: 'pedding' },
{ label: '已创建', value: 'created' },
{ label: '已取消', value: 'cancel' },
{ label: '错误', value: 'error' },
{ label: '售后异常', value: 'after-sales-error' },
{ label: '已完成', value: 'finished' },
{ label: '已作废', value: 'cancelled' },
{ label: '已归档', value: 'archived' },
] },
{ label: '储位', value: 'storage_status', type: 'select', options: [
{ label: '未分配', value: 'none' },
{ label: '分配中', value: 'padding' },
{ label: '已完成', value: 'fin' },
{ label: '错误', value: 'error' },
] },
{ label: '拣货状态', value: 'pick_status', type: 'select', options: [
{ label: '未拣货', value: 'none' },
{ label: '拣货中', value: 'padding' },
{ label: '已完成', value: 'fin' },
] },
{ label: '打包状态', value: 'pack_status', type: 'select', options: [
{ label: '未打包', value: 'none' },
{ label: '打包中', value: 'padding' },
{ label: '已完成', value: 'fin' },
] },
{ label: '收货人', value: 'name', type: 'text' },
{ label: '手机号', value: 'mobile', type: 'text' },
{ label: '省份', value: 'province', type: 'text' },
{ label: '城市', value: 'city', type: 'text' },
{ label: '区县', value: 'area', type: 'text' },
{ label: '是否紧急', value: 'is_urgency', type: 'select', options: [ { label: '是', value: 'Y' }, { label: '否', value: 'N' } ] },
{ label: '同步状态', value: 'sync_status', type: 'select', options: [ { label: '待同步', value: 'padding' }, { label: '已同步', value: 'fin' }, { label: '错误', value: 'error' } ] },
{ label: '下单时间', value: 'place_order_time', type: 'daterange' },
{ label: '创建时间', value: 'create_at', type: 'daterange' },
@ -818,6 +860,7 @@ export const workbenchStatusOptions = [
export const workbenchAvailableFields = [
{ label: '订单号', value: 'delivery_order_code', type: 'text' },
waveAssignmentScanField,
{ label: '波次号', value: 'wave_no', type: 'text' },
{ label: '买家昵称', value: 'buyer_nick', type: 'text' },
{ label: '订单状态', value: 'status', type: 'select', options: workbenchStatusOptions },
@ -868,6 +911,7 @@ export const expectionOrderAvailableFields = [
{ label: '货主', value: 'store_id', type: 'select', multiple: true, options: [] },
{ label: '订单号', value: 'order_code', type: 'text' },
{ label: '发货单号', value: 'delivery_order_code', type: 'text' },
waveAssignmentScanField,
{ label: '波次号', value: 'wave_no', type: 'text' },
{ label: '物流公司', value: 'logistics_name', type: 'select', options: [] },
{ label: '快递单号', value: 'express_code', type: 'text' },
@ -896,9 +940,6 @@ export const expectionColumns = [
{ prop: 'logistics_name', label: '快递', width: '120' },
{ prop: 'pre_delivery_order_code', label: '前置单号', width: '140' },
{ prop: 'order_flag', label: '订单标记', minWidth: '260' },
{ prop: 'sync_status', label: '同步状态', width: '100' },
{ prop: 'status', label: '订单状态', width: '100' },
{ prop: 'is_urgency', label: '紧急', width: '80' },
{ prop: 'items_total', label: '商品总数', width: '100' },
{ prop: 'total_amount', label: '订单金额', width: '110' },
{ prop: 'pay_time', label: '支付时间', width: '165', formatter: orderTimeFormatter },
@ -962,6 +1003,7 @@ export const archiveAvailableFields = [
{ label: '货主', value: 'store_id', type: 'select', multiple: true, options: [] },
{ label: '订单号', value: 'order_code', type: 'text' },
{ label: '发货单号', value: 'delivery_order_code', type: 'text' },
waveAssignmentScanField,
{ label: '波次号', value: 'wave_no', type: 'text' },
{ label: '店铺名称', value: 'shop_nick', type: 'text' },
{ label: '收货人', value: 'name', type: 'text' },

View File

@ -111,6 +111,30 @@
</el-tag>
</template>
<template #column-storage_status="{ row }">
<el-tag :type="getTagType('storage_status', row.storage_status)" size="small">
{{ translateOrderField('storage_status', row.storage_status) }}
</el-tag>
</template>
<template #column-post_status="{ row }">
<el-tag :type="getTagType('post_status', row.post_status)" size="small">
{{ translateOrderField('post_status', row.post_status) }}
</el-tag>
</template>
<template #column-pick_status="{ row }">
<el-tag :type="getTagType('pick_status', row.pick_status)" size="small">
{{ translateOrderField('pick_status', row.pick_status) }}
</el-tag>
</template>
<template #column-pack_status="{ row }">
<el-tag :type="getTagType('pack_status', row.pack_status)" size="small">
{{ translateOrderField('pack_status', row.pack_status) }}
</el-tag>
</template>
<template #column-order_flag="{ row }">
<el-tooltip
:content="orderFlagFullText(row)"
@ -170,7 +194,7 @@
<el-alert title="系统异常" type="error" :closable="false" description="库存不足或物流接口调用失败。" />
</div>
<div v-else class="detail-page order-log-wrapper">
<log :data="selectedRow" :request="orderQueryOrderLogs" />
<log :data="selectedRow" />
</div>
</KeepAlive>
</div>
@ -268,7 +292,6 @@ import { ArrowDown } from '@element-plus/icons-vue'
import ScanBox from '@/components/ScanBox/index.vue'
import UpperTable from '@/components/UpperTable/index.vue'
import * as indexApi from '@/api/index/index'
import { orderQueryOrderLogs } from '@/api/order.index/orderindex'
import { orderExpectionOrder } from '@/api/order.expectionorder/orderexpectionorder'
import { orderPendingOrder } from '@/api/order.pendingOrder/orderpendingOrder'

View File

@ -1,10 +1,10 @@
<template>
<div class="wave-management-container" :style="{ height: containerHeight }">
<div class="order-sub-container">
<scan-box
ref="scanBox"
width="320px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"
:width="waveScanBoxConfig.width"
:tree-props="waveScanBoxConfig.treeProps"
:auto-submit="waveScanBoxConfig.autoSubmit"
:preset-tree="presetTree"
:available-fields="availableFieldsRef"
@condition-change="handleConditionChange"
@ -13,24 +13,33 @@
/>
<div class="main-content">
<el-tabs v-model="activeTab" class="wave-tabs" @tab-change="handleTabChange">
<el-tab-pane label="团购波次" name="group" />
<el-tab-pane label="散单波次" name="sandan" />
</el-tabs>
<div class="toolbar">
<div class="toolbar-left">
<el-button size="small" type="primary" :loading="loading" @click="loadData">刷新</el-button>
<el-button size="small" @click="openColumnConfigPanel">字段设置</el-button>
<el-button size="small" type="info" :disabled="batchPrintDisabled" @click="handleBatchPrint">批量打印({{ selectedWaveOrderTotal }})</el-button>
<el-button size="small" type="warning" :disabled="!hasSelection" :loading="batchAutoGroupingLoading" @click="handleBatchAutoGrouping">批量改为自动加团</el-button>
<el-button size="small" type="success" :disabled="!hasSelection" :loading="batchFinishAutoGroupingLoading" @click="handleBatchFinishAutoGrouping">批量结束自动加团</el-button>
<el-button size="small" type="danger" :disabled="!hasSelection" :loading="batchCancelLoading" @click="handleBatchCancel">批量取消波次</el-button>
<el-button v-if="isGroupWaveTab" size="small" type="warning" @click="openGroupOrderDialog">抓取团购单</el-button>
<div class="toolbar-left" @wheel="handleToolbarWheel">
<div
class="toolbar-scroll-container"
ref="scrollContainerRef"
@mousedown="handleMouseDown"
@mousemove="handleMouseMove"
@mouseup="handleMouseUp"
@mouseleave="handleMouseUp"
>
<el-button
v-for="button in toolbarButtons"
:key="button.key"
:size="button.size || 'small'"
:type="button.type"
:plain="button.plain"
:disabled="resolveButtonDisabled(button.disabledKey)"
:loading="resolveButtonLoading(button.loadingKey)"
@click="handleToolbarButtonClick(button.action)"
>
{{ resolveButtonLabel(button.label, button.dynamicLabelKey) }}
</el-button>
</div>
</div>
</div>
<div v-if="isGroupWaveTab && fetchTaskProgress.taskId" class="task-progress-panel">
<div v-if="isGroupWaveTab && fetchTaskProgress.taskId" class="task-progress-panel task-progress-panel--toolbar">
<div class="task-progress-panel__header">
<span class="task-progress-panel__title">抓取任务进度</span>
<span class="task-progress-panel__meta">任务ID:{{ fetchTaskProgress.taskId }}</span>
@ -47,19 +56,20 @@
</div>
</div>
<div class="upper-wrapper">
<div class="split-stack" ref="splitStackRef">
<div class="upper-wrapper" :style="detailVisible ? upperPaneStyle : upperPaneFullStyle">
<upper-table
ref="upperTable"
title="波次列表"
:enable-column-config="true"
table-id="wave-management-list"
:title="waveUpperTableDefaults.title"
:enable-column-config="waveUpperTableDefaults.enableColumnConfig"
:table-id="tableListId"
:data="list"
:row-key="getRowIdentity"
:columns="columns"
:table-size="tableSize"
:pagination="pagination"
:show-index="true"
:show-selection="true"
:show-index="waveUpperTableDefaults.showIndex"
:show-selection="waveUpperTableDefaults.showSelection"
:loading="loading"
:queryTime="queryTime"
@current-change="handleRowClick"
@ -158,43 +168,51 @@
</template>
<template #empty>
<div class="empty-tip">暂无波次数据</div>
<div class="empty-tip">{{ waveUpperTableDefaults.emptyText }}</div>
</template>
</upper-table>
</div>
<div v-if="selectedRow" class="lower-level" :class="tableSize">
<div class="detail-header">
<span class="detail-title">波次详情</span>
<template v-if="detailVisible">
<div
class="pane-resizer"
title="拖动调整列表与详情区域高度"
@mousedown="beginSplitDrag"
/>
<div v-if="selectedRow" class="lower-level" :class="tableSize" :style="lowerPaneStyle">
<div class="detail-header">
<span class="detail-title">波次详情</span>
</div>
<div class="detail-container">
<el-descriptions :column="2" border size="small">
<el-descriptions-item label="波次编号">{{ getWaveCode(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="波次类型">{{ getWaveTypeText(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="状态">
<el-tag size="small" :type="getStatusTagType(selectedRow)">{{ getStatusText(selectedRow) }}</el-tag>
</el-descriptions-item>
<el-descriptions-item label="订单数量">{{ getOrderCount(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="已处理订单">{{ getProcessedOrders(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="仓库ID">{{ selectedRow.warehouse_id ?? '—' }}</el-descriptions-item>
<el-descriptions-item label="快递">{{ selectedRow.logistics_name || '—' }}</el-descriptions-item>
<el-descriptions-item label="库位分配状态">{{ getStorageAssignmentStatusText(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="快递分配状态">{{ selectedRow.express_assignment_status || '—' }}</el-descriptions-item>
<el-descriptions-item label="创建人">{{ selectedRow.creator || selectedRow.creator_name || '—' }}</el-descriptions-item>
<el-descriptions-item label="商品结构快照" :span="2">{{ getItemSnapshotText(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="订单信息" :span="2">{{ getOrderInfoSummary(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="创建时间">{{ formatDateTime(selectedRow.create_time || selectedRow.created_at || selectedRow.create_at) }}</el-descriptions-item>
<el-descriptions-item label="更新时间">{{ formatDateTime(selectedRow.update_time || selectedRow.updated_at || selectedRow.update_at) }}</el-descriptions-item>
<el-descriptions-item label="订单列表" :span="2">{{ getOrderListPreview(selectedRow) }}</el-descriptions-item>
</el-descriptions>
</div>
</div>
<div class="detail-container">
<el-descriptions :column="2" border size="small">
<el-descriptions-item label="波次编号">{{ getWaveCode(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="波次类型">{{ getWaveTypeText(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="状态">
<el-tag size="small" :type="getStatusTagType(selectedRow)">{{ getStatusText(selectedRow) }}</el-tag>
</el-descriptions-item>
<el-descriptions-item label="订单数量">{{ getOrderCount(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="已处理订单">{{ getProcessedOrders(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="仓库ID">{{ selectedRow.warehouse_id ?? '—' }}</el-descriptions-item>
<el-descriptions-item label="快递">{{ selectedRow.logistics_name || '—' }}</el-descriptions-item>
<el-descriptions-item label="库位分配状态">{{ getStorageAssignmentStatusText(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="快递分配状态">{{ selectedRow.express_assignment_status || '—' }}</el-descriptions-item>
<el-descriptions-item label="创建人">{{ selectedRow.creator || selectedRow.creator_name || '—' }}</el-descriptions-item>
<el-descriptions-item label="商品结构快照" :span="2">{{ getItemSnapshotText(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="订单信息" :span="2">{{ getOrderInfoSummary(selectedRow) }}</el-descriptions-item>
<el-descriptions-item label="创建时间">{{ formatDateTime(selectedRow.create_time || selectedRow.created_at || selectedRow.create_at) }}</el-descriptions-item>
<el-descriptions-item label="更新时间">{{ formatDateTime(selectedRow.update_time || selectedRow.updated_at || selectedRow.update_at) }}</el-descriptions-item>
<el-descriptions-item label="订单列表" :span="2">{{ getOrderListPreview(selectedRow) }}</el-descriptions-item>
</el-descriptions>
</div>
</div>
<div v-else class="no-selection">
<div class="empty-tip">
<p>请从上方列表中选择一项查看详情</p>
<div v-else class="no-selection" :style="lowerPaneStyle">
<div class="empty-tip">
<p>请从上方列表中选择一项查看详情</p>
</div>
</div>
</template>
</div>
</div>
@ -370,21 +388,31 @@ import { computed, onBeforeUnmount, onMounted, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import ScanBox from '@/components/ScanBox/index.vue'
import UpperTable from '@/components/UpperTable/index.vue'
import type { ToolbarButtonConfig } from '@/views/order/orderManagement/config/order-common-config'
import {
waveScanBoxConfig,
waveUpperTableDefaults,
waveAvailableFields,
waveBatchColumns,
waveWhereAllowedFields,
getWaveToolbarButtons
} from './config/wave-config'
import { safeInvoke } from '@/utils/safe-invoke'
import { useVerticalSplitPane } from '@/composables/useVerticalSplitPane'
import PendingOrderListPanel from './component/PendingOrderListPanel.vue'
import * as indexApi from '@/api/index/index'
import { getSettings as getWarehouseSettings } from '@/api/warehouse/warehouse'
import { settingWarehouseGetSettings as getWarehouseSettings } from '@/api/setting.warehouse/settingwarehouse'
import { orderWaveBatchAutoGrouping, orderWaveBatchCancel, orderWaveBatchFinishAutoGrouping, orderWaveBatchList, orderWaveFetch, orderWaveFetchTaskProgress, orderWaveGroupOrderFetchList } from '@/api/order.wave/orderwave'
import type { WaveFetchParams, WaveFetchResponse, WaveFetchTaskProgressResponse } from '@/api/order.wave/orderwave'
import { useSettingsStore } from '@/stores/modules/settings'
const settingsStore = useSettingsStore()
const shortcutExpanded = computed(() => settingsStore.shortcutExpanded)
const containerHeight = computed(() => shortcutExpanded.value ? 'calc(100vh - 150px)' : 'calc(100vh - 100px)')
const props = defineProps<{
/** 1 团购波次,2 散单波次 */
waveType: 1 | 2
}>()
const scanBox = ref<any>(null)
const upperTable = ref<any>(null)
const groupOrderTableRef = ref<any>(null)
const activeTab = ref<'group' | 'sandan'>('group')
const scrollContainerRef = ref<HTMLElement | null>(null)
const loading = ref(false)
const batchAutoGroupingLoading = ref(false)
const batchFinishAutoGroupingLoading = ref(false)
@ -422,55 +450,114 @@ const fetchTaskProgress = reactive({
const pagination = reactive({ currentPage: 1, pageSize: 20, total: 0 })
const groupOrderPagination = reactive({ currentPage: 1, pageSize: 20, total: 0 })
const presetTree = ref<any[]>([])
const availableFieldsRef = reactive([
{ label: '波次ID', value: 'wave_id', type: 'number' },
{ label: '波次号', value: 'wave_no', type: 'text' },
{ label: '波次状态', value: 'wave_status', type: 'select', options: [
{ label: '自动加团中', value: 0 },
{ label: '已就绪', value: 1 }
] },
{ label: '创建人', value: 'creator', type: 'text' },
{ label: '快递', value: 'logistics_name', type: 'text' },
{ label: '商品类型', value: 'item_part_type', type: 'text' },
{ label: '商品部位', value: 'item_part', type: 'text' },
{ label: '商品快照键', value: 'item_snapshot_key', type: 'text' },
{ label: '商品结构', value: 'item_detail_machine', type: 'text' },
{ label: '区分快递', value: 'distinguish_express', type: 'select', options: [
{ label: '是', value: 1 },
{ label: '否', value: 0 }
] },
{ label: '最小订单数', value: 'total_orders_min', type: 'number' },
{ label: '最大订单数', value: 'total_orders_max', type: 'number' },
{ label: '最小已处理订单', value: 'processed_orders_min', type: 'number' },
{ label: '最大已处理订单', value: 'processed_orders_max', type: 'number' }
])
const availableFieldsRef = reactive(JSON.parse(JSON.stringify(waveAvailableFields)))
const columns = ref(JSON.parse(JSON.stringify(waveBatchColumns)))
const columns = ref([
{ prop: 'wave_id', label: '波次ID', minWidth: 160, fixed: 'left' },
{ prop: 'wave_no', label: '波次编号', minWidth: 180, fixed: 'left' },
{ prop: 'wave_type', label: '波次类型', minWidth: 96 },
{ prop: 'wave_status', label: '状态', minWidth: 110 },
{ prop: 'total_orders', label: '总订单数', minWidth: 110, align: 'right' },
{ prop: 'order_count', label: '订单数量', minWidth: 100, align: 'right' },
{ prop: 'processed_orders', label: '已处理订单', minWidth: 108, align: 'right' },
{ prop: 'item_detail_machine', label: '商品结构', minWidth: 320 },
{ prop: 'item_part_type', label: '商品类型', minWidth: 120 },
{ prop: 'item_part', label: '商品部位', minWidth: 220 },
{ prop: 'distinguish_express', label: '区分快递', minWidth: 100 },
{ prop: 'storage_assignment_status', label: '库位分配', minWidth: 120 },
{ prop: 'express_assignment_status', label: '快递分配', minWidth: 120 },
{ prop: 'print_assignment_status', label: '打印状态', minWidth: 110 },
{ prop: 'logistics_name', label: '快递', minWidth: 120 },
{ prop: 'item_snapshot_key', label: '商品快照键', minWidth: 320 },
{ prop: 'creator', label: '创建人', minWidth: 100 },
{ prop: 'warehouse_id', label: '仓库ID', minWidth: 110 },
{ prop: 'create_time', label: '创建时间', minWidth: 168 },
{ prop: 'update_time', label: '更新时间', minWidth: 168 },
{ prop: 'operation', label: '操作', minWidth: 110, fixed: 'left' }
])
const toolbarButtons = computed(() => getWaveToolbarButtons(props.waveType))
const detailVisible = ref(true)
const { splitStackRef, beginSplitDrag, lowerPaneStyle, upperPaneStyle } = useVerticalSplitPane({
defaultLowerPercent: 38
})
const upperPaneFullStyle = computed(() => ({
flex: '1 1 auto',
minHeight: '0',
overflow: 'hidden' as const
}))
function toggleDetailVisible() {
detailVisible.value = !detailVisible.value
}
const isDragging = ref(false)
const startX = ref(0)
const scrollLeft = ref(0)
const handleToolbarWheel = (e: WheelEvent) => {
if (scrollContainerRef.value) {
e.preventDefault()
scrollContainerRef.value.scrollLeft += e.deltaY
}
}
const handleMouseDown = (e: MouseEvent) => {
if (!scrollContainerRef.value) return
isDragging.value = true
startX.value = e.pageX - scrollContainerRef.value.offsetLeft
scrollLeft.value = scrollContainerRef.value.scrollLeft
}
const handleMouseMove = (e: MouseEvent) => {
if (!isDragging.value || !scrollContainerRef.value) return
e.preventDefault()
const x = e.pageX - scrollContainerRef.value.offsetLeft
const walk = (x - startX.value) * 1.5
scrollContainerRef.value.scrollLeft = scrollLeft.value - walk
}
const handleMouseUp = () => {
isDragging.value = false
}
const buttonLoadingMap = computed(() => ({
loading: loading.value,
batchAutoGroupingLoading: batchAutoGroupingLoading.value,
batchFinishAutoGroupingLoading: batchFinishAutoGroupingLoading.value,
batchCancelLoading: batchCancelLoading.value
}))
const buttonDisabledMap = computed(() => ({
batchPrintDisabled: batchPrintDisabled.value,
noSelection: !hasSelection.value
}))
const buttonLabelMap = computed(() => ({
batchPrintTotal: `批量打印(${selectedWaveOrderTotal.value})`,
detailToggleLabel: detailVisible.value ? '隐藏详情' : '显示详情'
}))
function resolveButtonLoading(loadingKey?: string) {
if (!loadingKey) return false
return Boolean((buttonLoadingMap.value as Record<string, boolean>)[loadingKey])
}
function resolveButtonDisabled(disabledKey?: string) {
if (!disabledKey) return false
return Boolean((buttonDisabledMap.value as Record<string, boolean>)[disabledKey])
}
function resolveButtonLabel(defaultLabel: string, dynamicLabelKey?: string) {
if (!dynamicLabelKey) return defaultLabel
return (buttonLabelMap.value as Record<string, string>)[dynamicLabelKey] || defaultLabel
}
const toolbarActionMap: Record<string, () => void> = {
loadData: () => {
void loadData()
},
openColumnConfigPanel: () => openColumnConfigPanel(),
toggleDetailVisible: () => toggleDetailVisible(),
handleBatchPrint: () => handleBatchPrint(),
handleBatchAutoGrouping: () => {
void handleBatchAutoGrouping()
},
handleBatchFinishAutoGrouping: () => {
void handleBatchFinishAutoGrouping()
},
handleBatchCancel: () => {
void handleBatchCancel()
},
openGroupOrderDialog: () => openGroupOrderDialog()
}
function handleToolbarButtonClick(action: ToolbarButtonConfig['action']) {
const handler = toolbarActionMap[action]
if (!handler) return
safeInvoke(() => handler())
}
const groupOrderFilters = reactive({
distinguishExpress: false,
distinguishExpress: true,
storeId: undefined as number | string | undefined,
sameOrderQuantity: undefined as number | undefined,
shopName: '',
@ -478,8 +565,9 @@ const groupOrderFilters = reactive({
returnOrderIds: false
})
const groupOrderQuantityMap = reactive<Record<string, number | undefined>>({})
const isGroupWaveTab = computed(() => activeTab.value === 'group')
const currentWaveType = computed(() => activeTab.value === 'sandan' ? 2 : 1)
const isGroupWaveTab = computed(() => props.waveType === 1)
const currentWaveType = computed(() => props.waveType)
const tableListId = computed(() => `wave-management-list-${props.waveType}`)
const okCode = (code: unknown) => code === 1 || code === 200 || code === 0
const printableSelectionRows = computed(() => selectionRows.value.filter((row: any) => !isAutoGroupingWave(row)))
@ -603,26 +691,9 @@ function buildWhereConditions(rawConditions: Record<string, any>) {
}
function sanitizeWaveWhere(where: Record<string, any>) {
const allowedFields = new Set([
'wave_id',
'wave_no',
'wave_status',
'creator',
'logistics_name',
'item_part_type',
'item_part',
'item_snapshot_key',
'item_detail_machine',
'distinguish_express',
'total_orders_min',
'total_orders_max',
'processed_orders_min',
'processed_orders_max'
])
const nextWhere: Record<string, any> = {}
Object.keys(where || {}).forEach((key) => {
if (!allowedFields.has(key)) return
if (!waveWhereAllowedFields.has(key)) return
if (key === 'warehouse_id' || key === 'warehouseId') return
const value = where[key]
if (value === undefined || value === null || value === '' || (Array.isArray(value) && value.length === 0)) return
@ -647,16 +718,6 @@ function handleConditionReset() {
loadData()
}
function handleTabChange(name: string | number) {
activeTab.value = name === 'sandan' ? 'sandan' : 'group'
pagination.currentPage = 1
selectionRows.value = []
hasSelection.value = false
selectedRow.value = null
list.value = []
loadData()
}
function handleRowClick(row: any) {
selectedRow.value = row || null
}
@ -1165,6 +1226,7 @@ async function handleBatchCancel() {
function openGroupOrderDialog() {
groupOrderDialogVisible.value = true
groupOrderFilters.distinguishExpress = true
groupOrderPagination.currentPage = 1
groupOrderSelectionRows.value = []
resetGroupOrderQuantityMap()
@ -1250,7 +1312,7 @@ function handleGroupOrderFilterChange() {
}
function resetGroupOrderFilters() {
groupOrderFilters.distinguishExpress = false
groupOrderFilters.distinguishExpress = true
groupOrderFilters.storeId = undefined
groupOrderFilters.sameOrderQuantity = undefined
groupOrderFilters.shopName = ''
@ -1374,42 +1436,16 @@ async function submitGroupOrderDialog() {
</script>
<style scoped lang="scss">
.wave-management-container {
display: flex;
width: 100%;
background-color: #f0f2f5;
}
@use "../orderManagement/styles/order-sub.scss";
.main-content {
flex: 1;
display: flex;
flex-direction: column;
overflow: hidden;
padding: 10px;
gap: 10px;
}
.toolbar {
display: flex;
justify-content: space-between;
align-items: center;
padding: 8px 12px;
background: #fff;
border-radius: 4px;
box-shadow: 0 1px 4px rgba(0, 0, 0, 0.05);
}
.toolbar-left {
display: flex;
gap: 8px;
align-items: center;
.task-progress-panel--toolbar {
margin-bottom: 3px;
}
.task-progress-panel {
padding: 12px 14px;
background: #fff;
border-radius: 4px;
box-shadow: 0 1px 4px rgba(0, 0, 0, 0.05);
border: 1px solid #ebeef5;
}
.task-progress-panel__header {
@ -1446,33 +1482,14 @@ async function submitGroupOrderDialog() {
color: #606266;
}
.upper-wrapper {
flex: 1 1 auto;
min-height: 320px;
background: #fff;
border-radius: 4px;
overflow: hidden;
.order-sub-container .main-content .lower-level .detail-container {
padding: 10px;
overflow: auto;
}
.lower-level {
flex: 0 0 36%;
min-height: 220px;
display: flex;
flex-direction: column;
border-radius: 4px;
overflow: hidden;
background-color: #fff;
}
.detail-header {
flex-shrink: 0;
display: flex;
align-items: center;
.order-sub-container .main-content .lower-level .detail-header {
padding: 0 12px;
height: 42px;
border-bottom: 1px solid #ebeef5;
background-color: #fafafa;
}
.detail-title {
@ -1481,23 +1498,6 @@ async function submitGroupOrderDialog() {
color: #303133;
}
.detail-container {
flex: 1;
min-height: 0;
overflow: auto;
padding: 10px;
}
.no-selection {
display: flex;
align-items: center;
justify-content: center;
min-height: 220px;
color: #909399;
background-color: #fff;
border-radius: 4px;
}
.empty-tip {
text-align: center;
font-size: 13px;
@ -1540,4 +1540,28 @@ async function submitGroupOrderDialog() {
display: inline-block;
line-height: 1.4;
}
.order-sub-container .main-content {
.toolbar {
.toolbar-left {
cursor: grab;
&:active {
cursor: grabbing;
}
.toolbar-scroll-container {
display: flex;
align-items: center;
gap: 6px;
overflow-x: auto;
scrollbar-width: none;
&::-webkit-scrollbar {
display: none;
}
}
}
}
}
</style>

View File

@ -179,7 +179,9 @@ const scanBox = ref<any>(null)
const upperTable = ref<any>(null)
const presetTree = ref<any[]>([])
const availableFieldsRef = reactive(JSON.parse(JSON.stringify(pendingAvailableFields.filter((field: any) => field.value !== 'wave_no'))))
const availableFieldsRef = reactive(
JSON.parse(JSON.stringify(pendingAvailableFields.filter((field: any) => field.value !== 'wave_no')))
)
const toolbarButtons = pickToolbarButtons(['refresh', 'columnConfig', 'allocateStorage', 'allocateExpress', 'syncOrderIds'])
const list = ref<any[]>([])

View File

@ -0,0 +1,170 @@
import type { ToolbarButtonConfig } from '@/views/order/orderManagement/config/order-common-config'
/** 工具栏按钮:可限定仅在团购波次(waveType === 1)显示 */
export type WaveToolbarButtonConfig = ToolbarButtonConfig & {
onlyForWaveType?: 1
}
/** ScanBox 默认 props(与 orderManagement 子页一致的可配置项) */
export const waveScanBoxConfig = {
width: '320px',
treeProps: { children: 'children', label: 'label' } as const,
autoSubmit: false
}
/** 主表 UpperTable 展示与行为默认值 */
export const waveUpperTableDefaults = {
title: '波次列表',
enableColumnConfig: true,
showIndex: true,
showSelection: true,
emptyText: '暂无波次数据'
}
/** 左侧筛选可用字段 */
export const waveAvailableFields = [
// { label: '波次ID', value: 'wave_id', type: 'number' },
{ label: '波次号', value: 'wave_no', type: 'text' },
{
label: '波次状态',
value: 'wave_status',
type: 'select',
options: [
{ label: '自动加团中', value: 0 },
{ label: '已就绪', value: 1 }
]
},
{ label: '创建人', value: 'creator', type: 'text' },
{ label: '快递', value: 'logistics_name', type: 'text' },
// { label: '商品类型', value: 'item_part_type', type: 'text' },
// { label: '商品部位', value: 'item_part', type: 'text' },
{ label: '商品快照键', value: 'item_snapshot_key', type: 'text' },
// { label: '商品结构', value: 'item_detail_machine', type: 'text' },
{
label: '区分快递',
value: 'distinguish_express',
type: 'select',
options: [
{ label: '是', value: 1 },
{ label: '否', value: 0 }
]
},
{ label: '最小订单数', value: 'total_orders_min', type: 'number' },
{ label: '最大订单数', value: 'total_orders_max', type: 'number' },
{ label: '最小已处理订单', value: 'processed_orders_min', type: 'number' },
{ label: '最大已处理订单', value: 'processed_orders_max', type: 'number' }
]
/** 主表列配置 */
export const waveBatchColumns = [
// { prop: 'wave_id', label: '波次ID', minWidth: 160, fixed: 'left' },
{ prop: 'wave_no', label: '波次编号', minWidth: 180, fixed: 'left' },
{ prop: 'wave_type', label: '波次类型', minWidth: 96 },
{ prop: 'wave_status', label: '状态', minWidth: 110 },
{ prop: 'total_orders', label: '总订单数', minWidth: 110, align: 'right' },
{ prop: 'order_count', label: '订单数量', minWidth: 100, align: 'right' },
{ prop: 'processed_orders', label: '已处理订单', minWidth: 108, align: 'right' },
// { prop: 'item_detail_machine', label: '商品结构', minWidth: 320 },
// { prop: 'item_part_type', label: '商品类型', minWidth: 120 },
// { prop: 'item_part', label: '商品部位', minWidth: 220 },
{ prop: 'distinguish_express', label: '区分快递', minWidth: 100 },
{ prop: 'storage_assignment_status', label: '库位分配', minWidth: 120 },
{ prop: 'express_assignment_status', label: '快递分配', minWidth: 120 },
{ prop: 'print_assignment_status', label: '打印状态', minWidth: 110 },
{ prop: 'logistics_name', label: '快递', minWidth: 120 },
{ prop: 'item_snapshot_key', label: '商品快照键', minWidth: 320 },
{ prop: 'creator', label: '创建人', minWidth: 100 },
{ prop: 'warehouse_id', label: '仓库ID', minWidth: 110 },
{ prop: 'create_time', label: '创建时间', minWidth: 168 },
{ prop: 'update_time', label: '更新时间', minWidth: 168 },
{ prop: 'operation', label: '操作', minWidth: 110, fixed: 'left' }
]
/** 列表查询 where 白名单(与 sanitizeWaveWhere 一致) */
export const waveWhereAllowedFieldList = [
'wave_id',
'wave_no',
'wave_status',
'creator',
'logistics_name',
// 'item_part_type',
// 'item_part',
'item_snapshot_key',
// 'item_detail_machine',
'distinguish_express',
'total_orders_min',
'total_orders_max',
'processed_orders_min',
'processed_orders_max'
] as const
export const waveWhereAllowedFields = new Set<string>(waveWhereAllowedFieldList)
/**
* 主工具栏按钮(action 与 WaveBatchListPanel 内 toolbarActionMap 键一致)
*/
export const waveToolbarButtons: WaveToolbarButtonConfig[] = [
{ key: 'refresh', label: '刷新', type: 'primary', size: 'small', loadingKey: 'loading', action: 'loadData' },
{ key: 'columnConfig', label: '字段设置', size: 'small', action: 'openColumnConfigPanel' },
{
key: 'toggleDetail',
label: '显示详情',
dynamicLabelKey: 'detailToggleLabel',
size: 'small',
action: 'toggleDetailVisible'
},
{
key: 'batchPrint',
label: '批量打印(0)',
dynamicLabelKey: 'batchPrintTotal',
type: 'info',
size: 'small',
disabledKey: 'batchPrintDisabled',
action: 'handleBatchPrint'
},
{
key: 'batchAutoGrouping',
label: '批量改为自动加团',
type: 'warning',
size: 'small',
disabledKey: 'noSelection',
loadingKey: 'batchAutoGroupingLoading',
action: 'handleBatchAutoGrouping'
},
{
key: 'batchFinishAutoGrouping',
label: '批量结束自动加团',
type: 'success',
size: 'small',
disabledKey: 'noSelection',
loadingKey: 'batchFinishAutoGroupingLoading',
action: 'handleBatchFinishAutoGrouping'
},
{
key: 'batchCancel',
label: '批量取消波次',
type: 'danger',
size: 'small',
disabledKey: 'noSelection',
loadingKey: 'batchCancelLoading',
action: 'handleBatchCancel'
},
{
key: 'fetchGroupOrder',
label: '抓取团购单',
type: 'warning',
size: 'small',
action: 'openGroupOrderDialog',
onlyForWaveType: 1
}
]
export function getWaveToolbarButtons(waveType: 1 | 2): WaveToolbarButtonConfig[] {
return waveToolbarButtons.filter(
(b) => b.onlyForWaveType === undefined || b.onlyForWaveType === waveType
)
}

View File

@ -0,0 +1,7 @@
<template>
<wave-batch-list-panel :wave-type="1" />
</template>
<script setup lang="ts">
import WaveBatchListPanel from './WaveBatchListPanel.vue'
</script>

View File

@ -0,0 +1,195 @@
<template>
<div class="order-management-wrapper" :style="{ height: containerHeight }">
<el-tabs
v-model="activeTab"
@tab-change="handleTabChange"
tab-position="top"
type="border-card"
class="tab-container"
>
<el-tab-pane
v-for="tab in tabs"
:key="tab.name"
:name="tab.name"
:lazy="false"
>
<template #label>
<span class="custom-tab-label">{{ tab.label }}</span>
</template>
<keep-alive>
<component :is="tab.component" v-if="activeTab === tab.name" />
</keep-alive>
</el-tab-pane>
</el-tabs>
</div>
</template>
<script setup lang="ts">
import { ref, watch, onMounted, computed, markRaw } from 'vue'
import { useRoute, useRouter } from 'vue-router'
import { useSettingsStore } from '@/stores/modules/settings'
import GroupWave from './groupWave.vue'
import SandanWave from './sandanWave.vue'
import { safeInvoke } from '@/utils/safe-invoke'
const route = useRoute()
const router = useRouter()
const settingsStore = useSettingsStore()
const shortcutExpanded = computed(() => settingsStore.shortcutExpanded)
const containerHeight = computed(() => shortcutExpanded.value ? 'calc(100vh - 150px)' : 'calc(100vh - 100px)')
const activeTab = ref('groupWave')
type WaveTabItem = {
name: string
label: string
component: any
}
const tabs = ref<WaveTabItem[]>([
{ name: 'groupWave', label: '团购波次', component: markRaw(GroupWave) },
{ name: 'sandanWave', label: '散单波次', component: markRaw(SandanWave) }
])
const initFromRoute = () => {
const tabFromUrl = route.query.tab as string
const validTabs = tabs.value.map((t) => t.name)
if (tabFromUrl && validTabs.includes(tabFromUrl)) {
activeTab.value = tabFromUrl
} else {
activeTab.value = 'groupWave'
if (!route.query.tab || !validTabs.includes(tabFromUrl)) {
router.replace({
query: {
...route.query,
tab: 'groupWave'
}
})
}
}
}
watch(
() => route.query.tab,
(newTab) => {
const validTabs = tabs.value.map((t) => t.name)
if (newTab && validTabs.includes(newTab as string)) {
activeTab.value = newTab as string
} else {
activeTab.value = 'groupWave'
if (!newTab || !validTabs.includes(newTab as string)) {
router.replace({
query: {
...route.query,
tab: 'groupWave'
}
})
}
}
},
{ immediate: true }
)
onMounted(() => {
initFromRoute()
})
const handleTabChange = (tabName: string | number) => {
safeInvoke(() => {
const name = String(tabName)
if (String(route.query.tab ?? '') === name) {
return
}
router.replace({
query: {
...route.query,
tab: name
}
})
})
}
</script>
<style lang="scss" scoped>
.order-management-wrapper {
position: relative;
width: 100%;
overflow: hidden;
}
.tab-container {
display: flex;
flex-direction: column;
height: 100%;
:deep(.el-tabs__header) {
margin-bottom: 0;
flex-shrink: 0;
}
:deep(.el-tabs__header.is-top) {
padding: 4px 12px 0;
background: #f8fbff;
border-bottom: 1px solid #e8eef7;
margin: 0;
}
:deep(.el-tabs__nav-wrap::after) {
display: none;
}
:deep(.el-tabs__item.is-top) {
height: 38px;
line-height: 38px;
padding: 0 20px;
border-radius: 6px 6px 0 0;
color: #606266;
font-size: 14px;
font-weight: 500;
transition: all 0.3s cubic-bezier(0.645, 0.045, 0.355, 1);
border: 1px solid transparent;
border-bottom: none;
margin-right: 4px;
}
:deep(.el-tabs__item.is-top:hover) {
color: #409eff;
background-color: rgba(64, 158, 255, 0.05);
}
:deep(.el-tabs__item.is-top.is-active) {
color: #409eff;
font-weight: 600;
background: #ffffff;
border-color: #e8eef7;
border-bottom: 2px solid #ffffff;
margin-bottom: -1px;
position: relative;
z-index: 1;
}
:deep(.el-tabs__active-bar) {
height: 2px;
border-radius: 2px;
background-color: #409eff;
bottom: 0;
}
:deep(.el-tabs__content) {
flex: 1;
overflow: auto;
position: relative;
.el-tab-pane {
height: 100%;
}
}
}
.custom-tab-label {
display: inline-flex;
align-items: center;
gap: 6px;
}
</style>

View File

@ -0,0 +1,7 @@
<template>
<wave-batch-list-panel :wave-type="2" />
</template>
<script setup lang="ts">
import WaveBatchListPanel from './WaveBatchListPanel.vue'
</script>

View File

@ -3,90 +3,11 @@
{
"接口": "user.login",
"data": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3Nzc3MDE3NDksImV4cCI6MTc3NzcxNjE0OX0.tp7grssYCswBwcWl6JZUXT_O0Xxz7o2s-MqG-o7V6cM"
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3Nzc4ODU4MjEsImV4cCI6MTc3NzkwMDIyMX0.Q0F2Slir7PDYHsHlcMGWV_BkecHh1HPLBgAvx8KqaQg"
}
},
{
"接口": "storage.inventory.quickPutaway",
"data": null
},
{
"接口": "storage.inventory.matchPutaway",
"data": null
},
{
"接口": "storage.inventory.transferLocation",
"data": null
},
{
"接口": "storage.inventory.transferByProduct",
"data": null
},
{
"接口": "storage.inventory.list",
"data": null
},
{
"接口": "storage.expiry.list",
"data": {
"list": [
{
"id": 142,
"warehouse_id": 100000,
"store_id": 1000000,
"space_id": 7178,
"stock_id": 157059,
"batch_no": "R20554119",
"inventory_type": "ZP",
"quantity": 10,
"locked_quantity": 0,
"available_quantity": 10,
"production_date": "2023-10-12 08:00:00",
"expiry_date": "2026-10-11 08:00:00",
"inbound_time": "2026-04-12 00:01:11",
"inbound_order_no": "TEST-ENTRY-1775923270905",
"receiving_id": 666,
"entry_order_id": 189,
"supplier_id": null,
"supplier_batch_no": null,
"is_enabled": 1,
"created_at": "2026-04-12 00:01:11",
"updated_at": "2026-04-14 16:44:39",
"delete_at": null,
"stock": {
"id": 157059,
"item_code": "yjm20260411",
"goods_code": null,
"item_name": "yjm0411",
"sku_property": "",
"stock_unit": "个",
"store_id": 1000000,
"warehouse_id": 100000,
"is_shelf_life_mgmt": "Y",
"remaining_threshold_days": 180
},
"space": {
"id": 7178,
"space_code": "E02-01-01-01",
"custom_name": null
},
"threshold_days": 180,
"remaining_days": 162,
"is_expired": false
}
],
"pagination": {
"page": 1,
"pageSize": 20,
"total": 1,
"totalPages": 1,
"hasPrevious": false,
"hasNext": false
}
}
},
{
"接口": "storage.transaction.list",
"接口": "order.queryOrderLogList",
"data": null
}
]

View File

@ -1,11 +1,11 @@
# 接口
- 更新时间: 2026-05-01 10:32:58
- 更新时间: 2026-05-04 17:43:07
- 扫描目录: `src\api`
- 模块数: 30
- API 文件数: 30
- 接口数: 244
- 已启用: 215
- 模块数: 33
- API 文件数: 33
- 接口数: 258
- 已启用: 228
- 占位接口: 2
## 模块统计
@ -14,16 +14,18 @@
| --- | ---: | ---: | ---: | ---: |
| config | 1 | 1 | 0 | 0 |
| dashboard | 1 | 6 | 6 | 0 |
| index | 1 | 18 | 16 | 1 |
| index | 1 | 18 | 15 | 1 |
| order.archiveorder | 1 | 2 | 2 | 0 |
| order.deliveryexpectionorder | 1 | 2 | 2 | 0 |
| order.deliveryorder | 1 | 2 | 2 | 0 |
| order.entrustorder | 1 | 2 | 2 | 0 |
| order.expectionorder | 1 | 3 | 3 | 0 |
| order.index | 1 | 5 | 4 | 0 |
| order.index | 1 | 6 | 5 | 0 |
| order.outboundorder | 1 | 3 | 3 | 0 |
| order.pendingorder | 1 | 15 | 15 | 0 |
| order.pendingorder | 1 | 16 | 16 | 0 |
| order.revieworder | 1 | 3 | 3 | 0 |
| order.wave | 1 | 8 | 8 | 0 |
| pick | 1 | 1 | 1 | 0 |
| print | 1 | 13 | 12 | 1 |
| printer.station | 1 | 11 | 1 | 0 |
| setting.account | 1 | 7 | 7 | 0 |
@ -33,6 +35,7 @@
| setting.platform | 1 | 5 | 5 | 0 |
| setting.printtemplate | 1 | 13 | 13 | 0 |
| setting.role | 1 | 5 | 5 | 0 |
| setting.warehouse | 1 | 3 | 3 | 0 |
| stock | 1 | 26 | 25 | 0 |
| storage_receiving | 1 | 22 | 12 | 0 |
| storage.entry | 1 | 4 | 4 | 0 |
@ -65,7 +68,7 @@
| index | getPlatformList | index.getPlatformList | POST | 是 | 否 | index/index.ts | 表单用 |
| index | listInterfaceTypes | index.listInterfaceTypes | POST | 是 | 否 | index/index.ts | |
| index | loadStores | index.loadStores | POST | 是 | 否 | index/index.ts | |
| index | loginToIm | index.loginToIm | POST | 是 | 否 | index/index.ts | |
| index | loginToIm | index.loginToIm | POST | 否 | 否 | index/index.ts | |
| index | putI18nCollect | index.putI18nCollect | POST | 是 | 否 | index/index.ts | |
| index | recognizeLicensePlate | index.recognizeLicensePlate | POST | 否 | 否 | index/index.ts | |
| index | ReferenceFile | index.ReferenceFile | POST | 是 | 否 | index/index.ts | |
@ -87,12 +90,14 @@
| order.index | orderDetail | order.detail | POST | 否 | 否 | order.index/orderindex.ts | |
| order.index | orderList | order.list | POST | 是 | 否 | order.index/orderindex.ts | |
| order.index | orderManualOutboundOrder | order.manualOutboundOrder | POST | 是 | 否 | order.index/orderindex.ts | |
| order.index | orderQueryOrderLogList | order.queryOrderLogList | POST | 是 | 否 | order.index/orderindex.ts | |
| order.index | orderQueryOrderLogs | order.queryOrderLogs | POST | 是 | 否 | order.index/orderindex.ts | |
| order.outboundorder | orderOutboundOrderDetail | order.outboundOrder.detail | POST | 是 | 否 | order.outboundorder/orderoutboundOrder.ts | |
| order.outboundorder | orderOutboundOrderList | order.outboundOrder.list | POST | 是 | 否 | order.outboundorder/orderoutboundOrder.ts | |
| order.outboundorder | orderOutboundOrderManualOutboundOrder | order.outboundOrder.manualOutboundOrder | POST | 是 | 否 | order.outboundorder/orderoutboundOrder.ts | |
| order.pendingorder | orderPendingOrderAllocateExpressCode | order.pendingOrder.allocateExpressCode | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderAllocateStorage | order.pendingOrder.allocateStorage | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderAllocateStorageProgress | order.pendingOrder.allocateStorageProgress | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderCancelAllocateStorage | order.pendingOrder.cancelAllocateStorage | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderCancelOrder | order.pendingOrder.cancelOrder | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderCloneOrder | order.pendingOrder.cloneOrder | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
@ -109,6 +114,15 @@
| order.revieworder | orderReviewOrderDetail | order.reviewOrder.detail | POST | 是 | 否 | order.revieworder/orderreviewOrder.ts | |
| order.revieworder | orderReviewOrderList | order.reviewOrder.list | POST | 是 | 否 | order.revieworder/orderreviewOrder.ts | |
| order.revieworder | orderReviewOrderReviewOrder | order.reviewOrder.reviewOrder | POST | 是 | 否 | order.revieworder/orderreviewOrder.ts | |
| order.wave | orderWaveBatchAutoGrouping | order.wave.batchAutoGrouping | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveBatchCancel | order.wave.batchCancel | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveBatchFinishAutoGrouping | order.wave.batchFinishAutoGrouping | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveBatchList | order.wave.batchList | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveBatchRemoveOrders | order.wave.batchRemoveOrders | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveFetch | order.wave.fetch | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveFetchTaskProgress | order.wave.fetchTaskProgress | POST | 是 | 否 | order.wave/orderwave.ts | |
| order.wave | orderWaveGroupOrderFetchList | order.wave.groupOrderFetchList | POST | 是 | 否 | order.wave/orderwave.ts | |
| pick | pickQuery | pick.query | POST | 是 | 否 | pick/pick.ts | |
| print | getExpressList | index.getExpressList | POST | 否 | 否 | print/print.ts | |
| print | add | print.add | POST | 是 | 否 | print/print.ts | |
| print | delItems | print.del | POST | 是 | 否 | print/print.ts | |
@ -179,6 +193,9 @@
| setting.role | roleList | setting.role.list | POST | 是 | 否 | setting.role/role.ts | |
| setting.role | permissionroleList | setting.role.permission | POST | 是 | 否 | setting.role/role.ts | |
| setting.role | roleUpdate | setting.role.update | POST | 是 | 否 | setting.role/role.ts | |
| setting.warehouse | settingWarehouseGetFieldMeta | setting.warehouse.getFieldMeta | POST | 是 | 否 | setting.warehouse/settingwarehouse.ts | |
| setting.warehouse | settingWarehouseGetSettings | setting.warehouse.getSettings | POST | 是 | 否 | setting.warehouse/settingwarehouse.ts | |
| setting.warehouse | settingWarehouseSaveSettings | setting.warehouse.saveSettings | POST | 是 | 否 | setting.warehouse/settingwarehouse.ts | |
| stock | stockStockWarehouse | stock.stockWarehouse | POST | 是 | 否 | stock/stock.ts | |
| stock | backData | stock.warehouse.backData | POST | 是 | 否 | stock/stock.ts | |
| stock | bindItem | stock.warehouse.bindItem | POST | 是 | 否 | stock/stock.ts | |

View File

@ -8,31 +8,16 @@
}
},
{
"method": "storage.inventory.quickPutaway",
"method": "",
"body": {
}
},
{
"method": "",
"body": {}
},
{
"method": "storage.inventory.matchPutaway",
"body": {}
},
{
"method": "storage.inventory.transferLocation",
"body": {}
},
{
"method": "storage.inventory.transferByProduct",
"body": {}
},
{
"method": "storage.inventory.list",
"body": {}
},
{
"method": "storage.expiry.list",
"body": {}
},
{
"method": "storage.transaction.list",
"method": "",
"body": {}
}
],

View File

@ -1,9 +1,9 @@
{
"数据一览": {
"当前请求数": 8,
"成功数": 4,
"全部请求数": 8,
"成功数与全部请求数": "4/8",
"当前请求数": 2,
"成功数": 2,
"全部请求数": 2,
"成功数与全部请求数": "2/2",
"成功判定名单": [
"ok",
"成功",
@ -12,70 +12,7 @@
"查询成功",
"获取成功"
],
"失败接口": [
{
"接口": "storage.inventory.quickPutaway",
"message": "receiving_id 必填",
"code": 400,
"模块目录": "storage.inventory",
"api封装": [
{
"文件": "src/api/storage.inventory/inventory.ts",
"方法名": "quickPutaway"
},
{
"文件": "src/api/storage_receiving/receiving.ts",
"方法名": "quickPutaway"
}
],
"引用页面": [
"src/views/storage/receiving/index.vue"
]
},
{
"接口": "storage.inventory.matchPutaway",
"message": "receiving_ids 不能为空",
"code": 400,
"模块目录": "storage.inventory",
"api封装": [
{
"文件": "src/api/storage.inventory/inventory.ts",
"方法名": "matchPutaway"
}
],
"引用页面": []
},
{
"接口": "storage.inventory.transferLocation",
"message": "storage_id 必填",
"code": 400,
"模块目录": "storage.inventory",
"api封装": [
{
"文件": "src/api/storage.inventory/inventory.ts",
"方法名": "transferLocation"
}
],
"引用页面": [
"src/views/storage/inventory/component/panelstockdetail.vue"
]
},
{
"接口": "storage.inventory.transferByProduct",
"message": "space_id 必填",
"code": 400,
"模块目录": "storage.inventory",
"api封装": [
{
"文件": "src/api/storage.inventory/inventory.ts",
"方法名": "transferByProduct"
}
],
"引用页面": [
"src/views/storage/inventory/component/panelstockdetail.vue"
]
}
],
"失败接口": [],
"空数据接口": []
},
"详情": [
@ -84,104 +21,13 @@
"message": "登录成功",
"code": 200,
"data": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3Nzc3MDE3NDksImV4cCI6MTc3NzcxNjE0OX0.tp7grssYCswBwcWl6JZUXT_O0Xxz7o2s-MqG-o7V6cM"
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3Nzc4ODU4MjEsImV4cCI6MTc3NzkwMDIyMX0.Q0F2Slir7PDYHsHlcMGWV_BkecHh1HPLBgAvx8KqaQg"
}
},
{
"接口": "storage.inventory.quickPutaway",
"message": "receiving_id 必填",
"code": 400,
"data": null
},
{
"接口": "storage.inventory.matchPutaway",
"message": "receiving_ids 不能为空",
"code": 400,
"data": null
},
{
"接口": "storage.inventory.transferLocation",
"message": "storage_id 必填",
"code": 400,
"data": null
},
{
"接口": "storage.inventory.transferByProduct",
"message": "space_id 必填",
"code": 400,
"data": null
},
{
"接口": "storage.inventory.list",
"接口": "order.queryOrderLogList",
"message": "ok",
"code": 1,
"data": null
},
{
"接口": "storage.expiry.list",
"message": "查询成功",
"code": 200,
"data": {
"list": [
{
"id": 142,
"warehouse_id": 100000,
"store_id": 1000000,
"space_id": 7178,
"stock_id": 157059,
"batch_no": "R20554119",
"inventory_type": "ZP",
"quantity": 10,
"locked_quantity": 0,
"available_quantity": 10,
"production_date": "2023-10-12 08:00:00",
"expiry_date": "2026-10-11 08:00:00",
"inbound_time": "2026-04-12 00:01:11",
"inbound_order_no": "TEST-ENTRY-1775923270905",
"receiving_id": 666,
"entry_order_id": 189,
"supplier_id": null,
"supplier_batch_no": null,
"is_enabled": 1,
"created_at": "2026-04-12 00:01:11",
"updated_at": "2026-04-14 16:44:39",
"delete_at": null,
"stock": {
"id": 157059,
"item_code": "yjm20260411",
"goods_code": null,
"item_name": "yjm0411",
"sku_property": "",
"stock_unit": "个",
"store_id": 1000000,
"warehouse_id": 100000,
"is_shelf_life_mgmt": "Y",
"remaining_threshold_days": 180
},
"space": {
"id": 7178,
"space_code": "E02-01-01-01",
"custom_name": null
},
"threshold_days": 180,
"remaining_days": 162,
"is_expired": false
}
],
"pagination": {
"page": 1,
"pageSize": 20,
"total": 1,
"totalPages": 1,
"hasPrevious": false,
"hasNext": false
}
}
},
{
"接口": "storage.transaction.list",
"message": "ok",
"code": 1,
"data": null
}
]

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {
@ -12,26 +12,73 @@
"label": "全部"
}
},
"moduleCount": 30,
"totalInterfaceCount": 211,
"moduleCount": 33,
"totalInterfaceCount": 222,
"changes": {
"summary": {
"moduleAdded": 0,
"moduleAdded": 1,
"moduleDeleted": 0,
"moduleUpdated": 0,
"interfaceAdded": 0,
"interfaceDeleted": 0,
"moduleUpdated": 1,
"interfaceAdded": 1,
"interfaceDeleted": 2,
"interfaceParamsUpdated": 0,
"interfaceResponseUpdated": 0
},
"moduleUpdates": {
"added": [],
"added": [
{
"moduleName": "拣货模块",
"moduleKey": "pick",
"folder": "pick",
"methods": [
"pick.query"
],
"interfaceCount": 1
}
],
"deleted": [],
"updated": []
"updated": [
{
"moduleName": "商品模块",
"moduleKey": "stock",
"folder": "stock",
"previousModuleName": "商品模块",
"previousModuleKey": "stock",
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [
"stock.stockWarehouse",
"stock.warehouse.getStockDetail"
],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
}
]
},
"interfaceUpdates": {
"added": [],
"deleted": [],
"added": [
{
"moduleName": "拣货模块",
"moduleKey": "pick",
"folder": "pick",
"method": "pick.query"
}
],
"deleted": [
{
"moduleName": "商品模块",
"moduleKey": "stock",
"folder": "stock",
"method": "stock.stockWarehouse"
},
{
"moduleName": "商品模块",
"moduleKey": "stock",
"folder": "stock",
"method": "stock.warehouse.getStockDetail"
}
],
"paramsUpdated": [],
"responseUpdated": []
}
@ -108,6 +155,23 @@
}
]
},
{
"moduleName": "仓库设置模块",
"moduleKey": "setting.warehouse",
"folder": "setting.warehouse",
"interfaceCount": 3,
"interfaces": [
{
"method": "setting.warehouse.getSettings"
},
{
"method": "setting.warehouse.getFieldMeta"
},
{
"method": "setting.warehouse.saveSettings"
}
]
},
{
"moduleName": "出库单模块",
"moduleKey": "storage.stockout",
@ -207,7 +271,7 @@
"moduleName": "待处理订单模块",
"moduleKey": "order.pendingOrder",
"folder": "order.pendingorder",
"interfaceCount": 15,
"interfaceCount": 16,
"interfaces": [
{
"method": "order.pendingOrder.list"
@ -230,6 +294,9 @@
{
"method": "order.pendingOrder.allocateStorage"
},
{
"method": "order.pendingOrder.allocateStorageProgress"
},
{
"method": "order.pendingOrder.syncOrderIds"
},
@ -256,6 +323,38 @@
}
]
},
{
"moduleName": "订单波次模块",
"moduleKey": "order.wave",
"folder": "order.wave",
"interfaceCount": 8,
"interfaces": [
{
"method": "order.wave.groupOrderFetchList"
},
{
"method": "order.wave.batchList"
},
{
"method": "order.wave.batchCancel"
},
{
"method": "order.wave.fetch"
},
{
"method": "order.wave.fetchTaskProgress"
},
{
"method": "order.wave.batchAutoGrouping"
},
{
"method": "order.wave.batchFinishAutoGrouping"
},
{
"method": "order.wave.batchRemoveOrders"
}
]
},
{
"moduleName": "订单待出库模块",
"moduleKey": "order.outboundOrder",
@ -294,7 +393,7 @@
"moduleName": "订单工作台入口模块",
"moduleKey": "order.index",
"folder": "order.index",
"interfaceCount": 5,
"interfaceCount": 6,
"interfaces": [
{
"method": "order.list"
@ -310,6 +409,9 @@
},
{
"method": "order.queryOrderLogs"
},
{
"method": "order.queryOrderLogList"
}
]
},
@ -431,7 +533,7 @@
"moduleName": "基础模块",
"moduleKey": "index",
"folder": "index",
"interfaceCount": 15,
"interfaceCount": 14,
"interfaces": [
{
"method": "index.fastWhereTree"
@ -454,9 +556,6 @@
{
"method": "index.getMessageDetail"
},
{
"method": "index.loginToIm"
},
{
"method": "index.recognizeLicensePlate"
},
@ -480,6 +579,17 @@
}
]
},
{
"moduleName": "拣货模块",
"moduleKey": "pick",
"folder": "pick",
"interfaceCount": 1,
"interfaces": [
{
"method": "pick.query"
}
]
},
{
"moduleName": "角色管理模块",
"moduleKey": "setting.role",
@ -688,7 +798,7 @@
"moduleName": "商品模块",
"moduleKey": "stock",
"folder": "stock",
"interfaceCount": 23,
"interfaceCount": 21,
"interfaces": [
{
"method": "stock.warehouse.list"
@ -752,12 +862,6 @@
},
{
"method": "stock.warehouse.search"
},
{
"method": "stock.warehouse.getStockDetail"
},
{
"method": "stock.stockWarehouse"
}
]
},

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {
@ -16,7 +16,7 @@
"name": "基础模块",
"key": "index",
"folder": "index",
"interfaceCount": 15
"interfaceCount": 14
},
"changes": {
"fromPreviousSnapshot": {
@ -199,65 +199,6 @@
"params": [],
"response": []
},
{
"method": "index.loginToIm",
"title": "生成 IM 单点登录一次性 code(有效期 5 分钟)",
"description": "生成 IM 单点登录一次性 code(有效期 5 分钟)",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [],
"response": [
{
"name": "data.code",
"type": "string",
"required": false,
"description": "一次性登录码,长度固定 64 位(hex)"
},
{
"name": "data.employees_id",
"type": "string",
"required": false,
"description": "当前登录员工 ID"
},
{
"name": "data.employees_name",
"type": "string",
"required": false,
"description": "当前登录员工名称"
},
{
"name": "data.subject",
"type": "object",
"required": false,
"description": "当前登录主体信息"
},
{
"name": "data.store_type",
"type": "string",
"required": false,
"description": "主体类型,取自 wms_store.project 字段"
},
{
"name": "data.avatar",
"type": "string",
"required": false,
"description": "员工头像 URL,未设置时为空字符串"
}
]
},
{
"method": "index.recognizeLicensePlate",
"title": "识别车牌号码(通过 base64 图片)",

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {
@ -16,7 +16,7 @@
"name": "订单工作台入口模块",
"key": "order.index",
"folder": "order.index",
"interfaceCount": 5
"interfaceCount": 6
},
"changes": {
"fromPreviousSnapshot": {
@ -371,6 +371,42 @@
"description": "分页信息,包含 page、pageSize、total、totalPages"
}
]
},
{
"method": "order.queryOrderLogList",
"title": "按 order_id 查询订单操作日志,返回全量日志(不分页)。接口按当前登录用户的仓库上下文过滤(method 层从 ctx.user.store_id 获取 warehouse_id),以防跨仓越界。",
"description": "按 order_id 查询订单操作日志,返回全量日志(不分页)。接口按当前登录用户的仓库上下文过滤(method 层从 ctx.user.store_id 获取 warehouse_id),以防跨仓越界。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "order_id / id / orderId",
"type": "string|number",
"required": true,
"description": "订单ID;支持别名 id 与 orderId,接口会兼容解析。"
}
],
"response": [
{
"name": "list",
"type": "array",
"required": true,
"description": "日志列表(全量返回,无分页)。每项字段与 stock.warehouse.queryStockLogs 保持一致,典型字段包括 id、action、message、actor、created_at、warehouse_id 等。"
}
]
}
]
}

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {
@ -16,7 +16,7 @@
"name": "待处理订单模块",
"key": "order.pendingOrder",
"folder": "order.pendingorder",
"interfaceCount": 15
"interfaceCount": 16
},
"changes": {
"fromPreviousSnapshot": {
@ -411,8 +411,8 @@
},
{
"method": "order.pendingOrder.allocateStorage",
"title": "按订单批量分配储位(迁移自 order.storageAllocation.allocateStorage)。只接受订单相关入参,不再接受 warehouse_id / warehouseId,仓库上下文来自当前登录用户。",
"description": "按订单批量分配储位(迁移自 order.storageAllocation.allocateStorage)。只接受订单相关入参,不再接受 warehouse_id / warehouseId,仓库上下文来自当前登录用户。",
"title": "按订单批量分配储位(迁移自 order.storageAllocation.allocateStorage)。这是一个异步提交接口:调用后接口立即返回受理信息(包含 request_id),后端异步执行实际的储位分配与锁定操作;仓库上下文由当前登录用户提供(ctx.user.store_id)。接口不会在同步响应中返回分配明细(如 requested_order_ids、allocated_order_ids 等),客户端可通过请求 ID 或事件/查询链路获取最终结果。",
"description": "按订单批量分配储位(迁移自 order.storageAllocation.allocateStorage)。这是一个异步提交接口:调用后接口立即返回受理信息(包含 request_id),后端异步执行实际的储位分配与锁定操作;仓库上下文由当前登录用户提供(ctx.user.store_id)。接口不会在同步响应中返回分配明细(如 requested_order_ids、allocated_order_ids 等),客户端可通过请求 ID 或事件/查询链路获取最终结果。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -444,28 +444,94 @@
],
"response": [
{
"name": "flag",
"name": "request_id",
"type": "string",
"required": true,
"description": "全局调用结果标识,成功为 success"
"description": "请求 ID(后端生成的唯一标识),用于查询任务状态或结果"
},
{
"name": "code",
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "业务状态码,200 表示成功"
"description": "生效的仓库 ID(来自当前用户 store_id)"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示信息,成功或部分成功时给出人类可读的摘要。"
"description": "受理提示信息,通常为 '请求已受理,后端异步处理中' 或错误说明"
}
]
},
{
"method": "order.pendingOrder.allocateStorageProgress",
"title": "按 request_id 查询储位分配异步任务状态/结果(由 allocateStorage 提交)",
"description": "按 request_id 查询储位分配异步任务状态/结果(由 allocateStorage 提交)",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "request_id / requestId",
"type": "string",
"required": true,
"description": "任务请求 ID,兼容字段 requestId"
}
],
"response": [
{
"name": "request_id",
"type": "string",
"required": true,
"description": "请求 ID(后端生成的唯一标识)"
},
{
"name": "data",
"type": "object",
"name": "status",
"type": "string",
"required": true,
"description": "分配结果汇总对象,包含以下字段"
"description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)"
},
{
"name": "result",
"type": "object",
"required": false,
"description": "成功时返回底层分配结果,结构视实现而定"
},
{
"name": "error",
"type": "string",
"required": false,
"description": "失败时返回的错误信息"
},
{
"name": "warehouse_id",
"type": "number",
"required": false,
"description": "关联仓库 ID(若任务关联仓库时返回)"
},
{
"name": "update_time",
"type": "string",
"required": false,
"description": "最近一次状态更新时间,ISO8601 字符串"
},
{
"name": "message",
"type": "string",
"required": false,
"description": "额外提示信息"
}
]
},

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -0,0 +1,12 @@
{
"module": {
"name": "订单波次模块",
"key": "order.wave",
"folder": "order.wave"
},
"status": "active",
"createdAt": "2026-05-04 09:11:04",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -0,0 +1,563 @@
{
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {
"value": "web",
"label": "网页端"
},
"project": {
"value": "all",
"label": "全部"
}
},
"module": {
"name": "订单波次模块",
"key": "order.wave",
"folder": "order.wave",
"interfaceCount": 8
},
"changes": {
"fromPreviousSnapshot": {
"moduleAdded": false,
"moduleRenamed": false,
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
}
},
"interfaces": [
{
"method": "order.wave.groupOrderFetchList",
"title": "按机器结构分组的可抓取列表。仅处理待处理订单(排除待审核),且排除已在波次中的订单。",
"description": "按机器结构分组的可抓取列表。仅处理待处理订单(排除待审核),且排除已在波次中的订单。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "pagination",
"type": "object",
"required": false,
"description": "分页参数,支持 page / pageSize"
},
{
"name": "distinguish_express",
"type": "boolean",
"required": false,
"description": "是否区分快递(影响分组粒度)"
},
{
"name": "store_id",
"type": "number",
"required": false,
"description": "货主ID(仅作为筛选条件)"
},
{
"name": "same_order_quantity",
"type": "number",
"required": false,
"description": "最小同组订单数量阈值(>=)。若显式传入有效数值则按传入值使用;未传入时使用仓库配置 min_group_order_fetch_quantity(默认 13)。"
},
{
"name": "shop_name",
"type": "string",
"required": false,
"description": "店铺名称(模糊匹配)"
},
{
"name": "include_sku",
"type": "string",
"required": false,
"description": "仅保留包含该 SKU 的分组(页内过滤)"
},
{
"name": "return_order_ids",
"type": "boolean",
"required": false,
"description": "是否在结果中返回组内订单ID列表"
}
],
"response": [
{
"name": "list",
"type": "array",
"required": true,
"description": "分组列表,items 示例见实现:包含 item_detail_machine/item_snapshot/group_count 等字段"
},
{
"name": "pagination",
"type": "object",
"required": true,
"description": "分页信息(page、pageSize、total、totalPages、hasPrevious、hasNext)"
}
]
},
{
"method": "order.wave.batchList",
"title": "波次列表查询。仅使用当前登录操作者的仓库ID作为查询约束(禁止传入 warehouse_id / warehouseId)。支持通过白名单字段进行过滤(通过 where 对象传入),接口对 wave_status 固定叠加查询状态 0/1,无需客户端传入。列表按订单数量从大到小排序,并附带波次基础信息与分配状态汇总。",
"description": "波次列表查询。仅使用当前登录操作者的仓库ID作为查询约束(禁止传入 warehouse_id / warehouseId)。支持通过白名单字段进行过滤(通过 where 对象传入),接口对 wave_status 固定叠加查询状态 0/1,无需客户端传入。列表按订单数量从大到小排序,并附带波次基础信息与分配状态汇总。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "pagination",
"type": "object",
"required": false,
"description": "分页参数,支持 page / pageSize"
},
{
"name": "where",
"type": "object",
"required": false,
"description": "筛选白名单字段(object,可选)。仅支持下列字段过滤,且禁止传入 warehouse_id / warehouseId: - wave_id(等值) - wave_no(模糊) - wave_type(等值) - wave_status(等值,接口固定叠加状态 0/1) - creator(模糊) - logistics_name(模糊) - item_part_type(等值) - item_part(模糊) - item_snapshot_key(模糊) - item_detail_machine(模糊) - distinguish_express(等值) - total_orders_min / total_orders_max(范围) - processed_orders_min / processed_orders_max(范围)"
}
],
"response": [
{
"name": "list",
"type": "array",
"required": true,
"description": "波次列表,包含波次基础信息与状态汇总(order_count / storage_assignment_status / express_assignment_status / print_assignment_status)"
},
{
"name": "pagination",
"type": "object",
"required": true,
"description": "分页信息(page、pageSize、total、totalPages、hasPrevious、hasNext)"
}
]
},
{
"method": "order.wave.batchCancel",
"title": "批量解除波次。传入 ids,清理订单波次ID,并将命中的波次状态置为 -1(已取消)。仅作用于当前登录仓库。",
"description": "批量解除波次。传入 ids,清理订单波次ID,并将命中的波次状态置为 -1(已取消)。仅作用于当前登录仓库。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array|string|number",
"required": true,
"description": "波次ID列表;支持数组、逗号分隔字符串或单个ID"
}
],
"response": [
{
"name": "ids",
"type": "array",
"required": false,
"description": "归一化后的请求ID列表"
},
{
"name": "affected_wave_ids",
"type": "array",
"required": false,
"description": "实际命中的波次ID列表"
},
{
"name": "affected_order_count",
"type": "number",
"required": false,
"description": "被清理 wave_id 的订单数量"
},
{
"name": "canceled_wave_count",
"type": "number",
"required": false,
"description": "实际置为 -1 的波次数量"
}
]
},
{
"method": "order.wave.fetch",
"title": "提交波次抓取任务:该接口为异步任务提交接口,立即返回任务已受理的信息,后端异步执行实际抓取,不在接口同步返回抓取结果。客户端可通过任务 ID 或调用 order.wave.fetchTaskProgress 查询任务状态与进度。",
"description": "提交波次抓取任务:该接口为异步任务提交接口,立即返回任务已受理的信息,后端异步执行实际抓取,不在接口同步返回抓取结果。客户端可通过任务 ID 或调用 order.wave.fetchTaskProgress 查询任务状态与进度。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "structure_list",
"type": "array",
"required": true,
"description": "结构请求数组;每项必须包含 item_detail_machine(由 buildMachineStructureToken 生成的结构标识),可选 quantity(未传入时使用仓库默认或全局默认)"
}
],
"response": [
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务 ID(后端生成的唯一标识,用于查询任务状态或结果)"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "生效的仓库 ID"
},
{
"name": "structure_count",
"type": "number",
"required": true,
"description": "本次入参的结构数量(structure_list 长度)"
},
{
"name": "default_quantity",
"type": "number",
"required": true,
"description": "仓库默认抓取数量或全局默认值"
},
{
"name": "auto_fetch_disabled_marker",
"type": "string",
"required": true,
"description": "手动抓取标记;值为 'wave_manual_fetch' 表示手动抓取"
},
{
"name": "message",
"type": "string",
"required": false,
"description": "受理信息提示,通常为 '任务已提交,后端异步处理中' 或失败/错误说明"
}
]
},
{
"method": "order.wave.fetchTaskProgress",
"title": "查询波次抓取任务进度:按 task_id 查询任务状态与进度;兼容 taskId 参数名。",
"description": "查询波次抓取任务进度:按 task_id 查询任务状态与进度;兼容 taskId 参数名。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "task_id / taskId",
"type": "string",
"required": true,
"description": "任务 ID(后端生成的唯一标识),兼容旧参数名 taskId,可从 order.wave.fetch 的返回值中获取"
}
],
"response": [
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务 ID"
},
{
"name": "status",
"type": "string",
"required": true,
"description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)"
},
{
"name": "warehouse_id",
"type": "number",
"required": false,
"description": "生效的仓库 ID(若任务关联仓库时返回)"
},
{
"name": "structure_count",
"type": "number",
"required": false,
"description": "本次任务的结构数量(structure_list 长度)"
},
{
"name": "finished_structure_count",
"type": "number",
"required": false,
"description": "已完成抓取的结构数量"
},
{
"name": "progress_percent",
"type": "number",
"required": false,
"description": "进度百分比(0-100,可能为小数)"
},
{
"name": "total_fetched_quantity",
"type": "number",
"required": false,
"description": "已抓取的总件数"
},
{
"name": "duration_ms",
"type": "number",
"required": false,
"description": "任务已运行时长,毫秒级"
},
{
"name": "error",
"type": "string",
"required": false,
"description": "错误信息,仅当 status=failed 时返回"
},
{
"name": "update_time",
"type": "string",
"required": false,
"description": "最近一次状态更新时间,ISO8601 字符串"
},
{
"name": "message",
"type": "string",
"required": false,
"description": "额外提示信息"
}
]
},
{
"method": "order.wave.batchAutoGrouping",
"title": "批量将波次状态修改为 0(自动加团中),仅作用当前登录仓库命中的波次。限制条件: - 跳过已打印及之后状态的波次(wave_status >= 2); - 跳过 total_orders >= 仓库配置 max_wave_quantity 的波次。被跳过的波次不会被修改为自动加团中。",
"description": "批量将波次状态修改为 0(自动加团中),仅作用当前登录仓库命中的波次。限制条件: - 跳过已打印及之后状态的波次(wave_status >= 2); - 跳过 total_orders >= 仓库配置 max_wave_quantity 的波次。被跳过的波次不会被修改为自动加团中。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array|string|number",
"required": true,
"description": "波次ID 列表;支持数组、逗号分隔字符串或单个ID"
}
],
"response": [
{
"name": "ids",
"type": "array",
"required": false,
"description": "归一化后的请求ID"
},
{
"name": "affected_wave_ids",
"type": "array",
"required": false,
"description": "实际命中的波次ID"
},
{
"name": "updated_wave_count",
"type": "number",
"required": false,
"description": "实际更新数量"
},
{
"name": "skipped_wave_ids",
"type": "array",
"required": false,
"description": "被跳过的波次ID数组(不修改状态)"
},
{
"name": "skipped_wave_count",
"type": "number",
"required": false,
"description": "被跳过的波次数量"
},
{
"name": "skipped_details",
"type": "array",
"required": false,
"description": "被跳过的波次明细數組,元素包含 wave_id 与 reason,reason 枚举 printed_or_after_printed / reach_max_wave_quantity"
}
]
},
{
"method": "order.wave.batchFinishAutoGrouping",
"title": "批量结束自动加团,将当前仓库命中且 wave_status=0 的波次改为 1(已就绪)。",
"description": "批量结束自动加团,将当前仓库命中且 wave_status=0 的波次改为 1(已就绪)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array|string|number",
"required": true,
"description": "波次ID 列表;支持数组、逗号分隔字符串或单个ID"
}
],
"response": [
{
"name": "ids",
"type": "array",
"required": false,
"description": "归一化后的请求ID"
},
{
"name": "affected_wave_ids",
"type": "array",
"required": false,
"description": "实际命中的波次ID"
},
{
"name": "updated_wave_ids",
"type": "array",
"required": false,
"description": "实际更新为已就绪的波次ID"
},
{
"name": "updated_wave_count",
"type": "number",
"required": false,
"description": "实际更新数量"
}
]
},
{
"method": "order.wave.batchRemoveOrders",
"title": "按订单ID批量移出波次;仅处理当前仓库的待处理订单表中非待审核订单(step in [1,2,3])。操作会清空订单的 wave_id/wave_no,并在同一事务内回写 wms_wave_batch 表:重算 total_orders,若波次被清空则将 wave_status 置为 -1。仓库上下文来自当前登录用户(ctx.user.store_id)。",
"description": "按订单ID批量移出波次;仅处理当前仓库的待处理订单表中非待审核订单(step in [1,2,3])。操作会清空订单的 wave_id/wave_no,并在同一事务内回写 wms_wave_batch 表:重算 total_orders,若波次被清空则将 wave_status 置为 -1。仓库上下文来自当前登录用户(ctx.user.store_id)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids / order_ids / orderIds / order_id / orderId / id",
"type": "array|string|number",
"required": true,
"description": "订单 ID 列表;支持数组、逗号分隔字符串或单个 ID,以上别名均可用(ids、order_ids、orderIds、order_id、orderId、id)"
}
],
"response": [
{
"name": "ids",
"type": "array",
"required": true,
"description": "归一化后的请求 ID 列表"
},
{
"name": "removed_order_ids",
"type": "array",
"required": true,
"description": "实际被移出波次的订单 ID 列表"
},
{
"name": "removed_order_count",
"type": "number",
"required": true,
"description": "被移出波次的订单数量"
},
{
"name": "affected_wave_ids",
"type": "array",
"required": true,
"description": "本次操作涉及的波次 ID 列表"
},
{
"name": "updated_wave_ids",
"type": "array",
"required": true,
"description": "实际更新了 total_orders 的波次 ID 列表"
},
{
"name": "emptied_wave_ids",
"type": "array",
"required": true,
"description": "被清空且已置为 wave_status=-1 的波次 ID 列表"
}
]
}
]
}

View File

@ -0,0 +1,12 @@
{
"module": {
"name": "拣货模块",
"key": "pick",
"folder": "pick"
},
"status": "active",
"createdAt": "2026-05-04 17:23:48",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -0,0 +1,109 @@
{
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {
"value": "web",
"label": "网页端"
},
"project": {
"value": "all",
"label": "全部"
}
},
"module": {
"name": "拣货模块",
"key": "pick",
"folder": "pick",
"interfaceCount": 1
},
"changes": {
"fromPreviousSnapshot": {
"moduleAdded": true,
"moduleRenamed": false,
"interfaceChanges": {
"addedMethods": [
"pick.query"
],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
}
},
"interfaces": [
{
"method": "pick.query",
"title": "按订单查询波次拣货信息,支持 full/full_display/is_full 控制是否完整显示;接口按当前登录用户仓库上下文过滤,防止跨仓越界。",
"description": "按订单查询波次拣货信息,支持 full/full_display/is_full 控制是否完整显示;接口按当前登录用户仓库上下文过滤,防止跨仓越界。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "waybill_code",
"type": "string",
"required": true,
"description": "快递号/运单号,必填。"
},
{
"name": "full_display",
"type": "boolean",
"required": false,
"description": "是否完整显示拣货明细;默认 false。true 返回全部拣货明细,false 仅返回未完成的(inspection_status != 'fin')。"
}
],
"response": [
{
"name": "order_id",
"type": "string|number",
"required": false,
"description": "订单 ID"
},
{
"name": "wave_id",
"type": "number",
"required": false,
"description": "波次 ID(若订单未关联波次则为空)"
},
{
"name": "wave_no",
"type": "string",
"required": false,
"description": "波次编号(若订单未关联波次则为空)"
},
{
"name": "full_display",
"type": "boolean",
"required": false,
"description": "是否以完整明细展示(等同于请求中的 full/full_display/is_full)"
},
{
"name": "summary",
"type": "object",
"required": false,
"description": "汇总信息"
},
{
"name": "list",
"type": "array",
"required": false,
"description": "拣货明细列表(根据 full 参数返回全量或仅未复核明细),每项为明细对象,字段视实现而定。"
}
]
}
]
}

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:37:49",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 20:21:27",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:16:50",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -0,0 +1,12 @@
{
"module": {
"name": "仓库设置模块",
"key": "setting.warehouse",
"folder": "setting.warehouse"
},
"status": "active",
"createdAt": "2026-05-04 09:11:04",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -0,0 +1,159 @@
{
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {
"value": "web",
"label": "网页端"
},
"project": {
"value": "all",
"label": "全部"
}
},
"module": {
"name": "仓库设置模块",
"key": "setting.warehouse",
"folder": "setting.warehouse",
"interfaceCount": 3
},
"changes": {
"fromPreviousSnapshot": {
"moduleAdded": false,
"moduleRenamed": false,
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
}
},
"interfaces": [
{
"method": "setting.warehouse.getSettings",
"title": "获取当前登录仓库的 subject_config",
"description": "获取当前登录仓库的 subject_config",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [],
"response": [
{
"name": "warehouse_id",
"type": "number",
"required": false,
"description": "仓库 ID"
},
{
"name": "subject_config",
"type": "object",
"required": false,
"description": "仓库的 subject_config 配置对象"
}
]
},
{
"method": "setting.warehouse.getFieldMeta",
"title": "获取仓库设置字段元信息",
"description": "获取仓库设置字段元信息",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [],
"response": [
{
"name": "list",
"type": "array",
"required": false,
"description": "字段元信息数组"
}
]
},
{
"method": "setting.warehouse.saveSettings",
"title": "修改仓库设置并清理指定仓库缓存",
"description": "修改仓库设置并清理指定仓库缓存",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "subject_config",
"type": "object",
"required": true,
"description": "仓库的 subject_config 对象"
},
{
"name": "cache_warehouse_id",
"type": "number",
"required": false,
"description": "需清理缓存的仓库 ID(下划线命名兼容)"
},
{
"name": "cacheWarehouseId",
"type": "number",
"required": false,
"description": "需清理缓存的仓库 ID(驼峰命名兼容)"
}
],
"response": [
{
"name": "warehouse_id",
"type": "number",
"required": false,
"description": "生效的仓库 ID"
},
{
"name": "subject_config",
"type": "object",
"required": false,
"description": "保存后的 subject_config"
},
{
"name": "cache_cleared_warehouse_id",
"type": "number",
"required": false,
"description": "被清理缓存的仓库 ID(若未清理则为 null)"
}
]
}
]
}

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {
@ -16,7 +16,7 @@
"name": "商品模块",
"key": "stock",
"folder": "stock",
"interfaceCount": 23
"interfaceCount": 21
},
"changes": {
"fromPreviousSnapshot": {
@ -24,7 +24,10 @@
"moduleRenamed": false,
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [],
"deletedMethods": [
"stock.stockWarehouse",
"stock.warehouse.getStockDetail"
],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
@ -589,101 +592,6 @@
"description": "本次返回的记录条数(≤50)"
}
]
},
{
"method": "stock.warehouse.getStockDetail",
"title": "查询商品的库存明细,返回 wms_storage 表的数据(按库位/批次维度展示库存分布)",
"description": "查询商品的库存明细,返回 wms_storage 表的数据(按库位/批次维度展示库存分布)",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "stock_id",
"type": "number",
"required": true,
"description": "商品库存ID(stock_warehouse.id)"
},
{
"name": "pagination",
"type": "object",
"required": false,
"description": "分页参数,含 page(页码,默认1)和 pageSize(每页条数,默认20)"
},
{
"name": "group_by_batch",
"type": "boolean",
"required": false,
"description": "是否区分批次。false(默认)时按库位合并数量,批次相关字段(batch_no, production_date, expiry_date, inbound_time, inbound_order_no, supplier_batch_no)置 null;true 时按原逻辑返回每条明细"
}
],
"response": [
{
"name": "stockItem",
"type": "object",
"required": false,
"description": "商品概要信息,含 id, item_code, item_name, sku_property, stock_unit, quantity, locked_quantity"
},
{
"name": "storageList",
"type": "array",
"required": false,
"description": "库存明细数组,每条含 id, space_id, batch_no, inventory_type, quantity, locked_quantity, available_quantity, production_date, expiry_date, inbound_time, inbound_order_no, supplier_batch_no, created_at,关联 space 对象(id, space_code, custom_name)。当 group_by_batch=false 时,批次相关字段为 null"
},
{
"name": "pagination",
"type": "object",
"required": false,
"description": "分页信息,含 page, pageSize, total"
}
]
},
{
"method": "stock.stockWarehouse",
"title": "仓库商品列表查询兼容入口(等同于 stock.warehouse.list)",
"description": "仓库商品列表查询兼容入口(等同于 stock.warehouse.list)",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "pagination",
"type": "object",
"required": false,
"description": "分页参数"
},
{
"name": "where",
"type": "object",
"required": false,
"description": "筛选条件,写法与 stock.warehouse.list 一致"
}
],
"response": []
}
]
}

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {
@ -465,11 +465,29 @@
}
],
"params": [
{
"name": "id",
"type": "number|string",
"required": false,
"description": "收货单ID(与 receiving_id 二选一)"
},
{
"name": "receiving_id",
"type": "number|string",
"required": true,
"description": "收货单ID"
"required": false,
"description": "收货单ID(兼容字段,与 id 二选一)"
},
{
"name": "page",
"type": "number",
"required": false,
"description": "页码(兼容顶层分页入参)"
},
{
"name": "pageSize",
"type": "number",
"required": false,
"description": "每页数量(兼容顶层分页入参)"
},
{
"name": "pagination",

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {
@ -33,8 +33,8 @@
"interfaces": [
{
"method": "store.createStore",
"title": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB",
"description": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB",
"title": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13",
"description": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -74,14 +74,26 @@
"type": "string",
"required": false,
"description": "默认平台编码,缺省为 TB"
},
{
"name": "subject_config.group_wave_prefix",
"type": "string",
"required": false,
"description": "团购波次前缀,最多 5 个字符,默认 B"
},
{
"name": "subject_config.min_group_order_fetch_quantity",
"type": "number",
"required": false,
"description": "最小团购订单抓取数量,默认 13"
}
],
"response": []
},
{
"method": "store.createWarehouse",
"title": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB",
"description": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB",
"title": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13",
"description": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -121,6 +133,18 @@
"type": "string",
"required": false,
"description": "默认平台编码,缺省为 TB"
},
{
"name": "subject_config.group_wave_prefix",
"type": "string",
"required": false,
"description": "团购波次前缀,最多 5 个字符,默认 B"
},
{
"name": "subject_config.min_group_order_fetch_quantity",
"type": "number",
"required": false,
"description": "最小团购订单抓取数量,默认 13"
}
],
"response": []

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-05-02 09:08:01",
"updatedAt": "2026-05-04 17:23:48",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-05-02 09:08:01",
"generatedAtLocal": "2026-05-02 09:08:01",
"generatedAt": "2026-05-04 17:23:48",
"generatedAtLocal": "2026-05-04 17:23:48",
"source": "remote",
"filter": {
"platform": {