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

# Ejecutar una reconciliación

> Dispara el motor de Matcher desde la pantalla Reconciliations: elige Dry run para previsualizar o Commit para persistir, y revisa matches, no emparejados y excepciones.

Usa el panel **Run match** en la pantalla **Reconciliations** para disparar manualmente el motor de matching para el contexto seleccionado. Console envía esta acción de forma síncrona: la ejecución termina dentro de la solicitud en lugar de entrar en una cola. Usa un dry run para evaluar reglas y revisar sus estadísticas resumidas sin escribir artefactos de matching; usa una ejecución commit para persistir los resultados.

## Acceder al panel Run match

***

Navega a **Operate → Reconciliations** en la barra lateral izquierda. La pantalla Reconciliations muestra el historial de ejecuciones del contexto seleccionado, con el panel **Run match** para iniciar una nueva ejecución. Si no has seleccionado un contexto, Console selecciona automáticamente el primero disponible; usa el selector de contexto para elegir otro. Si no hay contextos disponibles, la pantalla muestra un estado vacío en lugar del panel.

## Modos de ejecución

***

Antes de empezar, elige un modo en el desplegable **Mode**:

| Modo        | Descripción                                                                                                                                                                                         |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Commit**  | Persiste grupos de match, cambios en el resultado de las transacciones y excepciones. Es el modo por defecto                                                                                        |
| **Dry run** | Evalúa reglas y muestra estadísticas de previsualización sin persistir grupos de match, cambios en el resultado de las transacciones ni excepciones. Úsalo para probar reglas antes de hacer commit |

## Iniciar una ejecución

***

Haz clic en **Run match**. Console envía `mode` sin `async`, por lo que la ejecución se realiza de forma síncrona; no entra en una cola. Su respuesta contiene un estado terminal de ejecución. Las insignias de estado pueden mostrar los siguientes estados:

| Estado         | Descripción                                                                                                                                                                                                             |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **QUEUED**     | Solo lo ve una llamada a la API que envía explícitamente `async: true`. La ejecución espera que el worker de matching habilitado la tome                                                                                |
| **PROCESSING** | El motor de matching está procesando la ejecución activamente                                                                                                                                                           |
| **FINALIZING** | Los resultados de matching son duraderos mientras se escriben registros diferidos de elementos no conciliados. Un cliente asíncrono que sondea puede observar brevemente este estado no terminal antes de **COMPLETED** |
| **COMPLETED**  | La ejecución terminó correctamente                                                                                                                                                                                      |
| **FAILED**     | La ejecución encontró un error. El motivo del fallo se muestra debajo de la insignia de estado                                                                                                                          |

Console consulta el estado de la ejecución después de cada inicio. Su inicio síncrono llega a un estado terminal en esa primera consulta, por lo que no continúa actualizándose. Una ejecución de API enviada con `async: true` responde **QUEUED** y necesita sondeo continuo hasta **COMPLETED** o **FAILED**; el envío asíncrono requiere que el worker de match runs esté habilitado, de lo contrario el servicio rechaza la solicitud en vez de encolarla. En la página de detalles de una ejecución no terminal —por ejemplo, una ejecución asíncrona abierta desde el historial— Console se actualiza cada dos segundos durante hasta 90 intentos (unos tres minutos). **Stop watching** solo detiene la actualización local, no la ejecución del servidor; **Recheck status** reinicia la actualización.

<Note>
  Console bloquea el inicio solo cuando su comprobación previa devuelve correctamente un total de cero transacciones. Entonces muestra una advertencia y el botón **Import data**. Mientras esa comprobación carga o falla, Console no afirma que el contexto esté vacío y deja disponible el inicio. Si una ejecución aun así termina con cero candidatos en ambos lados, Console muestra una advertencia de importación en lugar de las estadísticas o de **View match groups**.
</Note>

## Revisar los resultados

***

Para una ejecución completada, no vacía y con estadísticas, el panel muestra una cifra destacada de **Matches** y un desglose de estadísticas por lado:

| Estadística                                                             | Descripción                                                                                                                |
| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Candidates (left)** / **Candidates (right)**                          | Transacciones evaluadas en cada lado                                                                                       |
| **Auto-matched (left)** / **Auto-matched (right)**                      | Transacciones emparejadas automáticamente                                                                                  |
| **Pending review (left)** / **Pending review (right)**                  | Transacciones en matches pendientes de revisión manual                                                                     |
| **Proposed (left)** / **Proposed (right)**                              | Transacciones en matches propuestos (aún sin confirmar)                                                                    |
| **Unmatched (left)** / **Unmatched (right)** / **Unmatched (external)** | Transacciones que no se pudieron emparejar                                                                                 |
| **Exceptions raised** / **Exceptions updated**                          | Excepciones creadas por primera vez / excepciones existentes que la ejecución vuelve a tocar. Ambas son cero en un dry run |

Encima del desglose, Console puede mostrar una visualización resumida de las estadísticas devueltas por la ejecución.

## Resultados de un dry run

***

Un dry run crea y completa un registro de ejecución persistente con estadísticas agregadas, incluidos los recuentos calculados de candidatos, matches y no emparejados. Sus dos estadísticas de excepciones se fijan explícitamente en cero. No persiste grupos ni elementos de match, cambios en el resultado de las transacciones ni excepciones, por lo que Console lo presenta como una previsualización estadística y no como resultados persistidos grupo por grupo. Aunque **View match groups** todavía puede abrir el detalle de la ejecución, un dry run no escribió grupos de match. Usa las estadísticas para ajustar reglas y después cambia a **Commit** y ejecuta de nuevo para persistir los resultados.

## Ver resultados detallados

***

Después de una ejecución **Commit** completada, haz clic en **View match groups** para abrir el detalle de la ejecución e inspeccionar los grupos persistidos de esa ejecución. Un dry run no tiene grupos persistidos que inspeccionar; usa sus estadísticas resumidas en su lugar.
