feat(fleet): integrate trip management and fee coverage workflows

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

@@ -235,6 +235,9 @@ export async function releaseDispatchDraft(draftToken: string) {
 export interface TransferDeliveryItem { deliveryNo: string; deliveryStatus: string; destinationWarehouseId?: string | null; destinationWarehouseCode?: string | null; destinationWarehouseName?: string | null; palletCount: number; packageCount: number }
 export interface TransferDeliveryResult { dispatchNo: string; outboundNo: string; outboundStatus: string; palletCount: number; packageCount: number; deliveries: TransferDeliveryItem[]; replayed: boolean }
 export interface TransferDeliveryPayload {
+  feeCoverageCargoHash?: string
+  feeCoverage?: import('../feeCoverageTypes').FeeCoverageSelection[]
+  externalFreightHash?: string
   idempotencyKey: string
   plannedDeliveryAt: string
   deliveryMethod: string
@@ -262,3 +265,24 @@ export async function transferDispatchToDelivery(dispatchNo: string, payload: Tr
   )
   return unwrapApiResponse(response)
 }
+
+export interface ExternalFreightPreview {
+  snapshotHash: string
+  requiresDeliveryFee: boolean
+  quotes: Array<{ bookingNo: string; recordVersion: string | number; incomingNo: string; inboundCode: string;
+    customerName: string; destinationKey: string; currency: string; amount: number; quantity: number; quantityUnit: string; unitPrice: number }>
+}
+export async function getDispatchExternalFreight(dispatchNo: string): Promise<ExternalFreightPreview> {
+  const response = await http.get<ApiEnvelope<ExternalFreightPreview>, ApiEnvelope<ExternalFreightPreview>>(
+    `/platform/v1/last-leg/dispatches/${encodeURIComponent(dispatchNo)}/external-freight`,
+  )
+  return unwrapApiResponse(response)
+}
+
+export async function getDispatchFeeCoverage(dispatchNo: string): Promise<import('../feeCoverageTypes').FeeCoveragePreview> {
+  const response = await http.get<ApiEnvelope<import('../feeCoverageTypes').FeeCoveragePreview>, ApiEnvelope<import('../feeCoverageTypes').FeeCoveragePreview>>(
+    `/platform/v1/last-leg/dispatches/${encodeURIComponent(dispatchNo)}/fee-coverage`,
+  )
+  const data = unwrapApiResponse(response)
+  return { ...data, cargo: data.cargo.map(row => ({ ...row, dispatchItemId: String(row.dispatchItemId), warehousePalletId: String(row.warehousePalletId), orderId: row.orderId == null ? null : String(row.orderId), sourceInboundId: row.sourceInboundId == null ? null : String(row.sourceInboundId), packages: Number(row.packages) })), feeSources: data.feeSources.map(row => ({ ...row, financeFeeId: String(row.financeFeeId), sourceFeeId: String(row.sourceFeeId), customerId: String(row.customerId), sourceInboundId: String(row.sourceInboundId), sourceVersion: Number(row.sourceVersion), amount: Number(row.amount) })) }
+}