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

lastleg-service/src/main/resources/openapi/appointment-calendar-warehouse-v1.yaml

@@ -8,8 +8,8 @@ paths:
       description: >-
         仅平台，同时要求platform:appointment:list与platform:overseas-warehouse:last-mile-order:list。
         返回所选来源柜，以及查询区间内已人工维护或已有入库计划的到仓记录，支持跨月人工改期。
-        同柜多个客户合并一条。plannedAt只有整柜时间一致且人工维护版本大于0或已经建计划时才有值。
-        未人工维护、未建计划的日历默认日期由到港来源加2个自然日；此只读接口不写入库计划、不补造时刻。
+        同柜多个客户合并一条。plannedAt只有整柜时间一致且人工维护版本大于0时才有值；仅日期的冻结计划通过plannedDate返回。
+        plannedDate/isDefault由与清关提柜和入库计划共用的服务端解析器返回，默认按权威到港当地日期加2个自然日；此只读接口不写入库计划、不补造时刻。
         actualAt只读PDA首次收货时间，不替换计划日期。
         具备原尾程订单编辑权限、版本一致、无入库计划且未实际到仓时canEdit=true。
         保存复用overseas-business-v1的整柜expected-arrival入口和原版本、幂等键、冻结门禁。
@@ -41,10 +41,13 @@ paths:
                       type: object
                       properties:
                         sourceContainerBookingId: {type: string}
+                        cabinetNo: {type: string, nullable: true, description: 来源交接冻结的柜次号，作为日历主标识}
                         containerNo: {type: string, nullable: true}
                         warehouseName: {type: string, nullable: true}
                         warehouseCode: {type: string, nullable: true}
                         plannedAt: {type: string, format: date-time, nullable: true}
+                        plannedDate: {type: string, format: date, nullable: true, description: 人工日期、已生成计划冻结日期或权威默认日期}
+                        isDefault: {type: boolean, description: 仅当前未维护未建计划且有默认日期时为true}
                         actualAt: {type: string, format: date-time, nullable: true}
                         version: {type: integer, minimum: -1}
                         planCount: {type: integer, minimum: 0}

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