338 lines
7.5 KiB
TypeScript
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)
|
|
}
|