fix(lastleg): preserve return relabel delivery metadata and measurements

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

@@ -2054,6 +2054,10 @@ components:
       required: [deliveryNo, packageCount, signedPackages]
       properties:
         deliveryNo: { type: string }
+        customerName: { type: string, nullable: true, description: 客户名称快照；退货换标直出创建时从权威客户目录获取，查询不按ID猜名 }
+        overseasWarehouseName: { type: string, nullable: true, description: 作业海外仓名称快照；退货换标直出创建时从权威仓库目录获取 }
+        totalWeightKg: { type: number, nullable: true, description: 实物毛重千克；退货换标直出按选中实际箱每箱一次汇总，任一箱缺测则为空，不按SKU件数倍乘 }
+        totalVolumeCbm: { type: number, nullable: true, description: 实物体积立方米；退货换标直出按每箱实测长宽高厘米相乘除以1000000，任一箱缺尺寸则为空 }
         packageCount: { type: integer, minimum: 0 }
         signedPackages:
           type: integer
@@ -2080,7 +2084,7 @@ components:
             order: { $ref: '#/components/schemas/DeliveryOrderRow' }
             skus:
               type: array
-              description: 当前派送目的地的本次排车货物投影；数量按冻结排车与本次PDA实拣归属，不返回整单申报箱数。未实拣或MIXED库存没有单SKU归属时保留数量，SKU及品名为null；没有本次SKU测量事实时重量与体积为null，不按比例分摊整单测量。
+              description: 当前派送目的地的本次排车货物投影；数量按冻结排车与本次PDA实拣归属，不返回整单申报箱数。未实拣或MIXED库存没有单SKU归属时保留数量，SKU及品名为null；没有本次SKU测量事实时重量与体积为null，不按比例分摊整单测量。退货换标直接出库沿签收货物约定，按每实物箱的sku_code排序，仅首SKU行承载1箱及冻结的整箱重量/体积，其余SKU行承载0箱、物理量为空；每行productQuantity仍是对应SKU件数，整箱物理量不是单SKU净重。
               items: { $ref: '#/components/schemas/DeliveryCargoSku' }
     DeliveryCargoSku:
       type: object
@@ -2094,9 +2098,10 @@ components:
         fbaTrackingNo: { type: string, nullable: true }
         skuCode: { type: string, nullable: true }
         productName: { type: string, nullable: true }
-        packageCount: { type: integer, minimum: 0, description: 本次排车/实拣的箱数，不是整单申报箱数 }
-        weightKg: { type: number, nullable: true }
-        volumeCbm: { type: number, nullable: true }
+        packageCount: { type: integer, minimum: 0, description: 本次实物箱贡献数，不是件数或整单申报箱数；退货换标直出同箱仅首SKU行计1，其余为0 }
+        productQuantity: { type: string, nullable: true, pattern: '^[0-9]+$', description: 退货箱中本行SKU件数，long按字符串返回；不用于乘算箱级重量或体积 }
+        weightKg: { type: number, nullable: true, description: 千克；退货换标直出同箱首SKU行承载冻结整箱毛重，其余行或缺测为null }
+        volumeCbm: { type: number, nullable: true, description: 立方米；退货换标直出同箱首SKU行承载冻结整箱体积，其余行或缺测为null }
     ReturnOrderCreate:
       type: object
       required: [overseasWarehouseId, needRelabel, idempotencyKey, items]