完善预约货物资料与可选确认时间并修复排车衔接

2026-10-28 11:57:09 +08:00
parent 96ffc0925a
commit 4f2d90b490
23 changed files with 233 additions and 56 deletions
@@ -108,6 +108,7 @@ components:
        allocatedPackages: {type: integer, format: int64}
        unknownAllocationCount: {type: integer, format: int64}
        effectivePackages: {type: integer, nullable: true, description: 独立核实箱数；没有核实记录时采用原来源箱数}
+        effectiveShipmentReferences: {type: array, items: {type: string}, description: 有效货件号和追踪号；非空独立核实值优先，未补录货件时带入同客户原订单资料，去空去重；读取不会新增核实记录}
        availablePackages: {type: integer, format: int64, nullable: true}
        sourceChanged: {type: boolean}
        allowedActions: {type: array, items: {type: string, enum: [VERIFY_CARGO]}}
@@ -218,7 +218,7 @@ components:
        plannedAt: {type: string, nullable: true, description: 已知的计划开始当地时段，日期必须与plannedDate一致}
        plannedEndAt: {type: string, nullable: true}
        confirmationNo: {type: string, maxLength: 128, nullable: true, description: 仅SUCCESS登记收货方的外部约号；同一FBA仓不得重复}
-        appointmentAt: {type: string, nullable: true, description: 对方确认开始当地时间；SUCCESS必填，PENDING不能当作计划填写}
+        appointmentAt: {type: string, nullable: true, description: 对方确认开始当地时间；SUCCESS可留空，缺失时不从计划日期推造，填写时须校验地区时区及夏令时；PENDING不能当作计划填写}
        appointmentEndAt: {type: string, nullable: true, description: 明确结束时间时必须晚于开始时间；未知留空，不推算}
        appointmentStatus: {type: string, enum: [PENDING, SUCCESS, FAILED]}
        appointmentRemark: {type: string, maxLength: 1000, nullable: true}
@@ -7161,7 +7161,8 @@ components:
        confirmationNo: {type: string, nullable: true}
        appointmentAt:
          type: string
-          description: 目的仓当地确认开始时间，须结合timezone解释，不按浏览器时区转换。
+          nullable: true
+          description: 目的仓当地确认开始时间；未提供时保持为空，已提供时结合timezone解释，不按浏览器时区转换。
        appointmentEndAt: {type: string, nullable: true}
        timezone: {type: string}
    DispatchAppointmentAllocationCommand: