--- id: ATS-ACC-REC-011 scope: CAP-ACC-REC-011 product_area: accounting module: reconciliation revision: 3 status: proposed approved_by: null approved_at: null source_sha: services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8 react-console: baf6dae382d6f41dce976c7f848667ccc37e076f scenarios: - id: ATS-ACC-REC-011-01 title: Finalize key and lifecycle guards level: api proves: - BR-CAP-ACC-REC-011-01 preconditions: An open balanced reconciliation is available. steps: 'Finalize and replay its key, then try a new key, no key and an invalid version.' expected: 'Identical replay adds no posting; fresh finalization, missing key and invalid version fail.' negative: true data_needs: Provide Two people for this case. bound_to: - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#replays the stored answer for the same key and request - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#asks the ledger for nothing more on the replay - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses another key after success, naming the state (DEF-ACT-0596) - >- services-accounting:modules/reconciliation/tests/e2e/batch-lifecycle.e2e.spec.js#refuses a request without an Idempotency-Key with 400 - >- services-accounting:modules/reconciliation/tests/e2e/batch-lifecycle.e2e.spec.js#refuses a body whose version is not a number with 400 - TST-ACC-REC-049 - TST-ACC-REC-023 provenance: test source: >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#replays the stored answer for the same key and request category: validation - id: ATS-ACC-REC-011-02 title: Rows decide exact balance level: api proves: - BR-CAP-ACC-REC-011-02 preconditions: Examples include a one-unit difference and inconsistent maintained counters. steps: Attempt finalization for each. expected: Nonzero actual difference fails and is audited; balanced rows govern even when counters drift. negative: true data_needs: No additional fixture beyond the case setup. bound_to: - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a batch one minor unit short, naming the difference - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#leaves the refused batch open - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#records the refusal as batch.finalize-refused with the difference - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a batch whose counters balance but whose rows do not - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#finalizes a batch whose rows balance whatever its counters say, writing the rows’ totals - >- services-accounting:modules/reconciliation/tests/e2e/batch-lifecycle.e2e.spec.js#refuses an unbalanced batch with 409, its code and its difference - >- services-accounting:modules/reconciliation/tests/integration/db/reconciliation-batches.table.integration.spec.js#refuses a finalized batch whose difference is not zero (INV-07) - TST-ACC-REC-049 - TST-ACC-REC-023 - TST-ACC-REC-036 provenance: test source: >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a batch one minor unit short, naming the difference category: invariant - id: ATS-ACC-REC-011-03 title: Preparer exclusion and audited waiver level: api proves: - BR-CAP-ACC-REC-011-03 - BR-CAP-ACC-REC-011-04 preconditions: The preparer’s reconciliation is tested with second-person enforcement enabled and disabled. steps: Attempt the preparer’s finalize under both settings. expected: Enforcement refuses and audits self-approval; the disabled setting permits a visibly waived finalize. negative: true data_needs: Provide Two people; the workspace setting for this case. bound_to: - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses the person who created the batch - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a person who claimed items in it - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#records the refusal as batch.finalize-refused - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#lets the preparer finalize where the tenant does not require a second person, waived - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#records segregation.waived for that finalize - >- services-accounting:modules/reconciliation/tests/unit/rules/segregation.spec.js#refuses a preparer while a second person is required - >- services-accounting:modules/reconciliation/tests/unit/rules/segregation.spec.js#records any finalize as waived when the tenant does not require a second person - >- services-accounting:modules/reconciliation/tests/e2e/batch-lifecycle.e2e.spec.js#refuses the preparer with 403 segregation-required - TST-ACC-REC-049 - TST-ACC-REC-094 - TST-ACC-REC-023 provenance: test source: >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses the person who created the batch category: permission - id: ATS-ACC-REC-011-04 title: Invalid current holdings block finalize level: api proves: - BR-CAP-ACC-REC-011-05 preconditions: 'Examples contain a voided payout, resolved claim, absent payout or voided reconciliation.' steps: Attempt each finalize. expected: Every invalid record remains unfinalized with a refusal. negative: true data_needs: No additional fixture beyond the case setup. bound_to: - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a batch whose payout was voided after it was linked - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a batch whose item was resolved after it was claimed - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a batch that explains no payout - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a voided batch - TST-ACC-REC-049 provenance: test source: >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a batch whose payout was voided after it was linked category: validation - id: ATS-ACC-REC-011-05 title: Transfer lines and item recognition level: api proves: - BR-CAP-ACC-REC-011-06 - BR-CAP-ACC-REC-011-08 preconditions: 'The worked example includes positive, negative and zero payouts with distinct configured accounts.' steps: Finalize the cases and inspect request lines and subsequent clearing effects. expected: >- Requests balance, bank debit sides reverse, zero transfers are absent and each bank has its net line within one transfer. negative: false data_needs: 'Provide Distinct clearing, bank, fee and reserve accounts for this case.' bound_to: - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#asks the ledger for the transfer to the bank, the fee and the reserve, each balanced - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#nets the clearing account to zero with the captures and the refund the payment code posts (INV-12) - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#posts a bank debit from the bank to clearing - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#posts no transfer for a zero payout, only the fee it recognises - >- services-accounting:modules/reconciliation/tests/unit/rules/posting-plans.spec.js#gives each bank account its own line, netting its payouts, and clearing one line for the total - >- services-accounting:modules/reconciliation/tests/unit/rules/posting-plans.spec.js#debits processor fee expense and credits clearing for a fee - TST-ACC-REC-049 - TST-ACC-REC-091 provenance: test source: >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#asks the ledger for the transfer to the bank, the fee and the reserve, each balanced category: rule - id: ATS-ACC-REC-011-06 title: Missing default identifies its purpose level: api proves: - BR-CAP-ACC-REC-011-07 preconditions: The unit has no processor-fee expense default. steps: Finalize a balanced reconciliation including a fee. expected: The missing purpose is named and no ledger request is written. negative: true data_needs: No additional fixture beyond the case setup. bound_to: - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a fee in a unit with no processor_fee_expense default - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-posts-to-subledger.integration.spec.js#is refused naming the missing default - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-posts-to-subledger.integration.spec.js#asks the ledger for nothing, so batch posting has nothing to post for it - TST-ACC-REC-049 - TST-ACC-REC-051 provenance: test source: >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses a fee in a unit with no processor_fee_expense default category: failure - id: ATS-ACC-REC-011-07 title: 'Seal, resolved problem and finalizer history' level: api proves: - BR-CAP-ACC-REC-011-09 - BR-CAP-ACC-REC-011-10 preconditions: A finalized payout had an open unbalanced problem. steps: Change its holdings or money and inspect the exception and finalization activity. expected: >- Sealed changes fail, the problem is resolved with its reconciliation and activity keeps the finalizer and posting context. negative: true data_needs: No additional fixture beyond the case setup. bound_to: - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#locks the finalized batch against updates and deletes - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses releasing one of its claims (RHF30) - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses changing its payout’s amount (RHF30) - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#refuses changing the batch itself (RHF30) - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#resolves the payout’s unbalanced-payout exception naming the batch - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#records batch.finalized by the approver with the posting dates, batch and keys - TST-ACC-REC-049 provenance: test source: >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#locks the finalized batch against updates and deletes category: transition - id: ATS-ACC-REC-011-08 title: Close concurrency and selected batch date level: api proves: - BR-CAP-ACC-REC-011-11 preconditions: 'October is closing or closed, with a later operational batch available.' steps: Finalize an October payout while close holds the period and after its completion. expected: >- Finalize waits, fails against a selected closed-period batch and uses the later batch when selected, preserving document day and late mark. negative: true data_needs: Provide closed period for this case. bound_to: - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-concurrency.integration.spec.js#makes the finalize wait on the period row while the close holds it - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-concurrency.integration.spec.js#refuses the finalize once the close commits: its batch is dated in the closed October - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-concurrency.integration.spec.js#dates the request on the November batch’s date, the payout’s date its document date - >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-batch.integration.spec.js#records lateAfterClose in the finalize event - TST-ACC-REC-050 - TST-ACC-REC-049 provenance: test source: >- services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/finalize-concurrency.integration.spec.js#makes the finalize wait on the period row while the close holds it category: concurrency - id: ATS-ACC-REC-011-09 title: Finalize availability follows grants and preparation level: api proves: - BR-CAP-ACC-REC-011-12 preconditions: 'Callers include a missing-grant user, preparer and independent approver.' steps: Read available actions and attempt finalize as each. expected: Permission or preparation exclusions are explained; only an eligible approver can finalize. negative: true data_needs: Assign callers through the relevant role policies. bound_to: - >- services-accounting:modules/reconciliation/tests/e2e/batch-lifecycle.e2e.spec.js#refuses a principal without accounting.reconciliation-batches.finalize with 403 - >- services-accounting:modules/reconciliation/tests/integration/services/reconciliation-batches/batch-views.integration.spec.js#offers finalize to a person who did not prepare it - >- services-accounting:modules/reconciliation/tests/integration/services/reconciliation-batches/batch-views.integration.spec.js#does not offer finalize to the person who prepared it, the tenant requiring a second person - >- services-accounting:modules/reconciliation/tests/integration/services/reconciliation-batches/batch-views.integration.spec.js#names why finalize is withheld from the person who prepared it - >- services-accounting:modules/reconciliation/tests/integration/services/reconciliation-batches/batch-views.integration.spec.js#offers finalize to the preparer once the tenant turns the second-person rule off - >- services-accounting:modules/reconciliation/tests/unit/rules/batch-actions.spec.js#offers finalize only while balanced - >- services-accounting:modules/reconciliation/tests/unit/rules/batch-actions.spec.js#keeps only the actions whose permission the caller holds - >- services-accounting:modules/reconciliation/tests/unit/rules/batch-actions.spec.js#offers a finalized batch its reversal alone - TST-ACC-REC-023 - TST-ACC-REC-073 - TST-ACC-REC-082 provenance: test source: >- services-accounting:modules/reconciliation/tests/e2e/batch-lifecycle.e2e.spec.js#refuses a principal without accounting.reconciliation-batches.finalize with 403 category: permission - id: ATS-ACC-REC-011-10 title: Mock browser saves then finalizes level: browser proves: - BR-CAP-ACC-REC-011-13 preconditions: Mock mode supplies a balanced workspace and finalize authority. steps: Add an adjustment and activate Finalize. expected: >- Draft commands precede the finalize request and the mock success message appears; this does not prove live segregation. negative: false data_needs: Use the live Accounting service boundary. bound_to: - >- react-console:e2e/mock/accounting-reconciliation.mock.spec.ts#Save Draft and Finalize send the claims, the manual item and the finalize command - TST-ACC-REC-022 provenance: test source: >- react-console:e2e/mock/accounting-reconciliation.mock.spec.ts#Save Draft and Finalize send the claims, the manual item and the finalize command category: interaction - id: ATS-ACC-REC-011-11 title: Independent approval through the API level: api proves: - BR-CAP-ACC-REC-011-03 - BR-CAP-ACC-REC-011-06 - AS-JNY-ACC-REC-001-03 preconditions: Captures and a refund explain one payout. steps: >- Have the preparer create and claim, try their finalize, then have an independent approver finalize and retry. expected: Self-approval fails and independent approval creates one transfer before identical replay. negative: false data_needs: Use the isolated reconciliation fixture unit. bound_to: - >- react-console:acceptance/accounting/playwright/journeys/reconciliation-close/ACT-ACC-0590.spec.ts#ACT-ACC-0590 - TST-ACC-REC-001 provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/reconciliation-close/ACT-ACC-0590.spec.ts#ACT-ACC-0590 category: interaction - id: ATS-ACC-REC-011-12 title: Finalize refusal journey level: api proves: - BR-CAP-ACC-REC-011-02 - BR-CAP-ACC-REC-011-03 - BR-CAP-ACC-REC-011-05 preconditions: 'Cases have a nonzero difference, preparer conflict, absent payout, resolved claim or missing batch.' steps: Attempt each finalize. expected: Each failure explains its cause; absent batch rolls back even the refusal event. negative: true data_needs: Use the isolated reconciliation fixture unit. bound_to: - >- react-console:acceptance/accounting/playwright/journeys/reconciliation-close/ACT-ACC-0597.spec.ts#ACT-ACC-0597 - TST-ACC-REC-007 provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/reconciliation-close/ACT-ACC-0597.spec.ts#ACT-ACC-0597 category: failure - id: ATS-ACC-REC-011-13 title: Reversal releases sealed holdings category: interaction level: api proves: - BR-CAP-ACC-REC-011-09 - BR-CAP-ACC-REC-011-10 - AS-JNY-ACC-REC-003-01 - AS-JNY-ACC-REC-003-02 interacts_with: - CAP-ACC-REC-013 relies_on: - ATS-ACC-REC-011-07 - ATS-ACC-REC-013-08 preconditions: Use one isolated workspace with the financial records and caller roles required by the relied-on cases. steps: - do: 'Finalize a balanced explanation, try a sealed edit, reverse it and create a replacement.' expect: >- The edit fails; the original approval remains historical and the replacement can claim released money. provenance: proposed source: - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-011-approve-a-balanced-reconciliation-and-move-the-deposit-to.md - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-013-correct-a-finalized-reconciliation-by-reversing-it-and.md expected: The edit fails; the original approval remains historical and the replacement can claim released money. negative: false data_needs: >- Local merchant and bank accounts, an open operational batch and distinct preparation and approval callers. bound_to: [] provenance: proposed source: - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-011-approve-a-balanced-reconciliation-and-move-the-deposit-to.md - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-013-correct-a-finalized-reconciliation-by-reversing-it-and.md - id: ATS-ACC-REC-011-14 title: Contribution changes approval eligibility category: interaction level: api proves: - BR-CAP-ACC-REC-011-03 - BR-CAP-ACC-REC-011-04 - BR-CAP-ACC-REC-020-02 interacts_with: - CAP-ACC-REC-020 relies_on: - ATS-ACC-REC-011-03 - ATS-ACC-REC-020-02 preconditions: Use one isolated workspace with the financial records and caller roles required by the relied-on cases. steps: - do: >- Have a second person add a manual entry, then try approval by that person and by an uninvolved third person. expect: Only the uninvolved authorized approver completes approval under the default separation setting. provenance: proposed source: - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-011-approve-a-balanced-reconciliation-and-move-the-deposit-to.md - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-020-keep-preparing-apart-from-approving-and-leave-a-trail-of.md expected: Only the uninvolved authorized approver completes approval under the default separation setting. negative: false data_needs: >- Local merchant and bank accounts, an open operational batch and distinct preparation and approval callers. bound_to: [] provenance: proposed source: - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-011-approve-a-balanced-reconciliation-and-move-the-deposit-to.md - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-020-keep-preparing-apart-from-approving-and-leave-a-trail-of.md - id: ATS-ACC-REC-011-15 title: Period locking coordinates approval category: interaction level: api proves: - BR-CAP-ACC-REC-011-11 - BR-CAP-ACC-REC-018-13 interacts_with: - CAP-ACC-REC-018 relies_on: - ATS-ACC-REC-011-08 - ATS-ACC-REC-018-09 preconditions: Use one isolated workspace with the financial records and caller roles required by the relied-on cases. steps: - do: 'Hold a period close lock during approval, complete close and retry with an open selected batch.' expect: Approval waits for the lock and later accounting preserves the original document day. provenance: proposed source: - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-011-approve-a-balanced-reconciliation-and-move-the-deposit-to.md - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-018-tell-month-end-close-what-stops-a-period-from-closing.md expected: Approval waits for the lock and later accounting preserves the original document day. negative: false data_needs: >- Local merchant and bank accounts, an open operational batch and distinct preparation and approval callers. bound_to: [] provenance: proposed source: - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-011-approve-a-balanced-reconciliation-and-move-the-deposit-to.md - >- specs/accounting/reconciliation/planning/capabilities/CAP-ACC-REC-018-tell-month-end-close-what-stops-a-period-from-closing.md evidence: - >- Bindings identify existing tests at the pinned revisions; proposed cases remain unbound and describe the proof still needed. coverage: rule: covered transition: covered validation: covered permission: covered failure: covered concurrency: covered invariant: covered interaction: covered edge: 'gap: FND-ACC-REC-056' boundary: 'gap: FND-ACC-REC-056' coverage_notes: design_completeness: >- Covered categories count specified cases, including proposed cases. Exhaustive state-transition, permission-key and domain-invariant traceability remains a separate proof gap. --- # Finalize a balanced explanation with eligible approval: Capability Test Specification ## Coverage | Rule | Proved by | |---|---| | `BR-CAP-ACC-REC-011-01` | `ATS-ACC-REC-011-01` | | `BR-CAP-ACC-REC-011-02` | `ATS-ACC-REC-011-02`, `ATS-ACC-REC-011-12` | | `BR-CAP-ACC-REC-011-03` | `ATS-ACC-REC-011-03`, `ATS-ACC-REC-011-11`, `ATS-ACC-REC-011-12` | | `BR-CAP-ACC-REC-011-04` | `ATS-ACC-REC-011-03` | | `BR-CAP-ACC-REC-011-05` | `ATS-ACC-REC-011-04`, `ATS-ACC-REC-011-12` | | `BR-CAP-ACC-REC-011-06` | `ATS-ACC-REC-011-05`, `ATS-ACC-REC-011-11` | | `BR-CAP-ACC-REC-011-07` | `ATS-ACC-REC-011-06` | | `BR-CAP-ACC-REC-011-08` | `ATS-ACC-REC-011-05` | | `BR-CAP-ACC-REC-011-09` | `ATS-ACC-REC-011-07` | | `BR-CAP-ACC-REC-011-10` | `ATS-ACC-REC-011-07` | | `BR-CAP-ACC-REC-011-11` | `ATS-ACC-REC-011-08` | | `BR-CAP-ACC-REC-011-12` | `ATS-ACC-REC-011-09` | ## Interactions With Related Capabilities Mock browser saves then finalizes. Independent approval through the API. Reversal releases sealed holdings. Contribution changes approval eligibility. Period locking coordinates approval. Proposed interaction cases require executable proof.