优化

firstleg/src/main/resources/openapi/ocean-bookings-v1.yaml

@@ -1,6 +1,13 @@
 openapi: 3.0.3
 info: {title: Phase 3 Ocean Booking API, version: 1.1.0}
 paths:
+  /api/platform/v1/ocean-bookings/channels:
+    get:
+      summary: List logistics channels from the current ACTIVE price book for an origin warehouse
+      description: 'Requires platform:firstleg:ocean-booking:list. Returns only channels with an ACTIVE price row; the selected channel name is frozen server-side on draft save.'
+      parameters:
+        - {name: originWarehouseId, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
+      responses: {'200': {description: Available channel options, content: {application/json: {schema: {type: array, items: {$ref: '#/components/schemas/ChannelOption'}}}}}}
   /api/platform/v1/ocean-bookings:
     post:
       summary: Create an ocean booking draft with immutable channel and warehouse snapshots
@@ -33,12 +40,11 @@ components:
         data: {$ref: '#/components/schemas/DraftData'}
     DraftData:
       type: object
-      required: [customerId, customerName, channelCode, channelName, warehouseId, warehouseName, parties, containerRequirements]
+      required: [customerId, customerName, channelCode, warehouseId, warehouseName, parties, containerRequirements]
       properties:
         customerId: {type: integer, format: int64, minimum: 1}
         customerName: {type: string, maxLength: 128}
-        channelCode: {type: string, maxLength: 64}
-        channelName: {type: string, maxLength: 128}
+        channelCode: {type: string, maxLength: 64, description: Selected from GET /api/platform/v1/ocean-bookings/channels; server validates it against the current ACTIVE price book and freezes channelName.}
         warehouseId: {type: integer, format: int64, minimum: 1}
         warehouseName: {type: string, maxLength: 128}
         billOfLadingNo: {type: string, nullable: true, deprecated: true, description: Must be omitted until release}
@@ -57,6 +63,15 @@ components:
         capacityCbm: {type: number, exclusiveMinimum: true, minimum: 0}
         maxWeightKg: {type: number, exclusiveMinimum: true, minimum: 0}
         quantity: {type: integer, minimum: 1}
+    ChannelOption:
+      type: object
+      required: [priceBookVersionId, channelCode, channelName, priceModel, pricingTaxModes]
+      properties:
+        priceBookVersionId: {type: integer, format: int64}
+        channelCode: {type: string, maxLength: 64}
+        channelName: {type: string, maxLength: 128}
+        priceModel: {type: string}
+        pricingTaxModes: {type: array, items: {type: string}}
     ActionRequest:
       type: object
       required: [expectedVersion]