import request from '@/utils/request' const v = '1.0' // ============================================================ // 售后模块 V2 API // ============================================================ // ==================== 类型定义 ==================== /** 售后类型 */ export type AfterSaleType = 'order' | 'receiving' | 'entry' | 'stockout' /** 售后状态 */ export type AfterSaleStatus = 'pending' | 'processing' | 'completed' | 'closed' | 'cancelled' /** 角色组 */ export type AfterSaleRoleGroup = 'customer_service' | 'warehouse' | 'finance' /** 理赔状态 */ export type ClaimStatus = 'pending' | 'reviewing' | 'approved' | 'paid' | 'monthly' | 'rejected' /** 步骤状态: 0=待开始 1=进行中 2=已完成 3=已跳过 */ export type StepStatus = 0 | 1 | 2 | 3 /** 售后单对象 */ export interface AfterSale { id: number warehouse_id: number store_id: number | null after_sale_no: string type: AfterSaleType sub_type: string status: AfterSaleStatus priority: number title: string description: string | null creator_id: number inbox_message_id: number | null role_group: AfterSaleRoleGroup | null resolution: string | null resolved_at: string | null // 仓库理赔 claim_needed: 0 | 1 claim_amount: number | null claim_status: ClaimStatus | null // 运方理赔 carrier_claim_needed: 0 | 1 carrier_claim_amount: number | null carrier_claim_status: ClaimStatus | null // 关联单据 waybill_id: number | null waybill_no: string | null order_delivery_id: number | null order_delivery_no: string | null entry_order_id: number | null entry_order_no: string | null order_stockout_id: number | null order_stockout_no: string | null receiving_id: number | null receiving_no: string | null created_at: string updated_at: string } /** 售后步骤对象 */ export interface AfterSaleStep { id: number after_sale_id: number step_status: StepStatus operator_id: number | null operator_snapshot: string | null action: string | null remark: string | null started_at: string | null completed_at: string | null created_at: string attachments: FileReference[] } /** 文件引用 */ export interface FileReference { id?: number file_id?: number file_name?: string file_url?: string file_key?: string file_size?: number mime_type?: string } // ==================== 请求参数类型 ==================== /** 列表查询参数 */ export interface AfterSaleListParams { pagination?: { page?: number; pageSize?: number } where?: Record sort?: { sortField?: string; sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC' } } /** 创建售后单参数 */ export interface AfterSaleCreateParams { type: AfterSaleType sub_type: string title: string description?: string priority?: number store_id?: number waybill_id?: number order_id?: number order_delivery_no?: string entry_order_id?: number entry_order_no?: string order_stockout_id?: number order_stockout_no?: string receiving_id?: number receiving_no?: string } /** 更新售后单参数 */ export interface AfterSaleUpdateParams extends Partial { id: number } /** 转单参数 */ export interface AfterSaleTransferParams { id: number role_group: AfterSaleRoleGroup remark?: string } /** 处理工单参数 */ export interface AfterSaleHandleWorkOrderParams { id: number status?: AfterSaleStatus remark?: string attachment_ids?: number[] } /** 登记理赔参数 */ export interface AfterSaleRegisterClaimParams { id: number // 仓库理赔 claim_needed?: 0 | 1 claim_amount?: number claim_status?: ClaimStatus // 运方理赔 carrier_claim_needed?: 0 | 1 carrier_claim_amount?: number carrier_claim_status?: ClaimStatus // 步骤 action: string remark?: string attachment_ids?: number[] } /** 导出参数 */ export interface AfterSaleExportParams { where?: Record sort?: { sortField?: string; sortOrder?: 'asc' | 'desc' } } /** 导出进度查询参数 */ export interface AfterSaleExportTaskProgressParams { task_id: string } // ==================== API 方法 ==================== /** 2.1 工作列表 afterSale.workList */ export function afterSaleWorkList(data: AfterSaleListParams = {}) { return request({ url: '/system', method: 'post', params: { method: 'afterSale.workList', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** 2.2 审计列表 afterSale.auditList */ export function afterSaleAuditList(data: AfterSaleListParams = {}) { return request({ url: '/system', method: 'post', params: { method: 'afterSale.auditList', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** 2.3 售后明细 afterSale.detail */ export function afterSaleDetail(id: number) { return request({ url: '/system', method: 'post', params: { method: 'afterSale.detail', v, timestamp: Date.now() }, data: { id }, isSystemApi: true } as any) } /** 2.4 创建售后单 afterSale.create */ export function afterSaleCreate(data: AfterSaleCreateParams) { return request({ url: '/system', method: 'post', params: { method: 'afterSale.create', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** 2.5 更新售后单 afterSale.update */ export function afterSaleUpdate(data: AfterSaleUpdateParams) { return request({ url: '/system', method: 'post', params: { method: 'afterSale.update', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** 2.6 转单 afterSale.transfer */ export function afterSaleTransfer(data: AfterSaleTransferParams) { return request({ url: '/system', method: 'post', params: { method: 'afterSale.transfer', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** 2.7 处理工单 afterSale.handleWorkOrder */ export function afterSaleHandleWorkOrder(data: AfterSaleHandleWorkOrderParams) { return request({ url: '/system', method: 'post', params: { method: 'afterSale.handleWorkOrder', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** 2.8 登记理赔 afterSale.registerClaim */ export function afterSaleRegisterClaim(data: AfterSaleRegisterClaimParams) { return request({ url: '/system', method: 'post', params: { method: 'afterSale.registerClaim', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** 2.9 导出 afterSale.export */ export function afterSaleExport(data: AfterSaleExportParams = {}) { return request({ url: '/system', method: 'post', params: { method: 'afterSale.export', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** 2.10 导出进度 afterSale.exportTaskProgress */ export function afterSaleExportTaskProgress(data: AfterSaleExportTaskProgressParams) { return request({ url: '/system', method: 'post', params: { method: 'afterSale.exportTaskProgress', v, timestamp: Date.now() }, data, isSystemApi: true } as any) } /** 2.11 角标快速查询 afterSale.workCount */ export function afterSaleWorkCount(): Promise { return request({ url: '/system', method: 'post', params: { method: 'afterSale.workCount', v, timestamp: Date.now() }, data: {}, isSystemApi: true } as any) }