优化

2026-09-20 10:06:14 +08:00
parent d5c4059942
commit 507763a0d6
12 changed files with 199 additions and 24 deletions
@@ -836,10 +836,14 @@ paths:
    post:
      summary: 提交一条第三方箱规测量结果和一张图片
      description: >-
-        data 中的 inboundCode 匹配入库单，inboundDetailId 必须匹配该入库单关联订单中的已有货物明细；
-        每次只保存一条箱规明细和一张图片，不审核、不计费、不入库，也不改变入库单状态。
-        首轮联调可由服务端配置 signature-required=false：此时只强制固定 X-App-Key 和
-        Idempotency-Key，X-Timestamp、X-Nonce、X-Signature 可不传；恢复签名后按下述规则计算。
+        墨家 JSON 协议使用平台级 AppKey（tenant-id=0）和正数设备服务主体 ID；
+        按全平台唯一 boxCode 找到入库单真实客户，再校验 machineNo 绑定的仓库与入库单仓库一致。
+        匹配结果按真实客户保存，未匹配的联调收件按平台作用域保存；
+        每次只保存一条箱规明细和一张图片，不审核、不计费、不入库。
+        multipart 协议的 data 中则以 inboundCode 和 inboundDetailId 匹配指定客户的入库单及货物明细。
+        首轮联调可由服务端配置 signature-required=false：此时 JSON 协议只强制 X-App-Key，
+        multipart 协议还要求 Idempotency-Key；X-Timestamp、X-Nonce、X-Signature 可不传。
+        恢复签名后按下述规则计算。
        签名串依次为 METHOD、原始 PATH、X-Timestamp、X-Nonce、Idempotency-Key、
        签名body的 SHA-256 小写十六进制，六部分使用 LF（\n）连接且末尾不追加换行。
        签名body = data原始UTF-8文本 + LF + image文件内容SHA-256小写十六进制。