import request from '@/utils/request' import { orderUpdateExpressWeighingWeight, type UpdateExpressWeighingWeightParams, type UpdateExpressWeighingWeightResponse, type UpdateExpressWeighingWeightSplitItem } from '@/api/order.index/orderindex' const v = '1.0' /** 扫描关键词;支持 keyword、value、运单号、波次号与车号别名(见 order.recheckorder module.json) */ export type RecheckScanOrderParams = { keyword?: string value?: string waybill_no?: string waybillCode?: string waybill_code?: string wave_no?: string waveNo?: string cart_code?: string cartCode?: string } const SCAN_ORDER_FIELD_KEYS: (keyof RecheckScanOrderParams)[] = [ 'keyword', 'value', 'waybill_no', 'waybillCode', 'waybill_code', 'wave_no', 'waveNo', 'cart_code', 'cartCode' ] function pickScanOrderBody(data: RecheckScanOrderParams): Record { for (const key of SCAN_ORDER_FIELD_KEYS) { const raw = data[key] if (raw !== undefined && raw !== null && String(raw).trim() !== '') { return { [key]: String(raw).trim() } } } throw new Error( '扫描关键词不能为空(keyword / value / waybill_no / waybillCode / waybill_code / wave_no / waveNo / cart_code / cartCode)' ) } /** 散单 list 项(有波次时的扁平订单) */ export type ScanOrderSingleListItem = { order_id?: number delivery_order_code?: string waybill_no?: string pick_status?: string is_printed?: boolean | number | string is_reviewed?: boolean | number | string shop_nick?: string items_count?: number wave_index?: number | string recheck_status?: string order_type?: string status?: string logistics_name?: string store_remark?: string intercept_status?: string stock?: unknown[] /** 订单商品总重量(kg) */ items_weight?: number | string /** 推荐包材信息,无推荐时为 null */ suggested_package_material?: Record | null /** 无波次时单订单详情模式 */ detail?: Record items?: unknown[] expresses?: unknown[] logs?: unknown[] } /** 团购 list 项(波次视图) */ export type ScanOrderGroupListItem = { wave_id?: number wave_no?: string wave_type?: number wave_status?: string total_orders?: number processed_orders?: number creator?: string create_time?: string update_time?: string order_count?: number pick_mode?: number box_no?: string order_ids?: Array orders_detail?: unknown[] orders?: unknown[] stocks?: unknown[] recheck_status?: string is_reviewed?: boolean | number | string } /** scanOrder / scanTask 成功时服务端字段(与 order.recheckOrder.scanOrder 响应对齐) */ export type ScanOrderResultShape = { match_type?: 'waybill' | 'wave' | 'cart' | 'task' | string list_type?: 'single' | 'group' | string waybill_no?: string task_id?: number | null picker_id?: number | null picker_name?: string wave_id?: number wave_no?: string wave_type?: number pick_mode?: number strategy_id?: number | null strategy_name?: string total_orders?: number reviewed_count?: number unreviewed_count?: number list?: Array> /** 历史兼容:车号命中旧结构 */ cart_match_view?: Record | null order_id?: number | string order?: Record items?: unknown[] expresses?: unknown[] logs?: unknown[] } export function isRecheckApiSuccess(res: unknown) { const r = res as { code?: number; flag?: string } | null | undefined return Boolean(r && (r.code === 1 || r.code === 200 || r.flag === 'success')) } /** 解包 scanOrder / scanTask 响应 data */ export function unwrapScanOrderResponse(res: unknown): ScanOrderResultShape { if (!res || typeof res !== 'object') return {} const r = res as Record const d = r.data if (d && typeof d === 'object' && !Array.isArray(d)) return d as ScanOrderResultShape return r as ScanOrderResultShape } function asRecord(v: unknown): Record | null { return v && typeof v === 'object' && !Array.isArray(v) ? (v as Record) : null } function normalizeStockRows(raw: unknown): Record[] { if (!Array.isArray(raw)) return [] return raw .filter((item) => item && typeof item === 'object' && !Array.isArray(item)) .map((item) => { const row = item as Record const barcodes = Array.isArray(row.barcodes) ? row.barcodes : row.barcode ? [row.barcode] : [] return { ...row, item_name: row.item_name || row.name || '', barcode: barcodes[0] || row.item_code || row.barcode || '', barcodes, plan_qty: row.plan_qty ?? row.qty ?? row.quantity, images: Array.isArray(row.images) ? row.images : [], has_shared_barcode: !!row.has_shared_barcode } }) } /** 是否为无波次时的单订单详情 list 项(含 detail/items/expresses/logs) */ export function isScanOrderDetailListItem(item: unknown): boolean { const row = asRecord(item) if (!row) return false return Boolean(row.detail || row.items || row.expresses || row.logs) } /** 将 scanOrder list 项规范化为面板订单行 */ export function normalizeScanOrderPanelRow(item: unknown): Record { const row = asRecord(item) || {} if (isScanOrderDetailListItem(row)) { const detail = asRecord(row.detail) || row const items = Array.isArray(row.items) ? row.items : detail.items const stock = normalizeStockRows(items ?? detail.stock) return { ...detail, order_id: detail.order_id ?? detail.id ?? row.order_id, waybill_no: String( detail.waybill_no ?? detail.waybillCode ?? detail.waybill_code ?? row.waybill_no ?? '' ).trim(), stock, expresses: Array.isArray(row.expresses) ? row.expresses : detail.expresses, logs: Array.isArray(row.logs) ? row.logs : detail.logs } } const stock = normalizeStockRows(row.stock ?? row.stocks) return { ...row, order_id: row.order_id ?? row.id, waybill_no: String(row.waybill_no ?? row.waybillCode ?? row.waybill_code ?? '').trim(), stock: stock.length ? stock : normalizeStockRows(row.stocks) } } /** 将 scanOrder 团购波次 list 项规范化为面板行 */ export function normalizeScanOrderGroupWaveRow(wave: unknown): Record { const w = asRecord(wave) || {} const stocks = normalizeStockRows(w.stocks) const totalOrders = Number(w.total_orders ?? w.order_count ?? 0) const processedOrders = Number(w.processed_orders ?? 0) const recheckStatus = String( w.recheck_status ?? (processedOrders >= totalOrders && totalOrders > 0 ? 'fin' : '') ).trim() return { ...w, _is_wave: true, waybill_no: String(w.wave_no ?? '').trim(), id: w.wave_id, order_id: w.wave_id, order_ids: Array.isArray(w.order_ids) ? w.order_ids : [], orders_detail: Array.isArray(w.orders_detail) ? w.orders_detail : w.orders, stock: stocks, recheck_status: recheckStatus, is_reviewed: w.is_reviewed ?? (processedOrders >= totalOrders && totalOrders > 0) } } export function isOrderRecheckFinished(row: Record) { const status = String(row.recheck_status ?? row.is_reviewed ?? '').trim() return status === 'fin' || status === 'true' || row.is_reviewed === true } /** confirmRecheck 成功时服务端常用字段 */ export type ConfirmRecheckResultShape = { order_id?: number waybill_no?: string recheck_status?: string recheck_time?: string review_no?: string reviewNo?: string } /** order.recheckOrder.scanOrder:扫码查询订单(运单号或车号) */ export function scanOrder(data: RecheckScanOrderParams): Promise { return request({ url: '/system', method: 'post', params: { method: 'order.recheckOrder.scanOrder', v, timestamp: Date.now() }, data: pickScanOrderBody(data), isSystemApi: true } as any) } /** @deprecated 接口已下线,请使用 scanOrder */ export function scanWaybill(data: RecheckScanOrderParams): Promise { return scanOrder(data) } export type RecheckScanTaskParams = { task_id: number } /** order.recheckOrder.scanTask:按拣货任务 ID 拉取复核扫描视图 */ export function scanTask(data: RecheckScanTaskParams): Promise { return request({ url: '/system', method: 'post', params: { method: 'order.recheckOrder.scanTask', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** 订单 ID;优先 order_id,兼容 id、orderId;团购模式支持 wave_id */ export type ConfirmRecheckParams = { order_id?: string | number id?: string | number orderId?: string | number wave_id?: string | number } function coerceOrderId(v: string | number): string | number { if (typeof v === 'number' && Number.isFinite(v)) return v const s = String(v).trim() const n = Number(s) if (Number.isFinite(n) && String(n) === s) return n return s } function pickConfirmRecheckBody(data: ConfirmRecheckParams): Record { // 团购波次模式:优先使用 wave_id if (data.wave_id !== undefined && data.wave_id !== null && `${data.wave_id}`.trim() !== '') { return { wave_id: coerceOrderId(data.wave_id) } } const raw = data.order_id !== undefined && data.order_id !== null && `${data.order_id}`.trim() !== '' ? data.order_id : data.id !== undefined && data.id !== null && `${data.id}`.trim() !== '' ? data.id : data.orderId !== undefined && data.orderId !== null && `${data.orderId}`.trim() !== '' ? data.orderId : undefined if (raw === undefined) { throw new Error('订单 ID 不能为空(order_id / id / orderId / wave_id)') } return { order_id: coerceOrderId(raw) } } /** order.recheckOrder.confirmRecheck:按订单 ID 确认复核并记录复核任务 */ export function confirmRecheck(data: ConfirmRecheckParams): Promise { return request({ url: '/system', method: 'post', params: { method: 'order.recheckOrder.confirmRecheck', v, timestamp: Date.now() }, data: pickConfirmRecheckBody(data), isSystemApi: true } as any) } /** order.recheckOrder.batchQuickRecheck 请求参数 */ export type BatchQuickRecheckParams = { ids: number[] | string } /** order.recheckOrder.batchQuickRecheck 响应 data */ export type BatchQuickRecheckResponse = { success: unknown[] failed: unknown[] success_count: number failed_count: number } /** order.recheckOrder.batchQuickRecheck:批量快捷复核 */ export function batchQuickRecheck(data: BatchQuickRecheckParams): Promise { return request({ url: '/system', method: 'post', params: { method: 'order.recheckOrder.batchQuickRecheck', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } export type QueryRecheckOrderSingleListWhere = { keyword?: string wave_no?: string recheck_status?: string pick_status?: string } export type QueryRecheckOrderSingleListParams = { where?: QueryRecheckOrderSingleListWhere pagination?: { page?: number pageSize?: number } } export type RecheckOrderSingleListItem = { order_id?: number delivery_order_code?: string order_type?: string wave_id?: number wave_no?: string pick_status?: string recheck_status?: string shop_nick?: string logistics_name?: string items_count?: number items_total?: number items_weight?: number | string weight_type?: string status?: string create_at?: string pick_time?: string recheck_time?: string } export type QueryRecheckOrderSingleListResponse = { list: RecheckOrderSingleListItem[] pagination: { page?: number pageSize?: number total?: number totalPages?: number hasPrevious?: boolean hasNext?: boolean } } /** order.recheckOrder.queryRecheckOrderSingleList:散单模式复核列表查询 */ export function queryRecheckOrderSingleList( data: QueryRecheckOrderSingleListParams = {} ): Promise { return request({ url: '/system', method: 'post', params: { method: 'order.recheckOrder.queryRecheckOrderSingleList', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** order.recheckOrder.confirmIntercept:确认拦截,入参 order_id,匹配单个订单并标记拦截 */ export function confirmIntercept(data: ConfirmRecheckParams): Promise { return request({ url: '/system', method: 'post', params: { method: 'order.recheckOrder.confirmIntercept', v, timestamp: Date.now() }, data: pickConfirmRecheckBody(data), isSystemApi: true } as any) } export const orderRecheckOrder = { scanOrder, batchQuickRecheck, confirmRecheck, confirmIntercept, queryRecheckOrderSingleList } export type { UpdateExpressWeighingWeightParams, UpdateExpressWeighingWeightResponse, UpdateExpressWeighingWeightSplitItem } /** @deprecated 请使用 orderUpdateExpressWeighingWeight from @/api/order.index/orderindex */ export function updateExpressWeighingWeight(data: UpdateExpressWeighingWeightParams) { return orderUpdateExpressWeighingWeight(data) }