oms/frontend/src/api/outboundOrder.ts
liufumingren 9774ee1414 feat(stock): 出入库单/记录增加货主并按货主隔离,创建人显示员工名称
- 迁移:inbound_orders / outbound_orders 增加 subsidiary_id 与索引,按仓库回填
- 单据货主由仓库决定:创建写入、改仓库同步,接口不接受直写 subsidiary_id
- 入库单/出库单列表返回 subsidiary_name 并新增货主筛选;详情/编辑/删除/审核/
  推送/完成/取消/恢复/作废/驳回与明细接口统一加货主越界 403
- 出入库记录按仓库归属货主:列表与导出收窄、返回 subsidiary_id/subsidiary_name、
  新增货主列与筛选
- 导出:入库单/出库单/出入库记录新增货主列并按所在公司权限收窄
- 新增 resolveAccountNameMap:列表/详情返回 creator_name/auditor_name/voider_name,
  创建人展示员工名称(principal_users.name),不再回退成邮箱账号
- 前端:三个列表新增货主列与筛选,创建人/作废人展示改为员工名称

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 15:13:22 +08:00

154 lines
6.1 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 { get, post, put, del } from '@/utils/request'
import type { StockItemLine, StockItemPayload } from './stockOrder'
/** 出库单(单据头) */
export interface OutboundOrder {
id: number
bill_no: string
principal_id: number
/** 所属货主(下属公司ID),跟随仓库 */
subsidiary_id?: number | null
/** 所属货主名称(列表/详情接口返回) */
subsidiary_name?: string
shop_id: number | null
outbound_type: string
status: number
customer?: string | null
/** 操作人(审核时系统写入=审核人,接口不可传) */
operator?: string | null
warehouse_id: number | null
warehouse?: { id: number; code: string; name: string } | null
shop?: { id: number; name: string } | null
creator?: { id: number; nickname?: string | null; username: string } | null
/** 创建人展示名(员工名称,后端按 principal_users.name 解析) */
creator_name?: string
item_total: number | string
item_kind: number | null
total_amount: number | string
remark?: string | null
stock_deducted?: number
/** 推送锁定库存标记:1=已锁定(自动推送重试期间保持),0=未锁定/已释放/已扣减 */
stock_locked?: number
/** 运单号集合(WMS 出库确认回传,多包裹时为多个;列名对齐 wms_order_stockout) */
waybill_codes?: string[] | null
/** 快递公司编码(推送 deliveryOrder.logisticsCode,如 SF/STO) */
express_code?: string | null
/** 快递公司名称(按快递公司字典解析的快照) */
express_name?: string | null
/** 收件人(receiverInfo,推送 WMS stockout.create) */
receiver_name?: string | null
receiver_company?: string | null
receiver_tel?: string | null
receiver_mobile?: string | null
receiver_email?: string | null
receiver_country_code?: string | null
receiver_province?: string | null
receiver_city?: string | null
receiver_area?: string | null
receiver_town?: string | null
receiver_detail_address?: string | null
receiver_zip_code?: string | null
receiver_id?: string | null
void_at?: string | null
void_by?: number | null
void_reason?: string | null
voider?: { id: number; nickname?: string | null; username: string } | null
/** 作废人展示名(员工名称) */
voider_name?: string
pushed_at?: string | null
wms_push_result?: {
success?: boolean
code?: string | number | null
message?: string | null
error?: string | null
/** 失败类型:business 仓库明确拒绝 / timeout 无响应超时 / insufficient_stock / lock_failed / empty_items */
failureKind?: string
attempts?: number
maxAttempts?: number
retryable?: boolean
deliveryOrderCode?: string | null
pushedAt?: string | null
[key: string]: unknown
} | null
items?: StockItemLine[]
created_at?: string
updated_at?: string
}
/** 明细行(创建时随单提交) */
export interface OutboundItemInput {
product_id?: number | null
name?: string | null
code?: string | null
spec?: string | null
unit?: string | null
quantity?: number
price?: number | null
inventory_type?: 'ZP' | 'CC'
remark?: string | null
}
/** 创建 / 更新载荷 */
export interface OutboundOrderPayload {
warehouse_id?: number | null
shop_id?: number | null
outbound_type?: string
status?: number
customer?: string | null
total_amount?: number
remark?: string | null
/** 快递公司编码(推送为 deliveryOrder.logisticsCode) */
express_code?: string | null
/** 快递公司名称(传编码时前端自动带出) */
express_name?: string | null
receiver_name?: string | null
receiver_company?: string | null
receiver_tel?: string | null
receiver_mobile?: string | null
receiver_email?: string | null
receiver_country_code?: string | null
receiver_province?: string | null
receiver_city?: string | null
receiver_area?: string | null
receiver_town?: string | null
receiver_detail_address?: string | null
receiver_zip_code?: string | null
receiver_id?: string | null
items?: OutboundItemInput[]
}
/** 明细提交(含库存类型 ZP 正品 / CC 残次,与入库单对齐) */
export type OutboundItemPayload = StockItemPayload & { inventory_type?: 'ZP' | 'CC' }
export const outboundOrderApi = {
getList: (params?: object) =>
get<{ list: OutboundOrder[]; total: number; page: number; pageSize: number }>('/outbound-orders', params),
get: (id: number) => get<OutboundOrder>(`/outbound-orders/${id}`),
create: (data: OutboundOrderPayload) => post<{ id: number }>('/outbound-orders', data),
update: (id: number, data: Partial<OutboundOrderPayload>) =>
put<{ id: number }>(`/outbound-orders/${id}`, data),
audit: (id: number) => post<{ id: number; status?: number }>(`/outbound-orders/${id}/audit`),
push: (id: number) => post<{ id: number; attempts?: number }>(`/outbound-orders/${id}/push`),
complete: (id: number) => post<{ id: number }>(`/outbound-orders/${id}/complete`),
cancel: (id: number) => post<{ id: number }>(`/outbound-orders/${id}/cancel`),
restore: (id: number) => post<{ id: number }>(`/outbound-orders/${id}/restore`),
/** 作废:仅「已审核(2)」可作废,记录作废人/时间/原因,不可恢复 */
voidOrder: (id: number, data?: { void_reason?: string }) =>
post<{ id: number }>(`/outbound-orders/${id}/void`, data || {}),
/** 驳回:已审核(2)/已推送(3) 且未完成 -> 回到待出库(1),已推送的先走接口取消外部单据 */
reject: (id: number) => post<{ id: number; bill_no?: string }>(`/outbound-orders/${id}/reject`),
remove: (id: number) => del<{ id: number }>(`/outbound-orders/${id}`),
/** 明细列表(复用通用 stock_items,bill_type=2 出库) */
getItems: (billId: number, params?: object) =>
get<{ list: StockItemLine[]; total: number; page: number; pageSize: number }>('/stock-items', {
bill_id: billId,
bill_type: 2,
...params,
}),
createItem: (data: OutboundItemPayload) =>
post<{ id: number }>('/stock-items', { ...data, bill_type: 2 }),
updateItem: (id: number, data: Partial<OutboundItemPayload>) =>
put<{ id: number }>(`/stock-items/${id}`, data),
removeItem: (id: number) => del<{ id: number }>(`/stock-items/${id}`),
}