fix(dispatch): align dispatch actions and native return workflows

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

@@ -1,4 +1,5 @@
 import { http, unwrapApiResponse, type ApiEnvelope } from '@/shared/api/http'
+import { normalizeReturnSource, type ReturnSourceIdentity } from '../returnSource'
 
 import { normalizeOverseasPage, type OverseasPagePayload } from './lastMileOrders'
 import type { DeliveryDocumentSummary } from './deliveryDocuments'
@@ -70,26 +71,27 @@ export interface DeliveryFeeRow { id: string; feeDirection: string; feeType: str
 export interface DeliveryOperationRow { id: string; operatedAt: string; operationNode: string; operatorName?: string | null; result: string }
 export interface DeliveryOrderDetail { order: DeliveryOrderRow; skus: DeliverySkuRow[]; fees: DeliveryFeeRow[]; operations: DeliveryOperationRow[]; feeCoverage?: import('../feeCoverageTypes').FeeCoverageEvidence | null }
 
-export interface DeliveryReturnSource {
+export interface DeliveryReturnSource extends ReturnSourceIdentity {
   outboundPalletItemId: string
-  inventoryPositionId: string
+  cartonMark?: string | null
   palletNo?: string | null
   skuCode?: string | null
   maxReturnPackages: number
 }
 export interface DeliveryReturnRelation {
-  inboundOrderId: string
+  lastMileOrderId: string
+  inboundOrderId?: string | null
   inboundCode?: string | null
   lastMileOrderNo?: string | null
   customerId: string
   returnSources: DeliveryReturnSource[]
 }
 export interface MarkDeliveryReturnPayload {
-  inboundOrderId: string
+  lastMileOrderId: string
   reason: string
   returnDirection: 'OVERSEAS_WAREHOUSE' | 'CUSTOMER' | 'OTHER'
   returnLogisticsNo?: string
-  items: Array<{ outboundPalletItemId: string; inventoryPositionId: string; packageCount: number }>
+  items: Array<ReturnSourceIdentity & { outboundPalletItemId: string; packageCount: number }>
   idempotencyKey: string
 }
 
@@ -120,7 +122,14 @@ export async function listDeliveryReturnInboundOptions(deliveryNo: string, custo
   const response = await http.get<ApiEnvelope<DeliveryReturnRelation[]>, ApiEnvelope<DeliveryReturnRelation[]>>(
     `/platform/v1/last-leg/delivery-orders/${encodeURIComponent(deliveryNo)}/return-inbound-options`, { params: { customerId } },
   )
-  return unwrapApiResponse(response)
+  return unwrapApiResponse(response).map(relation => {
+    if (typeof relation.lastMileOrderId !== 'string' || !/^[1-9]\d*$/.test(relation.lastMileOrderId)) throw new Error('退回候选缺少有效尾程主单标识，请重新加载')
+    return { ...relation, returnSources: relation.returnSources.map(source => {
+    const quantity: unknown = source.maxReturnPackages
+    if ((typeof quantity !== 'number' && typeof quantity !== 'string') || !/^\d+$/.test(String(quantity)) || !Number.isSafeInteger(Number(quantity))) throw new Error('可退箱数无效，请重新加载')
+    return { ...normalizeReturnSource(source), maxReturnPackages: Number(quantity) }
+    }) }
+  })
 }
 
 export async function markDeliveryReturn(deliveryNo: string, customerId: string, payload: MarkDeliveryReturnPayload) {