优化

src/modules/overseas-warehouse/api/dispatches.test.ts

@@ -1,6 +1,6 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest'
 import { overseasHttp } from '@/shared/api/overseasHttp'
-import { listDispatchCandidates, listDispatches, lockDispatchDraftPallet, preArrangeDispatch, releaseDispatchDraft, unlockDispatchDraftPallet } from './dispatches'
+import { getDispatch, listDispatchCandidates, listDispatches, lockDispatchDraftPallet, preArrangeDispatch, releaseDispatchDraft, unlockDispatchDraftPallet } from './dispatches'
 
 vi.mock('@/shared/api/overseasHttp', () => ({ overseasHttp: { get: vi.fn(), post: vi.fn() } }))
 
@@ -28,6 +28,14 @@ describe('dispatch overseas API', () => {
     })
   })
 
+  it('loads a platform dispatch detail by encoded dispatch number', async () => {
+    vi.mocked(overseasHttp.get).mockResolvedValue({ code: '200', message: 'success', data: { id: '1', dispatchNo: 'PC/1' } })
+
+    await getDispatch('PC/1')
+
+    expect(overseasHttp.get).toHaveBeenCalledWith('/platform/v1/last-leg/dispatches/PC%2F1')
+  })
+
   it('loads candidates and creates a pre-arrange dispatch in an explicit customer scope', async () => {
     vi.mocked(overseasHttp.get).mockResolvedValue({ code: '200', message: 'success', data: [] })
     vi.mocked(overseasHttp.post).mockResolvedValue({ code: '200', message: 'success', data: { id: '1', dispatchNo: 'PC-1' } })

src/modules/overseas-warehouse/api/dispatches.ts

@@ -84,6 +84,25 @@ export interface DispatchSummaryDto {
   remainingPackageCount?: number | null
   partialCompletionReason?: string | null
   createdAt?: string | null
+  items?: DispatchItemDto[]
+}
+
+export interface DispatchItemDto {
+  id: string
+  planPalletId: string
+  warehousePalletId?: string | null
+  palletNo?: string | null
+  overseasWarehouseId?: string | null
+  overseasWarehouseName?: string | null
+  orderNo?: string | null
+  orderRefs?: string | null
+  inboundCode?: string | null
+  destinationWarehouseCode?: string | null
+  destinationWarehouseName?: string | null
+  fbaWarehouseCode?: string | null
+  packageCount?: number | null
+  volumeCbm?: number | null
+  sourceStage?: string | null
 }
 
 export async function listDispatches(query: DispatchQuery) {
@@ -94,6 +113,13 @@ export async function listDispatches(query: DispatchQuery) {
   return unwrapApiResponse(response)
 }
 
+export async function getDispatch(dispatchNo: string) {
+  const response = await overseasHttp.get<ApiEnvelope<DispatchSummaryDto>, ApiEnvelope<DispatchSummaryDto>>(
+    `/platform/v1/last-leg/dispatches/${encodeURIComponent(dispatchNo)}`,
+  )
+  return unwrapApiResponse(response)
+}
+
 export async function listDispatchCandidates(query: DispatchCandidateQuery) {
   const response = await overseasHttp.get<ApiEnvelope<DispatchPalletCandidateDto[]>, ApiEnvelope<DispatchPalletCandidateDto[]>>(
     '/platform/v1/last-leg/dispatches/candidates',