diff --git a/src/api/pick/pick.ts b/src/api/pick/pick.ts index 5f0abd5a..5201270f 100644 --- a/src/api/pick/pick.ts +++ b/src/api/pick/pick.ts @@ -96,17 +96,56 @@ export function pickWavePickTaskSubmit( } as any) } +/** pick.wavePickTaskComplete 请求参数(完全提交拣货任务) */ export type PickWavePickTaskCompleteParams = { + /** 拣货任务ID */ task_id: number + /** 提交模式:1=全部确认(默认),2=部分确认 */ mode?: number + /** 部分确认模式(mode=2)时必填;仅会确认命中当前任务的订单ID */ order_ids?: Array } +/** 被跳过的拦截订单明细(skipped_intercepted_orders 数组项) */ +export type PickWavePickTaskCompleteInterceptedOrder = { + /** 订单ID */ + order_id: number | string + /** 拦截状态 */ + intercept_status?: string | null + /** 面单打印状态:none/空 = 未打印(会被自动移出波次);其余 = 已打印(保持不动) */ + print_status?: string | null +} + +/** + * pick.wavePickTaskComplete 响应(2026-10-13 后端更新)。 + * + * 拦截订单处理语义: + * - 目标订单中已进入拦截流程的订单**直接跳过**(不完成拣货、不扣减库存、不报错) + * → `skipped_intercepted_order_ids` / `skipped_intercepted_orders` + * - 其中**未打印面单**(print_status = none/空)的拦截订单自动移出波次(wave_id 清零、删波次索引、 + * 回写波次统计、移除任务订单关联与篮子明细,写 ORDER_WAVE_REMOVE 日志、触发策略快扫) + * → `removed_from_wave_order_ids` + * - 其中**已打印面单**的拦截订单保持不动(保留波次/任务关联,需人工 wave.batchRemoveOrders 处理) + * → `kept_intercepted_order_ids` + */ export type PickWavePickTaskCompleteResponse = { + /** 拣货任务ID */ task_id: number + /** 实际生效的提交模式(1=全部确认,2=部分确认) */ mode: number + /** 本次成功确认的订单ID列表 */ confirmed_order_ids: Array + /** 被跳过(已进入拦截流程)的订单ID列表 */ + skipped_intercepted_order_ids: Array + /** 被跳过的拦截订单明细(每项含 order_id / intercept_status / print_status) */ + skipped_intercepted_orders: PickWavePickTaskCompleteInterceptedOrder[] + /** 被自动移出波次的「未打印面单」拦截订单ID列表 */ + removed_from_wave_order_ids: Array + /** 「已打印面单」保持不动的拦截订单ID列表(不自动移出波次,需人工 wave.batchRemoveOrders 处理) */ + kept_intercepted_order_ids: Array + /** 提交后任务是否已完成 */ is_completed: boolean + /** 任务订单拣货进度统计 */ progress: Record } @@ -140,7 +179,13 @@ export function pickWavePickComplete( } as any) } -/** pick.wavePickTaskComplete:完全提交拣货任务 */ +/** + * pick.wavePickTaskComplete:完全提交拣货任务。 + * 支持 mode=1 全部确认 / mode=2 部分确认(需传 order_ids);提交后按是否全部完成自动推进任务状态。 + * ⚠️ 后台抓取创建的任务(source=2)必须先绑定拣货车才能提交,否则返回 400。 + * ⚠️ 拦截订单不阻断提交:直接跳过,其中未打印面单的自动移出波次(removed_from_wave_order_ids), + * 已打印面单的保持不动(kept_intercepted_order_ids,需人工 wave.batchRemoveOrders 处理)。 + */ export function pickWavePickTaskComplete( data: PickWavePickTaskCompleteParams ): Promise }> { diff --git a/src/api/returnreceived/index.ts b/src/api/returnreceived/index.ts index d95e1c4c..be5db12b 100644 --- a/src/api/returnreceived/index.ts +++ b/src/api/returnreceived/index.ts @@ -38,8 +38,11 @@ export function returnReceivedCreate( /** returnReceived.list 的 where 筛选条件 */ export type ReturnReceivedListWhere = { - /** 退回收件运单号(模糊搜索,传 {operator:'like',value} 或直接值) */ - waybill_code?: string | { operator: string; value: any } + /** + * 退回收件运单号(模糊搜索,传 {operator:'like',value} 或直接值; + * **value 为数组时多值 OR 包含匹配**,用于多单号批量搜索) + */ + waybill_code?: string | string[] | { operator: string; value: any } /** 扫描日期范围 { operator:'between'|'gte'|'lte', value:[start,end] 或单值 } */ scan_date?: { operator: 'between' | 'gte' | 'lte'; value: [string, string] | string } /** 扫描人员工号ID(等值) */ @@ -226,9 +229,11 @@ export function returnReceivedDelete(data: ReturnReceivedDeleteParams): Promise< export type ReturnReceivedExportParams = { /** * 查询条件,语义与 returnReceived.list 的 where 一致;禁止传 warehouse_id/warehouseId(服务端注入)。 - * 支持字段:waybill_code(模糊)、scan_date/created_at/updated_at(范围)、 - * scanner_id/scanner_name/store_id/order_express_id/order_id/return_received_task_id(等值)、 - * is_original_return(是否原单退回) + * 支持 {operator,value} 标准结构或直接值;支持字段: + * - waybill_code 模糊(like 支持**数组多值 OR 包含**) + * - scan_date / created_at / updated_at 范围 + * - scanner_id / scanner_name / store_id / order_express_id / order_id / return_received_task_id 等值 + * - is_original_return 是否原单退回 */ where?: Record /** 排序参数,语义与 returnReceived.list 的 sort 一致(sortField 白名单 id/scan_date/created_at/updated_at/waybill_code,默认 created_at desc) */ diff --git a/src/api/returnwaybill/index.ts b/src/api/returnwaybill/index.ts index 85615930..071585d8 100644 --- a/src/api/returnwaybill/index.ts +++ b/src/api/returnwaybill/index.ts @@ -148,8 +148,11 @@ export function returnWaybillUpdate(data: ReturnWaybillUpdateParams): Promise