fix(finance): key container finance by booking

This commit is contained in:
2026-09-08 21:27:23 +08:00
parent 55c36cf290
commit 1cf6722d6e
13 changed files with 99 additions and 50 deletions
@@ -10,7 +10,7 @@ paths:
get:
summary: 按客户和柜次查询已结算柜费及成本分摊
description: >-
customerId 与 containerId 必须在 Finance 的费用来源或成本快照中存在归属关系。
customerId 与 containerBookingId 必须在 Finance 的费用来源或成本快照中存在归属关系。
服务端固定执行三条集合 SQL,不按结算单或成本逐项查询;响应不包含整张结算单、
其他客户数据、付款凭证或内部备注。
x-permissions-all-of:
@@ -25,10 +25,10 @@ paths:
in: query
required: true
schema: {$ref: '#/components/schemas/Id'}
- name: containerId
- name: containerBookingId
in: query
required: true
description: Firstleg 装柜计划 ID。
description: Firstleg 真实货柜 containerBookingId,不是装柜计划 loadingPlanId。
schema: {$ref: '#/components/schemas/Id'}
responses:
'200':
@@ -63,10 +63,10 @@ components:
timestamp: {type: string, format: date-time}
ContainerSettlementDetails:
type: object
required: [customerId, containerId, settledSourceFeeIds, costs]
required: [customerId, containerBookingId, settledSourceFeeIds, costs]
properties:
customerId: {$ref: '#/components/schemas/Id'}
containerId: {$ref: '#/components/schemas/Id'}
containerBookingId: {$ref: '#/components/schemas/Id'}
settledSourceFeeIds:
type: array
uniqueItems: true
@@ -76,7 +76,7 @@ components:
items: {$ref: '#/components/schemas/ContainerCostDetail'}
ContainerCostDetail:
type: object
required: [costId, costNo, costType, costOrigin, containerId, feeItemName, amount, currency, status, allocations]
required: [costId, costNo, costType, costOrigin, containerBookingId, feeItemName, amount, currency, status, allocations]
properties:
costId: {$ref: '#/components/schemas/Id'}
costNo: {type: string}
@@ -84,7 +84,7 @@ components:
costOrigin: {type: string, enum: [MANUAL, FIRSTLEG_DIRECT_PAID, BUSINESS_DIRECT_PAID]}
sourceFeeId: {$ref: '#/components/schemas/Id'}
sourceFeeVersion: {type: integer, minimum: 1}
containerId: {$ref: '#/components/schemas/Id'}
containerBookingId: {$ref: '#/components/schemas/Id'}
supplierName: {type: string, nullable: true}
feeItemName: {type: string}
amount: {$ref: '#/components/schemas/Money'}