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 & { /** 虚拟字段:true 仅已绑定收货单,false 仅未绑定 */ hasReceiving?: boolean } export type StorageEntryListItem = Record & { 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 } export function getEntryList(data: StorageEntryListParams = {}): Promise { 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 { 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 [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 { 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 { 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 { 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 } /** 按商品增量添加导入/PDA 入库记录(支持单条与批量) */ export function addItem(data: AddItemParams): Promise { 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 } /** 提交确认完成导入/PDA 入库 */ export function commit(data: EntryCommitParams): Promise { 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 } /** 移除一条导入/PDA 入库记录(仅限未提交的入库单) */ export function removeItem(data: RemoveItemParams): Promise { 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 } /** 快速入库(一键完成入库单) */ export function quickInbound(data: QuickInboundParams): Promise { 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> } /** 入库单与收货单商品对照(支持单个或多个收货单) */ export function receivingCompare( data: ReceivingCompareParams ): Promise { 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 { 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 { 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 [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 { 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 { 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 sort?: { sortField?: string sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC' } } /** storage.entry.export:导出入库单列表及明细(异步任务模式),返回 task_id */ export function entryExport(data: EntryExportParams = {}): Promise { 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 { 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 sort?: { sortField?: string sort_field?: string sortOrder?: string sort_order?: string } } /** storage.entry.storeExport:货主侧提交入库单导出任务 */ export function entryStoreExport(data: EntryStoreExportParams): Promise { 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 { return request({ url: '/system', method: 'post', params: { method: 'storage.entry.storeExportTaskProgress', v, timestamp: new Date().getTime(), }, data, isSystemApi: true, } as any) }