From 632d35faafde104171fe0dbdbdae8bcd11e93dd3 Mon Sep 17 00:00:00 2001
From: ouyangxq <775153912@qq.com>
Date: Wed, 21 Oct 2026 18:45:06 +0800
Subject: [PATCH] docs(api): describe unknown actual loading measurements

---
 .../src/main/resources/openapi/fleet-trips-v1.yaml        | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/lastleg-service/src/main/resources/openapi/fleet-trips-v1.yaml b/lastleg-service/src/main/resources/openapi/fleet-trips-v1.yaml
index fcfcd23db..63bd72cdf 100644
--- a/lastleg-service/src/main/resources/openapi/fleet-trips-v1.yaml
+++ b/lastleg-service/src/main/resources/openapi/fleet-trips-v1.yaml
@@ -602,8 +602,8 @@ components:
       properties:
         warehousePalletId: {type: string}
         palletSpaces: {type: integer, minimum: 1}
-        weightKg: {type: number, minimum: 0.001, multipleOf: 0.001, maximum: 999999999.999}
-        volumeCbm: {type: number, minimum: 0.001, multipleOf: 0.001, maximum: 999999999.999}
+        weightKg: {type: number, nullable: true, description: 已确认装车的未知实测保持空值；计划容量输入仍须填写正数, minimum: 0.001, multipleOf: 0.001, maximum: 999999999.999}
+        volumeCbm: {type: number, nullable: true, description: 已确认装车的未知实测保持空值；计划容量输入仍须填写正数, minimum: 0.001, multipleOf: 0.001, maximum: 999999999.999}
         deliveryIndex: {type: integer, minimum: 1, description: 卸货站索引，起运仓固定为0}
     PlanningEnvelope:
       allOf:
@@ -641,8 +641,8 @@ components:
       type: object
       properties:
         palletSpaces: {type: integer}
-        weightKg: {type: number}
-        volumeCbm: {type: number}
+        weightKg: {type: number, nullable: true, description: 实测不完整时未知，不表示零重量或可售余量}
+        volumeCbm: {type: number, nullable: true, description: 实测不完整时未知，不表示零体积或可售余量}
     ConfirmLoad:
       type: object
       required: [recordVersion, manifestHash, pallets, reason]