> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Balance Definitions

> Reference page explaining the four balance types (GL, Fund, Bank, Cash Position) used across the Finance module.

Reference page explaining the four balance types used across the Finance module at the in-app route `/fa/balance-definitions`.

## Overview

This screen is a reference page presenting side-by-side comparison cards for the four balance types: GL Balance, Fund Balance, Bank Balance, and Cash Position. Each card shows a full description, data source, and freshness information drawn from the `BALANCE_TERMS` configuration. An animated `BalanceFlowDiagram` shows how the four balance types relate to each other. A "Why Balances May Differ" section explains common reconciliation scenarios (GL vs Bank, Fund vs GL, Cash Position vs Bank). A "Common Questions" FAQ section explains when to use each balance type and what "stale data" means.

## Who it's for

Required permission: `fa.balance_definitions.view` (enforced at the route via `RequirePermission`).

## Before you start

* No data entry required — this is a read-only reference page.

## Steps

<Steps>
  <Step title="Navigate to Balance Definitions">Go to `/fa/balance-definitions` via Finance & Revenue.</Step>
  <Step title="Review the flow diagram">The animated diagram shows how GL, Fund, Bank, and Cash Position balances relate.</Step>
  <Step title="Read the balance type cards">Each card explains a balance type's data source and freshness.</Step>
  <Step title="Review the reconciliation guidance">The "Why Balances May Differ" section explains common causes of discrepancies.</Step>
</Steps>

## Key concepts

* GL Balance — based on posted journal entries in the general ledger
* Fund Balance — a subset view of the GL grouped by fund
* Bank Balance — from bank account records linked to GL accounts
* Cash Position — a calculated allocation snapshot; may not reflect the latest bank sync

## Related

<Columns cols={2}>
  <Card title="Finance & Revenue" icon="building-columns" href="/fa/overview">
    Finance & Revenue core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/fa.tsx
  * src/cores/fa/pages/BalanceDefinitionsPage.tsx
  * src/cores/fa/hooks/useBalanceTerminology.ts
</Accordion>