272 lines
7.0 KiB
TypeScript
272 lines
7.0 KiB
TypeScript
import request from '@/utils/request'
|
||
|
||
const v = '1.0'
|
||
|
||
/** 打包任务列表查询参数 */
|
||
export type PackingListParams = {
|
||
/** 仓库ID(按仓库维度查询,必填) */
|
||
warehouse_id?: number | string
|
||
pagination?: {
|
||
page?: number
|
||
pageSize?: number
|
||
}
|
||
where?: PackingListWhere
|
||
sort?: PackingListSort
|
||
}
|
||
|
||
/** 打包任务列表 where 条件 */
|
||
export type PackingListWhere = {
|
||
/** 任务状态:0=待处理 1=打包中 2=已完成 3=异常 */
|
||
status?: number | string
|
||
/** 打包模式:1=散单 2=团购 */
|
||
pack_mode?: number | string
|
||
/** 运单号(模糊匹配) */
|
||
waybill_code?: string
|
||
/** 波次号(模糊匹配) */
|
||
wave_no?: string
|
||
/** 订单ID(精确匹配) */
|
||
order_id?: number | string
|
||
/** 工作台ID(精确匹配) */
|
||
workbench_id?: number | string
|
||
/** 快捷搜索:运单号/波次号模糊匹配 */
|
||
quickWhere?: string
|
||
/** 开始打包时间范围-起始 */
|
||
start_time_start?: string
|
||
/** 开始打包时间范围-结束 */
|
||
start_time_end?: string
|
||
[key: string]: any
|
||
}
|
||
|
||
/** 打包任务列表排序 */
|
||
export type PackingListSort = {
|
||
sortField?: string
|
||
sortOrder?: 'ASC' | 'DESC' | 'asc' | 'desc'
|
||
}
|
||
|
||
/** 打包任务列表项 */
|
||
export type PackingTaskItem = {
|
||
id?: number
|
||
order_id?: number | string
|
||
warehouse_id?: number | string
|
||
workbench_id?: number | string
|
||
wave_id?: number | string
|
||
wave_no?: string
|
||
waybill_code?: string
|
||
pack_quantity?: number
|
||
pack_mode?: number | string
|
||
status?: number | string
|
||
start_time?: string
|
||
end_time?: string
|
||
create_time?: string
|
||
update_time?: string
|
||
[key: string]: any
|
||
}
|
||
|
||
/** 打包任务列表响应 */
|
||
export type PackingListResponse = {
|
||
list: PackingTaskItem[]
|
||
pagination: {
|
||
page?: number
|
||
pageSize?: number
|
||
total?: number
|
||
totalPages?: number
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 打包任务列表查询(仓库侧)
|
||
* 按仓库维度查询 wms_pack_task 表,支持分页、筛选、排序
|
||
*/
|
||
export function packingList(data: PackingListParams = {}): Promise<{
|
||
code: number
|
||
message: string
|
||
data: PackingListResponse
|
||
}> {
|
||
return request({
|
||
url: '/system',
|
||
method: 'post',
|
||
params: {
|
||
method: 'order.packing.list',
|
||
v,
|
||
timestamp: new Date().getTime()
|
||
},
|
||
data,
|
||
isSystemApi: true
|
||
} as any)
|
||
}
|
||
|
||
/**
|
||
* 打包任务详情查询(仓库侧)
|
||
* 按打包任务ID + 仓库维度查询单条打包任务记录
|
||
*/
|
||
export function packingGet(id: number): Promise<{
|
||
code: number
|
||
message: string
|
||
data: PackingTaskItem
|
||
}> {
|
||
return request({
|
||
url: '/system',
|
||
method: 'post',
|
||
params: {
|
||
method: 'order.packing.get',
|
||
v,
|
||
timestamp: new Date().getTime()
|
||
},
|
||
data: { id },
|
||
isSystemApi: true
|
||
} as any)
|
||
}
|
||
|
||
/** order.packing.setEndTime 请求参数 */
|
||
export type PackingSetEndTimeParams = {
|
||
/** 打包任务ID(必填) */
|
||
id: number
|
||
/** 结束时间(ISO 8601 格式,如 2026-07-27T11:00:00.000Z,必填) */
|
||
end_time: string
|
||
}
|
||
|
||
/** order.packing.setEndTime 响应 */
|
||
export type PackingSetEndTimeResponse = {
|
||
id: number
|
||
end_time: string
|
||
status: number
|
||
}
|
||
|
||
/**
|
||
* 设置打包任务结束时间
|
||
* 若任务状态不是已完成(2),则同步更新状态为已完成
|
||
*/
|
||
export function packingSetEndTime(data: PackingSetEndTimeParams): Promise<{
|
||
code: number
|
||
message: string
|
||
data: PackingSetEndTimeResponse
|
||
}> {
|
||
return request({
|
||
url: '/system',
|
||
method: 'post',
|
||
params: {
|
||
method: 'order.packing.setEndTime',
|
||
v,
|
||
timestamp: new Date().getTime()
|
||
},
|
||
data,
|
||
isSystemApi: true
|
||
} as any)
|
||
}
|
||
|
||
/** order.packing.forceRecord 请求参数 */
|
||
export type PackingForceRecordParams = {
|
||
/** 打包任务ID(必填) */
|
||
id: number
|
||
}
|
||
|
||
/** order.packing.forceRecord 响应 */
|
||
export type PackingForceRecordResponse = {
|
||
pack_task_id: number
|
||
computer_id: number
|
||
}
|
||
|
||
/**
|
||
* 强制重新录制打包任务视频
|
||
* 将任务推送到录制电脑,通过打印服务触发重新录制
|
||
*/
|
||
export function packingForceRecord(data: PackingForceRecordParams): Promise<{
|
||
code: number
|
||
message: string
|
||
data: PackingForceRecordResponse
|
||
}> {
|
||
return request({
|
||
url: '/system',
|
||
method: 'post',
|
||
params: {
|
||
method: 'order.packing.forceRecord',
|
||
v,
|
||
timestamp: new Date().getTime()
|
||
},
|
||
data,
|
||
isSystemApi: true
|
||
} as any)
|
||
}
|
||
|
||
/** order.packing.export 请求参数(where/sort 语义与 order.packing.list 一致;warehouse_id 由服务端注入,禁止前端传入) */
|
||
export type PackingExportParams = {
|
||
/** 查询条件,语义与 order.packing.list 的 where 一致;禁止传 warehouse_id/warehouseId(服务端注入) */
|
||
where?: Record<string, any>
|
||
/** 排序参数:sortField + sortOrder(asc/desc) */
|
||
sort?: PackingListSort
|
||
}
|
||
|
||
/** order.packing.export 响应(提交成功即返回任务受理信息) */
|
||
export type PackingExportResponse = {
|
||
/** 任务 ID(后端生成,格式 packing_export_{warehouseId}_{timestamp}_{random}) */
|
||
task_id: string
|
||
/** 任务状态:submitted/running/success/failed/not_found(提交成功时为 submitted) */
|
||
status: string
|
||
/** 当前进度百分比(0-100),提交时返回 0 */
|
||
progress: number
|
||
/** 当前已处理记录数(打包任务条数) */
|
||
current_count: number
|
||
/** 总记录数 */
|
||
total_count: number
|
||
/** 任务提示信息 */
|
||
message: string
|
||
/** 任务执行结果(提交时为 null;完成后为上传信息对象) */
|
||
result: Record<string, unknown> | null
|
||
/** 失败时的错误信息 */
|
||
error: string
|
||
/** 任务更新时间(Unix 毫秒时间戳) */
|
||
update_time: number
|
||
}
|
||
|
||
/**
|
||
* order.packing.export:提交打包任务导出任务(异步,立即返回 task_id)
|
||
* 后台异步生成单 Sheet Excel 并上传,导出进度/下载经 order.packing.exportTaskProgress 查询;免权限免日志口径与 order.export 一致
|
||
*/
|
||
export function packingExport(data: PackingExportParams = {}): Promise<{
|
||
code: number
|
||
message: string
|
||
data: PackingExportResponse
|
||
}> {
|
||
return request({
|
||
url: '/system',
|
||
method: 'post',
|
||
params: {
|
||
method: 'order.packing.export',
|
||
v,
|
||
timestamp: new Date().getTime()
|
||
},
|
||
data,
|
||
isSystemApi: true
|
||
} as any)
|
||
}
|
||
|
||
/** order.packing.exportTaskProgress 请求参数 */
|
||
export type PackingExportTaskProgressParams = {
|
||
/** 任务 ID(下划线写法,兼容) */
|
||
task_id?: string
|
||
/** 任务 ID(驼峰写法,兼容) */
|
||
taskId?: string
|
||
}
|
||
|
||
/**
|
||
* order.packing.exportTaskProgress:按 task_id 查询打包任务导出任务进度
|
||
* 上传完成后返回 download_url;task_id 缺失或缓存未命中时 status=not_found(正常响应);免权限免日志口径与 order.exportTaskProgress 一致
|
||
*/
|
||
export function packingExportTaskProgress(data: PackingExportTaskProgressParams): Promise<{
|
||
code: number
|
||
message: string
|
||
data: PackingExportResponse & { download_url: string }
|
||
}> {
|
||
return request({
|
||
url: '/system',
|
||
method: 'post',
|
||
params: {
|
||
method: 'order.packing.exportTaskProgress',
|
||
v,
|
||
timestamp: new Date().getTime()
|
||
},
|
||
data,
|
||
isSystemApi: true
|
||
} as any)
|
||
}
|