diff --git a/firstleg/src/main/java/com/baiyue/firstleg/repository/LoadingListRepository.java b/firstleg/src/main/java/com/baiyue/firstleg/repository/LoadingListRepository.java
index 61759d232..86fad576e 100644
--- a/firstleg/src/main/java/com/baiyue/firstleg/repository/LoadingListRepository.java
+++ b/firstleg/src/main/java/com/baiyue/firstleg/repository/LoadingListRepository.java
@@ -179,7 +179,7 @@ public class LoadingListRepository {
             decimal(row.getDimensionalWeightKg()), value(row.getProductQuantity()),
             integer(row.getUnitsPerCarton()), row.getFbaTrackingNo(), row.getShipmentNo(), row.getShippingMark(),
             row.getInternalRemark(), row.getCustomerRemark(), row.getWarehouseRemark(),
-            integer(row.getLoadSequence()), row.getFrozenAt())).toList();
+            integer(row.getLoadSequence()), row.getFrozenAt(), row.getItemVersion())).toList();
     }
 
     private List<History> histories(long planId) {
diff --git a/firstleg/src/main/resources/openapi/loading-lists-v1.yaml b/firstleg/src/main/resources/openapi/loading-lists-v1.yaml
index 19f4a0a37..b323df4ff 100644
--- a/firstleg/src/main/resources/openapi/loading-lists-v1.yaml
+++ b/firstleg/src/main/resources/openapi/loading-lists-v1.yaml
@@ -369,7 +369,7 @@ components:
         version: {type: integer, format: int32, minimum: 0, description: 乐观锁版本}
     LoadingItem:
       type: object
-      required: [itemId, accountId, orderId, orderNo, inboundId, inboundDetailId, packageCount, palletCount, grossWeightKg, netWeightKg, volumeCbm, dimensionalWeightKg, productQuantity, unitsPerPackage, loadSequence]
+      required: [itemId, accountId, orderId, orderNo, inboundId, inboundDetailId, packageCount, palletCount, grossWeightKg, netWeightKg, volumeCbm, dimensionalWeightKg, productQuantity, unitsPerPackage, loadSequence, itemVersion]
       properties:
         itemId: {$ref: '#/components/schemas/LongId'}
         accountId: {$ref: '#/components/schemas/LongId'}
@@ -401,6 +401,7 @@ components:
         warehouseRemark: {type: string, nullable: true, description: 仓库备注}
         loadSequence: {type: integer, format: int32, minimum: 0, description: 装柜顺序}
         frozenAt: {type: string, format: date-time, nullable: true, description: 明细冻结时间}
+        itemVersion: {type: integer, format: int32, minimum: 0, description: 明细乐观锁版本；更新仓库备注时作为 expectedItemVersion}
     OperationHistory:
       type: object
       required: [historyId, actionType, operatorId, occurredAt]