feat: complete overseas customer and PDA workflows

lastleg-service/src/main/resources/openapi/overseas-business-v1.yaml

@@ -86,7 +86,7 @@ paths:
       description: 权限 lastleg:pda:operate；FBA 从完整 cartonMark 的第一个 # 前提取固定入仓码，并精确匹配当前锁定柜唯一 FBA line；不要求逐箱 manifest，不校验 SKU 或箱序号。OVERSEAS 必须命中真实 manifest。两者均不返回 SKU，也不登记收货。
       security: [{ bearerAuth: [] }]
       requestBody: { required: true, content: { application/json: { schema: { type: object, required: [cartonMark], properties: { cartonMark: { type: string } } } } } }
-      responses: { '200': { description: 箱唛与入仓码信息, content: { application/json: { schema: { $ref: '#/components/schemas/ReceivingCartonResolvedApiResponse' } } } }, '404': { description: 入仓码未命中当前柜，或 OVERSEAS 箱码未命中真实 manifest }, '409': { description: 缺少 #、空入仓码前缀、跨柜或当前柜多重命中 } }
+      responses: { '200': { description: 箱唛与入仓码信息, content: { application/json: { schema: { $ref: '#/components/schemas/ReceivingCartonResolvedApiResponse' } } } }, '404': { description: 入仓码未命中当前柜，或 OVERSEAS 箱码未命中真实 manifest }, '409': { description: '缺少 #、空入仓码前缀、跨柜或当前柜多重命中' } }
   /api/pda/v1/last-leg/receiving-containers/current/pallets/resolve:
     post:
       summary: 解析当前柜实物托盘码
@@ -714,20 +714,125 @@ paths:
   /api/merchant/v1/last-leg/overseas-procurements:
     post:
       summary: 客户创建海外采购订单
-      description: 客户 ID 只取认证身份；新单固定进入 PENDING_REVIEW。
+      description: 权限 merchant:cross-border:procurement；客户 ID 只取认证身份且不接收 customerId；新单固定进入 PENDING_REVIEW。同幂等键同请求返回既有订单，异请求返回 A0409。
       security: [{ bearerAuth: [] }]
       requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/ProcurementCreate' } } } }
-      responses: { '200': { description: 统一 ApiResponse 包装的采购订单详情 } }
+      responses: { '200': { description: 采购订单详情, content: { application/json: { schema: { $ref: '#/components/schemas/ProcurementDetailResponse' } } } }, '409': { description: 幂等冲突 } }
     get:
       summary: 客户分页查询自己的海外采购订单
+      description: 权限 merchant:cross-border:procurement；客户范围只取认证 Token，不接收 customerId。
       security: [{ bearerAuth: [] }]
-      responses: { '200': { description: 统一 ApiResponse 包装的采购订单分页 } }
+      parameters:
+        - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } }
+        - { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 200, default: 20 } }
+        - { name: orderNo, in: query, schema: { type: string } }
+        - { name: purchaseCategory, in: query, schema: { type: string } }
+        - { name: productName, in: query, schema: { type: string } }
+        - { name: status, in: query, schema: { type: string } }
+        - { name: purchaseWarehouseId, in: query, schema: { type: string } }
+        - { name: createdFrom, in: query, schema: { type: string, format: date-time } }
+        - { name: createdTo, in: query, schema: { type: string, format: date-time } }
+      responses: { '200': { description: 当前客户采购订单分页, content: { application/json: { schema: { $ref: '#/components/schemas/ProcurementPageResponse' } } } } }
   /api/merchant/v1/last-leg/overseas-procurements/{orderNo}:
     get:
       summary: 客户查询自己的海外采购订单详情及流水
+      description: 权限 merchant:cross-border:procurement；列表权限包含详情只读，客户范围只取认证 Token。
       security: [{ bearerAuth: [] }]
       parameters: [{ name: orderNo, in: path, required: true, schema: { type: string } }]
-      responses: { '200': { description: 统一 ApiResponse 包装的采购订单详情 } }
+      responses: { '200': { description: 当前客户采购订单详情, content: { application/json: { schema: { $ref: '#/components/schemas/ProcurementDetailResponse' } } } }, '404': { description: 当前客户下订单不存在 } }
+  /api/merchant/v1/last-leg/us-truck-orders:
+    get:
+      summary: 客户分页查询自己的美国本土卡订单
+      description: 权限 merchant:cross-border:domestic-trucking；客户范围只取认证 Token，不接收 customerId。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } }
+        - { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 200, default: 20 } }
+        - { name: orderNo, in: query, schema: { type: string } }
+        - { name: routeKeyword, in: query, schema: { type: string } }
+        - { name: status, in: query, schema: { $ref: '#/components/schemas/TruckStatus' } }
+        - { name: transportType, in: query, schema: { type: string } }
+        - { name: requestedFrom, in: query, schema: { type: string, format: date } }
+        - { name: requestedTo, in: query, schema: { type: string, format: date } }
+      responses: { '200': { description: 当前客户本土卡订单分页, content: { application/json: { schema: { $ref: '#/components/schemas/TruckPageResponse' } } } } }
+    post:
+      summary: 客户创建美国本土卡订单
+      description: 权限 merchant:cross-border:domestic-trucking；新单固定进入 PENDING_REVIEW，客户不能调用平台审核或状态推进端点。
+      security: [{ bearerAuth: [] }]
+      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/TruckCreate' } } } }
+      responses: { '200': { description: 本土卡订单详情, content: { application/json: { schema: { $ref: '#/components/schemas/TruckDetailResponse' } } } }, '409': { description: 幂等冲突 } }
+  /api/merchant/v1/last-leg/us-truck-orders/{orderNo}:
+    parameters: [{ name: orderNo, in: path, required: true, schema: { type: string } }]
+    get:
+      summary: 客户查询自己的美国本土卡订单详情
+      description: 权限 merchant:cross-border:domestic-trucking；不泄露其他客户订单。
+      security: [{ bearerAuth: [] }]
+      responses: { '200': { description: 当前客户本土卡订单详情, content: { application/json: { schema: { $ref: '#/components/schemas/TruckDetailResponse' } } } }, '404': { description: 当前客户下订单不存在 } }
+    patch:
+      summary: 客户编辑待审核的美国本土卡订单
+      description: 权限 merchant:cross-border:domestic-trucking；仅 PENDING_REVIEW 可编辑，version 必填；不能修改状态。
+      security: [{ bearerAuth: [] }]
+      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/TruckUpdate' } } } }
+      responses: { '200': { description: 更新后的订单详情, content: { application/json: { schema: { $ref: '#/components/schemas/TruckDetailResponse' } } } }, '409': { description: 版本或状态冲突 } }
+  /api/merchant/v1/last-leg/local-looseboard-orders:
+    get:
+      summary: 客户分页查询自己的本土散板订单
+      description: 权限 merchant:cross-border:pallet-shipping；客户范围只取认证 Token，不接收 customerId。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } }
+        - { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 200, default: 20 } }
+        - { name: orderNo, in: query, schema: { type: string } }
+        - { name: routeKeyword, in: query, schema: { type: string } }
+        - { name: status, in: query, schema: { $ref: '#/components/schemas/LooseboardStatus' } }
+        - { name: transportMode, in: query, schema: { type: string, enum: [SHARED_TRUCK, PRIORITY_CONSOLIDATION] } }
+        - { name: requestedFrom, in: query, schema: { type: string, format: date } }
+        - { name: requestedTo, in: query, schema: { type: string, format: date } }
+      responses: { '200': { description: 当前客户本土散板订单分页, content: { application/json: { schema: { $ref: '#/components/schemas/LooseboardPageResponse' } } } } }
+    post:
+      summary: 客户创建本土散板订单
+      description: 权限 merchant:cross-border:pallet-shipping；新单固定进入 PENDING_ACCEPTANCE，客户不能调用平台状态推进端点。
+      security: [{ bearerAuth: [] }]
+      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/LooseboardCreate' } } } }
+      responses: { '200': { description: 本土散板订单详情, content: { application/json: { schema: { $ref: '#/components/schemas/LooseboardDetailResponse' } } } }, '409': { description: 幂等冲突 } }
+  /api/merchant/v1/last-leg/local-looseboard-orders/{orderNo}:
+    parameters: [{ name: orderNo, in: path, required: true, schema: { type: string } }]
+    get:
+      summary: 客户查询自己的本土散板订单详情
+      description: 权限 merchant:cross-border:pallet-shipping；不泄露其他客户订单。
+      security: [{ bearerAuth: [] }]
+      responses: { '200': { description: 当前客户本土散板订单详情, content: { application/json: { schema: { $ref: '#/components/schemas/LooseboardDetailResponse' } } } }, '404': { description: 当前客户下订单不存在 } }
+    put:
+      summary: 客户编辑待接单的本土散板订单
+      description: 权限 merchant:cross-border:pallet-shipping；仅 PENDING_ACCEPTANCE 可编辑，version 必填；不能修改状态。
+      security: [{ bearerAuth: [] }]
+      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/LooseboardUpdate' } } } }
+      responses: { '200': { description: 更新后的订单详情, content: { application/json: { schema: { $ref: '#/components/schemas/LooseboardDetailResponse' } } } }, '409': { description: 版本或状态冲突 } }
+  /api/merchant/v1/last-leg/inbound-plans:
+    get:
+      summary: 客户分页查询自己的海外入库订单
+      description: 权限 merchant:warehouse:inbound:list；客户范围只取认证 Token，不接收 customerId。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } }
+        - { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 200, default: 20 } }
+        - { name: planNo, in: query, schema: { type: string } }
+        - { name: inboundCode, in: query, schema: { type: string } }
+        - { name: status, in: query, schema: { type: string } }
+        - { name: overseasWarehouseId, in: query, schema: { type: string } }
+        - { name: destinationWarehouseCode, in: query, schema: { type: string } }
+        - { name: appointmentStatus, in: query, schema: { type: string, enum: [UNAPPOINTED, PENDING, SUCCESS, FAILED, CANCELLED] } }
+        - { name: dispatchStatus, in: query, schema: { type: string, enum: [UNSCHEDULED, SCHEDULED] } }
+        - { name: createdFrom, in: query, schema: { type: string, format: date-time } }
+        - { name: createdTo, in: query, schema: { type: string, format: date-time } }
+      responses: { '200': { description: 当前客户入库订单分页, content: { application/json: { schema: { $ref: '#/components/schemas/InboundPlanPageResponse' } } } } }
+  /api/merchant/v1/last-leg/inbound-plans/{planNo}:
+    get:
+      summary: 客户查询自己的海外入库订单详情
+      description: 权限 merchant:warehouse:inbound:list；列表权限包含详情只读，不接收 customerId。
+      security: [{ bearerAuth: [] }]
+      parameters: [{ name: planNo, in: path, required: true, schema: { type: string } }]
+      responses: { '200': { description: 当前客户入库订单详情, content: { application/json: { schema: { $ref: '#/components/schemas/InboundPlanDetailResponse' } } } }, '404': { description: 当前客户下入库订单不存在 } }
   /api/platform/v1/last-leg/us-truck-orders:
     get:
       summary: 分页查询本土卡车订单
@@ -1570,6 +1675,325 @@ components:
       properties:
         status: { $ref: '#/components/schemas/RelabelStatus' }
         remark: { type: string, nullable: true, maxLength: 1000 }
+    MerchantApiResponse:
+      type: object
+      required: [code, data]
+      properties:
+        code: { type: string, example: '200' }
+        message: { type: string, nullable: true }
+        data: { nullable: true }
+        requestId: { type: string, nullable: true }
+        traceId: { type: string, nullable: true }
+        timestamp: { type: string, format: date-time, nullable: true }
+    ProcurementPageResponse:
+      allOf:
+        - { $ref: '#/components/schemas/MerchantApiResponse' }
+        - type: object
+          properties: { data: { $ref: '#/components/schemas/ProcurementPage' } }
+    ProcurementDetailResponse:
+      allOf:
+        - { $ref: '#/components/schemas/MerchantApiResponse' }
+        - type: object
+          properties: { data: { $ref: '#/components/schemas/ProcurementDetail' } }
+    TruckPageResponse:
+      allOf:
+        - { $ref: '#/components/schemas/MerchantApiResponse' }
+        - type: object
+          properties: { data: { $ref: '#/components/schemas/TruckPage' } }
+    TruckDetailResponse:
+      allOf:
+        - { $ref: '#/components/schemas/MerchantApiResponse' }
+        - type: object
+          properties: { data: { $ref: '#/components/schemas/TruckDetail' } }
+    LooseboardPageResponse:
+      allOf:
+        - { $ref: '#/components/schemas/MerchantApiResponse' }
+        - type: object
+          properties: { data: { $ref: '#/components/schemas/LooseboardPage' } }
+    LooseboardDetailResponse:
+      allOf:
+        - { $ref: '#/components/schemas/MerchantApiResponse' }
+        - type: object
+          properties: { data: { $ref: '#/components/schemas/LooseboardDetail' } }
+    InboundPlanPageResponse:
+      allOf:
+        - { $ref: '#/components/schemas/MerchantApiResponse' }
+        - type: object
+          properties: { data: { $ref: '#/components/schemas/InboundPlanPage' } }
+    InboundPlanDetailResponse:
+      allOf:
+        - { $ref: '#/components/schemas/MerchantApiResponse' }
+        - type: object
+          properties: { data: { $ref: '#/components/schemas/InboundPlanDetail' } }
+    PageMetadata:
+      type: object
+      required: [page, size, total, pages]
+      properties:
+        page: { type: integer, format: int64 }
+        size: { type: integer, format: int64 }
+        total: { type: integer, format: int64 }
+        pages: { type: integer, format: int64 }
+    ProcurementPage:
+      allOf:
+        - { $ref: '#/components/schemas/PageMetadata' }
+        - type: object
+          required: [records]
+          properties: { records: { type: array, items: { $ref: '#/components/schemas/ProcurementSummary' } } }
+    ProcurementSummary:
+      type: object
+      required: [id, orderNo, customerId, purchaseCategory, productName, purchaseQuantity, inboundQuantity, outboundQuantity, inventoryQuantity, status, version, createdAt, updatedAt]
+      properties:
+        id: { type: string, pattern: '^[0-9]+$' }
+        orderNo: { type: string }
+        customerId: { type: string }
+        customerName: { type: string, nullable: true }
+        purchaseCategory: { type: string }
+        productName: { type: string }
+        productSpecification: { type: string, nullable: true }
+        purchaseQuantity: { type: integer, format: int64 }
+        budgetUnitPrice: { type: number, nullable: true }
+        currency: { type: string, nullable: true }
+        purchaseWarehouseId: { type: string, nullable: true }
+        purchaseWarehouseName: { type: string, nullable: true }
+        inboundQuantity: { type: integer, format: int64 }
+        outboundQuantity: { type: integer, format: int64 }
+        inventoryQuantity: { type: integer, format: int64 }
+        status: { type: string, description: PENDING_REVIEW/APPROVED/REJECTED 或按审核后出库数量派生的 PENDING_OUTBOUND/PARTIALLY_OUTBOUND/OUTBOUNDED }
+        version: { type: integer, format: int64 }
+        createdAt: { type: string, format: date-time }
+        updatedAt: { type: string, format: date-time }
+    ProcurementDetail:
+      type: object
+      required: [summary, histories, outboundDetails]
+      properties:
+        summary: { $ref: '#/components/schemas/ProcurementSummary' }
+        productUrl: { type: string, nullable: true }
+        receivingAddress: { type: string, nullable: true }
+        contactName: { type: string, nullable: true }
+        contactPhone: { type: string, nullable: true }
+        domesticCarrier: { type: string, nullable: true }
+        domesticTrackingNo: { type: string, nullable: true }
+        overseasCarrier: { type: string, nullable: true }
+        overseasTrackingNo: { type: string, nullable: true }
+        estimatedArrivalAt: { type: string, format: date-time, nullable: true }
+        remark: { type: string, nullable: true }
+        createdBy: { type: string, nullable: true }
+        reviewedBy: { type: string, nullable: true }
+        reviewRemark: { type: string, nullable: true }
+        reviewedAt: { type: string, format: date-time, nullable: true }
+        histories: { type: array, items: { $ref: '#/components/schemas/BusinessHistory' } }
+        outboundDetails: { type: array, items: { $ref: '#/components/schemas/ProcurementOutboundDetail' } }
+    ProcurementOutboundDetail:
+      type: object
+      properties:
+        id: { type: string }
+        quantity: { type: integer, format: int64 }
+        carrier: { type: string, nullable: true }
+        trackingNo: { type: string, nullable: true }
+        shippedAt: { type: string, format: date-time, nullable: true }
+        remark: { type: string, nullable: true }
+    TruckPage:
+      allOf:
+        - { $ref: '#/components/schemas/PageMetadata' }
+        - type: object
+          required: [records]
+          properties: { records: { type: array, items: { $ref: '#/components/schemas/TruckSummary' } } }
+    TruckSummary:
+      type: object
+      required: [id, customerId, orderNo, origin, destination, palletCount, packageCount, receivedPalletCount, allocatedPalletCount, totalWeightKg, totalVolumeCbm, status, version, createdAt, updatedAt]
+      properties:
+        id: { type: string, pattern: '^[0-9]+$' }
+        customerId: { type: string }
+        orderNo: { type: string }
+        transportType: { type: string, nullable: true }
+        origin: { type: string }
+        destination: { type: string }
+        containerType: { type: string, nullable: true }
+        palletCount: { type: integer }
+        packageCount: { type: integer }
+        receivedPalletCount: { type: integer }
+        allocatedPalletCount: { type: integer }
+        totalWeightKg: { type: number }
+        totalVolumeCbm: { type: number }
+        budgetAmount: { type: number, nullable: true }
+        currency: { type: string, nullable: true }
+        contactName: { type: string, nullable: true }
+        contactInfo: { type: string, nullable: true }
+        requestedDate: { type: string, format: date, nullable: true }
+        status: { $ref: '#/components/schemas/TruckStatus' }
+        version: { type: integer, format: int64 }
+        createdAt: { type: string, format: date-time }
+        updatedAt: { type: string, format: date-time }
+    TruckDetail:
+      type: object
+      required: [summary, pallets, histories]
+      properties:
+        summary: { $ref: '#/components/schemas/TruckSummary' }
+        originAddress: { type: string, nullable: true }
+        destinationAddress: { type: string, nullable: true }
+        remark: { type: string, nullable: true }
+        createdBy: { type: string, nullable: true }
+        pallets: { type: array, items: { $ref: '#/components/schemas/TruckPallet' } }
+        histories: { type: array, items: { $ref: '#/components/schemas/BusinessHistory' } }
+    TruckPallet:
+      type: object
+      properties:
+        id: { type: string, pattern: '^[0-9]+$' }
+        palletNo: { type: string }
+        sequenceNo: { type: integer }
+        source: { type: string }
+        status: { type: string }
+        warehousePalletId: { type: string, pattern: '^[0-9]+$', nullable: true }
+        packageCount: { type: integer, nullable: true }
+        receivedAt: { type: string, format: date-time, nullable: true }
+    LooseboardPage:
+      allOf:
+        - { $ref: '#/components/schemas/PageMetadata' }
+        - type: object
+          required: [records]
+          properties: { records: { type: array, items: { $ref: '#/components/schemas/LooseboardSummary' } } }
+    LooseboardSummary:
+      type: object
+      required: [id, customerId, orderNo, transportMode, palletRequired, transportType, origin, destination, packageCount, totalWeightKg, totalVolumeCbm, status, version, createdAt, updatedAt]
+      properties:
+        id: { type: string, pattern: '^[0-9]+$' }
+        customerId: { type: string }
+        orderNo: { type: string }
+        transportMode: { type: string, enum: [SHARED_TRUCK, PRIORITY_CONSOLIDATION] }
+        palletRequired: { type: string, enum: [YES, NO] }
+        transportType: { type: string }
+        origin: { type: string }
+        destination: { type: string }
+        containerType: { type: string, nullable: true }
+        packageCount: { type: integer }
+        totalWeightKg: { type: number }
+        totalVolumeCbm: { type: number }
+        budgetAmount: { type: number, nullable: true }
+        currency: { type: string, nullable: true }
+        contactName: { type: string, nullable: true }
+        contactInfo: { type: string, nullable: true }
+        requestedDate: { type: string, format: date, nullable: true }
+        status: { $ref: '#/components/schemas/LooseboardStatus' }
+        version: { type: integer, format: int64 }
+        createdAt: { type: string, format: date-time }
+        updatedAt: { type: string, format: date-time }
+    LooseboardDetail:
+      type: object
+      required: [summary, histories]
+      properties:
+        summary: { $ref: '#/components/schemas/LooseboardSummary' }
+        originAddress: { type: string, nullable: true }
+        destinationAddress: { type: string, nullable: true }
+        remark: { type: string, nullable: true }
+        createdBy: { type: string, nullable: true }
+        histories: { type: array, items: { $ref: '#/components/schemas/BusinessHistory' } }
+    BusinessHistory:
+      type: object
+      properties:
+        operationType: { type: string }
+        fromStatus: { type: string, nullable: true }
+        toStatus: { type: string, nullable: true }
+        operatorId: { type: string, nullable: true }
+        idempotencyKey: { type: string, nullable: true }
+        changeDetail: { type: string, nullable: true }
+        remark: { type: string, nullable: true }
+        createdAt: { type: string, format: date-time }
+    InboundPlanPage:
+      allOf:
+        - { $ref: '#/components/schemas/PageMetadata' }
+        - type: object
+          required: [records]
+          properties: { records: { type: array, items: { $ref: '#/components/schemas/InboundPlanSummary' } } }
+    InboundPlanSummary:
+      type: object
+      required: [lineId, planId, planNo, customerId, orderId, inboundCode, packageCount, pickedPackageCount, palletCount, status, createdAt, version]
+      properties:
+        lineId: { type: string, pattern: '^[0-9]+$' }
+        planId: { type: string, pattern: '^[0-9]+$' }
+        planNo: { type: string }
+        customerId: { type: string }
+        orderId: { type: string, pattern: '^[0-9]+$' }
+        inboundCode: { type: string }
+        orderType: { type: string, nullable: true }
+        warehouseId: { type: string, nullable: true }
+        warehouseCode: { type: string, nullable: true }
+        warehouseName: { type: string, nullable: true }
+        fbaWarehouseCode: { type: string, nullable: true }
+        customerName: { type: string, nullable: true }
+        packageCount: { type: integer }
+        pickedPackageCount: { type: integer }
+        volumeCbm: { type: number, nullable: true }
+        palletCount: { type: integer }
+        status: { type: string }
+        appointmentNo: { type: string, nullable: true }
+        appointmentStatus: { type: string, nullable: true }
+        appointmentAt: { type: string, format: date-time, nullable: true }
+        expectedLoadingAt: { type: string, format: date-time, nullable: true }
+        dispatchStatus: { type: string, nullable: true }
+        createdAt: { type: string, format: date-time }
+        version: { type: integer }
+    InboundPlanDetail:
+      type: object
+      required: [id, planNo, customerId, status, lineCount, palletCount, totalVolumeCbm, expectedPackageCount, pickedPackageCount, lines, pallets, allocations, version]
+      properties:
+        id: { type: string, pattern: '^[0-9]+$' }
+        planNo: { type: string }
+        customerId: { type: string }
+        sourceOrderId: { type: string, pattern: '^[0-9]+$', nullable: true }
+        containerNo: { type: string, nullable: true }
+        status: { type: string }
+        lineCount: { type: integer }
+        palletCount: { type: integer }
+        totalVolumeCbm: { type: number }
+        expectedPackageCount: { type: integer }
+        pickedPackageCount: { type: integer }
+        lines: { type: array, items: { $ref: '#/components/schemas/InboundPlanLine' } }
+        pallets: { type: array, items: { $ref: '#/components/schemas/InboundPlanPallet' } }
+        allocations: { type: array, items: { $ref: '#/components/schemas/InboundPlanAllocation' } }
+        version: { type: integer }
+    InboundPlanLine:
+      type: object
+      properties:
+        id: { type: string, pattern: '^[0-9]+$' }
+        orderId: { type: string, pattern: '^[0-9]+$' }
+        inboundCode: { type: string }
+        fbaWarehouseCode: { type: string, nullable: true }
+        destinationWarehouseId: { type: string, nullable: true }
+        destinationWarehouseCode: { type: string, nullable: true }
+        destinationWarehouseName: { type: string, nullable: true }
+        volumeCbm: { type: number }
+        requiredPackageCount: { type: integer }
+        plannedPalletCount: { type: integer }
+    InboundPlanPallet:
+      type: object
+      properties:
+        id: { type: string, pattern: '^[0-9]+$' }
+        palletNo: { type: string }
+        destinationWarehouseId: { type: string, nullable: true }
+        destinationWarehouseCode: { type: string, nullable: true }
+        destinationWarehouseName: { type: string, nullable: true }
+        capacityCbm: { type: number }
+        allocatedVolumeCbm: { type: number }
+        sequenceNo: { type: integer }
+        warehousePalletId: { type: string, pattern: '^[0-9]+$', nullable: true }
+        warehouseLocationId: { type: string, pattern: '^[0-9]+$', nullable: true }
+        warehouseResourceLockId: { type: string, pattern: '^[0-9]+$', nullable: true }
+        assignmentStatus: { type: string, nullable: true }
+        lockedAt: { type: string, format: date-time, nullable: true }
+        actualVolumeCbm: { type: number, nullable: true }
+        actualPackageCount: { type: integer }
+    InboundPlanAllocation:
+      type: object
+      properties:
+        lineId: { type: string, pattern: '^[0-9]+$' }
+        palletId: { type: string, pattern: '^[0-9]+$' }
+        allocatedVolumeCbm: { type: number }
+        plannedPackageCount: { type: integer }
+        countedPackageCount: { type: integer }
+        pickedPackageCount: { type: integer }
+        actualVolumeCbm: { type: number, nullable: true }
+        status: { type: string }
+        version: { type: integer }
     ProcurementStatus: { type: string, enum: [PENDING_REVIEW, APPROVED, REJECTED] }
     ProcurementReview:
       type: object