优化

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

@@ -51,8 +51,8 @@ paths:
         '200': {description: 幂等补偿完成}
   /internal/firstleg/v1/pricing/channels/validate:
     post:
-      summary: 校验订单渠道并返回进仓编码前缀
-      description: 仅供订单服务调用；前缀按渠道和目的仓类型选择，同一渠道的包税与不包税订单共用编码前缀。
+      summary: 校验订单渠道并按需返回进仓编码前缀
+      description: 仅供订单服务调用；AUTO 模式要求并返回编码前缀，LEGACY_MANUAL 模式仅校验渠道可用性。
       security:
         - internalServiceToken: []
       requestBody:
@@ -61,14 +61,15 @@ paths:
           application/json:
             schema:
               type: object
-              required: [tenantId, originWarehouseId, channelCode, destinationType]
+              required: [tenantId, originWarehouseId, channelCode, destinationType, requireInboundCodePrefix]
               properties:
                 tenantId: {type: string, pattern: '^[1-9][0-9]*$'}
                 originWarehouseId: {type: string, pattern: '^[1-9][0-9]*$'}
                 channelCode: {type: string, minLength: 1, maxLength: 64}
                 destinationType: {type: string, enum: [FBA, OVERSEAS, PRIVATE]}
+                requireInboundCodePrefix: {type: boolean}
       responses:
-        '200': {description: 成功时 data 返回 channelCode 和 inboundCodePrefix；未配置对应进仓编码时返回业务冲突}
+        '200': {description: 成功时 data 返回 channelCode；requireInboundCodePrefix=true 时同时返回 inboundCodePrefix}
   /api/platform/v1/first-leg/customer-dimension-config:
     get:
       summary: 查询客户固定四箱规尺寸配置