feat: add inbound hold lifecycle

order/src/main/java/com/baiyue/order/client/FirstlegUnifiedOrderClient.java

@@ -50,6 +50,7 @@ public interface FirstlegUnifiedOrderClient {
                    LocalDateTime expectedArrivalAt, LocalDateTime requestedPickupAt, String feeReviewStatus,
                    String companyName, String businessType, String taxMode, String containerMode,
                    Boolean customsInspection, String destinationType, String destinationCode,
+                   Boolean holdFlag, String currentHoldReason,
                    BigDecimal actualGrossWeightKg, BigDecimal actualNetWeightKg, BigDecimal actualVolumeCbm,
                    BigDecimal volumeWeightKg, BigDecimal chargeableVolumeCbm, Integer palletCount,
                    BigDecimal chargeableWeightKg, LocalDateTime measureCompletedAt,

order/src/main/java/com/baiyue/order/dto/UnifiedOrderResponse.java

@@ -19,6 +19,7 @@ public final class UnifiedOrderResponse {
         Long receivingWarehouseId, String receivingWarehouseName,
         Long destinationWarehouseId, String destinationWarehouseName,
         Long inboundId, Integer inboundVersion, String inboundCode, LocalDate expectedShipDate,
+        Boolean holdFlag, String currentHoldReason,
         Integer totalPackageCount, String recommendedPalletType, String locationCodes,
         BigDecimal estimatedVolumeCbm, BigDecimal expectedVolumeCbm,
         BigDecimal actualGrossWeightKg, BigDecimal actualVolumeCbm,

order/src/main/java/com/baiyue/order/service/UnifiedOrderQueryService.java

@@ -287,7 +287,7 @@ public class UnifiedOrderQueryService {
                 order.getChannelCode(), order.getChannelName(), Boolean.TRUE.equals(order.getChannelChanged()), order.getReceivingWarehouseId(), order.getReceivingWarehouseName(),
                 order.getDestinationWarehouseId(), order.getDestinationWarehouseName(), null, null,
                 order.getInboundCode(),
-                order.getExpectedShipDate(), totalPackageCount(cargo), null, null,
+                order.getExpectedShipDate(), null, null, totalPackageCount(cargo), null, null,
                 order.getEstimatedVolumeCbm(), volumeCbm(cargo), null, null,
                 order.getExpectedArrivalAt(), null, null, null, order.getPickupMethod(), order.getTaxMode(), order.getContainerMode(),
                 order.getCustomsInspection(), order.getDestinationType(), order.getAmazonWarehouseCode(),
@@ -306,7 +306,8 @@ public class UnifiedOrderQueryService {
             order.getCustomerId(), order.getCustomerName(),
             order.getChannelCode(), order.getChannelName(), Boolean.TRUE.equals(order.getChannelChanged()), order.getReceivingWarehouseId(), order.getReceivingWarehouseName(),
             order.getDestinationWarehouseId(), order.getDestinationWarehouseName(), inbound.id(), inbound.version(), inbound.inboundCode(),
-            order.getExpectedShipDate(), displayedPackageCount(order, cargo, inbound), null,
+            order.getExpectedShipDate(), inbound.holdFlag(), inbound.currentHoldReason(),
+            displayedPackageCount(order, cargo, inbound), null,
             distinctLocationCodes(inbound.locationCodes()),
             order.getEstimatedVolumeCbm(), volumeCbm(cargo),
             inbound.actualGrossWeightKg(), inbound.actualVolumeCbm(),
@@ -333,7 +334,7 @@ public class UnifiedOrderQueryService {
             inbound.customerId(), inbound.customerName(), inbound.channelCode(), inbound.channelName(),
             order != null && Boolean.TRUE.equals(order.getChannelChanged()), inbound.warehouseId(),
             inbound.warehouseName(), inbound.deliveryWarehouseId(), inbound.deliveryWarehouseName(),
-            inbound.id(), inbound.version(), inbound.inboundCode(), null,
+            inbound.id(), inbound.version(), inbound.inboundCode(), null, inbound.holdFlag(), inbound.currentHoldReason(),
             displayedPackageCount(order, cargo, inbound), null, distinctLocationCodes(inbound.locationCodes()),
             order == null ? null : order.getEstimatedVolumeCbm(), volumeCbm(cargo),
             inbound.actualGrossWeightKg(), inbound.actualVolumeCbm(),

order/src/main/resources/openapi/order-v1.yaml

@@ -753,6 +753,8 @@ components:
         inboundVersion: {type: integer, nullable: true, description: C04 loading/complete 的 expectedVersion}
         inboundCode: {type: string, nullable: true, description: 当前订单片段的权威入仓码；缺失时为 null，不得回退为 orderId 或 orderNo}
         expectedShipDate: {type: string, format: date, nullable: true}
+        holdFlag: {type: boolean, nullable: true, description: Firstleg 入库单当前扣货标识；尚未生成入库单时为 null}
+        currentHoldReason: {type: string, nullable: true, description: Firstleg 入库单当前扣货原因；未扣货或尚未生成入库单时为 null}
         totalPackageCount: {type: integer, nullable: true, description: 无入仓事实时为当前订单有效货物箱数合计；存在入仓业务单元后为该单元履约总箱数，拆分后不以父单原始箱数覆盖}
         recommendedPalletType: {type: string, nullable: true, description: 当前无列表级权威事实时返回 null，不得返回固定托盘类型}
         locationCodes: {type: string, nullable: true, description: "库位编码汇总；按首次出现顺序去重并使用中文顿号分隔"}