Teller and cash operations

Physical cash requires an authorised custodian, a permitted office and till, explicit currency and business date, and evidence connecting the physical movement to the retained accounting book.

Prepare a cash operation

Use a local or sandbox institution with synthetic accounts and an approved teller/cashier assignment. Confirm the actor’s office, currency, open-date and custody scope. Check the exact deposit, withdrawal, allocation and settlement commands in the core reference.

Keep teller and cashier identities separate from customer and account identities. JSON amounts should be decoded using decimal precision. Current teller journal/transaction DTOs expose currency and custody identifiers, and transaction records carry retained source entity identity.

Limits and physical evidence

The legacy GET /tellers/limits/validate route is a read-only preview returning authoritative:false. Supplied daily totals affect that preview. Retained posting controls independently evaluate the selected office/currency policy and cash exposure.

The legacy limit PUT returns 409 for an authorised valid request and directs the caller to /eod/governed-close/cash-limit-policies. The current source includes immutable limit proposals, independent approval, physical denomination proof and governed close. Review exact versions and the institution’s selected policy before use.

Deposit, withdrawal and correction

The actor records the customer instruction and physical custody evidence, then submits the permitted cash command. The financial effect must reconcile with the till movement and customer account. The receipt identifies the authoritative operation and resulting state.

Approved cash corrections preserve original records and link compensating effects. A physically confirmed correction must follow its retained recovery path. Book account transfers reject supplied cashierId or tellerId because that operation does not establish physical custody.

Close and recover

Independently count physical denominations and compare them to the retained book for the currency, cashier and date. Resolve differences as owned work. Governed close preserves unfinished external items, jobs, cash proofs and approval evidence before the business date advances.

Qualify duplicate commands, concurrent cash-out, custody conflicts, stale policy/proof versions, mixed currencies, closed dates and interruption with synthetic records. Retain physical acknowledgement, policy/approval version, journals, movements and reconciliation evidence. Source route discovery and those future checks remain distinct from completed runtime acceptance.