# Data Reconciliation Recipe

Source: https://userguide.qualytics.io/recipes/data-reconciliation/deep-dive/introduction/

The Data Reconciliation recipe is a guided flow around the existing [Data Diff](https://userguide.qualytics.io/data-quality-checks/data-diff/introduction/) rule type. It is not a new rule type. The recipe helps you pair an asset you want to investigate (the **left** side) with a reference asset treated as correct (the **right** side), pick the row identifiers that match a row on one side to its counterpart on the other, choose the fields that must agree and how close is close enough, and creates an ordinary Data Diff check from them. It then scans every record, groups the mismatches for you to resolve, and writes the corrections as a **keep set** and a **remove set** to your enrichment destination.

The check the recipe creates is an ordinary quality check. It stays **Active** after the recipe finishes, so future scans keep reporting drift between the two assets, and their anomalies can bring you straight back into the recipe's Reconcile step.

This Deep Dive covers:

- The two phases, **Build & Validate** and **Scan & Reconcile**, and the steps inside each
- The prerequisites: shared fields with compatible types, and a linked enrichment destination on the left datastore before the Scan step
- What the run produces: the check, the scan, the anomaly, the keep set, and the remove set
- The entry points that pull an existing check or anomaly into the flow, and how progress is kept
- Examples, best practices, and the permissions behind each step

For the rule's own semantics, such as how rows are paired and how tolerances are applied, see [How Data Diff Checks Work](https://userguide.qualytics.io/data-quality-checks/data-diff/deep-dive/how-it-works/).

## What You Will Find Here

- **How It Works**

  Left and right, the phases, the prerequisites, what the run reads and writes, and AgentQ's role.

  [How It Works](https://userguide.qualytics.io/recipes/data-reconciliation/deep-dive/how-it-works/)
- **Build and Validate**

  Select Assets, Row Identifiers, Compare Fields, Tolerances, Review, and Validate, step by step.

  [Build and Validate](https://userguide.qualytics.io/recipes/data-reconciliation/deep-dive/build-and-validate/)
- **Scan and Reconcile**

  The full scan, resolving each mismatch, writing the keep and remove sets, and the completion summary.

  [Scan and Reconcile](https://userguide.qualytics.io/recipes/data-reconciliation/deep-dive/scan-and-reconcile/)
- **Entry Points and Resuming**

  Scan in Recipe, Reconcile in Recipe, and how progress is kept between visits.

  [Entry Points and Resuming](https://userguide.qualytics.io/recipes/data-reconciliation/deep-dive/entry-points/)
- **Examples**

  Real scenarios showing two assets compared, their mismatches resolved, and the keep set written.

  [Examples](https://userguide.qualytics.io/recipes/data-reconciliation/deep-dive/examples/)
- **Best Practices**

  Guidelines for choosing sides, identifiers, tolerances, and resolutions that hold up.

  [Best Practices](https://userguide.qualytics.io/recipes/data-reconciliation/deep-dive/best-practices/)
- **Permissions**

  The roles and team permissions behind each step of the recipe.

  [Permissions](https://userguide.qualytics.io/recipes/data-reconciliation/deep-dive/permissions/)

*Last updated: September 21, 2026.*
