WEB/src/api/afterSale/index.ts
liufumingren 03051fb0d4 1
2026-08-11 09:34:45 +08:00

338 lines
7.5 KiB
TypeScript

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<string, any>
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<AfterSaleCreateParams> {
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<string, any>
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<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.workCount',
v,
timestamp: Date.now()
},
data: {},
isSystemApi: true
} as any)
}