提交

lastleg-service/src/main/resources/openapi/fleet-capacity-offers-v1.yaml

@@ -373,6 +373,36 @@ paths:
           application/json:
             schema:
               $ref: '#/components/schemas/OfferCommand'
+  /api/platform/v1/last-leg/fleet/capacity-offers/pending-looseboard-demands:
+    get:
+      summary: 分页读取客户已提交的待匹配散板原单
+      description: 权限：platform:fleet:capacity-offer:manage 或 (platform:fleet:capacity-offer:list 且 platform:fleet:capacity-offer:inquiry-create)。仅返回待接单、没有独立尾程来源且没有生效匹配的原单；取消未确认登记后恢复候选。下单及登记不占位，确认承运才占位。旧独立履约单不回填来源。
+      parameters:
+      - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } }
+      - { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 100, default: 20 } }
+      - { name: keyword, in: query, schema: { type: string, maxLength: 128 } }
+      responses:
+        '200':
+          description: 统一业务响应
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code: { type: string }
+                  message: { type: string }
+                  data:
+                    type: object
+                    properties:
+                      records:
+                        type: array
+                        items: { $ref: '#/components/schemas/LooseboardDemand' }
+                      page: { type: integer }
+                      size: { type: integer }
+                      total: { type: integer }
+                      pages: { type: integer }
+        '401': { description: 未登录 }
+        '403': { description: 无需求匹配权限 }
   /api/platform/v1/last-leg/fleet/capacity-offers/inquiries:
     get:
       summary: 分页查询本人或获准的全部意向
@@ -1310,6 +1340,24 @@ components:
             minimum: 0
           - type: string
             pattern: ^[0-9]+$
+    LooseboardDemand:
+      type: object
+      description: 原单待匹配投影；不含创建幂等键、请求哈希和操作人技术身份。
+      properties:
+        orderNo: { type: string }
+        customerId: { type: string }
+        version: { type: integer, format: int64 }
+        origin: { type: string }
+        destination: { type: string }
+        productName: { type: string, nullable: true }
+        estimatedPalletCount: { type: integer, nullable: true }
+        packageCount: { type: integer, nullable: true }
+        totalWeightKg: { type: number, nullable: true }
+        totalVolumeCbm: { type: number, nullable: true }
+        currency: { type: string }
+        originContactName: { type: string, nullable: true }
+        originContactPhone: { type: string, nullable: true }
+        remark: { type: string, nullable: true }
     InquiryWrite:
       type: object
       required:
@@ -1321,6 +1369,18 @@ components:
       - cargo
       - idempotencyKey
       properties:
+        sourceOrderNo:
+          type: string
+          maxLength: 64
+          nullable: true
+          description: 从待匹配散板选择原商业单；仅LOCAL_LOOSEBOARD支持。确认承运复用原单，不另开商业单。
+        sourceOrderVersion:
+          type: integer
+          format: int64
+          minimum: 0
+          nullable: true
+          description: 创建匹配时与原单号一起提交；已匹配登记不可替换来源。
+
         tripRecordVersion:
           oneOf:
           - type: integer