优化

墨家设备测量上传接口说明-V3.md

@@ -8,7 +8,7 @@
 墨家设备扫描当前箱上的两张标签并上传测量结果：
 
 - 柏悦唛头二维码，扫描结果作为 `boxCode`；
-- 客户从 Amazon FBA 下载并贴在箱上的 FBA 标签，扫描其中的 Shipment ID，作为 `shipment_id`。
+- 如果当前箱贴有客户从 Amazon FBA 下载的 FBA 标签，则扫描其中的 Shipment ID，作为 `shipment_id`；非 FBA 货物可以不传。
 
 每次请求对应一次设备测量，不需要传订单内部字段，也不需要关心柏悦后续如何处理数据。
 
@@ -20,7 +20,7 @@ PCHK2608040174#19-1
 
 设备不需要解析或修改 `boxCode`。
 
-`shipment_id` 不是柏悦生成的内容，也不能从 `boxCode` 推导。设备必须从当前箱的 Amazon FBA 标签实际扫描并原样上传。
+`shipment_id` 不是柏悦生成的内容，也不能从 `boxCode` 推导。当前箱存在 Amazon FBA 标签时，设备应实际扫描并原样上传；不存在时可以省略或传空字符串。
 
 ## 2. 接口地址
 
@@ -63,7 +63,7 @@ POST <GATEWAY_HOST>/openapi/v1/inbound-measurements
 | 字段 | 必填 | 说明 |
 |---|---|---|
 | `boxCode` | 是 | 扫描得到的唛头二维码文本，必须原样传输 |
-| `shipment_id` | 是 | 从当前箱 Amazon FBA 标签实际扫描得到的 Shipment ID，必须原样传输；兼容字段名 `shipmentId` |
+| `shipment_id` | 否 | 当前箱存在 Amazon FBA 标签时，上传实际扫描得到的 Shipment ID；非 FBA 货物可省略或传空；兼容字段名 `shipmentId` |
 | `length` | 是 | 当前箱长度，单位 cm |
 | `width` | 是 | 当前箱宽度，单位 cm |
 | `height` | 是 | 当前箱高度，单位 cm |
@@ -91,13 +91,13 @@ data:image/jpeg;base64,<Base64内容>
 
 网络超时或未收到响应时，设备可以重试同一次上传。当前按 `boxCode` 保存最新结果，同一个箱号重试不会新增多条当前记录。
 
-同一个 `boxCode` 后续再次上传时，以最新一次设备上传的测量结果和实扫 `shipment_id` 为准，设备无需额外传版本号。
+同一个 `boxCode` 后续再次上传时，以最新一次设备上传的测量结果为准；本次传了 `shipment_id` 则保存实扫值，未传则保存为空。设备无需额外传版本号。
 
 ## 7. 待墨家确认
 
-1. 是否可以同时扫描柏悦唛头和 Amazon FBA 标签，并分别上传 `boxCode`、`shipment_id`。
+1. 当前箱存在 Amazon FBA 标签时，是否可以同时扫描柏悦唛头和 Amazon FBA 标签，并分别上传 `boxCode`、`shipment_id`。
 2. `boxCode` 是否可以原样上传完整二维码文本，例如 `PCHK2608040174#19-1`。
-3. `shipment_id` 是否可以原样上传，例如 `FBA19L5KMY2CU000002`。
+3. 有 Amazon FBA 标签时，`shipment_id` 是否可以原样上传，例如 `FBA19L5KMY2CU000002`；非 FBA 货物允许不传。
 4. `picture` 是否可以按 `data:image/jpeg;base64,...` 格式上传。
 5. `weight` 的单位、精度和是否必传。
 6. `machineNo` 是否每台机器固定且唯一。