Ledgers

A ledger is the primary accounting boundary within Infrarails. It provides the context in which financial accounts, transactions, and accounting entries are organized.

Applications use ledgers to separate financial records and manage accounting activity within a defined scope.

Understanding ledgers

A ledger represents a logical collection of financial resources.

Each ledger can contain multiple accounts and transactions. Transactions reference accounts within the appropriate ledger and record financial movements through accounting entries.

Ledger
├── Accounts
│   ├── Account A
│   ├── Account B
│   └── Account C
└── Transactions
    ├── Transaction 1
    │   ├── Debit Entry
    │   └── Credit Entry
    └── Transaction 2
        ├── Debit Entry
        └── Credit Entry

Ledger properties

The ledger management model includes the following properties.

Property	Description
`id`	Unique ledger identifier
`user_id`	Associated owner or client identifier
`name`	Human-readable ledger name
`status`	Current ledger status
`metadata`	Additional configuration and descriptive information
`created_at`	Ledger creation timestamp
`updated_at`	Most recent update timestamp

Additional internal fields may be used for credential management and indexing.

Ledger status

Ledger management supports the following statuses:

Status	Description
`ACTIVE`	Ledger is active
`SUSPENDED`	Ledger is suspended
`CLOSED`	Ledger is closed

Applications should consult the API reference for the operations permitted in each state.

Environments

Ledger configuration can include an environment classification.

Supported classification values in the ledger management model are:

PRODUCTION
SANDBOX
`