Rhythm 2.0 Specifications

Appearance

CAP-ACC-REC-012Abandon a draft and release its money

Markdown

CAP-ACC-REC-012

Abandon a draft and release its money

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

Planning

Feature
FEAT-ACC-REC-03
Exercised by
FAS-ACC-REC-03-03, FAS-ACC-REC-03-04, JNY-ACC-REC-003
Key concepts
CON-ACC-REC-003
Actors
ACT-ACC-017, ACT-ACC-018
Journeys
JNY-ACC-REC-002
Depends on
CAP-ACC-REC-008
Related
CAP-ACC-REC-002, CAP-ACC-REC-013
Proved by
ATS-ACC-REC-012
Executed by
TST-ACC-REC-003

Implementation

Executable suites
TST-ACC-REC-023, TST-ACC-REC-034, TST-ACC-REC-036, TST-ACC-REC-053, TST-ACC-REC-095

KindCapabilityProduct areaAccountingModuleReconciliationRevision2

Read atservices-accounting f47cb263react-console baf6dae3

Abandon a draft and release its money ​

Purpose ​

Preparers need to cancel an incorrect explanation without leaving the payout or matched money stranded.

How It Works ​

The preparer selects an open draft and supplies the reason for abandonment. Rhythm checks the current version and releases its holdings. Manually introduced entries are withdrawn as part of cancelling that draft. Released payout and payment effects are available for another explanation. A finalized record requires reversal instead, and the current console lacks a draft-void action.

Relationships ​

Draft creation supplies the record; payout void can follow release; approved explanations use reversal rather than abandonment.

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes
Abandoned explanations free their payout and matched money.Terminal drafts retain their historical record.
Surfaces
api
Intent sources
services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D10 (§2 scope; journey 0593: voiding the draft releases everything)services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D10 (§4: the architecture §6 invariants hold; INV-14)

Controls

21 controls apply, from the corpus control catalogue.

TC-IAM-001 TC-IAM-002 TC-IAM-004 TC-IAM-005 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-AZ-006 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-DAT-001 TC-DAT-004 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-PI-001 TC-PI-003 TC-PI-005

Permissions

KeyChecked atScope
accounting.reconciliation-batches.deleteapitenant

Business Rules

9 rules, 8 to be proved before approval. A rule's product intent is derived from its origin: 9 confirmed by a product decision, the rest inheriting this capability's confirmed.

IdRuleKindEnforced atProvenance
01must prove
Confirmed
Only an open reconciliation can be voided, with a reason and its current version.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D10 (plan approved 2026-10-22 10:40 ET; §2 scope)
proved by ATS-ACC-REC-012-01, TST-ACC-REC-023, TST-ACC-REC-053
validationapi, servicetest
services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#refuses a finalized batch; services-accounting:modules/reconciliation/tests/e2e/batch-lifecycle.e2e.spec.js#refuses a void without a reason with 400; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#refuses a stale version; services-accounting:modules/reconciliation/tests/e2e/batch-lifecycle.e2e.spec.js#refuses a finalized batch with 409
02must prove
Confirmed
Void releases claims and payout links with the reason and withdraws its own manual entries, leaving matched settlement items unresolved and available.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D10 (plan approved 2026-10-22 10:40 ET; §2 scope)
proved by ATS-ACC-REC-008-14, ATS-ACC-REC-012-02, ATS-ACC-REC-012-08, TST-ACC-REC-053
lifecycleservice, databasetest
services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#withdraws the manual fee and leaves the capture unresolved; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#releases every claim with the reason; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#releases the payout link with the reason; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#asks the ledger for nothing; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#records batch.voided with the reason and what it released; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#frees the payout to be linked by another batch
03must prove
Confirmed
Abandoning an open reconciliation generates no ledger request.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D10 (plan approved 2026-10-22 10:40 ET; §2 scope)
proved by ATS-ACC-REC-008-14, ATS-ACC-REC-012-02, ATS-ACC-REC-012-08, TST-ACC-REC-053
policyservicetest
services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#asks the ledger for nothing; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#releases every claim with the reason; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#releases the payout link with the reason; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#withdraws the manual fee and leaves the capture unresolved; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#records batch.voided with the reason and what it released; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#frees the payout to be linked by another batch
04must prove
Confirmed
The released payout can enter another reconciliation or be voided independently.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D10 (plan approved 2026-10-22 10:40 ET; §2 scope); journey 0593
proved by ATS-ACC-REC-008-14, ATS-ACC-REC-012-02, ATS-ACC-REC-012-08, TST-ACC-REC-053
lifecycleservicetest
services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#frees the payout to be linked by another batch; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#releases every claim with the reason; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#releases the payout link with the reason; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#withdraws the manual fee and leaves the capture unresolved; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#asks the ledger for nothing; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#records batch.voided with the reason and what it released
05must prove
Confirmed
The stored lifecycle permits open to finalized or voided and finalized to reversed; reversed and voided are terminal.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D1 (reverse and redo, never reopen)
proved by ATS-ACC-REC-012-03, TST-ACC-REC-095
lifecycleservice, databasetest
services-accounting:modules/reconciliation/tests/unit/rules/transitions.spec.js#refuses voided as batch-not-open; services-accounting:modules/reconciliation/tests/unit/rules/transitions.spec.js#allows finalized; services-accounting:modules/reconciliation/tests/unit/rules/transitions.spec.js#allows voided; services-accounting:modules/reconciliation/tests/unit/rules/transitions.spec.js#allows reversed; services-accounting:modules/reconciliation/tests/unit/rules/transitions.spec.js#refuses open as batch-terminal; services-accounting:modules/reconciliation/tests/unit/rules/transitions.spec.js#refuses finalized as batch-terminal
06must prove
Confirmed
A voided reconciliation is immutable and retains no active holdings.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D10 (§4: the architecture §6 invariants hold; INV-08)
proved by ATS-ACC-REC-012-04, TST-ACC-REC-034, TST-ACC-REC-036, TST-ACC-REC-053
invariantdatabasetest
services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#leaves the voided batch sealed (RHF30); services-accounting:modules/reconciliation/tests/integration/db/reconciliation-batches.table.integration.spec.js#refuses any change to a voided batch; services-accounting:modules/reconciliation/tests/integration/db/reconciliation-allocations.table.integration.spec.js#refuses a claim into a voided batch
07must prove
Confirmed
The void event records its explanation and released records.
proved by ATS-ACC-REC-008-14, ATS-ACC-REC-012-02, ATS-ACC-REC-012-08, TST-ACC-REC-053
lifecycleservicetest
services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#records batch.voided with the reason and what it released; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#releases every claim with the reason; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#releases the payout link with the reason; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#withdraws the manual fee and leaves the capture unresolved; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#asks the ledger for nothing; services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#frees the payout to be linked by another batch
08must prove
Confirmed
Reconciliation delete permission controls draft abandonment.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D10 (§2: permissions)
proved by ATS-ACC-REC-012-05, TST-ACC-REC-023
permissionapitest
services-accounting:modules/reconciliation/tests/e2e/batch-lifecycle.e2e.spec.js#refuses a principal without accounting.reconciliation-batches.delete with 403
09
Confirmed
The console currently provides no draft-void command.
policyconsoleobserved
react-console:lib/accounting/reconciliation/client.ts:createReconciliationClient

Scenarios

IdGivenWhenThenProvenance
01The open draft holds a payout, capture and manual fee.Abandon it with a written reason.Payout and capture are released, the fee is withdrawn and accounting is untouched.test
services-accounting:modules/reconciliation/tests/integration/services/batch-lifecycle/void-batch.integration.spec.js#answers the voided batch whole, holding nothing

Edge Cases

IdGivenWhenThenProvenance
02The explanation has already been finalized.Attempt void.Abandonment is refused and correction requires reversal.test
services-accounting:modules/reconciliation/tests/e2e/batch-lifecycle.e2e.spec.js#refuses a finalized batch with 409

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.

Rhythm Software