> ## 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.

# Reconciliations

> Start, view, and complete bank reconciliation sessions with matched/unmatched transactions, adjustments, and PDF/Excel exports in Finance & Revenue.

The route `/fa/reconciliations` is a legacy redirect to `/fa/banking?tab=reconciliations`. The bank reconciliation list is now part of the Banking hub.

## Overview

Navigating to `/fa/reconciliations` triggers a `<Navigate to="/fa/banking?tab=reconciliations" replace />`. The Reconciliations tab in the Banking hub loads `ReconciliationsPage` lazily. That page lists bank reconciliation records with columns for date, bank account, status, and difference amount. `ReconciliationDashboard` and `ReconciliationStatusBadge` are used.

## Who it's for

Access follows your organization's role and module configuration. Starting a new reconciliation requires permission `fa.reconciliations.create`.

## Before you start

No setup required for viewing. To start a new reconciliation, confirm the bank statement for the period has been imported, ensure the fiscal period is not already locked, and have the bank account and statement end date ready.

## Steps

1. Navigate to **Finance & Revenue → Banking → Reconciliations**, or go to `/fa/banking?tab=reconciliations`.
2. Review the list of reconciliation records.
3. Select a reconciliation to view its details at `/fa/reconciliations/:id`.
4. Select **New Reconciliation** to start a new session at `/fa/reconciliations/new`.

## Viewing a reconciliation

The Reconciliation Details page at `/fa/reconciliations/:id` provides a full view of a bank reconciliation session including matched transactions, unmatched items, adjustments, and the completion workflow.

`ReconciliationDetailPage` fetches data via `useBankReconciliation` and `useReconciliationMatches`. The page displays a `ReconciliationSummaryCard` and three tabs: matched transactions (`MatchedTransactionsTab`), unmatched transactions (`UnmatchedTransactionsTab`), and a reports tab (`ReconciliationReportsTab`). An `ReconciliationAdjustmentsTable` shows adjusting entries. PDF and Excel exports are available via `useReconciliationPdfExport` and `useReconciliationExcelExport`. A **Complete Reconciliation** action is guarded by `CompletionConfirmationDialog` and uses `PermissionGate`.

Key concepts:

* **Summary card** — `ReconciliationSummaryCard` shows the balance difference.
* **Completion guard** — Completion is wrapped in `PermissionGate` and a `CompletionConfirmationDialog`.
* **Exports** — PDF via `useReconciliationPdfExport` and Excel via `useReconciliationExcelExport`.

1. Navigate to **Finance & Revenue → Banking → Reconciliations** and select a reconciliation, or go to `/fa/reconciliations/:id`.
2. Review the summary card showing the bank account and reconciliation status.
3. Work through the **Unmatched Transactions** tab to match items.
4. Review the **Matched Transactions** tab for confirmation.
5. Review and add any adjustments.
6. When the reconciliation is balanced, use the **Complete** action and confirm in the dialog.

## Creating a reconciliation

The New Reconciliation page at `/fa/reconciliations/new` launches the Bank Reconciliation Wizard, a multi-step guided workflow for starting a new bank reconciliation session. Requires permission `fa.reconciliations.create`.

Both `/fa/reconciliations/new` and `/fa/reconciliations/wizard` resolve to the same component: `BankReconciliationWizardPage`. The wizard collects `bank_account_id`, `reconciliation_date`, `statement_id`, and period dates. Completion requires a zero (or near-zero) difference before the `useWizardCompletion` hook finalizes the session. Progress is tracked with a progress bar.

Key concepts:

* **Difference threshold** — The wizard enforces `Math.abs(difference) > 0.01` as the completion guard; a difference above this amount prevents finalization.
* **Wizard session** — A `reconciliation_id` is established during the wizard flow and referenced by `useWizardCompletion` to finalize the record.

1. Navigate to **Finance & Revenue → Banking → Reconciliations** and select **New Reconciliation**, or go to `/fa/reconciliations/new`.
2. Follow the wizard steps, selecting the bank account, reconciliation date, and bank statement.
3. Match transactions and resolve discrepancies as guided.
4. When the difference reaches zero (within \$0.01), the wizard enables the **Complete** action.
5. Confirm completion. The reconciliation session is finalized and you are redirected.

## 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" />
</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/ReconciliationsPage.tsx
  * src/cores/fa/pages/BankingHubPage.tsx
  * src/cores/fa/pages/ReconciliationDetailPage.tsx
  * src/cores/fa/wizards/bank-reconciliation/BankReconciliationWizardPage.tsx
  * src/cores/fa/wizards/bank-reconciliation/hooks/useWizardCompletion.ts
  * src/cores/fa/wizards/bank-reconciliation/types.ts
  * src/cores/fa/hooks/useBankReconciliations.ts
  * src/cores/fa/hooks/useReconciliationMatches.ts
</Accordion>