import { get, post, put, del } from '@/utils/request' /** * 订单(状态分表) * * 订单按状态分表存储,状态同时代表「所在表」: * pending 待审核 / queued 待推送 / exception 异常 / outsourcing 委外中 / delivery 配送 * / void 已作废 / canceled 已取消 / history 历史(归档表)。 * 流转:待审核 →(审核+锁库存)待推送 →(推送仓库成功)委外中 →(仓库回传确认)配送;推送失败 → 异常。 * 列表按状态分视图(左侧 tab),状态流转由后端业务事务推动,前端只提交动作。 */ export type OrderStage = | 'pending' | 'queued' | 'exception' | 'outsourcing' | 'delivery' | 'void' | 'canceled' | 'history' /** 页面左侧 tab(顺序即状态流转顺序) */ export const ORDER_STAGE_TABS: { key: OrderStage; label: string }[] = [ { key: 'pending', label: '待审核' }, { key: 'queued', label: '待推送' }, { key: 'exception', label: '异常' }, { key: 'outsourcing', label: '委外中' }, { key: 'delivery', label: '配送' }, { key: 'void', label: '已作废' }, { key: 'canceled', label: '已取消' }, { key: 'history', label: '历史' }, ] /** 状态展示口径(文案与颜色,与后端 app/lib/orderStatus.js 对齐) */ export const ORDER_STAGE_META: Record< OrderStage, { label: string; tag: '' | 'info' | 'warning' | 'success' | 'danger' } > = { pending: { label: '待审核', tag: 'warning' }, queued: { label: '待推送', tag: '' }, exception: { label: '异常', tag: 'danger' }, outsourcing: { label: '委外中', tag: '' }, delivery: { label: '配送', tag: 'success' }, void: { label: '已作废', tag: 'info' }, canceled: { label: '已取消', tag: 'info' }, history: { label: '历史', tag: 'info' }, } /** 商品明细行(product_info JSON 元素,列表摘要用) */ export interface OrderProductLine { item_code: string | null item_name: string | null quantity: number | null price: number | null } /** 商品明细(order_status_items:发货单明细与平台明细的超集) */ export interface OrderItemLine { id?: number order_id?: number order_line_no?: string item_id?: number | null item_code?: string | null item_name?: string | null plan_qty: number actual_price?: number | null retail_price?: number | null ext_code?: string | null inventory_type?: string source_order_code?: string | null sub_source_order_code?: string | null stock_id?: number | null product_id?: number | null sku_code?: string | null spec?: string | null image?: string | null created_at?: string updated_at?: string } export interface OrderStatusItem { id: number principal_id: number order_no: string parent_order_no: string | null shop_id: number | null shop_name?: string | null warehouse_id?: number | null warehouse_code?: string | null warehouse_name?: string | null product_info: OrderProductLine[] | null product_summary?: string product_kind?: number receiver: string | null address: string | null status: OrderStage status_label?: string /** 是否外部打单平台拉取的订单(店铺由平台决定,不可修改) */ is_external?: boolean /** 来源平台:系统预设编码(PDD / DYXD / SPH…,见 constants/platform.ts) */ source_platform_code?: string | null /** 来源平台名称(如「拼多多」) */ source_platform_name?: string | null /** 平台自己的订单编号(店管家「订单编号」,来源订单号用的是其「系统编号」) */ oaid_order_source_code?: string | null remark: string | null /** —— 老发货单口径字段(为容纳老表而扩展) —— */ order_type?: string | null is_urgency?: string | null invoice_flag?: string | null shop_nick?: string | null buyer_message?: string | null seller_message?: string | null total_amount?: number | string | null item_amount?: number | string | null discount_amount?: number | string | null freight?: number | string | null ar_amount?: number | string | null got_amount?: number | string | null logistics_code?: string | null logistics_name?: string | null express_code?: string | null express_codes?: string[] | null logistics_area_code?: string | null operator_name?: string | null tel?: string | null mobile?: string | null email?: string | null country_code?: string | null province?: string | null city?: string | null area?: string | null town?: string | null detail_address?: string | null zip_code?: string | null oaid?: string | null stock_locked?: number | null wms_status?: string | null wms_order_no?: string | null wms_synced_at?: string | null pushed_at?: string | null wms_push_result?: Record | null legacy_source?: string | null legacy_order_id?: number | null legacy_status?: number | null item_total?: number | string | null item_kind?: number | null audit_by?: number | null audit_time?: string | null void_at?: string | null void_by?: number | null void_reason?: string | null /** 同步外部打单平台发货:0待同步 1已同步 2待重试 3异常(重试超限) */ external_send_status?: number | null external_send_status_label?: string | null external_send_times?: number | null external_send_error?: string | null external_send_at?: string | null external_sent_at?: string | null /** 索引表记录的当前所在表 */ current_table?: OrderStage created_at?: string updated_at?: string /** 仅历史视图 */ archived_at?: string | null transferred_at?: string | null } export interface OrderStatusQuery { status: OrderStage page: number pageSize: number order_no?: string parent_order_no?: string shop_id?: number | '' receiver?: string address?: string remark?: string created_from?: string created_to?: string archived_from?: string archived_to?: string } export interface OrderStatusFilters { statuses: { value: OrderStage; label: string }[] status_labels: Record active_statuses: OrderStage[] /** 超期自动归档阈值(月) */ archive_months: number /** 订单索引表名 */ index_table?: string /** 电商平台选项:系统预设 ∪ 订单里实际出现过的编码(preset=false 表示未收录进预设) */ platforms?: { code: string name: string count: number preset: boolean }[] shops: { id: number; code?: string; name: string; type?: number; subsidiary_id?: number | null }[] warehouses: { id: number; code: string; name: string; subsidiary_id?: number | null }[] } /** 新建/编辑订单(发货单口径) */ export interface OrderStatusPayload { /** 来源订单号(上游/平台订单号;与 order_no 至少传一个) */ parent_order_no?: string /** 电商平台编码(系统预设,如 TB / PDD;手工单默认 TB) */ source_platform_code?: string order_no?: string shop_id?: number | null warehouse_id?: number | null order_type?: string receiver?: string tel?: string mobile?: string email?: string country_code?: string province?: string city?: string area?: string town?: string detail_address?: string zip_code?: string address?: string oaid?: string is_urgency?: string invoice_flag?: string total_amount?: number | null item_amount?: number | null discount_amount?: number | null freight?: number | null ar_amount?: number | null got_amount?: number | null logistics_code?: string logistics_name?: string seller_message?: string buyer_message?: string remark?: string product_info?: OrderProductLine[] /** 商品明细(发货单口径;与 product_info 二选一) */ items?: OrderItemLine[] } /** 流转结果(审核 / 推送 / 转回待审核 / 取消 / 作废 / 按 id 归档) */ export interface OrderStatusTransitionResult { count: number status: OrderStage status_label: string order_nos: string[] /** 单条审核:本次锁定库存的明细行数 */ stock_locked?: number /** 批量审核:失败明细 */ failed?: number failures?: { id: number; message: string }[] } /** 单据级流转结果(驳回 / 恢复:可能换号) */ export interface OrderStatusSingleFlowResult { count: number status: OrderStage status_label: string items: { id: number; order_no: string; bill_no_changed: boolean }[] } /** 推送仓库结果 */ export interface OrderPushWmsResult { id: number attempts: number wms_response?: Record } export interface OrderPushWmsBatchResult { requested: number processed: number pendingRest: number pushed: number failed: number retry: number skipped: number details: { id: number; ok: boolean; message: string }[] } /** 归档结果(不传 ids 时按创建时间超期批量归档) */ export interface OrderStatusArchiveResult { count: number status?: OrderStage status_label?: string order_nos?: string[] months?: number threshold?: string by_status?: Record } /** 订单列表(按 status 定位状态表;principal_id 由请求拦截器注入) */ export function getOrderStatusList(params: OrderStatusQuery) { return get<{ list: OrderStatusItem[]; total: number; page: number; pageSize: number }>( '/order-status/list', params as unknown as object, ) } /** 筛选项数据源:状态枚举 + 当前主体下的店铺/仓库 + 归档阈值 */ export function getOrderStatusFilters() { return get('/order-status/filters') } /** 订单详情(单据头 + 商品明细) */ export function getOrderStatusDetail(id: number) { return get<{ order: OrderStatusItem; items: OrderItemLine[] }>(`/order-status/${id}`) } /** 新建订单 / 发货单(写入索引表 + 待审核表;带 items 时同时写入明细) */ export function createOrderStatus(data: OrderStatusPayload) { return post<{ id: number order_no: string status: OrderStage status_label: string item_count: number }>('/order-status', data) } /** 编辑订单(仅待审核 / 异常;未传字段保持原值) */ export function updateOrderStatus(id: number, data: OrderStatusPayload) { return put<{ id: number; order_no: string }>(`/order-status/${id}`, data) } /** 删除订单(仅待审核 / 异常 / 已取消) */ export function removeOrderStatus(id: number) { return del<{ count: number; order_nos: string[] }>(`/order-status/${id}`) } /** 商品明细(按订单ID) */ export function getOrderItems(orderId: number) { return get<{ list: OrderItemLine[]; total: number }>('/order-status/items', { order_id: orderId }) } /** 保存商品明细(整体替换,仅待审核 / 异常) */ export function saveOrderItems(orderId: number, items: OrderItemLine[]) { return post<{ list: OrderItemLine[]; total: number }>('/order-status/items', { order_id: orderId, items, }) } /** 收件人文本智能识别 */ export function parseReceiverText(text: string) { return post>('/order-status/parse-receiver', { text }) } /** 批量审核:待审核 / 异常 → 委外中 */ export function auditOrders(ids: number[]) { return post('/order-status/audit', { ids }) } /** 批量推送外部:outcome=success 成功回传(→ 配送)/ failed 推送失败(→ 异常,remark 记录原因) */ export function pushOrders(ids: number[], outcome: 'success' | 'failed', remark?: string) { return post('/order-status/push', { ids, outcome, remark }) } /** 异常批量转回待审核 */ export function returnOrdersToPending(ids: number[]) { return post('/order-status/return-to-pending', { ids }) } /** 归档:传 ids 归档指定订单;不传则归档创建时间超过 months(默认 3)个月的订单 */ export function archiveOrders(data: { ids?: number[]; months?: number }) { return post('/order-status/archive', data) } /** 驳回(委外中 → 待审核;换号 + 释放锁定库存) */ export function rejectOrders(ids: number[]) { return post('/order-status/reject', { ids }) } /** 取消(待审核 / 异常 / 委外中 → 已取消;已推送的会先取消外部单据) */ export function cancelOrders(ids: number[], remark?: string) { return post('/order-status/cancel', { ids, remark }) } /** 作废(待审核 / 异常 / 委外中 → 已作废;记录作废原因并释放锁定库存) */ export function voidOrders(ids: number[], voidReason?: string, remark?: string) { return post('/order-status/void', { ids, void_reason: voidReason, remark, }) } /** 恢复(已取消 / 已作废 → 待审核;曾推送过的自动换号) */ export function restoreOrders(ids: number[]) { return post('/order-status/restore', { ids }) } /** 推送仓库(WMS deliveryorder.create):单条立即推送 */ export function pushOrderToWms(id: number) { return post(`/order-status/${id}/push-wms`, {}) } /** 推送仓库:批量(顺序限流,超出部分交给定时任务) */ export function pushOrdersToWms(ids: number[]) { return post('/order-status/push-wms', { ids }) } /** 批量切换发货仓库(同步刷新 warehouse_code 快照) */ export function changeOrdersWarehouse(ids: number[], warehouseId: number) { return post<{ updated: number; target: { id: number; code: string; name: string } }>( '/order-status/change-warehouse', { ids, warehouse_id: warehouseId }, ) } /** 批量修改待审核订单的快递公司 */ export function changeOrdersLogistics(ids: number[], logisticsCode: string) { return post<{ updated: number; target: { code: string; name: string } }>( '/order-status/change-logistics', { ids, logistics_code: logisticsCode }, ) }