Files
admin-web/src/modules/loading-lists/api/platformLoadingLists.ts
T

303 lines
9.9 KiB
TypeScript
Raw Normal View History

2026-08-10 15:36:53 +08:00
import { http, unwrapApiResponse, type ApiEnvelope } from '@/shared/api/http'
export type LoadingListMode = 'preload' | 'confirmed'
export interface LoadingCustomer {
accountId: string
customerName: string | null
}
export interface PreloadSummary {
planId: string
2026-08-12 17:29:35 +08:00
containerBookingId: string
2026-08-10 15:36:53 +08:00
preloadNo: string
containerNo: string | null
internalContainerNo: string | null
customers: LoadingCustomer[]
warehouseId: string | null
warehouseName: string | null
vesselName: string | null
voyageNo: string | null
containerType: string | null
status: string
skuCount: string
totalPackageCount: string
totalVolumeCbm: number
totalGrossWeightKg: number
createdAt: string
version: number
}
export interface ConfirmedSummary {
planId: string
2026-08-12 17:29:35 +08:00
containerBookingId: string
2026-08-10 15:36:53 +08:00
loadingListNo: string
warehouseId: string | null
warehouseName: string | null
containerNo: string | null
internalContainerNo: string | null
status: string
totalPackageCount: string
totalGrossWeightKg: number
totalNetWeightKg: number
totalVolumeCbm: number
totalQuantity: string
remark: string | null
createdBy: string | null
createdByName: string | null
createdAt: string
version: number
}
export type LoadingListSummary = PreloadSummary | ConfirmedSummary
export interface LoadingItem {
itemId: string
accountId: string
customerName: string | null
inboundId: string
inboundDetailId: string
inboundCode: string | null
skuCode: string | null
destinationWarehouse: string | null
chineseName: string | null
englishName: string | null
goodsImageUrl: string | null
packageCount: number
palletCount: number
grossWeightKg: number
netWeightKg: number
volumeCbm: number
dimensionalWeightKg: number
productQuantity: string
unitsPerPackage: number
fbaTrackingNo: string | null
shipmentNo: string | null
shippingMark: string | null
internalRemark: string | null
customerRemark: string | null
warehouseRemark: string | null
loadSequence: number
frozenAt: string | null
}
export interface LoadingHistory {
historyId: string
itemId: string | null
actionType: string
fromStatus: string | null
toStatus: string | null
beforeSnapshot: string | null
afterSnapshot: string | null
operatorId: string
operatorName: string | null
operationReason: string | null
occurredAt: string
}
2026-08-13 11:57:44 +08:00
export interface BusinessDocument {
id: string | null
documentType: string
fileId: string
fileName: string
fileHash: string | null
uploadedBy: string | null
uploadedByName: string | null
uploadedAt: string | null
completedBy: string | null
completedByName: string | null
completedAt: string | null
version: number
}
2026-08-10 15:36:53 +08:00
export interface LoadingDetail<T extends LoadingListSummary = LoadingListSummary> {
summary: T
items: LoadingItem[]
histories: LoadingHistory[]
2026-08-13 11:57:44 +08:00
customsDocument?: BusinessDocument | null
2026-08-10 15:36:53 +08:00
}
export interface LoadingListPage<T extends LoadingListSummary = LoadingListSummary> {
records: T[]
page: number
size: number
total: number
pages: number
}
export interface LoadingListQuery {
page: number
size: number
2026-08-10 17:42:17 +08:00
warehouseId?: string
2026-08-10 15:36:53 +08:00
keyword?: string
createdFrom?: string
createdTo?: string
}
export interface TransportUpdateRequest {
containerNo: string | null
voyageNo: string | null
expectedVersion: number
operationReason: string | null
}
type RawId = string | number | null | undefined
type RawPage<T extends LoadingListSummary> = Omit<LoadingListPage<T>, 'page' | 'size' | 'total' | 'pages'> & {
page: string | number
size: string | number
total: string | number
pages: string | number
}
const basePath = '/platform/v1/first-leg'
function requiredId(value: RawId) {
return String(value ?? '')
}
function optionalId(value: RawId) {
return value === null || value === undefined ? null : String(value)
}
function normalizePreloadSummary(raw: PreloadSummary): PreloadSummary {
return {
...raw,
planId: requiredId(raw.planId),
2026-08-12 17:29:35 +08:00
containerBookingId: requiredId(raw.containerBookingId),
2026-08-10 15:36:53 +08:00
warehouseId: optionalId(raw.warehouseId),
skuCount: String(raw.skuCount ?? '0'),
totalPackageCount: String(raw.totalPackageCount ?? '0'),
customers: (raw.customers || []).map((customer) => ({
...customer,
accountId: requiredId(customer.accountId),
})),
}
}
function normalizeConfirmedSummary(raw: ConfirmedSummary): ConfirmedSummary {
return {
...raw,
planId: requiredId(raw.planId),
2026-08-12 17:29:35 +08:00
containerBookingId: requiredId(raw.containerBookingId),
2026-08-10 15:36:53 +08:00
warehouseId: optionalId(raw.warehouseId),
createdBy: optionalId(raw.createdBy),
totalPackageCount: String(raw.totalPackageCount ?? '0'),
totalQuantity: String(raw.totalQuantity ?? '0'),
}
}
function normalizeItem(raw: LoadingItem): LoadingItem {
return {
...raw,
itemId: requiredId(raw.itemId),
accountId: requiredId(raw.accountId),
inboundId: requiredId(raw.inboundId),
inboundDetailId: requiredId(raw.inboundDetailId),
productQuantity: String(raw.productQuantity ?? '0'),
}
}
function normalizeHistory(raw: LoadingHistory): LoadingHistory {
return {
...raw,
historyId: requiredId(raw.historyId),
itemId: optionalId(raw.itemId),
operatorId: requiredId(raw.operatorId),
}
}
2026-08-13 11:57:44 +08:00
function normalizeDocument(raw: BusinessDocument | null | undefined): BusinessDocument | null {
if (!raw) return null
return { ...raw, id: raw.id == null ? null : requiredId(raw.id), fileId: requiredId(raw.fileId), uploadedBy: optionalId(raw.uploadedBy), completedBy: optionalId(raw.completedBy), version: Number(raw.version ?? 0) }
}
2026-08-10 15:36:53 +08:00
function normalizePage<T extends LoadingListSummary>(raw: RawPage<T>, normalize: (row: T) => T): LoadingListPage<T> {
return {
records: (raw.records || []).map(normalize),
page: Number(raw.page),
size: Number(raw.size),
total: Number(raw.total),
pages: Number(raw.pages),
}
}
function idempotencyKey(planId: string) {
return `admin-preload-transport-${planId}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
}
export async function listPreloadPlans(query: LoadingListQuery) {
const response = await http.get<ApiEnvelope<RawPage<PreloadSummary>>, ApiEnvelope<RawPage<PreloadSummary>>>(
`${basePath}/loading-plans`,
2026-08-11 14:23:46 +08:00
{ params: query },
2026-08-10 15:36:53 +08:00
)
return normalizePage(unwrapApiResponse(response), normalizePreloadSummary)
}
export async function getPreloadPlan(planId: string, warehouseId: string) {
const response = await http.get<ApiEnvelope<LoadingDetail<PreloadSummary>>, ApiEnvelope<LoadingDetail<PreloadSummary>>>(
`${basePath}/loading-plans/${planId}`,
{ params: { warehouseId } },
)
const result = unwrapApiResponse(response)
return {
summary: normalizePreloadSummary(result.summary),
items: (result.items || []).map(normalizeItem),
histories: (result.histories || []).map(normalizeHistory),
2026-08-13 11:57:44 +08:00
customsDocument: normalizeDocument(result.customsDocument),
2026-08-10 15:36:53 +08:00
}
}
export async function updatePreloadTransport(planId: string, warehouseId: string, request: TransportUpdateRequest) {
const response = await http.patch<ApiEnvelope<LoadingDetail<PreloadSummary>>, ApiEnvelope<LoadingDetail<PreloadSummary>>>(
`${basePath}/loading-plans/${planId}/transport`,
request,
{ params: { warehouseId }, headers: { 'Idempotency-Key': idempotencyKey(planId) } },
)
const result = unwrapApiResponse(response)
return {
summary: normalizePreloadSummary(result.summary),
items: (result.items || []).map(normalizeItem),
histories: (result.histories || []).map(normalizeHistory),
2026-08-13 11:57:44 +08:00
customsDocument: normalizeDocument(result.customsDocument),
2026-08-10 15:36:53 +08:00
}
}
2026-08-13 11:57:44 +08:00
export async function getLoadingDeclaration(planId: string, warehouseId: string) {
const response = await http.get<ApiEnvelope<BusinessDocument | null>, ApiEnvelope<BusinessDocument | null>>(`${basePath}/loading-lists/${encodeURIComponent(planId)}/customs`, { params: { warehouseId } })
return normalizeDocument(unwrapApiResponse(response))
}
export async function uploadLoadingDeclaration(planId: string, warehouseId: string, file: File, expectedVersion: number, operationReason?: string | null) {
const body = new FormData()
body.append('file', file)
body.append('expectedVersion', String(expectedVersion))
if (operationReason) body.append('operationReason', operationReason)
const response = await http.post<ApiEnvelope<BusinessDocument>, ApiEnvelope<BusinessDocument>>(`${basePath}/loading-lists/${encodeURIComponent(planId)}/customs/document/upload`, body, { params: { warehouseId }, headers: { 'Content-Type': 'multipart/form-data', 'Idempotency-Key': `loading-customs-upload-${planId}-${Date.now()}` } })
return normalizeDocument(unwrapApiResponse(response))
}
export async function completeLoadingDeclaration(planId: string, warehouseId: string, expectedVersion: number, operationReason?: string | null) {
const response = await http.post<ApiEnvelope<BusinessDocument>, ApiEnvelope<BusinessDocument>>(`${basePath}/loading-lists/${encodeURIComponent(planId)}/customs/complete`, { expectedVersion, operationReason }, { params: { warehouseId }, headers: { 'Idempotency-Key': `loading-customs-complete-${planId}-${Date.now()}` } })
return normalizeDocument(unwrapApiResponse(response))
}
2026-08-10 15:36:53 +08:00
export async function listConfirmedLoadingLists(query: LoadingListQuery) {
const response = await http.get<ApiEnvelope<RawPage<ConfirmedSummary>>, ApiEnvelope<RawPage<ConfirmedSummary>>>(
`${basePath}/loading-lists`,
{ params: query },
)
return normalizePage(unwrapApiResponse(response), normalizeConfirmedSummary)
}
export async function getConfirmedLoadingList(planId: string, warehouseId: string) {
const response = await http.get<ApiEnvelope<LoadingDetail<ConfirmedSummary>>, ApiEnvelope<LoadingDetail<ConfirmedSummary>>>(
`${basePath}/loading-lists/${planId}`,
{ params: { warehouseId } },
)
const result = unwrapApiResponse(response)
return {
summary: normalizeConfirmedSummary(result.summary),
items: (result.items || []).map(normalizeItem),
histories: (result.histories || []).map(normalizeHistory),
}
}