Rhythm 2.0 Specifications

Appearance

JNY-ACC-TRX-002Settle with credit and correct receipt placement

Markdown

JNY-ACC-TRX-002

Settle with credit and correct receipt placement

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationObserved

Planning

Feature
FEAT-ACC-TRX-03
Actor
ACT-ACC-012
Capabilities
CAP-ACC-TRX-011, CAP-ACC-TRX-009, CAP-ACC-TRX-006, CAP-ACC-TRX-008, CAP-ACC-TRX-013
Rules in play
BR-CAP-ACC-TRX-011-01, BR-CAP-ACC-TRX-009-03, BR-CAP-ACC-TRX-009-04, BR-CAP-ACC-TRX-008-02, BR-CAP-ACC-TRX-008-06, BR-CAP-ACC-TRX-013-03

KindJourneyProduct areaAccountingModuleTransactionsRevision1End-to-endRequired

Read atreact-console baf6dae3services-accounting f47cb263

Settle with credit and correct receipt placement ​

Story ​

Finance gives a member goodwill value and combines it with the member’s check to settle dues and event billing. Staff review the credit contribution before confirming the remaining tender. A later uninstructed receipt starts available, then needs correction after it pays the wrong bill. Reallocation retains the mistaken application, its opposite and the replacement. If the bank returns the check instead, staff record that outcome and restore the debt.

The Formal Contract

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

Goal
Combine goodwill credit and check money across member invoices, then relocate a later misapplied receipt.
Screens
/console/{tenantId}/accounting/credits/new/console/{tenantId}/accounting/payments/receive/console/{tenantId}/accounting/settlements/{settlementId}/console/{tenantId}/accounting/payments/{paymentId}

Steps

#SurfaceActionCapabilityExpectedProvenance
1/console/{tenantId}/accounting/credits/newIssue 25.00 of goodwill credit with an explanation and accounting destinations.CAP-ACC-TRX-011A numbered open credit retains the full available amount.test
react-console:acceptance/accounting/playwright/journeys/payments/ACT-ACC-0301.spec.ts#ACT-ACC-0301
2/console/{tenantId}/accounting/payments/receiveChoose both invoices and review a 175.00 check with its reference and batch.CAP-ACC-TRX-009The review combines 25.00 credit with 175.00 money and completion settles both bills.test
react-console:acceptance/accounting/playwright/journeys/payments/ACT-ACC-0301.spec.ts#ACT-ACC-0301
3/console/{tenantId}/accounting/settlements/{settlementId}Follow the settlement to its credit and application records.CAP-ACC-TRX-009Component references remain inspectable and the consumed credit is used.test
services-accounting:modules/transactions/tests/integration/services/settlements/settlement-linkage.integration.spec.js#it names its settlement on the payment and on the intent it made
4/console/{tenantId}/accounting/payments/receiveRecord a later check without allocation instructions.CAP-ACC-TRX-006The receipt succeeds with its entire value available.test
react-console:acceptance/accounting/playwright/journeys/payments/ACT-ACC-0300.spec.ts#ACT-ACC-0300
5/console/{tenantId}/accounting/payments/{paymentId}Apply that check, identify the wrong target and relocate its allocation.CAP-ACC-TRX-008Opposing history restores the wrong bill while the replacement settles the intended one.test
react-console:acceptance/accounting/playwright/journeys/payments/ACT-ACC-0304.spec.ts#ACT-ACC-0304

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate2Staff leave individual credit selection unspecified.Eligible credit is selected oldest first.Tender covers the debt remaining after credit use.test
services-accounting:modules/transactions/tests/integration/services/settlements/settlements.integration.spec.js#it applies the open credit’s 500 first and takes a check of 8000 for the rest: completed with its payment
failure5The bank returns the allocated check.Staff enter its bounced-check outcome with an explanation.The receipt becomes returned and its formerly settled debt reopens.test
react-console:acceptance/accounting/playwright/journeys/payments/ACT-ACC-0306.spec.ts#ACT-ACC-0306
failure2The selected population includes an unrelated member’s bill.Customer eligibility rejects settlement before holding value.Staff remove the invalid target without earlier financial changes.documented
services-accounting:docs/accounting/settlements.md#Refusals

Assertions

IdStatementProvenance
01Credit use precedes check allocation and leaves both selected bills settled.test
react-console:acceptance/accounting/playwright/journeys/payments/ACT-ACC-0301.spec.ts#ACT-ACC-0301
02Settlement components retain references for following their related records.test
services-accounting:modules/transactions/tests/integration/services/settlements/settlement-linkage.integration.spec.js#it answers its settlement in the get
03The earlier application survives reallocation as fully reversed history.test
services-accounting:modules/transactions/tests/integration/services/payments/allocate.integration.spec.js#it writes a reversing row for the 5000 and a new row for the 4000, the original marked reversed in full
04The resulting receivable facts reconcile to the current financial balances.test
services-accounting:modules/transactions/tests/integration/services/payments/allocate.integration.spec.js#it writes the reversal’s facts, mirrored, so the items still agree with the balances

End-to-end policy: required: The settlement review and reallocation controls require browser coverage alongside the financial service assertions.

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