优化
This commit is contained in:
@@ -32,8 +32,17 @@ x-payable-cost-contract:
|
||||
paymentMethods: [ONLINE, BANK_TRANSFER, CASH, OTHER]
|
||||
onAccount: 可进入正式 PAYABLE settlement；paidAt/paymentMethod/paymentReferenceNo/paymentVoucherFileIds 必须为空
|
||||
directPaid: 必填 paidAt/paymentMethod，paymentReferenceNo 与 paymentVoucherFileIds 至少一项；只计成本，禁止进入 AP 和 outstandingPayable
|
||||
totals: 总成本=有效ON_ACCOUNT来源+有效DIRECT_PAID成本事实；待付=正式AP outstanding；已付=AP paid+DIRECT_PAID
|
||||
operatingFunds: 仅三类运营资金：待收客户款、待付供应商款、已线下支付供应商款；不存在客户线下支付分类，也不新增已收客户款卡片
|
||||
outstandingReceivable: 只聚合非VOIDED正式RECEIVABLE结算单outstanding，不叠加pendingBilling；客户收款只减少该余额并保留收款历史
|
||||
outstandingPayable: 非VOIDED正式PAYABLE结算单outstanding + 尚未进入非VOIDED AP的有效ON_ACCOUNT来源金额；按feeSourceId关联去重
|
||||
paidSupplierAmount: 有效FIRSTLEG_DIRECT_PAID确认成本 + 非VOIDED ON_ACCOUNT AP paidAmount；明细分别标识SUPPLIER_DIRECT_PAID和SUPPLIER_ON_ACCOUNT_PAYMENT
|
||||
totals: 总成本=有效ON_ACCOUNT来源+有效DIRECT_PAID成本事实；待付与已付按上述运营资金公式计算，作废、SUPERSEDED、部分付款和结清不得重复累计
|
||||
uniqueness: DIRECT_PAID 按 sourceSystem+sourceType+sourceFeeId+sourceVersion 唯一物化到 fin_cost，禁止与来源重复累计
|
||||
x-customer-account-ui-contract:
|
||||
operatingCards: [outstandingReceivable, outstandingPayable, paidCost]
|
||||
operatingCardLabels: [待收客户款, 待付供应商款, 已线下支付供应商款]
|
||||
auxiliaryFields: [pendingBilling, receivedInPeriod, totalCost]
|
||||
rule: 辅助字段只允许用于列表、明细或历史说明，不得生成第四类运营资金卡片；paidCost只属于供应商，禁止解释为客户线下支付。
|
||||
x-phase1-p0-contract:
|
||||
status: FROZEN
|
||||
rule: 所有已列 operation 均为当前目标契约；实现状态不得写入本文件。
|
||||
@@ -81,6 +90,7 @@ paths:
|
||||
- FIN-EVT-013
|
||||
- FIN-EVT-014
|
||||
- FIN-EVT-015
|
||||
- FIN-EVT-016
|
||||
- FIN-EVT-401
|
||||
parameters:
|
||||
- $ref: '#/components/parameters/InternalServiceToken'
|
||||
@@ -181,9 +191,11 @@ paths:
|
||||
operationId: getCustomerAccountSummary
|
||||
summary: 查询客户正式结算口径财务汇总
|
||||
description: >-
|
||||
固定 CNY。累计应收、已收和未结清仅聚合本客户非 VOIDED 的正式 RECEIVABLE
|
||||
fin_settlement；待出账仅聚合合格且尚未进入非 VOIDED 对账单的应收费用来源；
|
||||
未结应付仅聚合本客户非 VOIDED 的正式 PAYABLE fin_settlement。
|
||||
固定 CNY。待收客户款只聚合本客户非 VOIDED 正式 RECEIVABLE fin_settlement 的
|
||||
outstandingAmount，待出账只作为独立信息且不得叠加进待收。待付供应商款为非 VOIDED
|
||||
PAYABLE fin_settlement outstandingAmount，加尚未进入非 VOIDED AP 的合格 ON_ACCOUNT
|
||||
来源金额并按 feeSourceId 去重。paidCost 仅表示已线下支付供应商款，由有效
|
||||
FIRSTLEG_DIRECT_PAID 确认成本与非 VOIDED ON_ACCOUNT AP paidAmount 构成。
|
||||
x-permission: platform:finance:customer-account:list
|
||||
x-customer-isolation: 所有聚合子查询都必须使用 customerId 约束，空客户返回零值。
|
||||
parameters:
|
||||
@@ -867,7 +879,7 @@ components:
|
||||
enum: [UNPAID, PARTIALLY_PAID, PAID, OVERDUE]
|
||||
LedgerBusinessType:
|
||||
type: string
|
||||
enum: [RECONCILIATION_CREATED, SETTLEMENT_ISSUED, RECEIPT, PAYMENT, ADJUSTMENT, VOID]
|
||||
enum: [RECONCILIATION_CREATED, SETTLEMENT_ISSUED, RECEIPT, SUPPLIER_DIRECT_PAID, SUPPLIER_ON_ACCOUNT_PAYMENT, ADJUSTMENT, VOID]
|
||||
TraceMeta:
|
||||
type: object
|
||||
required: [requestId, traceId, timestamp]
|
||||
@@ -891,12 +903,20 @@ components:
|
||||
customerName: {type: string}
|
||||
contactName: {type: string}
|
||||
contactPhone: {type: string}
|
||||
outstandingReceivable: {$ref: '#/components/schemas/Money'}
|
||||
pendingBilling: {$ref: '#/components/schemas/Money'}
|
||||
outstandingReceivable:
|
||||
allOf: [{$ref: '#/components/schemas/Money'}]
|
||||
description: 待收客户款；仅正式非VOIDED应收结算单未收余额，不含待出账。
|
||||
pendingBilling:
|
||||
allOf: [{$ref: '#/components/schemas/Money'}]
|
||||
description: 合格但未进入有效对账单的应收来源，仅作独立过程信息，不计入待收客户款。
|
||||
receivedInPeriod: {$ref: '#/components/schemas/Money'}
|
||||
totalCost: {$ref: '#/components/schemas/Money'}
|
||||
paidCost: {$ref: '#/components/schemas/Money'}
|
||||
outstandingPayable: {$ref: '#/components/schemas/Money'}
|
||||
paidCost:
|
||||
allOf: [{$ref: '#/components/schemas/Money'}]
|
||||
description: 已线下支付供应商款；仅有效DIRECT_PAID确认成本与非VOIDED账期AP已付金额。
|
||||
outstandingPayable:
|
||||
allOf: [{$ref: '#/components/schemas/Money'}]
|
||||
description: 待付供应商款；有效AP未付与尚未制单ON_ACCOUNT来源按feeSourceId去重后的合计。
|
||||
status: {type: string, enum: [ACTIVE, DISABLED]}
|
||||
lastChangedAt: {type: string, format: date-time}
|
||||
AccountDetail:
|
||||
@@ -912,7 +932,7 @@ components:
|
||||
properties:
|
||||
customerId: {$ref: '#/components/schemas/Id'}
|
||||
currency: {type: string, enum: [CNY]}
|
||||
accountMode: {type: string, enum: [MANUAL_RECEIVABLE_LEDGER]}
|
||||
accountMode: {type: string, enum: [MANUAL_RECEIVABLE_LEDGER], description: 账户为人工财务操作台账；金额口径仍只取正式应收结算单。}
|
||||
totalReceivable: {$ref: '#/components/schemas/Money'}
|
||||
totalReceived: {$ref: '#/components/schemas/Money'}
|
||||
outstandingAmount: {$ref: '#/components/schemas/Money'}
|
||||
@@ -927,11 +947,19 @@ components:
|
||||
currency: {type: string, enum: [CNY]}
|
||||
totalReceivable: {$ref: '#/components/schemas/Money'}
|
||||
receivedAmount: {$ref: '#/components/schemas/Money'}
|
||||
outstandingReceivable: {$ref: '#/components/schemas/Money'}
|
||||
pendingBilling: {$ref: '#/components/schemas/Money'}
|
||||
outstandingReceivable:
|
||||
allOf: [{$ref: '#/components/schemas/Money'}]
|
||||
description: 待收客户款；仅正式非VOIDED应收结算单未收余额，不含待出账。
|
||||
pendingBilling:
|
||||
allOf: [{$ref: '#/components/schemas/Money'}]
|
||||
description: 独立待出账信息，不得与outstandingReceivable相加形成运营资金卡片。
|
||||
totalCost: {$ref: '#/components/schemas/Money'}
|
||||
paidCost: {$ref: '#/components/schemas/Money'}
|
||||
outstandingPayable: {$ref: '#/components/schemas/Money'}
|
||||
paidCost:
|
||||
allOf: [{$ref: '#/components/schemas/Money'}]
|
||||
description: 已线下支付供应商款；不存在客户线下支付含义。
|
||||
outstandingPayable:
|
||||
allOf: [{$ref: '#/components/schemas/Money'}]
|
||||
description: 待付供应商款；AP outstanding加未制单有效ON_ACCOUNT来源并去重。
|
||||
asOf: {type: string, format: date-time}
|
||||
lastChangedAt: {type: string, format: date-time}
|
||||
AccountEntryRead:
|
||||
|
||||
Reference in New Issue
Block a user