WEB/src/api/order.recheckorder/recheckOrder.ts
2026-06-21 18:21:10 +08:00

454 lines
13 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'
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<string, string> {
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<string, unknown> | null
/** 无波次时单订单详情模式 */
detail?: Record<string, unknown>
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<number | string>
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<ScanOrderSingleListItem | ScanOrderGroupListItem | Record<string, unknown>>
/** 历史兼容:车号命中旧结构 */
cart_match_view?: Record<string, unknown> | null
order_id?: number | string
order?: Record<string, unknown>
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<string, unknown>
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<string, unknown> | null {
return v && typeof v === 'object' && !Array.isArray(v) ? (v as Record<string, unknown>) : null
}
function normalizeStockRows(raw: unknown): Record<string, unknown>[] {
if (!Array.isArray(raw)) return []
return raw
.filter((item) => item && typeof item === 'object' && !Array.isArray(item))
.map((item) => {
const row = item as Record<string, unknown>
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<string, unknown> {
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<string, unknown> {
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<string, unknown>) {
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<any> {
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<any> {
return scanOrder(data)
}
export type RecheckScanTaskParams = {
task_id: number
}
/** order.recheckOrder.scanTask:按拣货任务 ID 拉取复核扫描视图 */
export function scanTask(data: RecheckScanTaskParams): Promise<any> {
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<string, string | number> {
// 团购波次模式:优先使用 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<any> {
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<any> {
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<any> {
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<any> {
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)
}