优化

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]