diff --git a/lastleg-service/src/main/resources/openapi/overseas-business-v1.yaml b/lastleg-service/src/main/resources/openapi/overseas-business-v1.yaml index ededbe554..82472280f 100644 --- a/lastleg-service/src/main/resources/openapi/overseas-business-v1.yaml +++ b/lastleg-service/src/main/resources/openapi/overseas-business-v1.yaml @@ -1034,52 +1034,6 @@ paths: required: true content: { application/json: { schema: { $ref: '#/components/schemas/ProcurementReview' } } } responses: { '200': { description: 统一 ApiResponse 包装的采购订单详情 } } - /api/merchant/v1/last-leg/delivery-orders: - get: - summary: 客户分页查询自己的派送单 - description: 权限 merchant:warehouse:delivery:list;客户范围只取认证 Token,不接收 customerId。 - security: [{ bearerAuth: [] }] - parameters: - - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } } - - { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 200, default: 20 } } - - { name: documentNo, in: query, schema: { type: string } } - - { name: warehouseId, in: query, schema: { type: string } } - - { name: status, in: query, schema: { type: string } } - - { name: dispatchNo, in: query, schema: { type: string } } - - { name: waybillNo, in: query, schema: { type: string } } - - { name: vehiclePlate, in: query, schema: { type: string } } - - { name: driverName, in: query, schema: { type: string } } - - { name: deliveryMethod, in: query, schema: { type: string } } - - { name: plannedFrom, in: query, schema: { type: string, format: date-time } } - - { name: plannedTo, in: query, schema: { type: string, format: date-time } } - responses: { '200': { description: 当前客户派送单分页, content: { application/json: { schema: { $ref: '#/components/schemas/DeliveryOrderPageResponse' } } } }, '403': { description: 缺少客户派送查看权限 } } - post: - summary: 客户从自己的排车单创建派送单 - description: 权限 merchant:warehouse:delivery:create;客户范围只取认证 Token,dispatchNo 必填,不接收 customerId;同一幂等键或已转换排车重复调用返回既有单据。已关联车次时请求不得覆盖车次维护的车牌、司机和电话。 - security: [{ bearerAuth: [] }] - parameters: [{ name: dispatchNo, in: query, required: true, schema: { type: string, minLength: 1 } }] - requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/DeliveryTransfer' } } } } - responses: { '200': { description: 出库与派送单转换结果 }, '403': { description: 缺少客户派送创建权限 }, '404': { description: 当前客户下排车单不存在 }, '409': { description: 状态、参数或幂等冲突 } } - /api/merchant/v1/last-leg/delivery-orders/{deliveryNo}: - get: - summary: 客户查询自己的派送单详情 - description: 权限 merchant:warehouse:delivery:list;列表权限包含详情只读,客户范围只取认证 Token,不接收 customerId。 - security: [{ bearerAuth: [] }] - parameters: [{ name: deliveryNo, in: path, required: true, schema: { type: string } }] - responses: { '200': { description: 当前客户派送单详情, content: { application/json: { schema: { $ref: '#/components/schemas/DeliveryOrderDetailResponse' } } } }, '403': { description: 缺少客户派送查看权限 }, '404': { description: 当前客户下派送单不存在 } } - /api/merchant/v1/last-leg/orders: - get: - summary: 客户分页查询自己的海外尾程订单 - description: 权限 merchant:overseas-warehouse:last-mile-order:list;列表权限包含详情只读,客户范围只取认证 Token。 - security: [{ bearerAuth: [] }] - responses: { '200': { description: 当前客户海外尾程订单分页 }, '403': { description: 缺少海外尾程订单查看权限 } } - /api/merchant/v1/last-leg/orders/{id}: - get: - summary: 客户查询自己的海外尾程订单详情 - description: 权限 merchant:overseas-warehouse:last-mile-order:list;不泄露其他客户订单。 - security: [{ bearerAuth: [] }] - parameters: [{ name: id, in: path, required: true, schema: { type: integer, format: int64 } }] - responses: { '200': { description: 当前客户海外尾程订单详情 }, '403': { description: 缺少海外尾程订单查看权限 }, '404': { description: 当前客户下订单不存在 } } /api/platform/v1/last-leg/warehouse-transfers/{transferNo}/allocations: post: summary: 选择已有库存转运的真实来源 @@ -1131,6 +1085,52 @@ paths: responses: '200': { description: 本票OUTBOUNDED事实或成功原命令重放 } '409': { description: 尚未完成本票换标客户确认或分配不完整 } + /api/merchant/v1/last-leg/delivery-orders: + get: + summary: 客户分页查询自己的派送单 + description: 权限 merchant:warehouse:delivery:list;客户范围只取认证 Token,不接收 customerId。 + security: [{ bearerAuth: [] }] + parameters: + - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } } + - { name: size, in: query, schema: { type: integer, minimum: 1, maximum: 200, default: 20 } } + - { name: documentNo, in: query, schema: { type: string } } + - { name: warehouseId, in: query, schema: { type: string } } + - { name: status, in: query, schema: { type: string } } + - { name: dispatchNo, in: query, schema: { type: string } } + - { name: waybillNo, in: query, schema: { type: string } } + - { name: vehiclePlate, in: query, schema: { type: string } } + - { name: driverName, in: query, schema: { type: string } } + - { name: deliveryMethod, in: query, schema: { type: string } } + - { name: plannedFrom, in: query, schema: { type: string, format: date-time } } + - { name: plannedTo, in: query, schema: { type: string, format: date-time } } + responses: { '200': { description: 当前客户派送单分页, content: { application/json: { schema: { $ref: '#/components/schemas/DeliveryOrderPageResponse' } } } }, '403': { description: 缺少客户派送查看权限 } } + post: + summary: 客户从自己的排车单创建派送单 + description: 权限 merchant:warehouse:delivery:create;客户范围只取认证 Token,dispatchNo 必填,不接收 customerId;同一幂等键或已转换排车重复调用返回既有单据。已关联车次时请求不得覆盖车次维护的车牌、司机和电话。 + security: [{ bearerAuth: [] }] + parameters: [{ name: dispatchNo, in: query, required: true, schema: { type: string, minLength: 1 } }] + requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/DeliveryTransfer' } } } } + responses: { '200': { description: 出库与派送单转换结果 }, '403': { description: 缺少客户派送创建权限 }, '404': { description: 当前客户下排车单不存在 }, '409': { description: 状态、参数或幂等冲突 } } + /api/merchant/v1/last-leg/delivery-orders/{deliveryNo}: + get: + summary: 客户查询自己的派送单详情 + description: 权限 merchant:warehouse:delivery:list;列表权限包含详情只读,客户范围只取认证 Token,不接收 customerId。 + security: [{ bearerAuth: [] }] + parameters: [{ name: deliveryNo, in: path, required: true, schema: { type: string } }] + responses: { '200': { description: 当前客户派送单详情, content: { application/json: { schema: { $ref: '#/components/schemas/DeliveryOrderDetailResponse' } } } }, '403': { description: 缺少客户派送查看权限 }, '404': { description: 当前客户下派送单不存在 } } + /api/merchant/v1/last-leg/orders: + get: + summary: 客户分页查询自己的海外尾程订单 + description: 权限 merchant:overseas-warehouse:last-mile-order:list;列表权限包含详情只读,客户范围只取认证 Token。 + security: [{ bearerAuth: [] }] + responses: { '200': { description: 当前客户海外尾程订单分页 }, '403': { description: 缺少海外尾程订单查看权限 } } + /api/merchant/v1/last-leg/orders/{id}: + get: + summary: 客户查询自己的海外尾程订单详情 + description: 权限 merchant:overseas-warehouse:last-mile-order:list;不泄露其他客户订单。 + security: [{ bearerAuth: [] }] + parameters: [{ name: id, in: path, required: true, schema: { type: integer, format: int64 } }] + responses: { '200': { description: 当前客户海外尾程订单详情 }, '403': { description: 缺少海外尾程订单查看权限 }, '404': { description: 当前客户下订单不存在 } } /api/merchant/v1/last-leg/warehouse-transfers: get: summary: 客户分页查询自己的仓储转运单