Merge test fixes into dev dropship flow

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

@@ -923,6 +923,39 @@ paths:
                   requestId: {type: string, nullable: true}
                   traceId: {type: string, nullable: true}
         '403': {description: 无查看权限}
+  /api/platform/inbounds/carton-label-pdf:
+    post:
+      summary: 批量生成入仓箱唛 PDF
+      description: 需要 platform:firstleg:inbound:view 权限；可跨客户选择1至200个入库单，聚合生成一个 PDF，首次调用冻结各入库单整单箱号。
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: array
+              minItems: 1
+              maxItems: 200
+              items:
+                type: object
+                required: [tenantId, inboundId]
+                properties:
+                  tenantId: {type: string, pattern: '^[1-9][0-9]*$'}
+                  inboundId: {type: string, pattern: '^[1-9][0-9]*$'}
+      responses:
+        '200':
+          description: 成功返回聚合 PDF；业务失败返回统一 JSON 响应，调用方必须按 Content-Type 区分。
+          content:
+            application/pdf: {schema: {type: string, format: binary}}
+            application/json:
+              schema:
+                type: object
+                required: [code, message]
+                properties:
+                  code: {type: string}
+                  message: {type: string}
+                  requestId: {type: string, nullable: true}
+                  traceId: {type: string, nullable: true}
+        '403': {description: 无查看权限}
   /api/platform/v1/first-leg/inbounds/{inboundId}/measurement:
     get:
       summary: 查询入库测量详情
@@ -964,6 +997,43 @@ paths:
       responses:
         '200': {description: 成功或业务失败，按响应体 code 判断}
         '403': {description: 无测量编辑权限}
+  /api/platform/v1/first-leg/inbounds/{inboundId}/measurement/calculation-strategy:
+    put:
+      summary: 更新箱规计算规则
+      description: >-
+        独立更新当前测量批次全部明细的箱规计算规则并重算体积，不覆盖整批测量数据，
+        不改变测量提交或审核状态。客户未确认或该票尚未装柜完成时均可修改；
+        仅当客户已确认费用且该票已装柜完成时冻结。
+      parameters:
+        - {name: tenantId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: inboundId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/InboundMeasurementCalculationStrategyRequest'}
+      responses:
+        '200': {description: 成功或业务失败，按响应体 code 判断}
+        '403': {description: 无测量编辑权限}
+  /api/platform/v1/first-leg/inbounds/{inboundId}/measurement/items/{itemId}/outer-dimensions:
+    put:
+      summary: 更新仓库外箱长宽高
+      description: >-
+        独立更新当前测量批次指定明细的仓库外箱尺寸并重算体积，不覆盖整批测量数据，
+        不改变测量提交或审核状态。客户未确认或该票尚未装柜完成时均可修改；
+        仅当客户已确认费用且该票已装柜完成时冻结。
+      parameters:
+        - {name: tenantId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: inboundId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: itemId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/InboundMeasurementOuterDimensionsRequest'}
+      responses:
+        '200': {description: 成功或业务失败，按响应体 code 判断}
+        '403': {description: 无测量编辑权限}
   /api/platform/v1/first-leg/inbounds/{inboundId}/measurement/carton-scans:
     post:
       summary: 平台模拟单箱设备扫描
@@ -1681,16 +1751,18 @@ components:
         updatedAt: {type: string, format: date-time, nullable: true}
     CustomerDimensionConfigInitializeRequest:
       type: object
-      required: [tenantId, operatorId, initializationKey]
+      required: [tenantId, operatorId, initializationKey, customerName]
       properties:
         tenantId: {type: string, pattern: '^[1-9][0-9]*$'}
         operatorId: {type: string, pattern: '^[0-9]+$'}
         initializationKey: {type: string, minLength: 1, maxLength: 128}
+        customerName: {type: string, minLength: 1, maxLength: 128}
     CustomerDimensionConfigInitializeResponse:
       type: object
-      required: [configId, createdByThisInitialization]
+      required: [configId, chargeRuleId, createdByThisInitialization]
       properties:
         configId: {type: string, pattern: '^[1-9][0-9]*$'}
+        chargeRuleId: {type: string, pattern: '^[1-9][0-9]*$'}
         createdByThisInitialization: {type: boolean}
     WeightPalletSnapshot:
       type: object
@@ -1933,6 +2005,25 @@ components:
           minItems: 1
           maxItems: 500
           items: {$ref: '#/components/schemas/InboundMeasurementItemRequest'}
+    InboundMeasurementCalculationStrategyRequest:
+      type: object
+      required: [measurementId, version, coefficientMode]
+      additionalProperties: false
+      properties:
+        measurementId: {type: string, pattern: '^[1-9][0-9]*$'}
+        version: {type: integer, minimum: 0}
+        coefficientMode: {type: string, enum: [ACTUAL, ADD, MULTIPLY]}
+        chargeRuleId: {type: string, pattern: '^[1-9][0-9]*$', nullable: true, description: MULTIPLY 模式必填}
+    InboundMeasurementOuterDimensionsRequest:
+      type: object
+      required: [measurementId, version]
+      additionalProperties: false
+      properties:
+        measurementId: {type: string, pattern: '^[1-9][0-9]*$'}
+        version: {type: integer, minimum: 0}
+        outerLengthCm: {type: number, minimum: 0.001, nullable: true}
+        outerWidthCm: {type: number, minimum: 0.001, nullable: true}
+        outerHeightCm: {type: number, minimum: 0.001, nullable: true}
     InboundMeasurementItemRequest:
       type: object
       required: [inboundDetailId, itemNo, boxSpecification, packageCount, lengthCm, widthCm, heightCm]