fix(admin): add inbound shortage confirmation action

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

@@ -1,10 +1,16 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest'
 import { http } from '@/shared/api/http'
-import { getInboundPlan, listInboundPlans } from './inboundPlans'
+import { confirmInboundShortage, getInboundPlan, listInboundPlans } from './inboundPlans'
 
-vi.mock('@/shared/api/http', async (importOriginal) => ({ ...(await importOriginal<typeof import('@/shared/api/http')>()), http: { get: vi.fn() } }))
+vi.mock('@/shared/api/http', async (importOriginal) => ({ ...(await importOriginal<typeof import('@/shared/api/http')>()), http: { get: vi.fn(), post: vi.fn() } }))
 describe('inbound plan overseas API', () => {
   beforeEach(() => vi.mocked(http.get).mockReset())
+  it('confirms the current shortage with customer, version and idempotency key', async () => {
+    vi.mocked(http.post).mockResolvedValue({ code: '200', data: { status: 'PARTIAL_INBOUND' } })
+    const payload = { customerId: '190000000000000001', version: 4, expectedPackageCount: 21, receivedPackageCount: 20, reason: '短少1箱' }
+    await confirmInboundShortage('IP/1', payload, 'request-key')
+    expect(http.post).toHaveBeenCalledWith('/platform/v1/last-leg/inbound-plans/IP%2F1/confirm-shortage', payload, { headers: { 'Idempotency-Key': 'request-key' } })
+  })
   it('pages plans with explicit customer scope', async () => {
     vi.mocked(http.get).mockResolvedValue({ code: '200', message: 'ok', data: { records: [], page: 1, size: 20, total: 0, pages: 0 } })
     await listInboundPlans({ customerId: '190000000000000001', page: 1, size: 20, inboundCode: 'IN-1' })

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

@@ -45,6 +45,7 @@ export interface InboundPlanSummaryDto {
 }
 
 export interface InboundPlanDetailDto {
+  version?: number
   id: string
   planNo: string
   customerId: string
@@ -81,6 +82,21 @@ export async function getInboundPlan(planNo: string, customerId: string) {
   return unwrapApiResponse(await http.get<ApiEnvelope<InboundPlanDetailDto>, ApiEnvelope<InboundPlanDetailDto>>(`/platform/v1/last-leg/inbound-plans/${encodeURIComponent(planNo)}`, { params: { customerId } }))
 }
 
+export interface ConfirmInboundShortagePayload {
+  customerId: string
+  version: number
+  expectedPackageCount: number
+  receivedPackageCount: number
+  reason: string
+}
+
+export async function confirmInboundShortage(planNo: string, payload: ConfirmInboundShortagePayload, idempotencyKey: string) {
+  return unwrapApiResponse(await http.post<ApiEnvelope<{ status: string }>, ApiEnvelope<{ status: string }>>(
+    `/platform/v1/last-leg/inbound-plans/${encodeURIComponent(planNo)}/confirm-shortage`, payload,
+    { headers: { 'Idempotency-Key': idempotencyKey } },
+  ))
+}
+
 export interface PlatformInventoryMoveRequest {
   overseasWarehouseId: string
   sourcePalletCode: string