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

# Reconciliation Wizard

> Guided multi-step wizard for starting a new bank reconciliation session in Finance & Revenue.

The Reconciliation Wizard at `/fa/reconciliations/wizard` provides a guided multi-step workflow for creating a new bank reconciliation session. This is the same wizard component as `/fa/reconciliations/new`.

## Overview

Both `/fa/reconciliations/wizard` and `/fa/reconciliations/new` route to `BankReconciliationWizardPage` (permission: `fa.reconciliations.create`). The wizard uses `ModuleWizardRenderer` from the PF wizard infrastructure. It collects `bank_account_id`, `reconciliation_date`, `statement_id`, and period dates. A progress bar tracks wizard progress. Completion requires `difference` within \$0.01 of zero. On completion, `useWizardCompletion` finalizes the session.

## Who it's for

Requires permission `fa.reconciliations.create`.

## Before you start

* The bank statement for the period must be imported.
* The target fiscal period should not be locked.
* Confirm the bank account and statement period dates.

## Steps

1. Navigate to **Finance & Revenue → Banking** and select **Start Reconciliation**, or go to `/fa/reconciliations/wizard`.
2. Complete each wizard step: select bank account, set reconciliation date, and link a bank statement.
3. Work through matching and verification steps as prompted.
4. When the balance difference is within \$0.01, the **Complete** action becomes enabled.
5. Confirm completion to finalize the reconciliation.

## Key concepts

**Difference enforcement** — `Math.abs(difference) > 0.01` blocks completion; the wizard shows the difference amount in the error if this threshold is exceeded.

**`BankReconciliationWizardData`** — The data type collected by the wizard includes `bank_account_id`, `reconciliation_date`, `period_start_date`, `period_end_date`, and `statement_id`.

## 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/wizards/bank-reconciliation/BankReconciliationWizardPage.tsx
  * src/cores/fa/wizards/bank-reconciliation/hooks/useWizardCompletion.ts
  * src/cores/fa/wizards/bank-reconciliation/types.ts
</Accordion>