46 lines
2.5 KiB
YAML
46 lines
2.5 KiB
YAML
openapi: 3.0.3
|
|
info: { title: Firstleg Container Fee Allocation API, version: 1.0.0 }
|
|
paths:
|
|
/api/platform/v1/loading-plans/{loadingPlanId}/fee-details/allocation-groups:
|
|
post:
|
|
summary: 原子创建柜级公共费用分摊组
|
|
description: 客户、订单必填；入仓ID与入仓码同时填写或同时留空。各分摊金额必须大于0且合计等于费用总额。
|
|
security: [{ bearerAuth: [] }]
|
|
parameters: [{ $ref: '#/components/parameters/LoadingPlanId' }]
|
|
requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/AllocationGroupRequest' } } } }
|
|
responses: { '200': { description: 按客户和业务归属生成的待审核费用行 }, '409': { description: 分摊合计或柜内真实归属不一致 } }
|
|
/api/platform/v1/loading-plans/{loadingPlanId}/fee-details/allocation-groups/{groupId}/{action}:
|
|
post:
|
|
summary: 整组审核、驳回、调整或作废柜级分摊费用
|
|
description: action 仅为 approve、reject、adjust、void；单行接口拒绝处理分摊组，避免部分成功。
|
|
security: [{ bearerAuth: [] }]
|
|
parameters:
|
|
- { $ref: '#/components/parameters/LoadingPlanId' }
|
|
- { in: path, name: groupId, required: true, schema: { type: string, pattern: '^[1-9][0-9]{0,19}$' } }
|
|
- { in: path, name: action, required: true, schema: { type: string, enum: [approve, reject, adjust, void] } }
|
|
responses: { '200': { description: 整组处理成功 }, '409': { description: 版本、状态或完整性冲突 } }
|
|
components:
|
|
parameters:
|
|
LoadingPlanId: { in: path, name: loadingPlanId, required: true, schema: { type: string, pattern: '^[1-9][0-9]{0,19}$' } }
|
|
schemas:
|
|
AllocationGroupRequest:
|
|
type: object
|
|
required: [fee, allocations]
|
|
properties:
|
|
fee: { type: object, description: 公共费用字段；amount为原始柜级总额 }
|
|
allocations:
|
|
type: array
|
|
minItems: 1
|
|
maxItems: 200
|
|
items:
|
|
type: object
|
|
required: [customerId, orderId, orderNo, amount]
|
|
properties:
|
|
customerId: { type: string }
|
|
orderId: { type: string }
|
|
orderNo: { type: string, maxLength: 64 }
|
|
inboundId: { type: string, nullable: true }
|
|
inboundCode: { type: string, maxLength: 64, nullable: true }
|
|
amount: { type: number, format: decimal, exclusiveMinimum: 0 }
|
|
securitySchemes: { bearerAuth: { type: http, scheme: bearer, bearerFormat: JWT } }
|