Skip to main content
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.

Finance & Revenue

Finance & Revenue core overview.

Governance & parity

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