Rhythm 2.0 Specifications

Appearance

CAP-ACC-TRX-006Record receipts collected outside Rhythm

Markdown

CAP-ACC-TRX-006

Record receipts collected outside Rhythm

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationObserved

Planning

Feature
FEAT-ACC-TRX-03
Exercised by
FAS-ACC-TRX-03-01, FAS-ACC-TRX-03-03, FAS-ACC-TRX-03-04
Key concepts
CON-ACC-TRX-003, CON-ACC-TRX-006
Actors
ACT-ACC-012, ACT-ACC-021
Journeys
JNY-ACC-TRX-002, JNY-ACC-TRX-004
Related
CAP-ACC-TRX-008, CAP-ACC-TRX-009, CAP-ACC-TRX-013, CAP-ACC-TRX-015
Proved by
ATS-ACC-TRX-006

Implementation

Executable suites
TST-ACC-TRX-012, TST-ACC-TRX-077, TST-ACC-TRX-078, TST-ACC-TRX-079, TST-ACC-TRX-081, TST-ACC-TRX-239

KindCapabilityProduct areaAccountingModuleTransactionsRevision1

Read atservices-accounting f47cb263react-console baf6dae3

Record receipts collected outside Rhythm ​

Purpose ​

Staff record checks, cash and transfers as identifiable customer money.

How It Works ​

Staff enter the customer, amount, method and financial destination for money already received. Accounting checks the selected method and applicable reference requirement. The receipt receives its number and eligible batch within the successful operation. Staff can apply it immediately or leave value available. A different sender can be retained as payer attribution. Invalid account, currency, period or batch choices prevent recording. The receipt’s core financial identity remains protected afterward.

Relationships ​

  • Allocate and relocate received money supplies or continues the related financial work.
  • Complete invoice settlement with credit and money supplies or continues the related financial work.
  • Record receipts that were voided or returned supplies or continues the related financial work.
  • Keep transaction batches and details correct supplies or continues the related financial work.

The Formal Contract

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

Outcomes
Staff record checks, cash and transfers as identifiable customer money.Invalid account, currency, period or batch choices prevent recording. The receipt’s core financial identity remains protected afterward.
Surfaces
consoleapi
Intent sources
services-accounting:docs/milestones/plans/ACCT-M2-plan.md#D4services-accounting:docs/milestones/plans/ACCT-M2-plan.md#D5services-accounting:docs/milestones/plans/ACCT-M2-plan.md#D6services-accounting:docs/milestones/plans/ACCT-M2-plan.md#D12services-accounting:docs/architecture/accounting-2.0/02-decisions.md#A-9services-accounting:docs/architecture/accounting-2.0/02-decisions.md#D-01

Controls

24 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-TEN-004 TC-DAT-001 TC-DAT-002 TC-DAT-003 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-PI-001 TC-PI-003 TC-PI-005 TC-PRV-001 TC-PRV-002

Permissions

KeyChecked atScope
accounting.payments.createapitenant
accounting.payments.readapitenant

Business Rules

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

IdRuleKindEnforced atProvenance
01must prove
Proposed
Received money must be positive and denominated in a currency supported by its business unit.
proved by ATS-ACC-TRX-006-01, TST-ACC-TRX-012, TST-ACC-TRX-081
validationapi, service, databasetest
services-accounting:modules/transactions/tests/integration/services/payments/receive-offline.integration.spec.js#it refuses an amount in another currency (currency_mismatch)
02must prove
Confirmed
A method must exist, be active and support the selected channel; a required reference applies to direct method selection except imports, while legacy aliases retain reference-free entry.
origin: services-accounting:docs/architecture/accounting-2.0/02-decisions.md#D-01
proved by ATS-ACC-TRX-006-02, TST-ACC-TRX-078
validationserviceobserved
services-accounting:modules/transactions/services/payments/payment-method-rules.ts:missingReferenceRefusal
03
Confirmed
During compatibility support, retired method values map to configured methods, and conflicting direct and alias selections are rejected.
origin: services-accounting:docs/architecture/accounting-2.0/02-decisions.md#D-01
policyservicetest
services-accounting:modules/transactions/tests/integration/services/payments/payment-methods.integration.spec.js#it records a payment on the retired check value as the paper check method
04must prove
Proposed
Offline receipts require a bank account in the receipt’s unit and currency.
proved by ATS-ACC-TRX-006-03, TST-ACC-TRX-081
validationapi, servicetest
services-accounting:modules/transactions/tests/integration/services/payments/receive-offline.integration.spec.js#it refuses a bank account of another unit (cash_account_mismatch)
05must prove
Proposed
A receipt requires an eligible explicit batch or an assignment-rule selection; failure to find either records nothing.
proved by ATS-ACC-TRX-006-04, TST-ACC-TRX-077, TST-ACC-TRX-081
validationservice, databasetest
services-accounting:modules/transactions/tests/integration/services/payments/receive-offline.integration.spec.js#it refuses a payment naming no batch in a unit with no batch assignment rule (batch_required), writing nothing
06must prove
Proposed
Offline receipts succeed immediately, default to today and use an accounting date covered by an open fiscal period.
proved by ATS-ACC-TRX-006-05, TST-ACC-TRX-081
validationservicetest
services-accounting:modules/transactions/tests/integration/services/payments/receive-offline.integration.spec.js#it refuses a date in no open period (period_not_open)
07must prove
Proposed
The payment sequence begins at one million and allows unused numbers.
proved by ATS-ACC-TRX-006-06, TST-ACC-TRX-081
policyservice, databasetest
services-accounting:modules/transactions/tests/integration/services/payments/receive-offline.integration.spec.js#it numbers the tenant’s first payment 1,000,000, succeeded, in the bank account and the unit’s batch
08must prove
Proposed
Unallocated value remains on the receipt and reduces the customer’s net debt until someone explicitly turns it into credit.
origin: services-accounting:docs/architecture/accounting-2.0/02-decisions.md#A-9
proved by ATS-ACC-TRX-006-07, ATS-ACC-TRX-006-10, ATS-ACC-TRX-008-09, ATS-ACC-TRX-011-10, TST-ACC-TRX-081, TST-ACC-TRX-239
calculationservice, databasetest
services-accounting:modules/transactions/tests/integration/services/payments/receive-offline.integration.spec.js#it writes the payment item’s facts: minus the whole amount, then plus each allocation, summing to minus the unapplied money
09must prove
Proposed
An offline receipt may identify a different payer by CRM identity or name; that write-once attribution does not expand the eligible invoice population.
proved by ATS-ACC-TRX-006-08, TST-ACC-TRX-079
policyservice, databasetest
services-accounting:modules/transactions/tests/integration/services/payments/payment-payer.integration.spec.js#it writes the payer once: the write-once trigger refuses a change (RHF01)
10must prove
Proposed
Recorded method, behavior, amount, customer and cash destination cannot be changed.
origin: services-accounting:docs/architecture/accounting-2.0/02-decisions.md#A-7
proved by ATS-ACC-TRX-006-09, ATS-ACC-TRX-006-10, ATS-ACC-TRX-011-10, TST-ACC-TRX-078
invariantdatabasetest
services-accounting:modules/transactions/tests/integration/services/payments/payment-methods.integration.spec.js#it refuses any other writer a change of a payment’s method (the write-once trigger, RHF01)
11
Proposed
The payment form prevents mixed-currency invoice selection and filters bank choices to the payment currency.
validationconsoleobserved
react-console:components/accounting/payments/settle-currency.ts:MIXED_CURRENCY_MESSAGE

Scenarios

IdGivenWhenThenProvenance
01A member’s check arrives without allocation instructions.Record the entire receipt without invoice targets.The numbered successful payment belongs to the unit’s batch with its full value available.test
react-console:acceptance/accounting/playwright/journeys/payments/ACT-ACC-0300.spec.ts#ACT-ACC-0300
02An employer supplies a check for the member’s dues.Record the member as customer and the employer as payer.Payer attribution identifies the employer and financial standing separately counts the third-party money.test
services-accounting:modules/transactions/tests/integration/services/payments/payment-payer.integration.spec.js#it counts the unapplied money another party sent in Ada’s summary: Metro’s and the lockbox’s, not her own

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