diff --git a/财务管理/Firstleg-Finance跨服务契约.md b/财务管理/Firstleg-Finance跨服务契约.md index 715d593..be972bc 100644 --- a/财务管理/Firstleg-Finance跨服务契约.md +++ b/财务管理/Firstleg-Finance跨服务契约.md @@ -16,11 +16,11 @@ Finance 已实现内部事件 Controller、令牌鉴权、Inbox 同事件哈希 | 事件名 | 生产时机 | Finance 处理 | 备注 | |---|---|---|---| -| `FIRSTLEG_FEE_PUBLISHED` | 入库或柜子费用审核通过、参与结算并发布；由 `aggregateType/payload` 区分来源 | 写入不可变来源版本 | 已实现并验证 | +| `FIRSTLEG_FEE_PUBLISHED` | 入库或柜子费用审核通过后自动发布；由 `aggregateType/payload` 区分来源 | 写入不可变来源版本 | 已实现并验证 | | `FIRSTLEG_FEE_ADJUSTED` | 入库或柜子费用调整产生新版本 | 追加新版本并将旧 `AVAILABLE` 标为 `SUPERSEDED` | 已实现并验证 | | `FIRSTLEG_FEE_VOIDED` | 入库或柜子费用作废 | 将同版本来源标为 `VOIDED`，不物理删除 | 已实现并验证 | -事件不是“已生成应收”通知；Finance 仍按产品确认的入池条件（例如 `settlementIncluded`、审核状态和作废状态）决定是否进入可出账池。 +事件不是“已生成应收”通知；Finance 按审核、发布、来源状态、币种和正金额条件决定是否进入可出账池，不保存人工“是否结算”开关。 ## 3. 统一事件信封 @@ -53,9 +53,9 @@ tenantId, sourceType, feeId, feeVersion, inboundId, inboundCode, orderId, containerId, containerBookingId, containerNo, customerId, customerName, feeItemId, feeItemCode, feeItemName, direction, businessDate, currency, totalAmount, -reviewStatus, publicationStatus, settlementIncluded, publishedAt, +reviewStatus, publicationStatus, publishedAt, chargeableQuantity, chargeUnit, actualGrossWeightKg, actualVolumeCbm, -sourceHash, snapshotVersion +supplierId, supplierName, supplierCategory, sourceHash, snapshotVersion ``` Finance 将完整 DTO 和 `sourceHash` 存入自有来源池。非 `FIRSTLEG_FEE_VOIDED` 事件只接受 `publicationStatus=PUBLISHED`；未发布返回 `FIN-EVT-015`。作废事件允许读取对应作废版本，但只能把既有来源标为 `VOIDED`，不得创建新来源。 @@ -117,6 +117,6 @@ Firstleg Outbox 发布采用至少一次投递：指数退避（建议 10s、30s 技术已确认：独立服务/数据库、DTO/事件通信、Outbox 至少一次、Finance Inbox 幂等、不可变来源快照、无跨库 Join、服务令牌、错误隔离和审计要求。 -产品口径已冻结：只有 `APPROVED + PUBLISHED + settlementIncluded=true + ACTIVE + CNY` 来源可入池；一期按客户/供应商形成五页单据，出账后冻结，调整/作废重开保留版本和原因；不做汇率、月结、钱包抵扣、费用分析和利润表。事件消费者不得从历史原型推断这些已排除能力。剩余问题是来源模型、接口、事件和消费者实现，不是产品冲突。 +产品口径已冻结：只有 `APPROVED + PUBLISHED + AVAILABLE + CNY + amount>0` 来源可入池；审核通过后自动成为结算候选。PAYABLE 的 supplierId 必须是 Warehouse `ACTIVE` 供应商，supplierCategory 为空时允许任意启用供应商，非空时严格匹配且 Finance 不从费用名称猜测类别。出账后冻结，调整/作废重开保留版本和原因；不做汇率、月结、钱包抵扣、费用分析和利润表。 主要剩余风险：测试环境尚未完成 Firstleg Relay → Finance Inbox → `fin_fee_source` 的真实 HTTP 冒烟。产品已确认无历史财务数据，不需要历史事件回放方案。 diff --git a/财务管理/openapi/finance-phase1-five-pages-v1.yaml b/财务管理/openapi/finance-phase1-five-pages-v1.yaml index 65d2707..868a5ca 100644 --- a/财务管理/openapi/finance-phase1-five-pages-v1.yaml +++ b/财务管理/openapi/finance-phase1-five-pages-v1.yaml @@ -5,7 +5,7 @@ info: description: >- 一期领导验收 5 页目标契约：客户账户、客户应收应付、客户对账单、结算单应收、 结算单应付。只支持 CNY。费用分析、利润表、钱包、预收和充值不属于本契约。 - 本文件只冻结一期目标契约，不记录开发中间态或测试进度。11 个 P0 operation 的实现与 + 本文件冻结一期目标契约及后续确认的费用编辑审核、客户确认和应收统计扩展。实现与 Admin 接入证据单独维护在财务一期P0实现证据矩阵.md，不得因代码文件出现反复修改本契约。 servers: - url: /api @@ -25,12 +25,11 @@ x-product-scope: - FOREIGN_CURRENCY - EXCHANGE_RATE x-source-gate: - eligible: APPROVED + PUBLISHED + settlementIncluded=true + ACTIVE + CNY - currentStatus: Finance 已显式校验非作废事件 PUBLISHED、APPROVED、参与结算、CNY、amount>0、客户/版本/方向/来源归属；Inbox 幂等及 fin_fee_source 写入/替代/作废均已验证。 + eligible: APPROVED + PUBLISHED + AVAILABLE + CNY + amount>0 + currentStatus: 审核通过后自动发布并进入结算候选；Finance 不再维护人工“是否结算”开关，并继续校验客户、版本、方向和来源归属。 x-phase1-p0-contract: status: FROZEN - operationCount: 11 - rule: 11 个 operation 均为一期 P0 目标契约；实现状态不得写入本文件。 + rule: 所有已列 operation 均为当前目标契约；实现状态不得写入本文件。 contract: ../财务一期P0操作契约与验收用例.md evidenceMatrix: ../财务一期P0实现证据矩阵.md x-idempotency-contract: @@ -56,7 +55,7 @@ paths: summary: 消费 Firstleg 不可变费用来源事件 description: >- 使用内部服务令牌鉴权；按 eventId 和完整事件请求哈希幂等消费，回查 Firstleg - 入库或柜子费用快照，校验客户、版本、审核、参与结算、CNY、方向和来源类型后， + 入库或柜子费用快照，校验客户、版本、审核、发布、CNY、方向和来源类型后， 写入 fin_inbox_event 与 fin_fee_source。调整新增版本并替代旧 AVAILABLE 版本，作废只改状态不删除历史。 x-authentication: X-Internal-Service-Token x-error-codes: @@ -118,6 +117,7 @@ paths: - FINANCE_RECEIVABLE_SETTLEMENT_DETAIL - FINANCE_PAYABLE_SETTLEMENT_LIST - FINANCE_PAYABLE_SETTLEMENT_DETAIL + - FINANCE_RECEIVABLE_STATISTICS requestBody: required: true content: @@ -241,9 +241,6 @@ paths: - name: reviewStatus in: query schema: {$ref: '#/components/schemas/ReviewStatus'} - - name: settlementIncluded - in: query - schema: {type: boolean} - name: statementGenerated in: query schema: {type: boolean} @@ -295,6 +292,19 @@ paths: '200': {$ref: '#/components/responses/FeeSourceDetailResponse'} '403': {$ref: '#/components/responses/BusinessError'} '404': {$ref: '#/components/responses/BusinessError'} + put: + operationId: editFinanceFeeSource + summary: 编辑草稿或驳回的费用来源 + x-permission: platform:finance:fee-source:edit + parameters: + - $ref: '#/components/parameters/FeeSourceId' + - $ref: '#/components/parameters/IdempotencyKey' + requestBody: + required: true + content: {application/json: {schema: {$ref: '#/components/schemas/FeeSourceEditRequest'}}} + responses: + '200': {$ref: '#/components/responses/FeeSourceDetailResponse'} + '409': {$ref: '#/components/responses/BusinessError'} /platform/finance/v1/fee-sources/{feeSourceId}/review: post: operationId: reviewFinanceFeeSource @@ -323,20 +333,11 @@ paths: '403': {$ref: '#/components/responses/BusinessError'} '404': {$ref: '#/components/responses/BusinessError'} '409': {$ref: '#/components/responses/BusinessError'} - /platform/finance/v1/fee-sources/{feeSourceId}/settlement-inclusion: - put: - operationId: updateFeeSourceSettlementInclusion - summary: 设置参与结算或禁止结算 - x-contract-status: FROZEN - x-delivery-priority: PHASE1_P0 - x-request-dto: SettlementInclusionRequest - x-response-dto: FeeSourceDetailEnvelope - x-idempotency: FULL_REQUEST_HASH_SAME_REPLAY_DIFFERENT_CONFLICT - x-customer-isolation: 只按 feeSourceId 解析其真实客户；跨客户业务引用按 FIN_404 隐藏。 - x-state-machine: APPROVED + PUBLISHED + AVAILABLE + CNY 可切换；LOCKED/BILLED/VOIDED/SUPERSEDED 禁止修改 - x-error-codes: [FIN_400, FIN_404, FIN_409, FIN_001] - x-acceptance-cases: [AC-08, AC-09, AC-29] - x-permission: platform:finance:fee-source:settlement + /platform/finance/v1/fee-sources/{feeSourceId}/submit: + post: + operationId: submitFinanceFeeSource + summary: 提交费用来源审核 + x-permission: platform:finance:fee-source:edit parameters: - $ref: '#/components/parameters/FeeSourceId' - $ref: '#/components/parameters/IdempotencyKey' @@ -344,12 +345,37 @@ paths: required: true content: application/json: - schema: {$ref: '#/components/schemas/SettlementInclusionRequest'} + schema: {$ref: '#/components/schemas/FeeSourceActionRequest'} + responses: + '200': {$ref: '#/components/responses/FeeSourceDetailResponse'} + '409': {$ref: '#/components/responses/BusinessError'} + /platform/finance/v1/fee-sources/{feeSourceId}/adjust: + post: + operationId: adjustFinanceFeeSource + summary: 将已审核费用调整为新草稿版本 + x-permission: platform:finance:fee-source:edit + parameters: + - $ref: '#/components/parameters/FeeSourceId' + - $ref: '#/components/parameters/IdempotencyKey' + requestBody: + required: true + content: {application/json: {schema: {$ref: '#/components/schemas/FeeSourceEditRequest'}}} + responses: + '200': {$ref: '#/components/responses/FeeSourceDetailResponse'} + '409': {$ref: '#/components/responses/BusinessError'} + /platform/finance/v1/fee-sources/{feeSourceId}/void: + post: + operationId: voidFinanceFeeSource + summary: 作废费用来源 + x-permission: platform:finance:fee-source:edit + parameters: + - $ref: '#/components/parameters/FeeSourceId' + - $ref: '#/components/parameters/IdempotencyKey' + requestBody: + required: true + content: {application/json: {schema: {$ref: '#/components/schemas/FeeSourceActionRequest'}}} responses: '200': {$ref: '#/components/responses/FeeSourceDetailResponse'} - '400': {$ref: '#/components/responses/BusinessError'} - '403': {$ref: '#/components/responses/BusinessError'} - '404': {$ref: '#/components/responses/BusinessError'} '409': {$ref: '#/components/responses/BusinessError'} /platform/finance/v1/statements: get: @@ -486,13 +512,13 @@ paths: '200': {$ref: '#/components/responses/PayableSettlementListReadResponse'} post: operationId: createPayableSettlement - summary: 从审核通过且参与结算的应付来源生成应付结算单 + summary: 从审核通过且已发布的应付来源生成应付结算单 x-contract-status: FROZEN x-delivery-priority: PHASE1_P0 x-request-dto: CreatePayableSettlementRequest x-response-dto: SettlementDetailEnvelope x-idempotency: FULL_REQUEST_HASH_SAME_REPLAY_DIFFERENT_CONFLICT - x-customer-isolation: 所有 PAYABLE 来源必须同 customerId、同 supplierId 且映射到同一供应商类别；supplierId 必须来自 Warehouse ACTIVE 供应商主数据并与费用类别匹配，跨客户来源按 FIN_404。 + x-customer-isolation: 所有 PAYABLE 来源必须同 customerId、同 supplierId；supplierId 必须来自 Warehouse ACTIVE 供应商主数据。费用项目 supplierCategory 非空时必须匹配，空时允许任意 ACTIVE 供应商；跨客户来源按 FIN_404。 x-state-machine: 合格未占用 PAYABLE 来源 -> ISSUED PAYABLE settlement x-error-codes: [FIN_400, FIN_404, FIN_409, FIN_503, FIN_001] x-acceptance-cases: [AC-20, AC-21, AC-29] @@ -548,6 +574,45 @@ paths: x-permission: merchant:finance:statement:view responses: '200': {$ref: '#/components/responses/ClientReceiptListReadResponse'} + /client/finance/v1/statements/{statementId}/confirm: + post: + operationId: confirmClientReconciliationStatement + summary: 当前登录客户确认本人已出账对账单 + description: 不接收 customerId；客户范围和确认人均取自登录态。重复请求按 Idempotency-Key 幂等处理。 + x-permission: merchant:finance:statement:confirm + parameters: + - $ref: '#/components/parameters/StatementId' + - $ref: '#/components/parameters/IdempotencyKey' + requestBody: + required: true + content: {application/json: {schema: {$ref: '#/components/schemas/CustomerConfirmationRequest'}}} + responses: + '200': {description: 已确认或幂等返回原确认结果} + '404': {$ref: '#/components/responses/BusinessError'} + '409': {$ref: '#/components/responses/BusinessError'} + /platform/finance/v1/receivable-statistics: + get: + operationId: getReceivableStatistics + summary: 按结算单生成月份和客户统计 CNY 应收款 + description: 只统计 direction=RECEIVABLE、status!=VOIDED 的 fin_settlement；按客户汇总应收、已收和余额未收。 + x-permission: platform:finance:receivable-statistics:list + parameters: + - name: month + in: query + required: true + schema: {type: string, pattern: '^\d{4}-\d{2}$', example: '2026-08'} + - name: customerId + in: query + schema: {$ref: '#/components/schemas/Id'} + - name: page + in: query + schema: {type: integer, minimum: 1, default: 1} + - name: pageSize + in: query + schema: {type: integer, minimum: 1, maximum: 200, default: 20} + responses: + '200': {description: CNY 应收款统计结果} + '400': {$ref: '#/components/responses/BusinessError'} /platform/finance/v1/settlements/{settlementId}: get: operationId: getSettlement @@ -683,7 +748,7 @@ components: type: object description: >- ACCOUNT_LIST: customerId?, status?；ACCOUNT_LEDGER: customerId, businessType?, startDate?, endDate?； - FEE_SOURCE_LIST: customerId?, direction?, status?, reviewStatus?, settlementIncluded?, statementGenerated?, + FEE_SOURCE_LIST: customerId?, direction?, status?, reviewStatus?, statementGenerated?, businessDateFrom?, businessDateTo?, keyword?；RECONCILIATION_STATEMENT_LIST: customerId?, status?, billNo?, containerNo?, periodStartFrom?, periodStartTo?, periodEndFrom?, periodEndTo?, settled?, lastPaymentFrom?, lastPaymentTo?, createdFrom?, createdTo?；AR_LIST: customerId?, status?, settlementNo?；AP_LIST 另含 @@ -785,7 +850,7 @@ components: enum: [UNPAID, PARTIALLY_PAID, PAID, OVERDUE] LedgerBusinessType: type: string - enum: [FEE_INCLUDED, FEE_EXCLUDED, RECONCILIATION_CREATED, SETTLEMENT_ISSUED, RECEIPT, PAYMENT, ADJUSTMENT, VOID] + enum: [RECONCILIATION_CREATED, SETTLEMENT_ISSUED, RECEIPT, PAYMENT, ADJUSTMENT, VOID] TraceMeta: type: object required: [requestId, traceId, timestamp] @@ -877,7 +942,7 @@ components: remark: {type: string} FeeSource: type: object - required: [feeSourceId, sourceSystem, sourceType, sourceFeeId, sourceVersion, direction, customerId, businessDate, feeItemName, amount, currency, reviewStatus, settlementIncluded, sourceStatus, statementGenerated] + required: [feeSourceId, sourceSystem, sourceType, sourceFeeId, sourceVersion, direction, customerId, businessDate, feeItemName, amount, currency, reviewStatus, sourceStatus, statementGenerated] properties: feeSourceId: {$ref: '#/components/schemas/Id'} sourceSystem: {type: string, minLength: 1} @@ -902,7 +967,6 @@ components: amount: {$ref: '#/components/schemas/Money'} currency: {type: string, enum: [CNY]} reviewStatus: {$ref: '#/components/schemas/ReviewStatus'} - settlementIncluded: {type: boolean} sourceStatus: {type: string, enum: [AVAILABLE, LOCKED, BILLED, VOIDED, SUPERSEDED]} statementGenerated: {type: boolean} FeeSourceDetail: @@ -911,7 +975,6 @@ components: - type: object properties: reviewReason: {type: string} - settlementReason: {type: string} sourceHash: {type: string} operationLogs: type: array @@ -949,16 +1012,27 @@ components: action: {type: string, enum: [APPROVE, REJECT]} reason: {type: string, maxLength: 500} expectedVersion: {type: integer, minimum: 0} - SettlementInclusionRequest: + FeeSourceEditRequest: type: object - required: [included, reason, expectedVersion] + required: [amount, reason, expectedVersion] properties: - included: {type: boolean} + amount: {$ref: '#/components/schemas/Money'} reason: {type: string, minLength: 1, maxLength: 500} expectedVersion: {type: integer, minimum: 0} + FeeSourceActionRequest: + type: object + required: [reason, expectedVersion] + properties: + reason: {type: string, minLength: 1, maxLength: 500} + expectedVersion: {type: integer, minimum: 0} + CustomerConfirmationRequest: + type: object + required: [expectedVersion] + properties: + expectedVersion: {type: integer, minimum: 0} ReconciliationSummary: type: object - required: [statementId, statementNo, customerId, customerName, periodStart, periodEnd, creditDays, currency, lineCount, sourceCount, sourceAmount, adjustmentAmount, totalReceivable, receivedAmount, outstandingAmount, settled, status, version, createdBy, createdAt, updatedBy, updatedAt] + required: [statementId, statementNo, customerId, customerName, periodStart, periodEnd, creditDays, currency, lineCount, sourceCount, sourceAmount, adjustmentAmount, totalReceivable, receivedAmount, outstandingAmount, settled, status, version, customerConfirmationStatus, createdBy, createdAt, updatedBy, updatedAt] properties: statementId: {$ref: '#/components/schemas/Id'} statementNo: {type: string, pattern: '^REC-\d{6}-\d{4}$', example: REC-260818-0001} @@ -982,6 +1056,10 @@ components: settled: {type: boolean} status: {$ref: '#/components/schemas/ReconciliationStatus'} version: {type: integer, minimum: 0} + customerConfirmationStatus: {type: string, enum: [NOT_REQUIRED, PENDING_CONFIRMATION, CONFIRMED]} + customerConfirmedBy: {$ref: '#/components/schemas/Id'} + customerConfirmedByName: {type: string} + customerConfirmedAt: {type: string, format: date-time} createdBy: {$ref: '#/components/schemas/Id'} createdByName: {type: string, description: 创建时操作人名称快照；历史数据可能为空} createdAt: {type: string, format: date-time} diff --git a/财务管理/财务一期P0操作契约与验收用例.md b/财务管理/财务一期P0操作契约与验收用例.md index 15ed349..323e576 100644 --- a/财务管理/财务一期P0操作契约与验收用例.md +++ b/财务管理/财务一期P0操作契约与验收用例.md @@ -1,7 +1,7 @@ # 财务一期 P0 操作契约与验收用例 > 日期：2026-08-11 -> 适用范围：一期 5 页闭环中尚未实现的 11 个 operation +> 适用范围：一期财务闭环及后续确认的费用编辑审核、客户确认操作 > 状态口径：以下 11 项全部是一期 P0，目标契约已冻结；实现和 Admin 接入证据只维护在 `财务一期P0实现证据矩阵.md` > 机器契约：`openapi/finance-phase1-five-pages-v1.yaml` @@ -16,19 +16,19 @@ - 稳定错误码固定为：`FIN_400` 参数/CNY/金额错误，`FIN_404` 不存在或跨客户隐藏，`FIN_409` 状态/版本/重复占用/幂等冲突，`FIN_503` File 或内部依赖不可用，`FIN_001` 未分类服务端错误。认证和权限拒绝使用 HTTP `401/403`。 - 所有成功和业务错误响应固定包含 `requestId`、`traceId`、`timestamp`；成功 body 使用 `code="200"`，不得返回 Entity、Map 或临时字段。 -## 2. 11 个 P0 operation 冻结矩阵 +## 2. P0 operation 冻结矩阵 | P0 | operationId | 请求 DTO | 响应 DTO | 权限 | 状态/隔离与核心验收 | |---|---|---|---|---|---| | P0-01 | `listDerivedCustomerAccounts` | `AccountListQuery`（page/pageSize/keyword/status） | `AccountPageEnvelope` | `platform:finance:account:view` | 聚合未收、待出账、本期已收、应付；停用客户仍保留历史金额；无钱包字段。验收 AC-01、AC-02 | | P0-02 | `listDerivedCustomerAccountLedger` | `AccountLedgerQuery`（customerId path、业务类型、日期、分页） | `LedgerPageEnvelope` | `platform:finance:account:view` | 只返回指定客户来源/单据/收付款派生流水；日期闭区间；跨客户对象不可混入。验收 AC-03、AC-04 | -| P0-03 | `getFinanceFeeSource` | `FeeSourceIdPath` | `FeeSourceDetailEnvelope` | `platform:finance:fee-source:view` | 返回业务关联、版本、审核、参与结算、占用和操作日志；不接受前端金额覆盖。验收 AC-05 | -| P0-04 | `reviewFinanceFeeSource` | `ReviewRequest` | `FeeSourceDetailEnvelope` | `platform:finance:fee-source:review` | `PENDING -> APPROVED/REJECTED`；非 PENDING、旧版本、已占用均拒绝。验收 AC-06、AC-07 | -| P0-05 | `updateFeeSourceSettlementInclusion` | `SettlementInclusionRequest` | `FeeSourceDetailEnvelope` | `platform:finance:fee-source:settlement` | 仅 `APPROVED + PUBLISHED + AVAILABLE + CNY` 可纳入；LOCKED/BILLED/VOIDED/SUPERSEDED 不可改。验收 AC-08、AC-09 | +| P0-03 | `getFinanceFeeSource` | `FeeSourceIdPath` | `FeeSourceDetailEnvelope` | `platform:finance:customer-arap:list` | 返回业务关联、版本、审核、占用和操作日志；不接受前端覆盖客户或来源标识。验收 AC-05 | +| P0-04 | `reviewFinanceFeeSource` | `ReviewRequest` | `FeeSourceDetailEnvelope` | `platform:finance:fee-source:review` | `PENDING -> APPROVED/REJECTED`；非 PENDING、旧版本、已占用均拒绝。审核通过自动发布并成为结算候选。验收 AC-06、AC-07 | +| P0-05 | `editFinanceFeeSource` / `submitFinanceFeeSource` / `adjustFinanceFeeSource` / `voidFinanceFeeSource` | `FeeSourceEditRequest` / `FeeSourceActionRequest` | `FeeSourceDetailEnvelope` | `platform:finance:fee-source:edit` | `DRAFT/REJECTED` 可编辑并提交；`APPROVED` 调整回新草稿；作废保留审计。没有“是否结算”开关。验收 AC-08、AC-09 | | P0-06 | `createReconciliationStatement` | `CreateReconciliationRequest` | `ReconciliationDetailEnvelope` | `platform:finance:reconciliation:create` | 按截止日或勾选来源生成 DRAFT；来源须同客户、合格且未被有效单据占用，金额由服务端快照读取。验收 AC-10 至 AC-12 | | P0-07 | `actionReconciliationStatement` | `ReconciliationActionRequest` | `ReconciliationDetailEnvelope` | 按 action 使用 review/issue/adjust/void 权限 | 提交、审核、出账、调整、作废、重开均走 revision；ISSUED 冻结来源，调整后总额不得低于已收。验收 AC-13 至 AC-17 | | P0-08 | `createReceivableSettlement` | `CreateReceivableSettlementRequest` | `SettlementDetailEnvelope` | `platform:finance:settlement-ar:create` | 只从同客户 ISSUED 对账单生成，一张有效对账单只能有一个有效应收结算单；直接进入 ISSUED。验收 AC-18、AC-19 | -| P0-09 | `createPayableSettlement` | `CreatePayableSettlementRequest` | `SettlementDetailEnvelope` | `platform:finance:settlement-ap:create` | 同客户、同供应商的 APPROVED/INCLUDED/AVAILABLE/CNY PAYABLE 来源生成；直接进入 ISSUED。验收 AC-20、AC-21 | +| P0-09 | `createPayableSettlement` | `CreatePayableSettlementRequest` | `SettlementDetailEnvelope` | `platform:finance:settlement-ap:create` | 同客户、同供应商的 APPROVED/PUBLISHED/AVAILABLE/CNY PAYABLE 来源生成；供应商必须 ACTIVE，非空 supplierCategory 必须匹配。直接进入 ISSUED。验收 AC-20、AC-21 | | P0-10 | `getSettlement` | `SettlementIdPath` | `SettlementDetailEnvelope` | AR/AP view 二选一并与单据方向匹配 | 返回结算单、来源快照、revision 和收付款记录；没有对应方向权限时 HTTP 403。验收 AC-22、AC-23 | | P0-11 | `createSettlementPayment` | `CreateSettlementPaymentRequest` | `SettlementDetailEnvelope` | `platform:finance:payment:create` | 只允许 PAYABLE 的 ISSUED/PARTIALLY_PAID；金额不得超过余额，凭证 File fail-closed；更新为 PARTIALLY_PAID/PAID。验收 AC-24 至 AC-26 | @@ -43,12 +43,12 @@ ### 3.1 费用来源 ```text -PENDING --APPROVE--> APPROVED +DRAFT/REJECTED --EDIT/SUBMIT--> PENDING +PENDING --APPROVE--> APPROVED + PUBLISHED（自动成为结算候选） PENDING --REJECT---> REJECTED - -APPROVED + PUBLISHED + AVAILABLE --INCLUDE/EXCLUDE--> settlementIncluded true/false +APPROVED --ADJUST--> DRAFT（新版本） AVAILABLE --对账单占用--> LOCKED --对账单出账--> BILLED -任意未出账有效版本 --上游作废--> VOIDED +任意未出账有效版本 --VOID--> VOIDED AVAILABLE --上游调整新版本--> SUPERSEDED ``` @@ -66,6 +66,8 @@ DRAFT/PENDING_REVIEW/APPROVED/ISSUED --VOID--> VOIDED（已收金额=0 且无有 `ADJUST` 必须提交至少一条调整行和原因；新总额不得小于已收金额。`VOID/REOPEN` 必须填写原因。ISSUED 后普通编辑接口不存在。 +客户确认状态独立于上述主状态：`NOT_REQUIRED --ISSUE--> PENDING_CONFIRMATION --客户确认--> CONFIRMED`；调整后重置为 `PENDING_CONFIRMATION` 并保留历史确认审计。 + ### 3.3 应收/应付结算单和收付款 ```text @@ -94,7 +96,7 @@ VOIDED --REOPEN--> ISSUED（新 revision） | AC-03/04 | 客户 A 流水不出现客户 B 单据；起止日期非法返回 `FIN_400` | | AC-05 | 详情返回来源版本、业务对象和操作日志；不存在返回 `FIN_404` | | AC-06/07 | PENDING 审核成功；重复审核、旧 expectedVersion 返回 `FIN_409` | -| AC-08/09 | 合格来源可切换参与结算；已锁定/出账/作废/替代版本返回 `FIN_409` | +| AC-08/09 | 草稿/驳回项可编辑提交，已审核项可调整，非法状态或旧版本返回 `FIN_409`；审核通过后自动进入结算候选 | | AC-10/11/12 | 两种生成模式成功；跨客户、非 CNY、重复占用或不合格来源分别返回 `FIN_404/FIN_400/FIN_409`，且不产生半成品 | | AC-13/14 | 合法提交、审核和出账按状态迁移；非法 action/state 或并发版本返回 `FIN_409` | | AC-15/16/17 | ISSUED 调整产生 revision；低于已收拒绝；有收款或有效结算单时作废拒绝；重开保留历史 | diff --git a/财务管理/财务一期五页产品与接口验收契约.md b/财务管理/财务一期五页产品与接口验收契约.md index f9c4c77..6e33842 100644 --- a/财务管理/财务一期五页产品与接口验收契约.md +++ b/财务管理/财务一期五页产品与接口验收契约.md @@ -39,7 +39,7 @@ | 指标 | 公式 | |---|---| | 未收余额 | 生效应收结算单应收金额合计 - 已收金额合计 | -| 待出账金额 | `AVAILABLE + APPROVED + settlementIncluded=true` 且未进入有效对账单的应收费用来源金额合计 | +| 待出账金额 | `AVAILABLE + APPROVED + PUBLISHED + CNY` 且未进入有效对账单的应收费用来源金额合计 | | 本期已收金额 | 查询期间内有效收款分配金额合计 | | 应付余额 | 生效应付结算单应付金额合计 - 已付金额合计 | @@ -48,10 +48,10 @@ | 页面 | 原型结构和筛选 | 一期字段 | 一期操作 | 状态与验收 | |---|---|---|---|---| | 客户账户 | 汇总卡、客户列表、账户详情、流水详情；客户名称/编号、账户状态、余额条件、流水类型和日期 | 客户基本信息、客户编号、联系人、电话、未收余额、待出账金额、本期已收金额、应付余额、账户状态、最后变动时间；流水号、时间、业务类型、关联单据、应收/应付变动、变动后未收余额、操作人、备注 | 详情、查询、重置、导出；**无充值、扣款或余额调整** | 客户主体正常/停用只影响访问和新业务；所有金额可由来源、单据和收付款逐笔追溯，禁止直接写余额 | -| 客户应收应付 | 工具栏、组合查询、选中汇总、费用列表、费用详情、审核进度、关联业务、操作记录 | 客户、费用单号、是否已生成对账单、参与结算、审核状态、应收/应付、入仓码/柜次号、业务状态、费用类型、金额、业务发生日、来源类型、来源版本 | 详情、审核通过、审核拒绝、编辑未审核人工项、参与结算/禁止结算、按截止时间或勾选生成；已发布来源不可删除，只能作废/调整 | `PENDING -> APPROVED/REJECTED`；只有 `APPROVED + INCLUDED + AVAILABLE + CNY` 可生成；同一来源版本不能重复进入有效单据 | -| 客户对账单 | 查询区、主表、账单明细、支付历史；审核状态、账单编号、客户、柜次、结算起止日、是否结清、创建日期、最后收款时间 | 对账单号、客户、期间、账期、CNY、总应收、已收、未收、最后收款时间、是否结清、备注、创建/更新人时间；明细保留入仓单/柜次、业务日、计费量、费用项、金额、来源版本 | 生成草稿、详情、导出、审核通过、审核拒绝、作废；不提供发票和汇率操作 | `DRAFT -> PENDING_REVIEW -> APPROVED/REJECTED/VOIDED`；审核通过后来源冻结，调整必须留 revision；支付历史只读展示有效收款 | +| 客户应收应付 | 工具栏、组合查询、选中汇总、费用列表、费用详情、审核进度、关联业务、操作记录 | 客户、费用单号、是否已生成对账单、审核状态、应收/应付、入仓码/柜次号、业务状态、费用类型、金额、业务发生日、来源类型、来源版本 | 详情、编辑草稿/驳回项、提交审核、审核通过/拒绝、调整、作废、按截止时间或勾选生成；不提供“是否结算”开关 | `DRAFT/REJECTED -> PENDING -> APPROVED`；`APPROVED + PUBLISHED + AVAILABLE + CNY` 自动成为结算候选；同一来源版本不能重复进入有效单据 | +| 客户对账单 | 查询区、主表、账单明细、支付历史；审核状态、账单编号、客户、柜次、结算起止日、是否结清、创建日期、最后收款时间 | 对账单号、客户、期间、账期、CNY、总应收、已收、未收、客户确认状态/确认人/确认时间、最后收款时间、是否结清、备注、创建/更新人时间 | 生成草稿、详情、导出、审核、出账、调整、作废；客户在 Client 确认本人已出账账单 | 主状态与客户确认状态独立；出账后 `PENDING_CONFIRMATION`，客户确认后 `CONFIRMED`，调整后重置待确认并保留历史审计 | | 结算单应收 | 汇总卡、筛选、列表、详情、费用明细、收款记录；收款状态、客户、结算单号 | 结算单号、客户、CNY、应收、已收、余额、关联对账单、业务期间、生成日、到期日、收款状态、制单人、状态 | 从已出账对账单生成、详情、部分收款、导出、作废/重开；不保留高级查询假入口 | 生成后直接 `ISSUED -> PARTIALLY_PAID -> PAID`；来源已在对账单阶段审核，结算单不重复增加假审批；未收款可作废，调整保留 revision | -| 结算单应付 | 汇总卡、供应商筛选、列表、详情、费用明细、付款记录 | 结算单号、供应商、费用类型、CNY、应付、已付、余额、来源期间、生成日、到期日、付款状态、制单人、状态 | 从审核通过且参与结算的应付来源生成、详情、部分付款、导出、作废/重开；删除利润分析和利润审批按钮 | 生成后直接 `ISSUED -> PARTIALLY_PAID -> PAID`；不重复增加结算单审批；作废/重开保留 revision，付款为人工登记和凭证图片 | +| 结算单应付 | 汇总卡、供应商筛选、列表、详情、费用明细、付款记录 | 结算单号、供应商、费用类型、CNY、应付、已付、余额、来源期间、生成日、到期日、付款状态、制单人、状态 | 从审核通过且自动发布的应付来源生成、详情、部分付款、导出、作废/重开；删除利润分析和利润审批按钮 | 生成后直接 `ISSUED -> PARTIALLY_PAID -> PAID`；不重复增加结算单审批；作废/重开保留 revision，付款为后台人工登记和凭证图片 | 表格“操作”列必须位于第一列。原型中未形成真实闭环的“新增、生成账单、高级查询、快捷导出”等按钮，只有在对应接口和权限完成后才显示。 @@ -60,7 +60,7 @@ | 页面 | 当前仓库事实 | 一期目标 | 差异等级 | |---|---|---|---| | 客户账户 | 后端已新增 `/customer-accounts/{customerId}` 和固定读 DTO；无列表接口 | 派生财务往来汇总、详情和流水，无任何充值/余额写入口 | IMPLEMENTED（单客户查询）；列表/筛选仍缺，Finance DTO 测试通过 | -| 客户应收应付 | `/fee-pool` 固定 DTO、Firstleg 事件/快照和 `fin_fee_source` 写入均已实现并验证 | 真实入库/柜子费用来源池，支持审核、参与结算、详情和生成对账单 | 查询与来源入池已实现；详情、审核、参与结算均为一期 P0 | +| 客户应收应付 | `/fee-sources` 固定 DTO、Firstleg 事件/快照和 `fin_fee_source` 写入均已实现 | 真实入库/柜子费用来源池，支持编辑、提交、审核、调整、作废、详情和生成对账单 | 审核通过自动成为结算候选，不提供人工结算开关 | | 客户对账单 | 后端已新增 `/statements` 和 `/bills/{billId}` 固定读 DTO 路径；独立生成/审核模型仍缺失 | 按截止时间或勾选合格来源生成，支持审核、明细、支付历史和 revision | IN_PROGRESS/P0 | | 结算单应收 | 后端已新增 `/receivable-settlements` 固定读 DTO 路径；`fin_bill + fin_receipt` 已有人工状态能力 | 关联审核通过的客户对账单，按原型结构形成应收结算页 | IN_PROGRESS/P0 适配 | | 结算单应付 | 后端已新增 `/payable-settlements` 固定读 DTO 路径并读取人工成本；付款单和完整供应商来源池仍缺失 | 从真实 PAYABLE 来源生成，审核后人工登记付款与凭证 | IN_PROGRESS/P0 | @@ -73,8 +73,7 @@ Finance 来源写入不再是阻断：内部事件入口、Inbox 幂等、Firstl flowchart LR I["入库单费用项"] --> R["审核"] C["柜子费用项"] --> R - R --> S["参与结算/禁止结算"] - S --> P["发布不可变来源版本"] + R --> P["审核通过后自动发布不可变来源版本"] P --> X["Finance Inbox"] X --> F["fin_fee_source"] F --> A["客户应收应付费用池"] @@ -91,17 +90,17 @@ flowchart LR 现有 `fl_inbound_fee_detail` 已具备客户、入库单、方向、业务日、费用项快照、计费量、单价、金额、审核、发布和 `settlement_included` 字段；已有列表、新增、编辑、删除、审核通过和驳回接口。 -当前 Firstleg 来源发布、调整/作废事件、Relay、Finance 消费者和来源快照写入已经实现并通过测试。Finance 五页内的费用来源详情、二次审核和参与结算操作仍按一期 P0 补齐；这些操作不得绕过已发布不可变来源版本或覆盖上游业务事实。 +当前 Firstleg 来源发布、调整/作废事件、Relay、Finance 消费者和来源快照写入已经实现。费用来源采用编辑、提交、审核、调整、作废闭环；审核通过后自动发布，不再提供参与结算开关。 ### 4.2 柜子费用项 -当前柜子费用来源表/实体、Controller、审核/参与结算/作废服务、发布事件、Relay 和内部快照已经实现，相关定向测试 17/17 通过。Firstleg 的真实柜次体积快照同时服务 Finance 整柜成本分摊，但仍不能由 Admin 手工提交的订单归属或体积替代。 +当前柜子费用来源表/实体、Controller、审核/调整/作废服务、自动发布事件、Relay 和内部快照已经实现。Firstleg 的真实柜次体积快照同时服务 Finance 整柜成本分摊，但仍不能由 Admin 手工提交的订单归属或体积替代。 一期至少需要业务侧模型： - `containerFeeId/version`、`containerId/containerNo`、费用方向、费用项目、业务日、CNY 金额。 - 应付来源必须有供应商；应收来源必须有客户分摊结果。 -- 审核状态、参与结算状态、发布状态、作废/调整原因和操作审计。 +- 审核状态、发布状态、作废/调整原因和操作审计。 - 柜内跨客户时，业务侧按真实体积形成不可变客户分摊行；Finance 只接收客户级来源，不自行猜测客户归属。 建议新增 `fl_container_fee_detail + fl_container_fee_allocation`，或建立统一 `fl_business_fee_source`；这是技术选型，不改变上述产品字段和验收结果。 @@ -115,7 +114,6 @@ flowchart LR ```text reviewStatus = APPROVED publicationStatus = PUBLISHED -settlementIncluded = true sourceStatus = ACTIVE currency = CNY amount > 0 @@ -129,12 +127,11 @@ Finance 必须通过 Inbox 幂等消费来源版本，或通过受保护的快 | 页面/链路 | 目标接口 | 当前状态 | |---|---|---| | 入库费用审核 | `POST /api/platform/v1/inbounds/{inboundId}/fee-details/{detailId}/approve|reject` | 已有 | -| 入库费用参与结算 | `PUT /api/platform/v1/inbounds/{inboundId}/fee-details/{detailId}/settlement-inclusion` | 缺失 | -| 入库费用发布 | `POST /api/platform/v1/inbounds/{inboundId}/fee-details/{detailId}/publish` | 通用入口缺失 | +| 入库费用发布 | 审核通过后自动发布，无独立人工开关 | 已确认 | | 柜子费用 | `/api/platform/v1/loading-plans/{loadingPlanId}/fee-details/**` | 模型、审核/调整/作废、事件、Relay 和快照已实现；Firstleg 相关 17/17 定向测试通过 | | Finance 来源接入 | `POST /internal/finance/v1/fee-source-events` | 已实现并验证；来源专项 10/10、Finance 全量 35/35、Firstleg 相关 17/17 通过 | | 客户账户 | `GET /api/platform/finance/v1/customer-accounts/{customerId}` | 已实现固定 DTO 单客户查询并通过测试；列表接口仍缺失 | -| 客户应收应付 | `GET /api/platform/finance/v1/fee-pool?customerId=&direction=` | 已实现固定 DTO 查询并通过测试；详情、审核和参与结算操作仍缺失 | +| 客户应收应付 | `GET /api/platform/finance/v1/fee-sources` 及 edit/submit/review/adjust/void | 已实现编辑审核闭环；无“是否结算”接口 | | 客户对账单 | `GET /api/platform/finance/v1/statements?customerId=`、`GET /api/platform/finance/v1/bills/{billId}` | 已实现固定 DTO 查询并通过测试；生成/审核操作仍缺失 | | 结算单应收 | `GET /api/platform/finance/v1/receivable-settlements?customerId=` | 已实现固定 DTO 查询并通过测试；生成与页面动作仍缺失 | | 应收人工收款 | `GET/POST /api/platform/finance/v1/receipts` | 已实现平台固定 DTO、多账单分配、合计校验、共用凭证和 File fail-closed；测试通过 | @@ -144,7 +141,7 @@ Finance 必须通过 Inbox 幂等消费来源版本，或通过受保护的快 | 模型 | 必要字段 | 当前缺口 | |---|---|---| -| `fin_fee_source` | 来源系统/类型/ID/版本/hash、方向、客户、供应商、订单/入库/柜次、业务日、费用项、数量/单价/金额、审核/参与结算快照、状态、占用单据 | 已有写入、类型、方向、柜次、费用编码、hash、完整 JSON 快照和版本状态；供应商顶层字段及对账单占用关系属于本期 P0 数据模型，不得延后 | +| `fin_fee_source` | 来源系统/类型/ID/版本/hash、方向、客户、供应商、订单/入库/柜次、业务日、费用项、数量/单价/金额、审核、发布、状态、占用单据 | 不保存人工结算开关；供应商 ID/名称与可空类别约束均来自上游不可变快照 | | `fin_reconciliation_statement` | 对账单号、客户、期间、账期、CNY 总额、状态、审核、版本、备注 | 缺失 | | `fin_reconciliation_line` | 对账单、feeSourceId/version/hash、业务与计费快照、金额 | 缺失 | | `fin_settlement` | AR/AP、客户/供应商、来源对账单、期间、到期日、总额、已收付、余额、状态、版本 | 当前 `fin_bill` 仅覆盖部分 AR | @@ -156,7 +153,7 @@ Finance 必须通过 Inbox 幂等消费来源版本，或通过受保护的快 ### P0：一期验收硬阻断 -1. 以下 11 个 operation 全部实现并通过直接行为测试：账户列表/流水；费用来源详情/审核/参与结算；对账单生成及出账/调整/作废；应收/应付结算单生成；结算单详情；人工付款登记。人工收款已实现但必须继续通过 300 元分配 3 张 100 元应收单等 P0 回归。 +1. 财务 operation 全部通过直接行为测试：账户列表/流水；费用来源详情及编辑审核闭环；对账单生成、审核、出账、客户确认、调整/作废；应收/应付结算单生成与详情；人工收付款登记。人工收款继续覆盖 300 元分配 3 张 100 元应收单等回归。 2. 对账单、应收/应付结算单、付款和 revision 所需数据模型与唯一约束同步落地，不能只做空 Controller。 3. 详细冻结契约见 `财务一期P0操作契约与验收用例.md`；不得把其中任何一项标为 P1、后续优化或假入口。 diff --git a/财务管理/财务管理产品确认表.md b/财务管理/财务管理产品确认表.md index 1011007..3c0804b 100644 --- a/财务管理/财务管理产品确认表.md +++ b/财务管理/财务管理产品确认表.md @@ -46,7 +46,7 @@ | 成员停用 | 客户子用户停用只撤销访问权限；客户账单、应收、余额等仍归客户企业，不触发财务单据转交；历史保留操作人快照 | | 一期页面 | 只做客户账户、客户应收应付、客户对账单、结算单应收、结算单应付；费用分析和利润表不进菜单/路由 | | 客户账户性质 | 财务往来派生总览，不是钱包；删除手动充值、预收、可消费余额和自动扣款入口 | -| 费用来源链路 | 入库单费用和柜子费用必须审核、标记参与结算并发布到 Finance 来源池后，才能生成对账单/结算单 | +| 费用来源链路 | 入库单费用和柜子费用审核通过后自动发布到 Finance 来源池并成为结算候选；不保留人工“是否结算”标记 | ## 二、全量范围确认 @@ -87,7 +87,7 @@ | F0-05 | 汇率 | 保留汇率扩展字段，首期不自动折算、不计算汇兑损益 | 首期不做汇率能力、不做汇兑损益 | 已确认 | | F0-06 | 财务期间 | 自定义账期；支持 OPEN/CLOSED 和重开；重开必须记录原因、操作人和前后版本 | 自定义账期，关账后允许重开 | 已确认 | | F0-07 | 编号 | 服务端按单据类型+年月+流水号发号；重试返回原号，作废号不回收 | 按成熟软件规则实现 | 已确认 | -| F0-08 | 来源费用入池 | APPROVED、PUBLISHED、settlementIncluded=true 的有效来源可入池；未出账允许调整，进入有效账单后冻结 | 出账冻结，未出账允许修改 | 已确认 | +| F0-08 | 来源费用入池 | 所有有效费用都需要结算；`APPROVED + PUBLISHED + AVAILABLE + CNY + amount>0` 自动成为结算候选，不保留“是否结算/参与结算”人工开关；未出账允许调整，进入有效账单后冻结 | 审核通过自动发布并进入结算候选；出账冻结，未出账允许修改 | 已确认 | | F0-09 | 事件可靠性 | Firstleg Outbox 发布费用事件，Finance 消费幂等并保存来源快照；失败可重试、可查结果 | 按现有 Outbox 与幂等模式实现 | 技术已确认 | | F0-10 | 审计与权限 | 首期不强制双人复核/金额分级；财务写操作仍使用独立权限、原因和审计事件 | 平台财务按最简单方式处理，不增加强制审批 | 已确认 | @@ -97,21 +97,22 @@ |---|---|---|---|---| | F1-01 | 账单聚合维度 | 客户 + 币种 + 账期；不同币种不合并 | 首期只支持 RMB/CNY；支持多种费用项；多笔订单分别出账 | 已确认 | | F1-02 | 生成方式 | 支持按筛选结果人工生成；后续可增加定时生成，但不得重复出账 | 按截止时间或财务勾选合格来源生成；同一来源版本不得重复进入有效对账单 | 已确认 | -| F1-03 | 账单状态 | DRAFT → ISSUED → CLOSED；客户只读，异议线下反馈后由平台财务调整或作废重开 | 客户不在线确认/争议，平台财务手工处理 | 已确认 | +| F1-03 | 账单状态 | 主状态独立于客户确认状态；平台出账后进入 `PENDING_CONFIRMATION`，客户确认后为 `CONFIRMED`，账单调整后重新待确认 | 客户确认不改变结算主状态；调整、作废和重开均保留审计 | 已确认 | | F1-04 | 应收状态 | OPEN → PARTIALLY_SETTLED → SETTLED；到期后增加 OVERDUE 标记，不改变余额 | 客户账期由客户配置，默认 30 天；到期日按账单日期+客户账期计算 | 已确认 | -| F1-05 | 客户确认 | 首期不做客户在线确认/争议；客户只读查看，异议线下反馈 | 客户不能操作，由平台财务处理 | 已确认 | +| F1-05 | 客户确认 | 客户使用登录态确认本人已出账对账单，不接受前端 customerId；使用独立权限、乐观锁和幂等键 | 客户可在线确认，平台和客户均展示确认状态、确认人和确认时间；不做在线争议 | 已确认 | | F1-06 | 收款登记 | 首版人工登记到账日、金额、币种、方式、凭证号、附件和登记人 | 平台财务人工填写收款表单并上传收款凭证图片 | 已确认 | | F1-07 | 核销关系 | 支持一笔收款核销多张应收、一张应收被多笔收款核销；禁止跨币种和超额 | 一笔客户付款可分配到多张账单；财务分别填写各账单对应金额并关联同一收款凭证；首期不处理预收、多收、手续费、退款 | 已确认 | | F1-08 | 反核销/作废 | 独立高风险权限，填写原因并保留原记录；不物理删除 | 首期不做复杂反核销；未收单据可作废，已出账调整/作废重开必须留原因、版本和原记录 | 已确认 | | F1-09 | 出账后调整 | 已出账冻结；平台财务通过调整/作废重开形成新版本，保留原金额和原因 | 仅平台财务手工调整，不允许客户修改 | 已确认 | | F1-10 | 预收/多收/手续费/退款 | 单独建模为预收、其他应付款或退款，不直接冲减应收金额 | 一期全部不做；不设计钱包或预收入口 | 已确认 | +| F1-11 | 应收款统计表 | 按结算单生成自然月和客户汇总 CNY 正式应收 | 展示应收总额、已收合计、余额未收，支持打印和异步 Excel；不做 FBA 渠道拆分、USD、编辑或零头减免 | 已确认 | ## 五、F2 供应商应付与结算确认 | 编号 | 需要确认的事项 | 建议结论 | 最终结论 | 状态 | |---|---|---|---|---| -| F2-01 | 成本来源 | 只有具备供应商、付款主体、成本凭证、币种金额和成本归属的来源才能进入应付池 | 一期只接具备供应商、真实业务来源、审核、参与结算和 CNY 金额的 PAYABLE 来源 | 已确认 | -| F2-02 | 成本确认节点 | 以供应商账单/业务完成/内部审核中确定一个正式节点；确认后冻结成本快照 | 费用审核通过、参与结算并发布后进入 Finance；来源版本冻结 | 已确认 | +| F2-01 | 成本来源 | 只有具备 Warehouse 供应商、真实业务来源、审核和 CNY 正金额的 PAYABLE 来源才能进入应付池 | 供应商必须为 `ACTIVE`，名称只取 Warehouse 快照；费用项目 `supplierCategory` 为空时允许任意启用供应商，非空时严格匹配类别 | 已确认 | +| F2-02 | 成本确认节点 | 费用审核通过后自动发布并进入 Finance 结算候选，确认后冻结成本快照 | 不保留“参与结算”开关；来源版本冻结 | 已确认 | | F2-03 | 供应商账单 | DRAFT → INTERNAL_REVIEW → SENT → CONFIRMED → CLOSED；差异走争议/补差/冲销 | 一期不单独做供应商对账页，直接在结算单应付中生成、审核和付款 | 已确认 | | F2-04 | 应付状态 | OPEN → PARTIALLY_PAID → PAID；到期增加 OVERDUE 标记 | DRAFT → PENDING_REVIEW → ISSUED → PARTIALLY_PAID → PAID；可拒绝/作废并留痕 | 已确认 | | F2-05 | 付款与核销 | 付款单独登记，支持多对多付款核销；禁止跨币种和超额 | 平台财务人工登记付款表单和凭证；不得跨供应商或超额 | 已确认 |