优化

2026-08-07 18:03:56 +08:00
parent 645c483649
commit 1a76602872
15 changed files with 273 additions and 6 deletions
@@ -192,6 +192,38 @@ paths:
                  requestId: {type: string, nullable: true}
                  traceId: {type: string, nullable: true}
        '403': {description: 无查看权限}
+  /api/platform/v1/first-leg/inbounds/{inboundId}/measurement/carton-scans:
+    post:
+      summary: 平台模拟单箱设备扫描
+      description: >-
+        需要 platform:firstleg:inbound:measure:edit 权限；仅用于平台联调和代设备录入，
+        复用正式单箱覆盖规则，不代表最终第三方设备协议或鉴权方式。
+      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:
+          multipart/form-data:
+            schema:
+              type: object
+              required: [data, image]
+              properties:
+                data:
+                  type: object
+                  required: [boxCode, length, width, height, machineNo, measuredAt]
+                  properties:
+                    boxCode: {type: string, maxLength: 128}
+                    length: {type: number, format: double, minimum: 0.001}
+                    width: {type: number, format: double, minimum: 0.001}
+                    height: {type: number, format: double, minimum: 0.001}
+                    weight: {type: number, format: double, minimum: 0.001, nullable: true}
+                    machineNo: {type: string, maxLength: 64}
+                    measuredAt: {type: string, format: date-time}
+                image: {type: string, format: binary}
+      responses:
+        '200': {description: 成功或业务失败，按响应体 code 判断}
+        '403': {description: 无测量编辑权限}
  /api/platform/v1/inbounds/{inboundId}/measurements/approve:
    post:
      summary: 审核通过测量