WEB/src/api/order/packing/index.ts
2026-09-02 18:02:26 +08:00

272 lines
7.0 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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)
}