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

# Ejecución de una conciliación

> Activa el motor de Matcher desde la pantalla Reconciliations: elige Dry run para previsualizar o Commit para conservar, y luego revisa las coincidencias, los conteos de no conciliados y las excepciones.

Usa el panel **Run match** en la pantalla **Reconciliations** para activar el motor de coincidencia manualmente para el contexto seleccionado. La Console envía esta acción de forma síncrona. La ejecución se completa dentro de la solicitud en lugar de entrar en una cola. Usa una ejecución en modo Dry run para evaluar las reglas e inspeccionar sus estadísticas resumidas sin escribir artefactos de coincidencia. Usa una ejecución en modo Commit para conservar los resultados.

## Cómo 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 ejecución nueva. Si no has seleccionado un contexto, la 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

***

Elige un modo de ejecución en la lista desplegable **Mode** antes de iniciar:

| Modo        | Descripción                                                                                                                                                                                                          |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Commit**  | Conserva los grupos de coincidencia, los cambios en el resultado de la transacción y las excepciones. Es el modo predeterminado                                                                                      |
| **Dry run** | Evalúa las reglas y muestra estadísticas de vista previa sin conservar los grupos de coincidencia, los cambios en el resultado de la transacción ni las excepciones. Úsalo para probar las reglas antes de confirmar |

## Cómo iniciar una ejecución

***

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

| Estado         | Descripción                                                                                                                                                                                                                         |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **QUEUED**     | Solo un llamador de la API que envía explícitamente `async: true` ve este estado. La ejecución espera a que el worker de coincidencia habilitado la tome                                                                            |
| **PROCESSING** | El motor de coincidencia está procesando activamente la ejecución                                                                                                                                                                   |
| **FINALIZING** | Los resultados de la coincidencia son duraderos mientras se escriben los registros diferidos de discrepancia no conciliada. Un cliente de sondeo asíncrono 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                                                                                                                                      |

La Console obtiene el estado de la ejecución después de cada inicio. Su inicio síncrono alcanza un estado terminal en esa primera consulta, así que no continúa actualizándose. Una ejecución de la API enviada con `async: true` responde **QUEUED** y necesita sondeo continuo hasta **COMPLETED** o **FAILED**. El envío asíncrono requiere un worker de ejecución de coincidencia activo. Sin ese worker, el servicio rechaza la solicitud en lugar de encolarla.

En la página de detalle de la ejecución para una ejecución no terminal, la Console se actualiza cada dos segundos hasta 90 intentos (unos tres minutos). Una ejecución asíncrona abierta desde el historial de ejecuciones es un ejemplo. Haz clic en **Stop watching** para detener solo la actualización local, no la ejecución del lado del servidor. Haz clic en **Recheck status** para reiniciar la actualización.

<Note>
  La Console bloquea el inicio solo cuando su verificación previa a la ejecución devuelve correctamente un total de cero transacciones. Luego muestra una advertencia y un botón **Import data**. Mientras esa verificación se ejecuta o falla, la Console no afirma que el contexto está vacío y deja el inicio disponible. Si una ejecución igual se completa con cero candidatos en ambos lados, la Console muestra una advertencia de importación en lugar de las estadísticas o de **View match groups**.
</Note>

## Cómo revisar los resultados

***

Para una ejecución completada y no vacía 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 conciliadas automáticamente                                                                                         |
| **Pending review (left)** / **Pending review (right)**                  | Transacciones en coincidencias que esperan revisión manual                                                                        |
| **Proposed (left)** / **Proposed (right)**                              | Transacciones en coincidencias propuestas (aún no confirmadas)                                                                    |
| **Unmatched (left)** / **Unmatched (right)** / **Unmatched (external)** | Transacciones que no se pudieron conciliar                                                                                        |
| **Exceptions raised** / **Exceptions updated**                          | Excepciones creadas de nuevo / excepciones preexistentes que la ejecución volvió a tocar. Ambas son cero en una ejecución Dry run |

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

## Resultados del modo Dry run

***

Una ejecución en modo Dry run crea y completa un registro de ejecución persistido con estadísticas agregadas, incluidos los conteos calculados de candidatos, coincidencias y no conciliados. Sus dos estadísticas de excepciones son explícitamente cero. No conserva los grupos ni los ítems de coincidencia, los cambios en el resultado de la transacción ni las excepciones. Por eso, la Console presenta la ejecución como una vista previa estadística en lugar de resultados persistidos grupo por grupo. Aunque **View match groups** igual puede abrir el detalle de la ejecución, una ejecución en modo Dry run no escribe grupos de coincidencia. Usa las estadísticas para ajustar las reglas, y luego cambia a **Commit** y ejecuta de nuevo para conservar los resultados.

## Cómo ver los 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. Una ejecución en modo Dry run no tiene grupos persistidos para inspeccionar. Usa sus estadísticas resumidas en su lugar.
