Edit account · ext-coffee-shop-supply-co Coffee Shop Supply Co

← back to Accounts
ⓘ Reference

An Account is one row in the institution's chart of accounts — a singleton ledger position the institution either owns (internal) or counterparty-owns (external). Every money-movement leg posts to one Account by ID. Accounts that share a role are interchangeable from the rest of the L2 model's perspective; rails / templates / limit-schedules reference accounts by role, not by id.

Required: id (the addressing key — used in URLs and on every transaction row's account_id) and scope (institution-internal vs external counterparty — controls limit + drift visibility). Strongly recommended: role (without it the account isn't reachable by any rail) and name (what shows up in dashboards).

Where this sits

Open full diagram →
Identity
Unique identifier within this L2 instance.
Human-readable label rendered in dashboards + the audit PDF.
Free-form prose; markdown OK. Read by handbook templates.
Classification
`internal` = institution-side; `external` = counterparty.
Classifier this account plays. Rails reference accounts by role — without one, this account can't participate in any flow. Multiple accounts can share a role (N:1 grouping).
When this is a subledger account, names its singleton parent's Role. Used by L1 limit-breach views.
Balance
Numeric — empty means no EOD invariant on this account.
Hours from midnight UTC for this account's EOD cutoff. Positive = later (e.g., +9 for a Tokyo-style EOD); negative = earlier; range [-23, 23]. Leave blank for midnight-aligned. External accounts ignore this — we don't track their EOD balance.
Sparse (default): balance rows arrive only on activity days; intervening days carry the prior balance forward. Explicit-daily: balance rows MUST arrive every business day (missing day = gap violation on L1 Exceptions).
Cancel
Delete