优化

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

@@ -262,7 +262,11 @@ paths:
                   format: binary
                   description: 当前测量明细唯一对应图片，JPG/PNG/BMP且不超过5MB
       responses:
-        '200': {description: 成功或业务失败，按响应体字符串 code 判断；非法签名返回 A0401}
+        '200':
+          description: JSON 墨家协议在正式箱码匹配或未匹配联调收件成功时均返回 code=200；data.matched 区分结果。其他业务失败按 code 判断。
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/MojiaMeasurementUploadEnvelope'}
         '413': {description: 请求体超过网关限制}
         '415': {description: Content-Type 不支持}
   /openapi/v1/inbound-measurements/events/{eventNo}:
@@ -523,6 +527,24 @@ components:
       required: true
       schema: {type: string, pattern: '^[1-9][0-9]*$'}
   schemas:
+    MojiaMeasurementUploadEnvelope:
+      type: object
+      properties:
+        code: {type: string, example: '200'}
+        message: {type: string, example: success}
+        data: {$ref: '#/components/schemas/MojiaMeasurementUploadResponse'}
+    MojiaMeasurementUploadResponse:
+      type: object
+      required: [accepted, matched, boxCode, created]
+      properties:
+        accepted: {type: boolean, example: true}
+        matched: {type: boolean, description: true 表示已写入正式箱级测量；false 表示已写入联调收件箱等待排查}
+        receiptId: {type: string, nullable: true, description: matched=false 时返回的联调收件记录ID}
+        measurementId: {type: string, nullable: true}
+        itemId: {type: string, nullable: true}
+        boxCode: {type: string}
+        imageFileId: {type: string, nullable: true}
+        created: {type: boolean}
     CustomerDimensionConfigUpdateRequest:
       type: object
       required: [rules]

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

@@ -46,21 +46,6 @@ paths:
             schema: {$ref: '#/components/schemas/TransportUpdateRequest'}
       responses:
         '200': {$ref: '#/components/responses/PreloadDetailResponse'}
-  /api/platform/v1/first-leg/loading-plans/{planId}/complete:
-    post:
-      summary: 完成预装
-      description: 仅允许将 LOADING 单向推进为 COMPLETED；完成前必须完成全部 PDA 拣货。
-      x-permission: platform:firstleg:preload:complete
-      parameters:
-        - {$ref: '#/components/parameters/PlanId'}
-        - {$ref: '#/components/parameters/IdempotencyKey'}
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema: {$ref: '#/components/schemas/AdvanceRequest'}
-      responses:
-        '200': {$ref: '#/components/responses/PreloadDetailResponse'}
   /api/platform/v1/first-leg/loading-lists:
     get:
       summary: 分页查询装柜清单
@@ -326,10 +311,3 @@ components:
         voyageNo: {type: string, maxLength: 64, nullable: true, description: 航次}
         expectedVersion: {type: integer, format: int32, minimum: 0, description: 当前乐观锁版本}
         operationReason: {type: string, maxLength: 500, nullable: true, description: 操作原因}
-    AdvanceRequest:
-      type: object
-      required: [expectedVersion]
-      additionalProperties: false
-      properties:
-        expectedVersion: {type: integer, format: int32, minimum: 0, description: 当前乐观锁版本}
-        operationReason: {type: string, maxLength: 500, nullable: true, description: 操作原因}