454 lines
13 KiB
TypeScript
454 lines
13 KiB
TypeScript
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)
|
||
}
|