feat: support mixed-SKU dropship cartons

order/src/main/resources/db/order.sql

@@ -304,6 +304,7 @@ CREATE TABLE IF NOT EXISTS ord_order_cargo (
   reference_id VARCHAR(64) NULL COMMENT '货物级 Amazon Reference ID',
   product_image_file_id BIGINT UNSIGNED NULL COMMENT '文件中心产品图片逻辑ID',
   wooden_product TINYINT(1) NOT NULL DEFAULT 0 COMMENT '木制品权威判定快照；1时订单必须商检',
+  packing_group_no VARCHAR(32) NULL COMMENT '混箱组合号；同组货物行共享同一批物理箱',
   created_by BIGINT UNSIGNED NOT NULL COMMENT '创建人ID',
   created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
   updated_by BIGINT UNSIGNED NOT NULL COMMENT '最后修改人ID',

order/src/main/resources/db/phase1-order-extension.sql

@@ -60,6 +60,7 @@ CALL phase1_add_column('ord_order_cargo', 'product_height_cm', "DECIMAL(12,2) NU
 CALL phase1_add_column('ord_order_cargo', 'shipment_id', "VARCHAR(64) NULL COMMENT '本货物明细对应的Amazon Shipment ID'");
 CALL phase1_add_column('ord_order_cargo', 'reference_id', "VARCHAR(64) NULL COMMENT '本货物明细对应的Amazon Reference ID'");
 CALL phase1_add_column('ord_order_cargo', 'product_image_file_id', "BIGINT UNSIGNED NULL COMMENT 'File服务中的产品图片逻辑文件ID'");
+CALL phase1_add_column('ord_order_cargo', 'packing_group_no', "VARCHAR(32) NULL COMMENT '混箱组合号；同组货物行共享同一批物理箱'");
 
 -- 货物级字段上线前，FBA 编号只保存在主单；回填后提交校验可统一按每条货物执行。
 UPDATE ord_order_cargo cargo

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: