修复费用记录、装柜完成及海外履约资料

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

@@ -3582,7 +3582,9 @@ components:
       required: [sourceContainerBookingId, version, planCount]
       properties:
         sourceContainerBookingId: { type: string }
-        estimatedWarehouseArrivalAt: { type: string, format: date-time, nullable: true, description: 人工维护或入库计划冻结的整柜时间；未维护未建计划时为空，由页面按到港当地日期加两个自然日展示默认日期 }
+        estimatedWarehouseArrivalAt: { type: string, format: date-time, nullable: true, description: 人工维护的整柜时间；默认日期及只有日期的冻结计划不补造时间 }
+        plannedDate: { type: string, format: date, nullable: true, description: 与日历和入库计划共用的服务端日期，人工或冻结日期优先，否则按权威到港当地日期加两个自然日 }
+        isDefault: { type: boolean, description: 未人工维护未建计划时使用权威到港推算日期 }
         actualWarehouseArrivalAt: { type: string, format: date-time, nullable: true, description: 海外 PDA 首次开始收货时间 }
         version: { type: integer, minimum: -1, description: -1表示柜内时间版本不一致 }
         planCount: { type: integer, format: int64, minimum: 0, description: 整柜已有入库计划数量；非零时禁止默认推算及改期 }
@@ -4022,6 +4024,11 @@ components:
         remark:
           type: string
           nullable: true
+        maintenance:
+          allOf:
+          - $ref: '#/components/schemas/DispatchMaintenance'
+          nullable: true
+          description: 本趟可空补充资料，八字段均可空；空白字符串规范为null，不替代正式FBA预约或实际发车时间。
       required:
       - publishLooseboardDemand
       - recordVersion
@@ -4558,7 +4565,7 @@ components:
           items: { $ref: '#/components/schemas/LastlegOrderManualNode' }
     ManualInboundPlanRequest:
       type: object
-      description: 单票人工计划只能使用所属柜已冻结的接柜仓；接柜仓变更必须通过柜级接口完成。预计到仓日期由服务端读取来源柜冻结的 estimatedWarehouseArrivalAt，同柜所有计划保持一致，不接受人工提交。
+      description: 单票人工计划只能使用所属柜已冻结的接柜仓；接柜仓变更必须通过柜级接口完成。预计到仓日期由共用服务端解析器返回 plannedDate：人工时间或已有计划冻结日期优先，其余按 Firstleg 权威到港当地日期加两个自然日；同柜所有计划保持一致，不接受人工提交，不补造默认时间。
       required: [customerId, orderId, expectedOrderVersion, palletCount, palletType, assigned, mergeRequired, urgent]
       properties:
         customerId: { type: string, pattern: '^[1-9][0-9]*$' }
@@ -5390,6 +5397,43 @@ components:
       - name
       - phone
       - evidence
+    DispatchMaintenance:
+      type: object
+      x-java-record: DispatchContracts.Maintenance
+      description: 保存于排车resourcesJson.maintenance的唯一正式资料结构，不新增费用金额或审核门禁。
+      properties:
+        plannedDeliveryDate:
+          type: string
+          format: date
+          nullable: true
+        deliveryMethod:
+          type: string
+          enum: [FBA自提, 客户自提, 卡派打托, 卡派地板, 快递, 外配]
+          nullable: true
+        pickupMethod:
+          type: string
+          enum: [一提一卸, 一提多卸]
+          nullable: true
+        loadType:
+          type: string
+          enum: [托盘, 地板, 混装]
+          nullable: true
+        fleetEmail:
+          type: string
+          maxLength: 254
+          nullable: true
+        vehicleType:
+          type: string
+          enum: [厢式货车, 平板车, 集装箱卡车]
+          nullable: true
+        appointmentAccount:
+          type: string
+          maxLength: 128
+          nullable: true
+        appointmentNo:
+          type: string
+          maxLength: 128
+          nullable: true
     DispatchResources:
       type: object
       x-java-record: DispatchContracts.Resources
@@ -5402,6 +5446,11 @@ components:
           allOf:
           - $ref: '#/components/schemas/DispatchDriverSnapshot'
           nullable: true
+        maintenance:
+          allOf:
+          - $ref: '#/components/schemas/DispatchMaintenance'
+          nullable: true
+          description: 本趟可空补充资料，八字段均可空；空白字符串规范为null，不替代正式FBA预约或实际发车时间。
       required:
       - vehicle
       - driver
@@ -6356,6 +6405,11 @@ components:
           allOf:
           - $ref: '#/components/schemas/DispatchDriverSnapshot'
           nullable: true
+        maintenance:
+          allOf:
+          - $ref: '#/components/schemas/DispatchMaintenance'
+          nullable: true
+          description: 本趟可空补充资料，八字段均可空；空白字符串规范为null，不替代正式FBA预约或实际发车时间。
       required:
       - vehicle
       - driver