Teller & branch cash¶

The teller console is where physical cash meets the ledger: deposits and withdrawals at the counter, the tills and vaults that hold cash, and the blind proofs that keep everyone honest.

Where: the Teller & Branch group.

The teller console¶

Teller & Branch → Teller is a role-aware workspace with tabs: Cashier (everyone), Tills and Vaults (supervisors), and Cash proofs (the audit trail).

A context rail shows your active till, cash on hand per currency, your name, your branch, and a Close till button. If no till is open, you will see "No open till. A supervisor must open a till before cash can be transacted."

Taking cash: the pre-post review¶

On the Cashier tab, pick the account and amount, add an optional narrative and, if you count it, a per-denomination note and coin mix (which must sum to the amount). Deposit or Withdraw opens a pre-post review. Nothing has moved yet. It shows:

the account holder, and the current, available, held and overdraft balances;
the projected available balance after the transaction;
the charges the customer will bear, quoted from the same engine that posts them;
the physical cash mix;
the account's specimen signatures, to check against the wet signature (needs signature:view).

Confirm and it posts. If the amount is over your limit, it is sent to Approvals for a checker.

Tills and vaults (supervisors)¶

Open a till: a till code, branch, teller and an opening float per currency. Each float posts a movement from the vault to the till. (teller:till-open)
Fund a vault: top up a branch vault. (teller:vault-fund)
Tables show till and vault balances and their movements, with Close on a till (teller:till-close).

A till session cannot span a date roll; end of day force-closes any till still open.

Closing a till is a blind count. You record the cash you physically counted per currency (or a denomination breakdown); the expected system balance is hidden until you submit. Each currency is proved on its own (a surplus in one never offsets a shortage in another) and a currency left blank closes unproven.

After you submit, the outcome is revealed: balanced, over, short or unproven, with the over/short journal for a supervisor to review. The Cash proofs tab filters by outcome and exports a close-till report.

Cash logistics¶

Teller & Branch → Cash logistics manages cash in transit: orders, repatriations, inter-branch movements and central-bank deliveries.

Key terms¶

Till / vault: The till is a teller's working cash drawer; the vault is the branch's cash store. Cash moves between them.
Opening float: The cash a till starts the session with, drawn from the vault.
Blind count / cash proof: Counting a till's cash without seeing the expected figure, so the count is honest. The result is a proof: balanced, over, short or unproven.

Roles that do this work¶

Task	Permission	Typical role
Operate the counter	`teller:operate`, `teller:cash-in`, `teller:cash-out`	Teller
Open / close tills	`teller:till-open`, `teller:till-close`	Chief Teller
Fund vaults	`teller:vault-fund`	Chief Teller
View specimen signatures	`signature:view`	Teller, Chief Teller
Approve cash over threshold	`teller:cash-approve`	Chief Teller