Rhythm 2.0 Specifications

Appearance

JNY-ACC-TRX-005Cancel paid ticket value and follow its return

Markdown

JNY-ACC-TRX-005

Cancel paid ticket value and follow its return

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationObserved

Planning

Feature
FEAT-ACC-TRX-02
Actor
ACT-ACC-012
Capabilities
CAP-ACC-TRX-014, CAP-ACC-TRX-003, CAP-ACC-TRX-012
Rules in play
BR-CAP-ACC-TRX-014-02, BR-CAP-ACC-TRX-014-04, BR-CAP-ACC-TRX-014-06, BR-CAP-ACC-TRX-014-07, BR-CAP-ACC-TRX-003-04, BR-CAP-ACC-TRX-012-03

KindJourneyProduct areaAccountingModuleTransactionsRevision1End-to-endRequired

Read atreact-console baf6dae3services-accounting f47cb263

Cancel paid ticket value and follow its return ​

Story ​

Staff review cancellation of two paid tickets through the reversal preview. Confirmation retains the credit memo and starts returning released value to the card. The reversal remains pending until the processor establishes completion. A purchase paid by check and card produces separate source-specific return work, with the check portion awaiting staff payment. Definite refund failure leaves a visible exception alongside the already booked adjustment.

The Formal Contract

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

Goal
Reduce a paid purchase and return released value to the contributing receipts.
Screens
/console/{tenantId}/accounting/invoices/{invoiceId}/console/{tenantId}/accounting/invoices/{invoiceId}/reverse/console/{tenantId}/accounting/reversals/{reversalId}/console/{tenantId}/accounting/creditMemos/new

Steps

#SurfaceActionCapabilityExpectedProvenance
1/console/{tenantId}/accounting/invoices/{invoiceId}/reverseSelect two of four paid tickets on the reversal page.CAP-ACC-TRX-014Preview identifies the reduction and per-receipt return figures without retained financial records.test
react-console:acceptance/accounting/playwright/journeys/payments/ACT-ACC-0327.spec.ts#ACT-ACC-0327
2/console/{tenantId}/accounting/invoices/{invoiceId}/reverseConfirm the cancellation with refund treatment.CAP-ACC-TRX-014A memo releases the ticket value and starts its card return.test
react-console:acceptance/accounting/playwright/journeys/payments/ACT-ACC-0327.spec.ts#ACT-ACC-0327
3/console/{tenantId}/accounting/reversals/{reversalId}Follow the reversal record through processor confirmation.CAP-ACC-TRX-014Unresolved refund work is pending and confirmed payment completes the return.test
services-accounting:modules/transactions/tests/integration/services/reversals/reversal-refund-status.integration.spec.js#it turns succeeded and completed when the signed event settles the refund

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate1Check and card receipts both contributed.Create separate source-specific returns with processor and staff execution responsibilities.Each receipt accounts for the value it contributed.test
react-console:acceptance/accounting/playwright/journeys/payments/ACT-ACC-0328.spec.ts#ACT-ACC-0328
alternate1Staff choose a plain credit memo instead.The memo releases unneeded paid value to the newest applicable receipt.Refunding remains a separate staff operation.test
react-console:acceptance/accounting/playwright/journeys/invoices/ACT-ACC-0197.spec.ts#ACT-ACC-0197
failure2The processor definitely rejects return.The refund fails and the reversal records a completion exception.Booked adjustment remains and finance must resolve the return.test
services-accounting:modules/transactions/tests/integration/services/reversals/reversal-refund-status.integration.spec.js#it turns failed and completed_with_exception with the processor’s code

Assertions

IdStatementProvenance
01Preview retains no financial rows while document-number allocations can advance.observed
services-accounting:modules/transactions/services/reversals/reversal-commands.ts:previewReversal
02Reduction releases only allocated value no longer needed by the line.test
services-accounting:modules/transactions/tests/integration/services/reversals/reversals.integration.spec.js#it reverses the allocation a credited line no longer needs: the money back on the payment as unapplied
03Each contributing receipt receives its own return request.test
services-accounting:modules/transactions/tests/integration/services/reversals/reversal-two-payments.integration.spec.js#it requests one refund per payment, 7000 and 3000, each from its own payment
04The adjustment books before external refund completion.test
services-accounting:modules/transactions/tests/integration/services/reversals/reversal-refund-status.integration.spec.js#it books the credit memo at once although the refund is not paid

End-to-end policy: required: Browser coverage exercises reversal preview, confirmation and related records; service proof follows asynchronous refund completion.

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