优化

2026-08-14 19:59:26 +08:00
parent 7d4256dbd2
commit 993b3dfe03
15 changed files with 282 additions and 30 deletions
@@ -40,13 +40,15 @@ components:
        data: {$ref: '#/components/schemas/DraftData'}
    DraftData:
      type: object
-      required: [customerId, customerName, channelCode, warehouseId, warehouseName, parties, containerRequirements]
+      required: [channelCode, warehouseId, warehouseName, serviceTerm, freightTerm, parties, containerRequirements]
      properties:
-        customerId: {type: integer, format: int64, minimum: 1}
-        customerName: {type: string, maxLength: 128}
+        customerId: {type: integer, format: int64, minimum: 1, nullable: true, description: Optional customer snapshot; must be supplied together with customerName.}
+        customerName: {type: string, maxLength: 128, nullable: true, description: Optional customer snapshot; must be supplied together with customerId.}
        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}
+        serviceTerm: {type: string, maxLength: 32, description: Required free-text Service Term snapshot, for example CY-CY.}
+        freightTerm: {type: string, maxLength: 32, description: Required free-text Freight Term snapshot, for example NINGBO.}
        billOfLadingNo: {type: string, nullable: true, deprecated: true, description: Must be omitted until release}
        vesselName: {type: string, nullable: true, deprecated: true, description: Must be omitted until release}
        voyageNo: {type: string, nullable: true, deprecated: true, description: Must be omitted until release}