2026-08-25 18:14:47 +08:00

807 lines
20 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'
/** storage.entry.list 查询参数(pagination / where / sort) */
export type StorageEntryListPagination = {
page?: number
pageSize?: number
}
export type StorageEntryListWhere = Record<string, unknown> & {
/** 虚拟字段:true 仅已绑定收货单,false 仅未绑定 */
hasReceiving?: boolean
}
export type StorageEntryListItem = Record<string, unknown> & {
hasReceiving?: boolean
receivingBindings?: EntryOrderReceivingBinding[]
}
export type StorageEntryListSort = {
sortField?: string
sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC'
}
export type StorageEntryListParams = {
pagination?: StorageEntryListPagination
where?: StorageEntryListWhere
sort?: StorageEntryListSort
}
export type StorageEntryListResponse = {
code?: number
message?: string
list?: StorageEntryListItem[]
pagination?: {
page?: number
pageSize?: number
total?: number
totalPages?: number
hasPrevious?: boolean
hasNext?: boolean
}
summary?: {
total?: number
pending?: number
creating?: number
created?: number
completed?: number
cancelled?: number
}
data?: Partial<StorageEntryListResponse>
}
export function getEntryList(data: StorageEntryListParams = {}): Promise<StorageEntryListResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.list',
v,
timestamp: new Date().getTime(),
},
data,
})
}
/** storage.entry.listStore — 货主侧入库单列表(复用 list 的出入参结构) */
export function getEntryListStore(data: StorageEntryListParams = {}): Promise<StorageEntryListResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.listStore',
v,
timestamp: new Date().getTime(),
},
data,
})
}
export type GetEntryDetailParams = {
/** 入库单ID(必填) */
id: number
}
export type EntryDetailBinding = {
id?: number
entry_item_id?: number
receiving_detail_id?: number
allocated_quantity?: number
status?: string
receivingDetail?: Record<string, unknown>
[key: string]: unknown
}
export type EntryAvailableReceivingDetail = {
receiving_detail_id?: number
receiving_id?: number
receiving_number?: string
product_name?: string
actual_quantity?: number
stored_quantity?: number
allocated_quantity?: number
receiving_allocated?: number
available_quantity?: number
binding_id?: number
binding_status?: string
status?: string
batch_number?: string
production_date?: string
expiry_date?: string
[key: string]: unknown
}
export type EntryDetailItemBarcode = {
id?: number
barcode?: string
sku_property?: string
[key: string]: unknown
}
export type DirectInboundLog = {
id?: number
stock_id?: number
quantity?: number
inbound_type?: string
remark?: string
/** 存放库位ID,关联 wms_location_space.id */
space_id?: number
created_at?: string
warehouse_item_code?: string
warehouse_item_name?: string
[key: string]: unknown
}
export type EntryDetailItem = {
id?: number
stock_id?: number
external_item_code?: string
external_item_id?: number
warehouse_item_code?: string
warehouse_item_name?: string
warehouse_item_spec?: string
count?: number
received_quantity?: number
confirm_quantity?: number
warehouse_quantity?: number | null
warehouse_locked_quantity?: number | null
warehouse_is_batch_mgmt?: string | null
warehouse_is_shelf_life_mgmt?: string | null
warehouse_image_url?: string
warehouse_is_images?: string | null
barcodes?: EntryDetailItemBarcode[]
direct_inbound_quantity?: number
remaining_quantity?: number
/** 当前 pending 绑定的总预分配数量 */
pending_total?: number
/** 计划入库数量(= count) */
total_planned?: number
/** pending 绑定列表 */
bindings?: EntryDetailBinding[]
/** 可绑定/已绑定的收货明细(含可用量) */
available_receiving_details?: EntryAvailableReceivingDetail[]
/** 导入/PDA 入库记录(明细级) */
direct_logs?: DirectInboundLog[]
[key: string]: unknown
}
export type EntryOrderReceivingBinding = {
id?: number
receiving_id?: number
receiving?: {
id?: number
receiving_number?: string
status?: string
storage_status?: string
created_at?: string
[key: string]: unknown
}
[key: string]: unknown
}
export type EntryOrderDetail = {
entry_order_code?: string
purchase_order_code?: string
store_name?: string
store_remask?: string
order_status?: string
items?: EntryDetailItem[]
receivingBindings?: EntryOrderReceivingBinding[]
/** 入库单级导入/PDA 记录汇总(若后端返回) */
direct_logs?: DirectInboundLog[]
[key: string]: unknown
}
export type GetEntryDetailResponse = {
code?: number
message?: string
entryOrder?: EntryOrderDetail
data?: {
entryOrder?: EntryOrderDetail
items?: EntryDetailItem[]
receivingBindings?: EntryOrderReceivingBinding[]
}
}
/** 从 storage.entry.get 返回的入库单详情中汇总导入/PDA 入库记录 */
export function collectDirectInboundLogs(
entryOrder: EntryOrderDetail | undefined | null
): DirectInboundLog[] {
if (!entryOrder) return []
const topLevel = entryOrder.direct_logs
if (Array.isArray(topLevel) && topLevel.length) {
return topLevel
}
const logs: DirectInboundLog[] = []
for (const item of entryOrder.items || []) {
const itemLogs = item.direct_logs
if (!Array.isArray(itemLogs)) continue
for (const log of itemLogs) {
logs.push({
...log,
stock_id: log.stock_id ?? item.stock_id,
warehouse_item_code: log.warehouse_item_code ?? item.warehouse_item_code,
warehouse_item_name: log.warehouse_item_name ?? item.warehouse_item_name,
})
}
}
return logs
}
export function getEntryDetail(data: GetEntryDetailParams): Promise<GetEntryDetailResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.get',
v,
timestamp: new Date().getTime(),
},
data,
})
}
/** storage.entry.getStore — 货主侧入库单详情(复用 get 的出入参结构) */
export function getEntryDetailStore(data: GetEntryDetailParams): Promise<GetEntryDetailResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.getStore',
v,
timestamp: new Date().getTime(),
},
data,
})
}
export type CancelEntryParams = {
/** 入库单ID,兼容旧调用;与 ids 二选一。若同时传入 ids,以 ids 为准 */
id?: number
/** 入库单ID数组,用于批量作废;必须为非空数组 */
ids?: number[]
}
export type CancelEntryResponse = {
code?: number
message?: string
id?: number
ids?: number[]
data?: {
id?: number
ids?: number[]
}
}
export function cancelEntry(data: CancelEntryParams): Promise<CancelEntryResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.cancel',
v,
timestamp: new Date().getTime(),
},
data,
})
}
export type AddItemBatchEntry = {
stock_id: number
quantity?: number
inbound_type: 'import' | 'pda' | string
space_id?: number
remark?: string
receiving_detail_id?: number
allocated_quantity?: number
}
export type AddItemSingleParams = {
/** 入库单 ID */
entry_order_id: number
stock_id: number
quantity?: number
inbound_type: 'import' | 'pda' | string
space_id?: number
remark?: string
receiving_detail_id?: number
allocated_quantity?: number
}
export type AddItemBatchParams = {
/** 入库单 ID */
entry_order_id: number
items: AddItemBatchEntry[]
}
export type AddItemParams = AddItemSingleParams | AddItemBatchParams
export type AddItemResultEntry = {
id?: number
stock_id?: number
quantity?: number
inbound_type?: string
space_id?: number
plan_quantity?: number
existing_before?: number
existing_after?: number
remaining?: number
[key: string]: unknown
}
export type AddItemResponse = {
code?: number
message?: string
id?: number
stock_id?: number
quantity?: number
inbound_type?: string
plan_quantity?: number
existing_before?: number
existing_after?: number
remaining?: number
count?: number
total_quantity?: number
items?: AddItemResultEntry[]
data?: Partial<AddItemResponse>
}
/** 按商品增量添加导入/PDA 入库记录(支持单条与批量) */
export function addItem(data: AddItemParams): Promise<AddItemResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.addItem',
v,
timestamp: new Date().getTime(),
},
data,
})
}
export type EntryCommitParams = {
/** 入库单 ID */
entry_order_id: number
}
export type EntryCommitResponse = {
code?: number
message?: string
id?: number
entry_order_code?: string
order_status?: string
sync_status?: string
items_count?: number
total_quantity?: number
data?: Partial<EntryCommitResponse>
}
/** 提交确认完成导入/PDA 入库 */
export function commit(data: EntryCommitParams): Promise<EntryCommitResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.commit',
v,
timestamp: new Date().getTime(),
},
data,
})
}
export type RemoveItemParams = {
/** 入库记录ID(wms_inbound_direct_log.id) */
id: number
}
export type RemoveItemResponse = {
code?: number
message?: string
id?: number
stock_id?: number
quantity?: number
inbound_type?: string
data?: Partial<RemoveItemResponse>
}
/** 移除一条导入/PDA 入库记录(仅限未提交的入库单) */
export function removeItem(data: RemoveItemParams): Promise<RemoveItemResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.removeItem',
v,
timestamp: new Date().getTime(),
},
data,
})
}
export type QuickInboundParams = {
/** 入库单ID */
id: number
}
export type QuickInboundResponse = {
code?: number
message?: string
id?: number
entry_order_code?: string
order_status?: string
sync_status?: string
items_count?: number
total_quantity?: number
data?: Partial<QuickInboundResponse>
}
/** 快速入库(一键完成入库单) */
export function quickInbound(data: QuickInboundParams): Promise<QuickInboundResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.quickInbound',
v,
timestamp: new Date().getTime(),
},
data,
})
}
export type ReceivingCompareMatchStatus = 'matched' | 'entry_only' | string
/** 逐行对照项(comparison / entry_only / receiving_only 数组元素) */
export type ReceivingCompareRow = {
entry_item_id?: number
stock_id?: number
warehouse_item_code?: string
warehouse_item_name?: string
warehouse_item_spec?: string
/** 入库计划数量 */
entry_count?: number
/** 入库已收数量 */
entry_received?: number
receiving_detail_id?: number | null
receiving_product_code?: string | null
receiving_product_name?: string | null
/** 收货实际数量 */
receiving_actual_quantity?: number | null
/** 收货已分配数量 */
receiving_allocated?: number | null
/** 收货可用数量 */
receiving_available?: number | null
match_status?: ReceivingCompareMatchStatus
[key: string]: unknown
}
export type ReceivingCompareSummary = {
total_rows?: number
total_entry_items?: number
total_receiving_items?: number
matched_items?: number
entry_only_items?: number
receiving_only_items?: number
unmatched_items?: number
matched_count?: number
entry_only_count?: number
receiving_only_count?: number
unmatched_count?: number
total_entry_qty?: number
total_receiving_qty?: number
matched_qty?: number
entry_only_qty?: number
receiving_only_qty?: number
match_rate?: number
is_fully_matched?: boolean
fully_matched?: boolean
comparison_rows?: number
[key: string]: unknown
}
/** 单个收货单对照结果(comparisons 数组元素) */
export type ReceivingCompareItem = {
receiving_id?: number
receiving_number?: string
/** 对照状态:matched / error 等 */
status?: string
comparison?: ReceivingCompareRow[]
entry_only?: ReceivingCompareRow[]
receiving_only?: ReceivingCompareRow[]
summary?: ReceivingCompareSummary
[key: string]: unknown
}
export type ReceivingCompareParams = {
/** 入库单ID */
entry_order_id: number
/** 收货单ID,单个时使用,与 receiving_ids 二选一 */
receiving_id?: number
/** 收货单ID数组,优先使用;与 receiving_id 二选一 */
receiving_ids?: number[]
}
export type ReceivingCompareResponse = {
code?: number
message?: string
entry_order_id?: number
entry_order_code?: string
/** 合并后的逐行对照列表(多个收货单明细先合并,再与入库单对照;以入库单明细为主,每个入库明细仅一行,含匹配状态 matched/entry_only、合并收货数量与各收货单来源明细) */
comparison?: ReceivingCompareRow[]
/** 仅收货单有的商品列表(合并后仍未匹配到任何入库明细,按商品合并) */
receiving_only?: ReceivingCompareRow[]
/** 合并对照汇总统计,含 total_entry_items/matched_items/entry_only_items/receiving_only_items */
summary?: ReceivingCompareSummary
/** 各收货单对照结果列表(兼容旧结构) */
comparisons?: ReceivingCompareItem[]
/** 校验失败的收货单列表 */
errors?: Array<{ receiving_id?: number; message?: string; [key: string]: unknown }>
/** 总体汇总统计 */
total_summary?: ReceivingCompareSummary
data?: Partial<Omit<ReceivingCompareResponse, 'data'>>
}
/** 入库单与收货单商品对照(支持单个或多个收货单) */
export function receivingCompare(
data: ReceivingCompareParams
): Promise<ReceivingCompareResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.receivingCompare',
v,
timestamp: new Date().getTime(),
},
data,
})
}
export type BindReceivingParams = {
/** 入库单ID */
entry_order_id: number
/** 要绑定的收货单ID列表 */
receiving_ids: number[]
}
export type BindReceivingSuccessItem = {
receiving_id?: number
receiving_number?: string
[key: string]: unknown
}
export type BindReceivingFailedItem = {
receiving_id?: number
error_code?: string
message?: string
[key: string]: unknown
}
export type BindReceivingResponse = {
code?: number
message?: string
success?: BindReceivingSuccessItem[]
failed?: BindReceivingFailedItem[]
success_count?: number
failed_count?: number
data?: {
success?: BindReceivingSuccessItem[]
failed?: BindReceivingFailedItem[]
success_count?: number
failed_count?: number
}
}
/** 将收货单绑定到入库单(主表级关联) */
export function bindReceiving(data: BindReceivingParams): Promise<BindReceivingResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.bindReceiving',
v,
timestamp: new Date().getTime(),
},
data,
})
}
/** storage.entry.reviewEntry 参数 */
export type ReviewEntryParams = {
/** 入库单ID */
id: number
}
/** storage.entry.reviewEntry 响应 */
export type ReviewEntryResponse = {
flag?: string
code?: number
message?: string
data?: {
id?: number
order_status?: string
}
}
/** 审核入库单(CREATED → PENDING),仅允许已绑定收货单的入库单推进状态 */
export function reviewEntry(data: ReviewEntryParams): Promise<ReviewEntryResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.reviewEntry',
v,
timestamp: new Date().getTime(),
},
data,
})
}
export type EntryContainerListParams = {
/** 入库单 ID */
entry_order_id: number
/** 商品 stock_id(wms_stock_warehouse.id) */
stock_id: number
}
export type EntryContainerListItem = {
detail_id?: number
receiving_id?: number
barcode?: string
product_name?: string
actual_quantity?: number
receiving_status?: string
stock?: Record<string, unknown>
[key: string]: unknown
}
export type EntryContainerListResponse = {
code?: number
message?: string
list?: EntryContainerListItem[]
total?: number
data?: {
list?: EntryContainerListItem[]
total?: number
}
}
/** PDA 上架时拉取入库单已绑定收货单中指定商品的可用容器列表 */
export function containerList(
data: EntryContainerListParams
): Promise<EntryContainerListResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.containerList',
v,
timestamp: new Date().getTime(),
},
data,
})
}
/** storage.entry.queryEntryLogs 参数 */
export type QueryEntryLogsParams = {
/** 入库单 ID(必填) */
id: number | string
page?: number
pageSize?: number
}
/** 查询入库单操作日志 */
export function queryEntryLogs(data: QueryEntryLogsParams = {
id: ''
}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.queryEntryLogs',
v,
timestamp: new Date().getTime(),
},
data,
isSystemApi: true,
} as any)
}
/** storage.entry.export 导出参数(异步任务模式) */
export type EntryExportParams = {
where?: Record<string, unknown>
sort?: {
sortField?: string
sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC'
}
}
/** storage.entry.export:导出入库单列表及明细(异步任务模式),返回 task_id */
export function entryExport(data: EntryExportParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.export',
v,
timestamp: new Date().getTime(),
},
data,
isSystemApi: true,
} as any)
}
/** storage.entry.exportTaskProgress 查询参数 */
export type EntryExportTaskProgressParams = {
task_id?: string
taskId?: string
}
/** storage.entry.exportTaskProgress:查询入库单导出任务进度与下载链接 */
export function entryExportTaskProgress(data: EntryExportTaskProgressParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.exportTaskProgress',
v,
timestamp: new Date().getTime(),
},
data,
isSystemApi: true,
} as any)
}
/** storage.entry.storeExport 查询参数(货主侧入库单导出) */
export type EntryStoreExportParams = {
where?: Record<string, any>
sort?: {
sortField?: string
sort_field?: string
sortOrder?: string
sort_order?: string
}
}
/** storage.entry.storeExport:货主侧提交入库单导出任务 */
export function entryStoreExport(data: EntryStoreExportParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.storeExport',
v,
timestamp: new Date().getTime(),
},
data,
isSystemApi: true,
} as any)
}
/** storage.entry.storeExportTaskProgress 查询参数 */
export type EntryStoreExportTaskProgressParams = {
task_id?: string
taskId?: string
}
/** storage.entry.storeExportTaskProgress:货主侧查询入库单导出任务进度 */
export function entryStoreExportTaskProgress(data: EntryStoreExportTaskProgressParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'storage.entry.storeExportTaskProgress',
v,
timestamp: new Date().getTime(),
},
data,
isSystemApi: true,
} as any)
}