Files
admin-web/src/modules/overseas-warehouse/api/relabelOrders.ts
T

215 lines
7.7 KiB
TypeScript
Raw Normal View History

2026-08-20 09:10:36 +08:00
import { overseasHttp } from '@/shared/api/overseasHttp'
import { unwrapApiResponse, type ApiEnvelope } from '@/shared/api/http'
2026-08-26 20:39:55 +08:00
import { listSharedReceivingOverseasWarehouseOptions } from '@/modules/iam'
import { normalizeOverseasPage, type OverseasPagePayload } from './lastMileOrders'
2026-08-20 09:10:36 +08:00
export interface RelabelOrderQuery {
page: number
size: number
2026-08-28 14:33:57 +08:00
relabelNo?: string
2026-08-20 09:10:36 +08:00
skuCode?: string
status?: string
2026-09-28 17:26:26 +08:00
reviewedFrom?: string
reviewedTo?: string
measuredFrom?: string
measuredTo?: string
outboundFrom?: string
outboundTo?: string
2026-08-20 09:10:36 +08:00
}
2026-08-21 11:20:09 +08:00
export interface CreateRelabelItemPayload {
skuCode: string
productNameZh: string
totalPackageCount: number
notifiedPackageCount: number
shipmentNo: string
newSkuCode: string
labelRequirement?: string
productImageFileId?: string
productImageFileName?: string
productImageUrl?: string
trackingCode?: string
relabelFileId?: string
relabelFileName?: string
relabelFileUrl?: string
}
export interface CreateRelabelPayload {
customerOrderNo: string
2026-09-23 11:25:23 +08:00
operationWarehouseId?: string
/** @deprecated compatibility alias for older platform fixtures */
overseasWarehouseId?: string
2026-08-21 11:20:09 +08:00
labelDeadline: string
contactName: string
contactPhone: string
chargeAmount: number
2026-08-21 11:20:09 +08:00
remark?: string
idempotencyKey: string
items: CreateRelabelItemPayload[]
}
export interface RelabelWarehouseOptionDto {
id: string
customerId: string
warehouseCode: string
warehouseName: string
warehouseType: string
status: string
}
2026-08-20 09:10:36 +08:00
export interface RelabelSummaryDto {
id: string
relabelNo: string
lastlegOrderId?: string | null
lastlegOrderNo?: string | null
customerOrderNo?: string | null
overseasWarehouseId?: string | null
labelDeadline?: string | null
contactName?: string | null
contactPhone?: string | null
status?: string | null
itemCount?: number | null
totalPackageCount?: number | null
notifiedPackageCount?: number | null
skuCodes?: string | null
2026-09-09 13:35:43 +08:00
totalFileId?: string | null
totalFileName?: string | null
totalFileUrl?: string | null
chargeAmount?: number | string | null
chargeCurrency?: string | null
walletStatus?: string | null
walletErrorMessage?: string | null
2026-09-10 15:33:54 +08:00
deliveryMethod?: string | null
printShippingLabel?: boolean | null
shippingLabelFileId?: string | null
shippingLabelFileName?: string | null
fulfillmentStatus?: string | null
outboundOrderNo?: string | null
customerConfirmedAt?: string | null
2026-09-23 11:25:23 +08:00
reviewChannel?: 'TAIL_ORDER' | 'RELABEL_ORDER' | null
reviewRemark?: string | null
2026-09-28 17:26:26 +08:00
reviewedAt?: string | null
measuredAt?: string | null
outboundAt?: string | null
2026-08-20 09:10:36 +08:00
createdAt?: string | null
}
export interface RelabelItemDto {
id: string
skuCode?: string | null
productNameZh?: string | null
totalPackageCount?: number | null
notifiedPackageCount?: number | null
newSkuCode?: string | null
labelRequirement?: string | null
2026-09-09 13:35:43 +08:00
relabelFileId?: string | null
2026-08-20 09:10:36 +08:00
relabelFileName?: string | null
relabelFileUrl?: string | null
2026-09-06 18:11:35 +08:00
shipmentNo?: string | null
trackingCode?: string | null
remark?: string | null
cartonMark?: string | null
fbaCartonMark?: string | null
destinationWarehouseId?: string | null
destinationFbaWarehouseCode?: string | null
2026-08-20 09:10:36 +08:00
}
export interface RelabelHistoryDto {
fromStatus?: string | null
toStatus?: string | null
operatorId?: string | null
remark?: string | null
createdAt?: string | null
}
export interface RelabelDetailDto {
application: RelabelSummaryDto
remark?: string | null
items: RelabelItemDto[]
history: RelabelHistoryDto[]
2026-09-10 15:33:54 +08:00
completionEvidence?: { taskId: string; photoFileIds: string[]; completionRemark?: string | null; reviewerName?: string | null; reviewRemark?: string | null; completedAt?: string | null } | null
2026-08-20 09:10:36 +08:00
}
export async function listRelabelOrders(query: RelabelOrderQuery) {
const response = await overseasHttp.get<ApiEnvelope<OverseasPagePayload<RelabelSummaryDto>>, ApiEnvelope<OverseasPagePayload<RelabelSummaryDto>>>(
2026-08-21 11:20:09 +08:00
'/platform/v1/last-leg/relabel-applications', { params: query },
2026-08-20 09:10:36 +08:00
)
return normalizeOverseasPage(unwrapApiResponse(response))
2026-08-20 09:10:36 +08:00
}
2026-08-21 11:20:09 +08:00
export async function getRelabelOrder(relabelNo: string) {
2026-08-20 09:10:36 +08:00
const response = await overseasHttp.get<ApiEnvelope<RelabelDetailDto>, ApiEnvelope<RelabelDetailDto>>(
2026-08-21 11:20:09 +08:00
`/platform/v1/last-leg/relabel-applications/${encodeURIComponent(relabelNo)}`,
)
return unwrapApiResponse(response)
}
2026-08-26 20:39:55 +08:00
export async function listRelabelWarehouseOptions() {
const records: RelabelWarehouseOptionDto[] = (await listSharedReceivingOverseasWarehouseOptions()).map((warehouse) => ({
id: warehouse.id,
customerId: '0',
warehouseCode: warehouse.warehouseCode,
warehouseName: warehouse.warehouseName,
warehouseType: 'OVERSEAS',
status: 'ACTIVE',
}))
return { records, page: 1, size: 200, total: records.length, pages: records.length ? 1 : 0 }
}
export async function createRelabelOrder(customerId: string, payload: CreateRelabelPayload) {
2026-08-21 11:20:09 +08:00
const response = await overseasHttp.post<ApiEnvelope<RelabelDetailDto>, ApiEnvelope<RelabelDetailDto>>(
'/platform/v1/last-leg/relabel-applications', payload, { params: { customerId } },
2026-08-21 11:20:09 +08:00
)
return unwrapApiResponse(response)
}
export async function changeRelabelOrderStatus(relabelNo: string, status: string, remark?: string) {
const response = await overseasHttp.put<ApiEnvelope<RelabelDetailDto>, ApiEnvelope<RelabelDetailDto>>(
`/platform/v1/last-leg/relabel-applications/${encodeURIComponent(relabelNo)}/status`,
{ status, remark },
2026-08-20 09:10:36 +08:00
)
return unwrapApiResponse(response)
}
2026-09-09 13:35:43 +08:00
2026-09-15 15:20:28 +08:00
export async function getRelabelReviewTask(relabelNo: string) {
const response = await overseasHttp.get<ApiEnvelope<{ version: number; taskStatus: string }>, ApiEnvelope<{ version: number; taskStatus: string }>>(`/platform/v1/last-leg/relabel-applications/${encodeURIComponent(relabelNo)}/review-task`)
return unwrapApiResponse(response)
}
export async function returnRelabelForRework(relabelNo: string, expectedVersion: number, remark: string, idempotencyKey: string) {
const response = await overseasHttp.post<ApiEnvelope<unknown>, ApiEnvelope<unknown>>(`/platform/v1/last-leg/relabel-applications/${encodeURIComponent(relabelNo)}/rework`, { decision: 'REWORK', expectedVersion, remark, idempotencyKey })
return unwrapApiResponse(response)
}
2026-09-17 13:36:31 +08:00
export async function confirmRelabelCompletion(relabelNo: string, remark?: string) {
const response = await overseasHttp.post<ApiEnvelope<unknown>, ApiEnvelope<unknown>>(
`/platform/v1/last-leg/relabel-applications/${encodeURIComponent(relabelNo)}/confirm-completion`,
{ idempotencyKey: crypto.randomUUID(), remark },
)
return unwrapApiResponse(response)
}
2026-09-09 13:35:43 +08:00
export async function uploadRelabelPdf(relabelNo: string, file: File, scope: 'TOTAL' | 'ITEM', itemId?: string) {
const body = new FormData()
body.append('file', file)
const response = await overseasHttp.post<ApiEnvelope<RelabelDetailDto>, ApiEnvelope<RelabelDetailDto>>(
`/platform/v1/last-leg/relabel-applications/${encodeURIComponent(relabelNo)}/files`, body,
{ params: { scope, itemId }, headers: { 'Content-Type': 'multipart/form-data' } },
)
return unwrapApiResponse(response)
}
export async function downloadRelabelPdf(relabelNo: string, fileId: string, scope: 'TOTAL' | 'ITEM', itemId?: string) {
return overseasHttp.get<Blob, Blob>(
`/platform/v1/last-leg/relabel-applications/${encodeURIComponent(relabelNo)}/files/${encodeURIComponent(fileId)}/download`,
{ params: { scope, itemId }, responseType: 'blob' },
)
}
2026-09-10 15:33:54 +08:00
export async function downloadRelabelCompletionPhoto(relabelNo: string, fileId: string) {
return overseasHttp.get<Blob, Blob>(
`/platform/v1/last-leg/relabel-applications/${encodeURIComponent(relabelNo)}/completion-photos/${encodeURIComponent(fileId)}/download`,
{ responseType: 'blob' },
)
}