java-project/baiyue-firstleg
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

修复海外业务接口契约格式

Browse Source
This commit is contained in:
ouyangxq
2026-09-09 16:49:01 +08:00
parent 7113703e3c
commit 83e95d764e
1 changed files with 15 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lastleg-service/src/main/resources/openapi/overseas-business-v1.yaml
+15 -7
View File
@@ -347,7 +347,15 @@ paths:
application/json: application/json:
schema: { $ref: '#/components/schemas/ChangeReceivingWarehouseRequest' } schema: { $ref: '#/components/schemas/ChangeReceivingWarehouseRequest' }
responses: responses:
'200': { description: 更新后的柜级摘要, content: { application/json: { schema: { type: object, properties: { code: { type: string, enum: ['200'] }, data: { $ref: '#/components/schemas/ContainerPlanProgressSummary' } } } } } '200':
description: 更新后的柜级摘要
content:
application/json:
schema:
type: object
properties:
code: { type: string, enum: ['200'] }
data: { $ref: '#/components/schemas/ContainerPlanProgressSummary' }
'400': { description: 请求无效或目标不是有效 OVERSEAS 仓 } '400': { description: 请求无效或目标不是有效 OVERSEAS 仓 }
'409': { description: 版本冲突、幂等键冲突或PDA接柜会话已建立 } '409': { description: 版本冲突、幂等键冲突或PDA接柜会话已建立 }
/api/platform/v1/last-leg/orders/{id}/destination: /api/platform/v1/last-leg/orders/{id}/destination:
@@ -625,7 +633,7 @@ paths:
description: 权限 platform:overseas-warehouse:outbound:list；只按全局唯一 outboundNo 定位并从记录解析客户范围，不接收 customerId。 description: 权限 platform:overseas-warehouse:outbound:list；只按全局唯一 outboundNo 定位并从记录解析客户范围，不接收 customerId。
security: [{ bearerAuth: [] }] security: [{ bearerAuth: [] }]
parameters: [{ name: outboundNo, in: path, required: true, schema: { type: string } }] parameters: [{ name: outboundNo, in: path, required: true, schema: { type: string } }]
responses: { '200': { description: 出库单、出库托盘及关联派送单详情；pallets[].palletNo 为 Warehouse 权威实物托盘码 }, '404': { description: 出库单不存在 } } responses: { '200': { description: '出库单、出库托盘及关联派送单详情；pallets[].palletNo 为 Warehouse 权威实物托盘码' }, '404': { description: 出库单不存在 } }
/api/platform/v1/last-leg/outbound-orders/{outboundNo}/cancel: /api/platform/v1/last-leg/outbound-orders/{outboundNo}/cancel:
post: post:
summary: 取消未执行出库单 summary: 取消未执行出库单
@@ -1344,9 +1352,9 @@ components:
supplierName: { type: string, maxLength: 200 } supplierName: { type: string, maxLength: 200 }
supplierCategory: { type: string, maxLength: 32 } supplierCategory: { type: string, maxLength: 32 }
settlementMode: { type: string, enum: [ON_ACCOUNT, DIRECT_PAID] } settlementMode: { type: string, enum: [ON_ACCOUNT, DIRECT_PAID] }
chargeableQuantity: { type: number, exclusiveMinimum: 0 } chargeableQuantity: { type: number, minimum: 0, exclusiveMinimum: true }
quantityUnit: { type: string, maxLength: 32 } quantityUnit: { type: string, maxLength: 32 }
unitPrice: { type: number, exclusiveMinimum: 0 } unitPrice: { type: number, minimum: 0, exclusiveMinimum: true }
periodStart: { type: string, format: date } periodStart: { type: string, format: date }
periodEnd: { type: string, format: date } periodEnd: { type: string, format: date }
LastMileFee: LastMileFee:
@@ -1865,14 +1873,14 @@ components:
feeName: { type: string, maxLength: 128 } feeName: { type: string, maxLength: 128 }
direction: { type: string, enum: [RECEIVABLE, PAYABLE] } direction: { type: string, enum: [RECEIVABLE, PAYABLE] }
currency: { type: string, enum: [CNY, USD] } currency: { type: string, enum: [CNY, USD] }
amount: { type: number, exclusiveMinimum: 0 } amount: { type: number, minimum: 0, exclusiveMinimum: true }
supplierId: { type: string, pattern: '^[1-9][0-9]*$' } supplierId: { type: string, pattern: '^[1-9][0-9]*$' }
supplierName: { type: string, maxLength: 200 } supplierName: { type: string, maxLength: 200 }
supplierCategory: { type: string, maxLength: 32 } supplierCategory: { type: string, maxLength: 32 }
settlementMode: { type: string, enum: [ON_ACCOUNT, DIRECT_PAID] } settlementMode: { type: string, enum: [ON_ACCOUNT, DIRECT_PAID] }
chargeableQuantity: { type: number, exclusiveMinimum: 0 } chargeableQuantity: { type: number, minimum: 0, exclusiveMinimum: true }
quantityUnit: { type: string, maxLength: 32 } quantityUnit: { type: string, maxLength: 32 }
unitPrice: { type: number, exclusiveMinimum: 0 } unitPrice: { type: number, minimum: 0, exclusiveMinimum: true }
periodStart: { type: string, format: date } periodStart: { type: string, format: date }
periodEnd: { type: string, format: date } periodEnd: { type: string, format: date }
remark: { type: string, nullable: true, maxLength: 500 } remark: { type: string, nullable: true, maxLength: 500 }