修复海外报价合作仓候选缓存刷新

lastleg-service/src/main/resources/openapi/overseas-master-data-v1.yaml

@@ -25,8 +25,25 @@ paths:
   /api/platform/v1/last-leg/master-data/overseas-quotes/warehouse-options:
     get:
       summary: 查询缓存的有效海外合作仓选项
-      description: '权限：platform:overseas-master-data:quote:list；浏览器不直接调用国内内部接口'
-      responses: { '200': { description: 业务响应 } }
+      description: '权限：platform:overseas-master-data:quote:list；浏览器不直接调用国内内部接口；非空结果缓存30分钟，空结果不缓存；国内合作仓变更后可使用refresh=true强制刷新'
+      parameters:
+        - name: refresh
+          in: query
+          required: false
+          description: 是否绕过仍有效的非空缓存并重新读取国内海外合作仓
+          schema: { type: boolean, default: false }
+      responses:
+        '200':
+          description: 业务响应，data为海外合作仓候选数组
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code: { type: string, example: '200' }
+                  data:
+                    type: array
+                    items: { $ref: '#/components/schemas/PartnerWarehouseOption' }
   /api/platform/v1/last-leg/master-data/overseas-quotes/export:
     get:
       summary: 导出海外仓报价
@@ -161,6 +178,14 @@ components:
     Size: { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 200, default: 20 } }
   schemas:
     ActiveStatus: { type: string, enum: [ACTIVE, INACTIVE] }
+    PartnerWarehouseOption:
+      type: object
+      required: [warehouseId, warehouseCode, warehouseName, countryCode]
+      properties:
+        warehouseId: { type: string, description: 平台公共海外合作仓雪花ID字符串 }
+        warehouseCode: { type: string, description: 仓库编码 }
+        warehouseName: { type: string, description: 仓库名称 }
+        countryCode: { type: string, pattern: '^[A-Z]{2}$', description: ISO国家二字码 }
     QuoteFee:
       type: object
       required: [item, billingUnit, unitPrice]