feat: support mixed-SKU dropship cartons

order/src/main/resources/openapi/order-v1.yaml

@@ -477,6 +477,7 @@ paths:
   /api/merchant/v1/orders/first-leg/{id}/submit:
     post:
       summary: 提交订单
+      description: 每条货物的每箱数量、箱数和总数量均必填，且总数量必须等于每箱数量 × 箱数。
       parameters:
         - $ref: '#/components/parameters/OrderId'
         - $ref: '#/components/parameters/IdempotencyKey'
@@ -581,6 +582,7 @@ paths:
   /api/platform/v1/orders/first-leg/{id}/submit:
     post:
       summary: 平台代客提交指定订单
+      description: 每条货物的每箱数量、箱数和总数量均必填，且总数量必须等于每箱数量 × 箱数。
       parameters:
         - $ref: '#/components/parameters/OrderId'
         - $ref: '#/components/parameters/TenantId'
@@ -1258,11 +1260,12 @@ components:
         lengthCm: {type: number, minimum: 0, description: 箱规长（厘米）}
         widthCm: {type: number, minimum: 0, description: 箱规宽（厘米）}
         heightCm: {type: number, minimum: 0, description: 箱规高（厘米）}
-        unitsPerPackage: {type: integer, minimum: 1, description: 每箱数量}
+        unitsPerPackage: {type: integer, minimum: 1, description: 每箱数量；提交时必填}
         packageCount: {type: integer, minimum: 1, description: 箱数}
+        packingGroupNo: {type: string, maxLength: 32, description: 一件代发混箱组合号；相同组合号的货物行共享同一批物理箱，组内箱数、包装类型和箱规必须一致}
         grossWeightKg: {type: number, exclusiveMinimum: true, minimum: 0, description: 总毛重}
         volumeCbm: {type: number, exclusiveMinimum: true, minimum: 0, description: 总体积}
-        totalQuantity: {type: integer, minimum: 1, description: 总数量}
+        totalQuantity: {type: integer, minimum: 1, description: 总数量；提交时必填且必须等于每箱数量 × 箱数}
         netWeightKg: {type: number, exclusiveMinimum: true, minimum: 0, description: 总净重}
         unitDeclaredValue: {type: number, minimum: 0, description: 清关申报单价（USD）}
         declaredValue: {type: number, minimum: 0, description: 清关申报金额（USD）}
@@ -1282,7 +1285,7 @@ components:
         woodenProduct: {type: boolean, description: 木制品权威判定快照；为 true 时订单 customsInspection 必须为 true}
       description: >-
         原型货物明细字段。FBA 货物的 skuNo、upcNo、shipmentId、referenceId 由服务端按每条货物校验；
-        productImageFileId 必须属于当前登录客户。
+        productImageFileId 必须属于当前登录客户。一件代发中，相同 packingGroupNo 的多条 SKU 行属于同一批物理箱，物理箱数只计算一次。
     FirstLegOrderSummary:
       type: object
       properties: