Files
admin-web/src/modules/first-leg-orders/api/platformFirstLegOrders.ts
T

172 lines
5.2 KiB
TypeScript
Raw Normal View History

2026-08-03 18:49:18 +08:00
import { http, unwrapApiResponse, type ApiEnvelope } from '@/shared/api/http'
2026-07-31 13:43:16 +08:00
export type PlatformFirstLegOrderStatus =
| 'DRAFT'
| 'SUBMITTED'
| 'APPROVED'
| 'ACCEPTED'
| 'REJECTED'
| 'CANCELLED'
| 'PROCESSING'
| 'COMPLETED'
export interface PlatformFirstLegOrderResource {
id: number | string
tenantId: number | string
orderNo: string | null
customerId: number | string | null
customerName: string
status: PlatformFirstLegOrderStatus
transportMode: 'SEA' | 'AIR' | 'RAIL' | 'TRUCK'
tradeTerm: string | null
destinationCountryCode: string
destinationWarehouseId: number | string | null
destinationWarehouseName: string
expectedShipDate: string | null
customerRemark: string | null
pickupMethod: string
receivingWarehouseId: number | string
receivingWarehouseName: string
receivingWarehouseAddress: string | null
receivingTime: string | null
channelCode: string
channelName: string
taxMode: string
containerMode: string | null
customsInspection: boolean | null
destinationType: string
amazonWarehouseCode: string | null
shipmentId: string | null
referenceId: string | null
expressCompany: string | null
expressTrackingNo: string | null
createdAt: string
updatedAt: string
}
export interface PlatformFirstLegCargoResource {
id: number | string
itemNo: number
cargoName: string
cargoNameEn: string | null
packageType: string
packageCount: number
grossWeightKg: number
volumeCbm: number
totalQuantity: number | null
cargoRemark: string | null
}
export interface PlatformFirstLegPartyResource {
id: number | string
partyType: 'SENDER' | 'RECEIVER' | string
companyName: string
contactName: string
phone: string
email: string | null
countryCode: string
province: string | null
city: string
district: string | null
addressLine: string
postalCode: string | null
}
export interface PlatformOrderStatusHistoryResource {
id: number | string
fromStatus: PlatformFirstLegOrderStatus | null
toStatus: PlatformFirstLegOrderStatus
action: string
reason: string | null
operatorName: string | null
occurredAt: string
}
export interface PlatformOrderInternalNoteResource {
id: number | string
content: string
createdAt: string
createdBy: number | string | null
}
export interface PlatformFirstLegOrderDetailResource {
order: PlatformFirstLegOrderResource
cargoes: PlatformFirstLegCargoResource[]
parties: PlatformFirstLegPartyResource[]
internalNotes: PlatformOrderInternalNoteResource[]
statusHistory: PlatformOrderStatusHistoryResource[]
}
export interface PlatformFirstLegOrderPageResource {
records: PlatformFirstLegOrderResource[]
page: number
size: number
total: number
pages: number
}
export interface PlatformFirstLegOrderQuery {
keyword?: string
status?: PlatformFirstLegOrderStatus
customerId?: string
destinationWarehouseId?: string
createdFrom?: string
createdTo?: string
page: number
size: number
}
async function getData<T>(path: string, params?: Record<string, unknown>) {
const response = await http.get<ApiEnvelope<T>, ApiEnvelope<T>>(path, { params })
return unwrapApiResponse(response)
}
async function postData<T>(path: string, body?: unknown, params?: Record<string, unknown>) {
const response = await http.post<ApiEnvelope<T>, ApiEnvelope<T>>(path, body, { params })
return unwrapApiResponse(response)
}
export function listPlatformFirstLegOrders(tenantId: string, query: PlatformFirstLegOrderQuery) {
return getData<PlatformFirstLegOrderPageResource>('/platform/v1/orders/first-leg', { tenantId, ...query })
}
export function getPlatformFirstLegOrder(tenantId: string, orderId: string) {
return getData<PlatformFirstLegOrderDetailResource>(`/platform/v1/orders/first-leg/${orderId}`, { tenantId })
}
export function approvePlatformFirstLegOrder(tenantId: string, orderId: string) {
return postData<void>(`/platform/v1/orders/first-leg/${orderId}/approve`, undefined, { tenantId })
}
export function acceptPlatformFirstLegOrder(tenantId: string, orderId: string) {
return postData<void>(`/platform/v1/orders/first-leg/${orderId}/accept`, undefined, { tenantId })
}
export function startPlatformFirstLegOrder(tenantId: string, orderId: string) {
return postData<void>(`/platform/v1/orders/first-leg/${orderId}/start`, undefined, { tenantId })
}
export function completePlatformFirstLegOrder(tenantId: string, orderId: string) {
return postData<void>(`/platform/v1/orders/first-leg/${orderId}/complete`, undefined, { tenantId })
}
export function cancelPlatformFirstLegOrder(tenantId: string, orderId: string, reason: string) {
return postData<void>(`/platform/v1/orders/first-leg/${orderId}/cancel`, { reason }, { tenantId })
}
export function addPlatformFirstLegOrderNote(tenantId: string, orderId: string, content: string) {
return postData<number | string>(`/platform/v1/orders/first-leg/${orderId}/internal-notes`, { content }, { tenantId })
}
export function updatePlatformFirstLegOrderExpress(
tenantId: string,
orderId: string,
payload: { expressCompany: string; expressTrackingNo: string },
) {
return http.put<ApiEnvelope<void>, ApiEnvelope<void>>(
`/platform/v1/orders/first-leg/${orderId}/express`,
payload,
{ params: { tenantId } },
).then(unwrapApiResponse)
}